Upgrading Helm charts in the Catalog

You can upgrade the Helm charts for other products that you added to the IBM® Cloud Private Catalog.

You can obtain the compressed files for these products from IBM Passport Advantage® Opens in a new tab . After you install the new files, you must upgrade the existing Helm releases.

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

Before you upgrade a chart, complete the following prerequisites:

Make sure that you meet the prerequisites for installing bundled products. See Installing IBM software onto IBM Cloud Private.
Install the Helm command line interface (CLI). See Installing the Helm CLI (helm).

To upgrade the software:

Obtain the compressed file from IBM Passport Advantage® .
Ensure that you have enough disk space to load the images in the compressed files to your computer.
1. Check the Docker disk usage by running 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, perform one of the following actions:
  - Remove the 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.
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.
Install a new version of the chart from Passport Advantage:
```
cloudctl catalog load-archive --archive <compressed_file_name>
```
The compressed_file_name is the name of the file that you downloaded from Passport Advantage, cluster_CA_domain is the (CA) domain, and namespace is the Docker namespace that hosts the Docker image.
View the chart in the IBM Cloud Private Catalog:
1. From the IBM Cloud Private management console, select Manage > Helm Repositories.
2. Click Sync Repositories.
  
  Required user type or access level to sync, add, or remove repositories: Cluster administrator
3. Select Catalog.
  
  When you install the new version of the chart, both charts are visible in the Catalog. You can install either version into your cluster.
Upgrade the existing Helm release that uses the chart by running the following command:
```
helm upgrade <releaseName> http://<cluster_CA_domain>:8443/helm-repo/requiredAssets/<chartName>-<chartVersion>.tgz
```
In this command:
- <releaseName> is the name of the existing Helm release to upgrade. You can find the release name from the management console.
- <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.
- <chartName> is the name of the chart that the Helm release uses. You can obtain the chart name from the Catalog page.
- <chartVersion> is the new version of the chart to use. You can obtain the chart version by clicking the new chart in the Catalog.