Overview

Skill Level: Intermediate

In this recipe we will learn how to deploy ACE dashboard with persistent storage on IBM Cloud Pak for Integration running on OpenShift Container Platform 3.11.

Ingredients

1) IBM Cloud Pak for Integration on OCP 3.11

2) NFS server mount

3) oc client CLI is installed on client machine. If not installed already, follow the instructions at https://docs.openshift.com/online/cli_reference/get_started_cli.html 

4) Default namespace 'ace' has been used here for example. If you are deploying in some other namespace, make sure that security policies and secrets are configured appropriately.

Step-by-step

  1. Create directory for ACE dashboard in NFS mount

    Login to NFS server and go to NFS mount. Create a directory where ACE Dashboard configuration/data will be persisted.

    I have created the directory ‘ace-dashboard’ here.

     

    Screen-Shot-2019-09-30-at-1.02.42-PM

  2. Create Persistent Volume

    Login to Openshift cluster.

    oc login <Openshift cluster url> -u <username> -p <password>

    Below is a sample¬†json file to create PV for ACE dashboard. Save it in a file, say named ‘pvcreate.json’. Note that accessMode for ACE dashboad should be ‘ReadWriteMany’ (RWX).

    Now run below command to create persistent volume using this definition.

    oc create -f pvcreate.json

    {
    "apiVersion": "v1",
    "kind": "PersistentVolume",
    "metadata": {
    "name": "ace-dashboard"
    },
    "spec": {
    "capacity": {
    "storage": "5Gi"
    },
    "nfs": {
    "server": "10.41.16.69",
    "path": "/nfs/integration/ace-dashboard"
    },
    "accessModes": [
    "ReadWriteMany"
    ],
    "persistentVolumeReclaimPolicy": "Retain"
    }
    }

     

    Screen-Shot-2019-09-30-at-1.30.29-PM

     

    You may also create Persistent Volume Claim; however here we will leave it on Kubernetes to create PVC.

  3. Create ACE Dashboard instance from Platform Navigator

    Login to ICP4I Platform mavigator.

    Screen-Shot-2019-09-30-at-1.35.43-PM

     

    Click on ‘Add new instance’ in ‘AppConnect’ and click ‘continue’. Fill the appropriate values in respective fields.

    Screen-Shot-2019-09-30-at-1.45.44-PM

     

    Specify the hostname of the ingress proxy to be configure.

    Screen-Shot-2019-09-30-at-1.47.58-PM

    Uncheck ‘dynamic provisioning’ as we are using NFS and leave Persistent Volume Claim blank. Click on ‘Install’.

    Screen-Shot-2019-09-30-at-1.58.22-PM

     

    It will take few minutes to install and configure ACE Dashboard. Go to Platform navigator and you should be able to see ACE Dashboard link there. 

    Screen-Shot-2019-09-30-at-2.22.24-PM

     

    Click on the dashboard link; it will navigate you to the page from where you can deploy BAR files and create integration servers.

     

    Screen-Shot-2019-09-30-at-2.41.24-PM

  4. Conclusion

    In this recipe, we learnt how to deploy ACE Dashboard on ICP4I using persistent storage.

    To learn how to deploy a BAR file and create an IntegrationServer, navigate to below recipe:

    https://developer.ibm.com/recipes/tutorials/deploying-ace-integrationserver-on-ibm-cloud-pak-for-integration/ 

     

Join The Discussion