Upgrading Concert software (VM)

You can upgrade IBM® Concert on a virtual machine. Follow the upgrade process for an in-place upgrade of the Concert installation.

Instructions

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.4/ibm-concert-std.tgz
```
Go to the directory where your current version of Concert is installed.

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>

Stop all Concert services:
```
./ibm-concert-std/bin/stop
```
Confirm that services are stopped:
```
./ibm-concert-std/bin/status
```

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>/.

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
```

Run a Docker or Podman log in to authenticate with the source image registry. For example:

${DOCKER_EXE} login ${CONCERT_REGISTRY} --username=${CONCERT_REGISTRY_USER} --password=${CONCERT_REGISTRY_PASSWORD}

Run the ibm-concert-std/bin/setup script to prepare your machine. The --license_acceptance=y setting is required.
Warning: If the following command fails, do not attempt to run it again. Doing so could impact your Concert data. Instead, if the command fails, contact IBM Support for assistance.
```
ibm-concert-std/bin/setup --license_acceptance=y --registry=${CONCERT_REGISTRY} --runtime=${DOCKER_EXE} --username=ibmconcert --password
```

(For upgrading from v1.0.1 to v1.0. 2 only) If you are upgrading to Concert software to version 1.0.2, run the following steps:

$ ${DOCKER_EXE} exec -it ibm-roja-postgres bash

bash-5.1$ \
PGPASSWORD=${APPDB_PASSWORD} psql -U ${APPDB_USER} -d ${APPDB_DBNAME} -h ${APPDB_HOST} -p ${APPDB_PORT} -c "\
set schema 'ibm_roja_app'; \ 
update vulnerability_findings set scan_type='image_scan' where scan_type is null or scan_type = ''; \
alter table certificates alter column metadata type jsonb using metadata::jsonb; \
alter table certificates alter column additional_data type jsonb using additional_data::jsonb; \
"

exit

Note: To update Concert to the latest version, you must first install and activate each preceding version in order.