Updating your environment variables script (Upgrading from Version 4.6.x to a later 4.6 refresh)

The commands for upgrading IBM Cloud Pak® for Data use variables with the format ${VARIABLE_NAME}. You can reuse most of the existing information in your environment variables script. However, to upgrade from Cloud Pak for Data Version 4.6.x to a later 4.6 refresh, you must update the VERSION environment variable.

Editing your environment variables file

  1. Open your existing environment variable shell script in a text editor.
  2. Locate the VERSION entry and specify the version of Cloud Pak for Data that you want to install:
    # ------------------------------------------------------------------------------
# Cloud Pak for Data version
# ------------------------------------------------------------------------------

export VERSION=4.6.6

    For additional information about this section of the script, see Cloud Pak for Data version.

  3. If you use the COMPONENTS variable, verify that the list of components is accurate. 
    # ------------------------------------------------------------------------------
# Components
# ------------------------------------------------------------------------------
# Set the following variable if you want to install or upgrade multiple components at the same time.
#
# To export the variable, you must uncomment the command.

export COMPONENTS=cpfs,scheduler,cpd_platform,<component-ID>
  4. Save your changes.
  5. Confirm that the script does not contain any errors. For example, if you named the script cpd_vars.sh, run:
    bash ./cpd_vars.sh

Sourcing the environment variables

You must run the script from a bash prompt before you run the installation and upgrade commands. The script exports the environment variables to your command-line session.

Important: You must re-run the script each time you open a new bash prompt.
  1. Change to the directory where you saved the script.
  2. Source the environment variables. For example, if you named the script cpd_vars.sh, run:
    source ./cpd_vars.sh

Cloud Pak for Data version

The variable in the Cloud Pak for Data version section specifies which version of Cloud Pak for Data to install or upgrade to.

Remember: All of the components must be installed at the same version.
Variable Description
VERSION The version of the Cloud Pak for Data software to install.
Default value
4.6.6
Valid values
  • 4.6.0
  • 4.6.1
  • 4.6.2
  • 4.6.3
  • 4.6.4
  • 4.6.5
  • 4.6.6

Components

If you want to install or upgrade multiple components at the same time, you can specify a comma separated list of components. The variable in the Components section is recommended to help you easily specify the list of components.

Important: If you want to use this variable, you must uncomment the command in the Components section of the script.
Variable Description
COMPONENTS The comma separated list of the components that you want to install or upgrade.
Default value
By default, the list includes the required and recommended components:
cpfs,scheduler,cpd_platform

You can optionally remove scheduler if you don't plan to install Watson™ Machine Learning Accelerator or if you don't plan to use the quota enforcement feature.

Important: You must specify cpfs and cpd_platform. These components are required for all installations.

Do not add any components to the comma separated list before cpfs or cpd_platform. Only add components after the cpd_platform entry. This ensures that the components are installed in the correct order.

Valid values
Review the guidance in Determining which components to install to determine which components to specify.