Validating a successful installation

The following section describes how to validate that IBM RPA is installed correctly.

Validating IBM RPA installation

There are two ways to verify if the installation was successful:

  • Validating with Zen routing enabled (default since version 1.2.0 of the IBM RPA operator)
  • Validating with Zen routing disabled

Validating with Zen routing enabled

To validate the IBM RPA installation with the Zen routing enabled, see the following steps:

Adding users to the IBM RPA cluster

  1. In the OpenShift web console, go to the Routes page under Networking.

  2. Verify that you have a route with the name cpd, and that its status is Accepted.

  3. Then click the cpd route's Location.

  4. Select the OpenShift authentication option.

  5. On the Zen homepage, click Manage users.

  6. Click Add users.

  7. Add a user email, and click Next.

  8. Add the user roles. If this user is an administrator, add the Administrator role.

  9. Click Next to view a summary of the users that you added and then click Add.

  10. Sign out of the OpenShift user.

  11. Try to log back in to the cpd location's URL using the Enterprise LDAP authentication, and sign in with your SSO ID.

  12. Click the hamburger menu at the top left and select IBM RPA Control Center to log in to the IBM RPA Control Center with your new user.

Checking the IBM RPA instance status

  1. In the OpenShift console, go to the Installed Operators page under Operators.

  2. Select the project that you installed the operator in, then the IBM Robotic Process Automation operator.

  3. Go to the Robotic Process Automation tab and check that the status for the IBM RPA instance is marked as Ready.

IBM RPA CR ready status

Optional: Alternatively, you can run the following command, replacing <PROJECT> with the one the IBM RPA instance is installed in (where <INSTANCE_NAME> is the name of the IBM RPA instance):

oc get roboticprocessautomation -n <PROJECT>
NAME                       READY
<INSTANCE_NAME>            True

If you prefer to consult the full status, see Checking the status of each component to proceed.

Validating with Zen routing disabled

To validate the IBM RPA installation for the API route and UI route, see the following steps:

Checking the IBM RPA instance status

  1. In the OpenShift console, go to the Installed Operators page under Operators.

  2. Select the project that you installed the operator in, then the IBM Robotic Process Automation operator.

  3. Go to the Robotic Process Automation tab and check that the status for the IBM RPA instance is marked as Ready.

IBM RPA CR ready status

Optional: Alternatively, you can run the following command, replacing <PROJECT> with the one the IBM RPA instance is installed in (where <INSTANCE_NAME> is the name of the IBM RPA instance):

oc get roboticprocessautomation -n <PROJECT>
NAME                       READY
<INSTANCE_NAME>            True

If you prefer to consult the full status, see Checking the status of each component to proceed.

Checking the installation

  1. In the OpenShift console, go to the Routes page under Networking.
  2. Select the project that you installed the operator in. You can find several routes that the IBM RPA instance created.

    • Optional: Alternatively, you can run the following command. Replace <PROJECT> with the project where the IBM RPA instance is installed (where <INSTANCE_NAME> is the name of the IBM RPA instance and <CLUSTER_HOST_NAME> is the name of your cluster host):

      $ oc get routes -n <PROJECT>
NAME                               HOST/PORT                                                        PATH   SERVICES                        PORT                   TERMINATION            WILDCARD
cpd                                cpd-<PROJECT>.<CLUSTER_HOST_NAME>                                       ibm-nginx-svc                   ibm-nginx-https-port   passthrough/Redirect   None
<INSTANCE_NAME>-apiserver          <INSTANCE_NAME>-apiserver-<PROJECT>.<CLUSTER_HOST_NAME>                 <INSTANCE_NAME>-apiserver-rpa   <all>                  passthrough/Redirect   None
<INSTANCE_NAME>-mq-rpa-ibm-mq-qm   <INSTANCE_NAME>-mq-rpa-ibm-mq-qm-<PROJECT>.<CLUSTER_HOST_NAME           <INSTANCE_NAME>-mq-rpa-ibm-mq   1414                   passthrough            None
<INSTANCE_NAME>-ui                 <INSTANCE_NAME>-ui-<PROJECT>.<CLUSTER_HOST_NAME>                        <INSTANCE_NAME>-ui-rpa          <all>                  passthrough/Redirect   None
rpa.chl.mq.ibm.com                 rpa.chl.mq.ibm.com
  3. Open the apiserver URL in <INSTANCE_NAME>-apiserver and add /v1.0/en/configuration to the end of the URL.
  4. Accept the certificate.
  5. Open the UI URL in <INSTANCE_NAME>-ui and accept the certificate.
  6. You can now log in.