If you have Maximo Predict or Maximo Health, data scientists can use the notebooks in IBM Watson Studio to train predictive models for groups of assets. Before data scientists
can download, use, and train the notebooks, they must have the Watson Studio URL, username, and password, credentials for downloading the notebooks and notebook
documentation, and a Db2 certificate.
Before you begin
Ensure that you are a member of the MAXADMIN security group and have access to Red Hat® OpenShift® Container Platform.
About this task
The credentials for downloading, using, and training the notebooks correspond to the
following values in Maximo Predict or Maximo Health:
Table 1. Credentials for notebooks
Credential |
Value |
Use |
APM_ID |
The current value for the mxe.PMIId system property. |
Download, train, and score notebooks. |
APM_API_BASEURL |
The root of the URL value for the PREDICTAPI endpoint. |
Train and score notebooks. |
EXTERNAL_APM_API_BASEURL |
The route location for the application project in Red Hat OpenShift Container Platform. |
Download notebooks. |
APM_API_KEY |
An API key. |
Download and use notebooks. |
Procedure
- Retrieve the Watson Studio URL, username, and password.
- In Maximo Application Suite, on the Suite administration page, click
Configurations.
- In the Other table, select IBM Watson Studio. The Watson Studio URL, username, and password values that
you need are the values that are in the URL, Username,
and Password fields at the system scope.
- Retrieve the value for the APM_ID credential:
- In Maximo Predict or Maximo Health,
from the navigation menu, select Application administration to open the Start
Center.
- In the System Properties application, in the Global Properties table, click the
Filter icon.
- In the Property Name field, search for the
mxe.PMIId system property. The value in the Current
Value field for the mxe.PMIId system property is the APM_ID
credential.
- Retrieve the value for the APM_API_BASEURL credential:
- In Maximo Predict or Maximo Health,
from the navigation menu, select Application administration to open the Start
Center.
- In the End Points application, in the End Point field, search
for predict.
- Open the PREDICTAPI endpoint.
- From the Properties for End-Point table, copy the root portion of the URL that is
specified for the URL property. For example, in the following URL, the root
variable is the root portion of the URL: https://root/ibm/pmi/service/rest. The
root portion of the URL is the APM_API_BASEURL credential.
- Retrieve the value for the EXTERNAL_APM_API_BASEURL credential:
- Log in to Red Hat OpenShift Container Platform. For more information, see Accessing the Red Hat OpenShift Container Platform Web
Console.
- Click Projects and then open the project.
- In the Networking section, click Routes.
- In the Location column, the root portion of the URL is the EXTERNAL_APM_API_BASEURL
credential. For example, in the following URL, the root variable is the root
portion of the URL: https://root/ibm/pmi/service
- Create a new internal user and add the user to the PREDICT and PREDICTGROUPUING security
groups.
- In Maximo Application Suite, on the Suite
administration page, click Users.
- Click Create user.
- Specify the required information.
- In the Application access section, grant the user access to Maximo Predict or Maximo Health. If Maximo Health is deployed, the user must have access to both Maximo Health and Maximo Predict.
- Click Create.
- In Maximo Predict or Maximo Health,
from the navigation menu, select Application administration to open the Start
Center.
- In the Security Groups application, in both the PREDICT and PREDICTGROUPING security
groups, add the new user to the group. You can add users to a security group by opening the group
and then on the Users tab, adding a row for the user to the
table.
- In the Users application, ensure that the user can access at least one site and has a
default insert site.
- Retrieve the value for the APM_API_KEY credential:
- In Maximo Predict or Maximo Health,
from the navigation menu, select Application administration to open the Start
Center.
- From the navigation menu, in the Administration section, select
Administration.
- On the Integration page, on the API Keys
tab, click Add API Key.
- In the User field, select the user that you created in step 5
and then click Add.
- On the API key card, click Copy. This API key is the
APM_API_KEY credential.
- Retrieve the Db2 certificate.
- In Red Hat OpenShift console, click Projects and then open the
project for Maximo Monitor.
- On Secrets, select db2-certificate.
- Click the secret that pops up and copy its value from the data
section.
- Paste this value into a file and save it as
db2_certificate.pem.
- Upload this file into Cloud Pak for Data.
What to do next
Provide the Watson Studio URL, username, and password, credentials for
downloading the notebooks and notebook documentation, and the Db2
certificate to the data scientists. The same values can be provided to all data scientists.
Ensure that you also grant data scientists access to Watson Studio on
Cloud Pak for Data. Access is managed from Cloud Pak for Data.
For automating notebook uploads, see Automating notebook uploads in IBM Watson Studio.