VRS Upgrade Guide from 14.7 to 14.8.0

Steps to Upgrade VRS with CISCO Deployment Profile

  1. Stop and remove all the VRS containers and images running in Docker.

  2. Navigate to the recording-solution/docker directory.

  3. Open the docker-compose-cisco.yaml file in your preferred text editor. Locate and update the following services and update their tags:

    1. frontend: 14.8

    2. backend: 14.8

    3. Save the changes before closing the file.

  4. The following variable will be added to the config.env file.

Name

Description

1

KEYCLOAK_ADMIN_USERNAME

Username for the Keycloak admin user, by default it is set to admin.

2

KEYCLOAK_ADMIN_PASSWORD

Password for the Keycloak admin user, by default it is set to admin.

3

KEYCLOAK_PERMISSION_GROUP

Keep this value as AGENT_GROUP.

4

ENABLE_FINESSE_GADGET

This config is to enable/disable auto-login while VRS is embedded in Finesse as a gadget.

  1. Navigate the application directory and run ./install-cisco and check your container using the docker ps command.

  2. Once the containers get up, the VRS Application should be accessible on https://<IP-Address >/#/login

Optional Steps:

  1. Follow the Keycloak guide,

    1. Creation of a permission group. (If finesse embedding is enabled)

    2. Addition of realm-management roles.

  2. Update the following VRS Gadget Files in Finesse, embedding is enabled.

    1. VRSGadget.xml

    2. VRSGadget.js

  3. If truststore is required, uncomment the following variables in the docker/config.env file, which is located in your recording-solution directory. And place the truststore.jks file in the recording-solution/ssl directory. If the SSL directory is missing, make a new one and assign it full permission using the chmod 777 command.

Name

Description

1

TRUST_STORE_PATH

It is the path where the truststore file is kept.

2

TRUST_STORE_PASSWORD

Password of the truststore

  1. Once done, run the ./install-cisco script.