This document explains about how to enable and use Topology Manager API service in IBM Cloud Pak for Watson AIOps.
1. Enabling Topology Manager API Route
-
Open the web console of the OCP Cluster where WAIOps AIMgr is installed.
-
Open the ASM Operator by doing the following.
- Choose the
Installed Operators
mneu
- Choose the project
cp4waiops
- Choose
IBM Netcool Agile Service Manager
operator
- Choose the Yaml tab and the yaml would be like this.
As seen in the image, need to add the below values at the license attribute level. ( metadata
> annotations
> alm-examples
> spec
> helmValuesASM
)
"helmValuesASM": {
"global.enableAllRoutes": true"
},
- Wait for 2 minutes, the routes will start getting created.
2. Retrieve Topology Manager API access details
A shell script files/00-print-topology-url-usr-pwd.sh is available to print the url and access details of the Topology API.
1. Update NAMESPACE property
In the above script file, update the below property to point to WAIOps AIMgr installed namespace
2. Login into OCP Cluster
Login into the OCP Cluster where WAIOps AIMgr is installed
3. Print the Topology Manager API and access details
Run the below script
sh files/00-print-topology-url-usr-pwd.sh
As a result, Topology API url and access details will be printed like the below.
================================================================
TOPO_API_URL=https://aiops-topology-topology-cp4waiops.aaaa.cloud/1.0/topology
TOPO_API_URL_SWAGGER=https://aiops-topology-topology-cp4waiops.aaaa.cloud/1.0/topology/swagger
TOPO_USER=aiops-topology-cp4waiops-user
TOPO_PWD=aaaaaaaaaaaaaaaa
TOPO_TENENT_ID=cfd95b7e-3bc7-4006-a4a8-a73a79c71255
================================================================
3. Swagger UI
The Swagger UI url will be printed as part of the above script. The TOPO_API_URL_SWAGGER
url to be used to open the Swagger UI.
The above printed User, Password and TenantId fields would be used in Swagger UI.
Swagger UI allows anyone to visualize and interact with the API’s resources.
Note :
- The article is based on the the following.
- RedHat OpenShift 4.8 on IBM Cloud (ROKS)
- IBM Cloud Pak for Watson AIOps 3.2.0
- API service is not officially supported for production.
#API#ASM#CloudPakforWatsonAIOps#howto#Netcool#Topology#topologymanager