Accessing Z Understand and Refactor
Retrieve route hostnames and connect to the Z Understand administration interface and the IBM Bob extension.
Retrieving the route hostnames
After the workload reaches the Ready state, retrieve the route hostnames.
Z Understand route
oc get ingress understand \
-n <instance-namespace> \
-o jsonpath='{.spec.rules[0].host}'Refactor route
oc get ingress refactor \
-n <instance-namespace> \
-o jsonpath='{.spec.rules[0].host}'Routes follow the pattern <name>-<namespace>.apps.<ocp-domain>.
Accessing the Z Understand administration interface
Open https://<understand-route>/ad/admin in a web browser and sign in using the administrator credentials specified in the userAccess.password parameter of your setup.json configuration file.
Connecting the service to the extension
To connect to Z Understand and Refactor, configure the following two settings in the Bob IDE extension:
| Setting | Value |
|---|---|
Bob-z > Understand: URL | https://<refactor-route> |
Bob-z > Understand: Certificate Path | Absolute path to the extracted server.crt file on the local machine |
Extract server.crt from the bobz-refactor-config Kubernetes secret within your instance namespace by running the following command:
oc extract secret/bobz-refactor-config -n <instance-namespace> --keys=server.crtConfigure the Bob IDE extension settings:
- Open Settings (
Cmd+,on macOS,Ctrl+,on Windows and Linux). - Search for Bob-z Understand.
- Set Understand: URL to the Refactor route that you retrieved earlier:
https://<refactor-route>. - Set Understand: Certificate Path to the absolute local path of the extracted
server.crtfile, for example/home/user/certs/server.crt.
The certificate path is required when the cluster uses a self-signed certificate or a custom certificate authority (CA). Without the certificate, the extension cannot establish a secure connection to the Z Understand service.