Upgrading Concert on a VM

You can upgrade IBM® Concert on a virtual machine. For the upgrade, you use the installation package that includes scripts and utilities for you to operate an updated version of the Concert services.

To upgrade on a virtual machine:

  1. Download the latest package of the Concert software, replacing <version> with the latest available version number. This package is also available on the Concert GitHub repository.
    wget https://github.com/IBM/Concert/releases/download/v1.0.1/ibm-concert-std.tgz
  2. Go to the directory where your current version of Concert is installed.
  3. Set the following environment variables to the values that you set during the original installation:
    export DOCKER_EXE=<docker or podman>
    
    export CONCERT_REGISTRY=<your registry>
    
    export CONCERT_REGISTRY_USER=<your Concert registry user>
    
    export CONCERT_REGISTRY_PASSWORD=<your Concert registry user password>
  4. Stop all Concert services:
    ./ibm-concert-std/bin/stop
  5. Confirm that services are stopped:
    ./ibm-concert-std/bin/status
  6. Copy data and configuration files to another directory for a backup:
    mkdir <backup directory>
    
    cp -rp  ./ibm-concert-std/localstorage <backup directory>/.
    
    cp  -p  ./ibm-concert-std/etc/local_config.env <backup directory>/.
  7. Expand the new ibm-concert-std.tgz package in the same directory that contains your existing installation of Concert, and with at least 512 GB of available disk space.
    tar xfz ibm-concert-std.tgz
  8. Edit the file ./ibm-concert-std/etc/local_config.env and remove the line that starts with "ROJA_IMAGE_TAG=".
  9. Run a Docker or Podman log in to authenticate with the source image registry:
    ${DOCKER_EXE} login ${CONCERT_REGISTRY} --username=${CONCERT_REGISTRY_USER} --password=${CONCERT_REGISTRY_PASSWORD}
  10. Run the following command to start your upgraded version of Concert:
    ./ibm-concert-std/bin/start
  11. Confirm that the Concert services are running:
    ibm-concert-std/bin/status