Installing bundled products

You must manually install the Helm charts for other products that are included with your IBM® Cloud Private package.

You can obtain the compressed files for these products from IBM Passport Advantage .

Required user type or access level: Cluster administrator or team administrator

Before you load a chart, complete the following prerequisites:

• Install IBM Cloud Private. See Installing a standard IBM Cloud Private environment.
• Install the IBM Cloud Private CLI and log in to your cluster. See Installing the IBM Cloud Private CLI.
• Configure authentication from your computer to the Docker private image registry host and log in to the private registry. See Configuring authentication for the Docker CLI.
• If you are not a root user, ensure that your account is part of the docker group. See Post-installation steps for Linux in the Docker documentation.
• Ensure that you have a stable network connection between your computer and the cluster.

To install the packaged products:

1. Obtain the compressed file from Passport Advantage.

2. Ensure that you have enough disk space to load the images in the compressed files to your computer.

   1. Check the Docker disk usage. Run the following command:

      docker system df
      

      For more command options, see docker system df in the Docker documentation.

   2. If you need more disk space, take one of the following actions:
      • Remove old Docker images.
      • Increase the amount of storage that the Docker daemon uses. To increase the amount of storage that the Docker daemon uses, see the entry for dm.basesize in the dockerd Docker documentation.

3. If you have not, log in to your cluster from the IBM Cloud Private CLI and log in to the Docker private image registry.

   cloudctl login -a https://<cluster_CA_domain>:8443 --skip-ssl-validation
   docker login <cluster_CA_domain>:8500
   

   The cluster_CA_domain is the certificate authority (CA) domain. If you did not specify a CA domain, the default value is mycluster.icp. See Specifying your own certificate authority (CA) for IBM Cloud Private services.

4. Install the file from Passport Advantage:

   cloudctl catalog load-archive --archive <compressed_file_name> --registry mycluster.icp:8500/namespace
   

   The compressed_file_name parameter is the name of the file that you downloaded from Passport Advantage, --registry is the registry where the Docker image is pushed to, and namespace is the Docker namespace that hosts the Docker image.

   • For macOS, run the following command to install the file from Passport Advantage:

   cloudctl catalog load-archive --archive <compressed_file_name> --username user --password pass --registry mycluster.icp:8500/namespace
   

   Note: The --registry parameter is not required. If the --registry parameter is not specified, images are uploaded to the registry associated with the default cluster CA domain and the current targeted namespace.

5. View the charts in the IBM Cloud Private Catalog.

   From the IBM Cloud Private management console, click Catalog. The new Helm charts load into the Catalog, and you can install them into your cluster.

   Note: You can load the Helm charts by using only the Catalog. You cannot load the charts by using the Helm CLI.