Running a batch installation of solutions and services

Run a batch installation to install multiple services at the same time, which enables you to complete your installation in fewer steps. Batch installations also support parallel installation of some components, which reduces installation time.

However, if you want more granular control over the installation process, you can install services one at a time. See the instructions for installing each service individually in Services.

Installation phase

Setting up a client workstation
Setting up a cluster
Collecting required information
Preparing to run installs in a restricted network
Preparing to run installs from a private container registry
Preparing the cluster for IBM® Software Hub
Preparing to install an instance of IBM Software Hub
Installing an instance of IBM Software Hub
Setting up the control plane
Installing solutions and services

Who needs to complete this task?

Instance administrator An instance administrator can complete this task.

When do you need to complete this task?

Repeat as needed Repeat this task for each instance of IBM Software Hub on your cluster.

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.

About this task

Remember: All of the software in the instance must be installed at the same version as the IBM Software Hub control plane.

Procedure

To run a batch installation of services:

Log the cpd-cli in to the Red Hat® OpenShift® Container Platform cluster:
```
${CPDM_OC_LOGIN}
```
Remember: CPDM_OC_LOGIN is an alias for the cpd-cli manage login-to-ocp command.
Install the operators in the operators project for the instance.
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.
```
cpd-cli manage apply-olm \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--components=${COMPONENTS}
```
Wait for the cpd-cli to return the following message before proceeding to the next step:
```
[SUCCESS]... The apply-olm command ran successfully.
```
If the apply-olm command fails, see Troubleshooting the command during installation or upgrade.
Install the operands in the operands project for the instance:
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.

The command that you run depends on the storage on your cluster:
Red Hat OpenShift Data Foundation storage

Create the custom resources for the specified components.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
IBM Fusion Data Foundation storage

Create the custom resources for the specified components.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
IBM Fusion Global Data Platform storage

Create the custom resources for the specified components.

When you use IBM Fusion storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ibm-spectrum-scale-sc or ibm-storage-fusion-cp-sc.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
IBM Storage Scale Container Native storage

Create the custom resources for the specified components.

When you use IBM Storage Scale Container Native storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ibm-spectrum-scale-sc.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
Portworx storage

Create the custom resources for the specified components.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --storage_vendor=portworx \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --storage_vendor=portworx \ --license_acceptance=true
NFS storage

When you use IBM Storage Scale Container Native storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically managed-nfs-storage.

Create the custom resources for the specified components.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
AWS EFS storage only

Create the custom resources for the specified components.

When you use only EFS storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically efs-nfs-client.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
AWS EFS and EBS storage

Create the custom resources for the specified components.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
NetApp Trident

Create the custom resources for the specified components.

When you use NetApp Trident storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ontap-nas.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
Nutanix

Create the custom resources for the specified components.
Installation options defined in the install-options.yml file
Run the following command if you created an install-options.yml file.

By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true \ --param-file=/tmp/work/install-options.yml
No installation options
By default, the apply-cr installs up to 4 components at the same time. You can adjust this setting by specifying the --parallel_num option.

cpd-cli manage apply-cr \ --release=${VERSION} \ --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \ --components=${COMPONENTS} \ --block_storage_class=${STG_CLASS_BLOCK} \ --file_storage_class=${STG_CLASS_FILE} \ --license_acceptance=true
Wait for the cpd-cli to return the following message before proceeding to the next step:
```
[SUCCESS]... The apply-cr command ran successfully.
```

What to do next

Now that you've installed the services that support your business needs, you're ready to complete the Post-installation setup (Day 1 operations).