Upgrade the Vera Server applications

These instructions will automatically update the Vera components configured inside your Docker compose file. In a standard installation, that will include the Vera API Server, the Tricentis Vera Web Portal, Vera Microservices and RabbitMQ.

Note Updated: 09 DEC 2020

The Docker login credentials listed below have been updated. The credentials listed before this update will not work.

Download the new software

To download the new software, follow these steps:

  1. Open an Administrative PowerShell prompt.

  2. Navigate to the Vera Docker Compose directory that was configured during installation. This is the directory that contains the docker-compose.yml file.

  3. Update the images for vera.server, vera.web.portal, vera.worker.qtest, vera.api.qtest.routeactions, vera.api.routes.routeevents, vera.api.connections.testconnection, vera.worker.jobservice, vera.worker.jira, and vera.api.jira.routeactions within the docker-compose.yml file to match the desired release.

    Note that the beginning of the image will remain the same and only the tag after : will need to be updated when upgrading.

  4. Add container sections for vera.worker.audithistory and vera.api.audithistory.

    Docker-Compose example:

    Copy
    vera.server:
        image: veraserver20190209075900.azurecr.io/tx3/vera-server-legacy:2023.4.0

    vera.web.portal:
        image: veraserver20190209075900.azurecr.io/tx3/vera-web-portal:2023.4.0

    rabbitmq:
        image: masstransit/rabbitmq:3.11.18

    vera.worker.qtest:
        image: veraserver20190209075900.azurecr.io/tricentis/vera-worker-qtest:2023.4.0

    vera.api.qtest.routeactions:
       image: veraserver20190209075900.azurecr.io/tricentis/vera-api-qtest-routeactions:2023.4.0

    vera.api.routes.routeevents:
        image: veraserver20190209075900.azurecr.io/tricentis/vera-api-routes-routeevents:2023.4.0

    vera.api.connections.testconnection:
       image: veraserver20190209075900.azurecr.io/tricentis/vera-api-connections-testconnection:2023.4.0
       
    vera.jira.worker:
       image: veraserver20190209075900.azurecr.io/tricentis/vera-worker-jira:2023.4.0

    vera.api.jira.routeactions:
       image: veraserver20190209075900.azurecr.io/tricentis/vera-api-jira-routeactions:2023.4.0
       
    vera.jira.jobservice:
       image: veraserver20190209075900.azurecr.io/tricentis/vera-worker-jobservice:2023.4.0
       
    vera.worker.audithistory:
       image: veraserver20190209075900.azurecr.io/tricentis/vera-worker-audithistory:2023.4.0

    vera.api.audithistory:
       image: veraserver20190209075900.azurecr.io/tricentis/vera-api-audithistory:2023.4.0
  5. Execute the following commands:

    • docker login Veraserver20190209075900.azurecr.io -u fc12bdd5-6753-40b3-a4da-32bc5d451b39 -p bhfV1g0RhN1O~xS-R-Osv67~HO.zeKMbHp

    • docker-compose pull

Restart Vera with the updated software

Caution: These steps will result in a temporary outage of the Vera software lasting several minutes. Therefore, we recommend scheduling an outage window before executing these steps.

To restart Vera with the updated software, follow these steps:

  1. Open an Administrative PowerShell prompt.

  2. Navigate to the Vera Docker Compose directory that was configured during installation. This is the directory that contains the docker-compose.yml file.

  3. Execute the following commands:

    • docker-compose down

    • docker-compose up -d