Before you begin
Best practice: You can run the commands
in this task exactly as written using the installation environment variables. Ensure that you added
the new environment variables from
Updating
your environment variables script.
In addition, ensure that you source the environment
variables before you run the commands in this task.
About this task
You must run the setup-instance-topology
command
to:
Procedure
-
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.
- Run the
cpd-cli
manage
setup-instance-topology
command to upgrade IBM Cloud Pak foundational services and create the required
ConfigMap
.
Tip: Before you run this command against your cluster, you can preview
the
oc
commands that this command will issue on your behalf by running the command
with the
--preview=true
option.
The oc
commands are saved to the preview.sh
file in the work
directory.
Instances without tethered projects
cpd-cli manage setup-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--license_acceptance=true
Important: If the command fails with the error
No storage class defined for
CommonService CR. Please specify --block_storage_class=<RWO class name>, re-run the
command with the
--block_storage_class
option:
cpd-cli manage setup-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class
=${STG_CLASS_BLOCK} \
--license_acceptance=true
Instances with tethered projects
cpd-cli manage setup-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--additional_ns=${PROJECT_CPD_INSTANCE_TETHERED_LIST} \
--license_acceptance=true
Important: If the command fails with the error
No storage class defined for
CommonService CR. Please specify --block_storage_class=<RWO class name>, re-run the
command with the
--block_storage_class
option:
cpd-cli manage setup-instance-topology \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--additional_ns=${PROJECT_CPD_INSTANCE_TETHERED_LIST} \
--block_storage_class
=${STG_CLASS_BLOCK} \
--license_acceptance=true
What to do next
Now that you've upgraded IBM Cloud Pak foundational services, you're ready to complete
Checking for expired SSL certificates (Upgrading from Version 4.5 to Version 4.7).