Creating OLM objects for an express installation (Upgrading from Version 3.5 to Version 4.6)

A cluster administrator, or a user with the appropriate permissions to install operators, must create the Operator Lifecycle Manager (OLM) objects, such as operators and operator subscriptions, that are required to upgrade the IBM Cloud Pak® for Data platform and services. The OLM objects that you create depend on the services that you use.

Upgrade phase
You are not here. Setting up a client workstation
You are not here. Collecting required information
You are not here. Preparing your cluster
You are here icon. Upgrading the Cloud Pak for Data platform and services
Who needs to complete this task?
A user with the appropriate permissions to install operators must complete this task.
When do you need to complete this task?
You must complete this task before you upgrade the Cloud Pak for Data software to Version 4.6.

Before you begin

Best practice: You can run the commands in this task exactly as written if you set up environment variables. For instructions, see Setting up installation environment variables.

Ensure that you source the environment variables before you run the commands in this task.

IBM Cloud Pak foundational services can be installed exactly once on your cluster. Before you create the OLM objects on the cluster, confirm whether IBM Cloud Pak foundational services is installed on the cluster. If IBM Cloud Pak foundational services is installed, confirm that it is installed in the ibm-common-services project. If IBM Cloud Pak foundational services is installed in a different project, follow the guidance in Creating OLM objects for a specialized installation (Upgrading from Version 3.5 to Version 4.6).

About this task

Use the cpd-cli manage apply-olm command to create the IBM Cloud Pak foundational services operators and the Cloud Pak for Data operators in the ibm-common-services project.

The instructions assume that you are installing the operators for all of the components at the same time, which enables you to complete the task in fewer steps. You can always install additional operators if you decide to install additional services on your environment.

Procedure

  1. Run the cpd-cli manage login-to-ocp command to log in to the cluster as a user with sufficient permissions to complete this task. For example: 
    cpd-cli manage login-to-ocp \
--username=${OCP_USERNAME} \
--password=${OCP_PASSWORD} \
--server=${OCP_URL}
    Tip: The login-to-ocp command takes the same input as the oc login command. Run oc login --help for details.
  2. Create the OLM objects for the specified components: 
    cpd-cli manage apply-olm \
--release=${VERSION} \
--components=${COMPONENTS}
    Tip: If you want to preview the oc commands that the cpd-cli manage apply-olm will issue on your behalf, you can run the command with --preview=true.

    The oc commands are saved to the preview.sh file in the cpd-cli-workspace/olm-utils-workspace/work directory.

Results

The operators for the specified components are created in the ibm-common-services project.
You can optionally run the cpd-cli manage get-olm-artifacts command to get the list of catalog sources and operator subscriptions that are on the cluster.
cpd-cli manage get-olm-artifacts \
--subscription_ns=${PROJECT_CPFS_OPS}

What to do next

Now that you've created the OLM objects, you are ready to complete Upgrading components in an express installation (Upgrading from Version 3.5 to Version 4.6).