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>
  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 Cloud Pak for Data project, use the name of the Cloud Pak for Data project.

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

    • Replace <host> with the hostname of Cloud Pak for Data.
    • 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.