Updating the HCL Commerce runtime package within IBM Cloud Private

If you are using IBM Cloud Private (ICP) to orchestrate your HCL Commerce runtime environment, you can use IBM Cloud Private to update your HCL Commerce packages.

Important:

Starting from HCL Commerce Version 9.1, HCL Commerce does not provide IBM Cloud Private offline package as part of the provided eAssemblies. However, HCL Commerce can still be deployed on ICP by treating ICP as a kind of Kubernetes cluster. All updated HCL Commerce docker images can be downloaded from the HCL License and Delivery portal, and pushed to a private docker registry accessible by the ICP cluster. A helm upgrade command can be used to upgrade HCL Commerce with new images.

Before you begin

  • If you have created a custom Docker image based on the HCL Commerce Docker image, ensure that you have tagged your image. This topic illustrates how to update your Docker images. Proper tagging ensures that you are updating the correct image. For more information about Docker tagging, see Docker tag.

About this task

The following steps are applicable to users who have set up their HCL Commerce runtime environment by using IBM Cloud Private and want to upgrade their HCL Commerce to a higher version. For more information about setting up HCL Commerce with IBM Cloud Private, see Setting up an HCL Commerce production environment with IBM Cloud Private.

For more information about resiliency and how you can use IBM Cloud Private to achieve minimal downtime when operating your containerize environment, see Understand disaster recovery on IBM Cloud Private.

Procedure

  1. Download the latest HCL Commerce archive file from the HCL License and Delivery portal. For a list of the available eAssemblies, see HCL Commerce eAssemblies.
  2. Log in to your IBM Cloud Private master node with your CLI administrator password by using the following command. The default user name is admin, and the default password is admin.
    cloudctl login -a https://master_ip_address:8443 --skip-ssl-validation
    Where master_ip_address is the external IP address for your master or leading master node of your IBM Cloud Private cluster.
  3. Load the HCL Commerce archive into your IBM Cloud Private Catalog by running the following command. 
    # cloudctl catalog load-archive --archive archiveFile.tgz
    Where:
    archiveFile.tgz
    The full path to the archive file that you downloaded from HCL License and Delivery portal.
    Wait for the load to complete successfully, then search for the package in IBM Cloud Private by using the commerce search term.

  4. From your IBM Cloud Private menu, go to Workloads > Helm Releases.
  5. Search for your Helm Release by using the search field. For example, demo1qaauth. You can refer to the Status column for the release name.
  6. Click the ACTION ACTION icon button icon , then click Upgrade.
  7. Click Select Upgrade Version. The available chart versions appear. Click the version to which you are upgrading.
    Note: If you deployed a custom docker image that is based on the default HCL Commerce image, ensure that you specify the correct custom tag in the Tag field.
  8. Click Upgrade.
  9. After the upgrade is complete, verify your environment by logging in to the following HCL Commerce tools with your wcsadmin/wcs1admin username and password. If you need to reset your wcsadmin password, see Resetting the wcsadmin user password (runtime).