Installing tools and utilities in Cloud Pak for Data

You can install tools and utilities, such as ObjectManager. You must run these tools and utilities from a remote system.

Before you begin

The computer where you install the tools and utilities must meet the following requirements:
  • IBM® SDK, Java™ Technology Edition 8 or Java Runtime Environment (JRE) 8 is installed.
  • JAVA_HOME is defined.
  • The remote system has access to IBM OpenPages® for IBM Cloud Pak for Data.

About this task

Do this task if you want to use the following tools and utilities:

Procedure

  1. Get the installation package.
    1. Log in to your Red Hat® OpenShift® cluster as a project administrator:
      oc login OpenShift_URL:port
    2. Download the installation package:
      oc cp openpages-<instance_name>-sts-0:/opt/ibm/OpenPages/openpages-tools.zip ./openpages-tools.zip

      Replace <instance_name> with the name of the OpenPages instance.

  2. Extract the openpages-tools.zip file to a new directory.
  3. Go to the openpages-tools/bin directory.
  4. Open the openpages-tools-client.properties file in a text editor.
  5. Update the value of the rest.url.path property.
    Type the base URL of the public REST API.
    https\://<cpd_url>/openpages-<instance_name>-grc/api

    Replace <cpd_url> with the URL of Cloud Pak for Data. Replace <instance_name> with the name of the OpenPages instance.

  6. Set the value of the platform.cloudpak.jwt.auth property to true.
    This setting enables you to authenticate by using either jwt and a Cloud Pak for Data JSON Web Token (JWT) or your Cloud Pak for Data username and API key rather than a username and password.

    You generate the API key in Cloud Pak for Data. For more information, see Generating API keys for authentication.

  7. By default, the application server's TLS (SSL) certificate is checked for validity when you run tools such as ObjectManager. To change this behavior, update the insecure.skip.tls.verify property.
    For more information, see Tools properties and parameters.
  8. Save and close the file.

Results

You can now run the tools by using the scripts and properties files in the openpages-tools/bin directory.