Post-provisioning setup for OpenPages Loss Event Entry

If you plan to use OpenPages Loss Event Entry, you need to complete these post-installation tasks.

Procedure

  1. Log in to your Red Hat® OpenShift® cluster as an instance administrator:
    oc login OpenShift_URL:port
  2. Change to the project where OpenPages is installed:
    oc project ${PROJECT_CPD_INST_OPERANDS}
  3. Get the name of the OpenPages service by running the following command:
    oc get services -n <Project> | grep openpages
  4. Create a yaml file, for example: lee-route-def-file.yaml.
  5. Copy the following text into the file:
    kind: Route
    apiVersion: route.openshift.io/v1
    metadata:
      annotations:
        openshift.io/host.generated: 'true'
      name: lee
      namespace: <openpages_namespace>
      labels:
        app: openpages
        app.kubernetes.io/instance: openpages
        release: openpages
        app.kubernetes.io/component: opapp
        app.kubernetes.io/managed-by: openpages
        icpdsupport/app: openpages
        app.kubernetes.io/name: openpages
        component: opapp
    spec:
      host: lee-<openpages_namespace>.apps.<host>
      to:
        kind: Service
        name: openpages-<openpages_instance_name>-svc
        weight: 100
      port:
        targetPort: https
      tls:
        termination: reencrypt
      wildcardPolicy: None
    status:
      ingress:
        - host: lee-<openpages_namespace>.apps.<host>
          routerName: default
          conditions:
            - type: Admitted
              status: 'True'
          wildcardPolicy: None
          routerCanonicalHostname: <host>
    • Replace <openpages_namespace> with the project where the OpenPages instance is installed.

      If OpenPages is installed in the IBM® Software Hub project, use the name of the IBM Software Hub project.

      Or if OpenPages is installed in a tethered project, use the name of the tethered project.

    • Replace <host> with the hostname of IBM Software Hub.
    • Replace <openpages_instance_name> with the name of the instance.
    • In this example, the name of the service is openpages. If your OpenPages service has a different name, use the name of your service.
      Tip: To get the name of the service, run: oc get services -n <Project> | grep openpages
    For example, if the OpenPages URL is https://cpd-zen.apps.my.host.com/openpages-openpagesinstance1/, then the values are:
    • <openpages_namespace>: zen (In this example, OpenPages is installed in a project called zen.)
    • <host>: my.host.com
    • <openpages_instance_name>: openpagesinstance1
  6. Run the following command to create the route:
    oc apply -f <route-def-file.yaml>
    The URL for Loss Event Entry is now:
    https://lee-<openpages_namespace>.apps.<host>/openpages-<openpages_instance_name>/app/jspview/react/lossEventEntry.html
    For example:
    https://lee-zen.apps.my.host.com/openpages-openpagesinstance1/app/jspview/react/lossEventEntry.html

    The route uses sticky sessions. Sticky sessions are required by this feature.

  7. When you configure OpenPages Loss Event Entry, change the password of each LEE_* user.
    For more information, see Using the Loss Event Configuration tool.
  8. Give your users the URL from step 6.