Table of contents

Installing the services for OpenPages

After the cluster is set up, a project administrator can install the OpenPages service and Db2® as a service on IBM® Cloud Pak for Data.

Before you begin

Required role: To complete this task, you must be an administrator of the project (namespace) where you will deploy OpenPages.

Before you install OpenPages, ensure that:

Procedure

Set up the cluster by completing the following tasks:

  1. Installing the OpenPages service
  2. Installing Db2 as a service
  3. Verifying the installation
  4. Verifying the installation.
  5. What to do next.

Installing the OpenPages service

  1. Log in to Red Hat® OpenShift® Container Platform as a user with sufficient permissions to complete the task:
    oc login OpenShift_URL:port
  2. Change to the namespace where Cloud Pak for Data is installed.
  3. Create a new yaml file, for example openpages-service.yaml.
  4. Copy the following text into the yaml file, and then update it for your environment.

    Replace <openpages_service_name> with the name that you want to use for the service.

    Replace <cpd_namespace> with the project where Cloud Pak for Data is installed.

    apiVersion: openpages.cpd.ibm.com/v1 
    kind: OpenPagesService 
    metadata:
      name: <openpages_service_name>
      namespace: <cpd_namespace>
      labels:
        app.kubernetes.io/name: openpages
        app.kubernetes.io/instance: openpages-service
        app.kubernetes.io/version: "8.203.0"
        app.kubernetes.io/managed-by: ibm-cpd-openpages-operator 
    spec:
      version: "8.203.0"
      license:
        accept: true
        license: Enterprise|Standard     # Specify the license that you purchased
  5. Run the following command:

    Replace <openpages-service.yaml> with the path and name of the file you created in step 3.

    oc create -f <openpages-service.yaml>

Installing Db2 as a service

If you plan to use the Db2 database that is installed with OpenPages, install Db2 as a service.

When you install Db2 as a service, the security context constraint (SCC) for Db2 is created automatically. For more information, see Db2 SCC capabilities.

Note: If you are using a Db2 database that is outside of Cloud Pak for Data, skip this task.
  1. Log in to your Red Hat OpenShift cluster as a project administrator:
    oc login OpenShift_URL:port
  2. Change to the namespace where Cloud Pak for Data is installed.
  3. Create a new yaml file, for example db2-service.yaml.
  4. Copy the following text into the yaml file, and then update it for your environment.

    Replace <db2_service_name> with the name that you want to use for the service.

    Replace <cpd_namespace> with the project where Cloud Pak for Data is installed.

    apiVersion: databases.cpd.ibm.com/v1
    kind: Db2aaserviceService 
    metadata: 
      name: <db2_service_name> 
      namespace: <cpd_namespace> 
    spec: 
      license: 
        accept: true
  5. Run the following command:

    Replace <db2-service.yaml> with the path and name of the file you created in step 4.

    oc create -f <db2-service.yaml>
  6. Log in to the OpenShift Console and go to OperatorHub.
  7. Switch to the ibm-common-services namespace, and then search for db2 as a service.
  8. Click Install.

    If Db2 as a service is already installed, skip this step. You do not need to install it again.

Verifying the installation

To verify the installation, run the following command:
oc get OpenPagesService openpagesservice-cr -o yaml
Verify the installation of Db2 as a service by running the following command:
oc describe Db2AaserviceServices <db2_service_name> -n <cpd_namespace> | grep 'db2aaserviceStatus'

Verify that the command returns Completed.

What to do next

Preparing to provision an OpenPages instance