Updating your custom resource for an upgrade

Download the custom resource YAML file that you deployed in a previous version, and edit it by following the instructions for each capability that you deployed. Do not apply the updated custom resource file before you make the necessary changes for all the capabilities in your deployment.

About this task

The following table shows the shared configuration parameters that changed between 22.0.1 and 22.0.2. For more information, about the structure of the custom resource and the parameter sections, see Custom resource pattern structure.

Table 1. Changed shared configuration parameters
Configuration parameter Comment
appVersion Change to 22.0.2.
release Change to 22.0.2. This parameter is not used, but for consistency it is recommended to update it to the new version.
Note: External Share is no longer supported as of 22.0.2. Be sure to remove External Share from the custom resource.

Procedure

  1. Open the YAML view of the deployed custom resource in the console.
    In the OpenShift console, click Operators > Installed Operators and select the project where you installed the Cloud Pak operator. Select the IBM Cloud Pak® for Business Automation (CP4BA) multi-pattern operator in the list, click the CP4BA deployment tab, select the ICP4ACluster instance (default name is icp4adeploy), and then click the YAML tab.
    Warning: Do not save the upgrade updates to the custom resource directly in the YAML view of the OCP console. You must wait until you complete all of the updates for all of the capabilities before you save and apply the file. Saving the changes in the console prompts the operator to upgrade to the new version of the images, and that might cause services to fail.
  2. Download the YAML file by clicking Download.

    By default, the custom resource (CR) file name is icp4acluster-icp4adeploy.yaml.

    Tip: To download the file from the command line, run the following command:
    oc get deployment icp4adeploy > <your_cr_name.yaml>
    
  3. Make a copy of the file for your upgrade and give it a recognizable name so that you can apply it later.

    For example, ibm_cp4a_cr_final.yaml.

  4. Open the ibm_cp4a_cr_final.yaml file in your favorite editor, and change the appVersion number from 22.0.1 to 22.0.2.

What to do next

Use the following sections to upgrade each capability that is included in your CR file. If you do not want to use the default values, check and configure the optional parameters.

When your custom resource upgrade is complete, go to and complete the steps in Stopping your deployment.