Configuring notebook access

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

  1. Retrieve the Watson Studio URL, username, and password.
    1. In Maximo Application Suite, on the Suite administration page, click Configurations.
    2. 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.
  2. Retrieve the value for the APM_ID credential:
    1. In Maximo Predict or Maximo Health, from the navigation menu, select Application administration to open the Start Center.
    2. In the System Properties application, in the Global Properties table, click the Filter icon.
    3. 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.
  3. Retrieve the value for the APM_API_BASEURL credential:
    1. In Maximo Predict or Maximo Health, from the navigation menu, select Application administration to open the Start Center.
    2. In the End Points application, in the End Point field, search for predict.
    3. Open the PREDICTAPI endpoint.
    4. 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.
  4. Retrieve the value for the EXTERNAL_APM_API_BASEURL credential:
    1. Log in to Red Hat OpenShift Container Platform. For more information, see Accessing the Red Hat OpenShift Container Platform Web Console.
    2. Click Projects and then open the project.
    3. In the Networking section, click Routes.
    4. 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
  5. Create a new internal user and add the user to the PREDICT and PREDICTGROUPUING security groups.
    1. In Maximo Application Suite, on the Suite administration page, click Users.
    2. Click Create user.
    3. Specify the required information.
    4. 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.
    5. Click Create.
    6. In Maximo Predict or Maximo Health, from the navigation menu, select Application administration to open the Start Center.
    7. 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.
    8. In the Users application, ensure that the user can access at least one site and has a default insert site.
    For more information about user management, see User management.
  6. Retrieve the value for the APM_API_KEY credential:
    1. In Maximo Predict or Maximo Health, from the navigation menu, select Application administration to open the Start Center.
    2. From the navigation menu, in the Administration section, select Administration.
    3. On the Integration page, on the API Keys tab, click Add API Key.
    4. In the User field, select the user that you created in step 5 and then click Add.
    5. On the API key card, click Copy. This API key is the APM_API_KEY credential.
  7. Retrieve the Db2 certificate.
    1. In Red Hat OpenShift console, click Projects and then open the project for Maximo Monitor.
    2. On Secrets, select db2-certificate.
    3. Click the secret that pops up and copy its value from the data section.
    4. Paste this value into a file and save it as db2_certificate.pem.
    5. 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.