Page Comparison

If you are upgrading from 2023.1, please follow these steps to ensure your upgrade is successful.

1. Upgrade MongoDB, if needed. See the “MongoDB Compatibility Update” section below.

2. Add the following containers to the docker-compose.yml (or similar) file. A sample file is located here: Vera Deployment with Docker

   1. vera.server: replace the tx3/vera-server image with the tricentis/vera-server-legacy image

   2. rabbitmq

   3. vera.api.audithistory

   4. vera.api.connections.testconnection

   5. vera.api.jira.routeactions

   6. vera.api.qtest.routeactions

   7. vera.api.routes.routeevents

   8. vera.worker.audithistory

   9. vera.worker.jobservice

   10. vera.worker.jira

   11. vera.worker.qtest

3. Set the image tags to the highest patch available for 2024.1. See here for more information on setting the image tags: Upgrade the Vera Server Applications

4. Update the vera.api.audithistory service in the docker-compose file with the JWT information. Following environment variables needs to be copied from the vera.server service.

   1. VERA_SERVER_JWT_CERT_NAME

   2. VERA_SERVER_JWT_CERT_PASSWORD

Values of these variables need to be exactly same as in the vera.server service.

5. Set the client secret for the vera.web.portal container. See here for more information on setting the client secret: https://tx3.atlassian.net/wiki/spaces/V20241/pages/546118588/Vera+Deployment+with+Docker#Configure-Docker-Orchestration-(Docker-Compose)

6. Vera will create the following databases and collections. Ensure the MongoDB user has the appropriate permissions to create the collections, or create them manually if needed:

   1. New Database: vera-worker-qtest

      1. Collection: webhook.subscriptions

   2. New Database: vera-api-gateway

      1. Collection: endpoints

   3. New Database: vera-audithistory

      1. Collection: audit-entries

   4. New Database: tx3-vera-connections:

      1. Collection: connections

   5. New Database: tx3-vera-webhooks

      1. Collection: webhook-callbacks

   6. New Database: vera-qtest-routeactions-sagas

      1. Collection: job-attempts

      2. Collection: job-types

      3. Collection: jobs

   7. New Database: tx3-vera-jira

      1. Collection: webhook-calls

   8. New Database: vera-worker-jobservice-sagas

      1. Collection: job-attempts

      2. Collection: job-types

      3. Collection: jobs

7. Pull the images.

8. Restart the containers.

If you are upgrading from 2023.2, please follow these steps to ensure your upgrade is successful.

1. Add the following containers to the docker-compose.yml (or similar) file. A sample file is located here: Vera Deployment with Docker

   1. vera.api.audithistory

   2. vera.api.jira.routeactions

   3. vera.worker.audithistory

   4. vera.worker.jobservice

   5. vera.worker.jira

2. Set the image tags to the highest patch available for 2024.1. See here for more information on setting the image tags: Upgrade the Vera Server Applications

3. Update the vera.api.audithistory service in the docker-compose file with the JWT information. Following environment variables needs to be copied from the vera.server service.

   1. VERA_SERVER_JWT_CERT_NAME

   2. VERA_SERVER_JWT_CERT_PASSWORD

Values of these variables need to be exactly same as in the vera.server service.

4. Set the client secret for the vera.web.portal container. See here for more information on setting the client secret: https://tx3.atlassian.net/wiki/spaces/V20241/pages/546118588/Vera+Deployment+with+Docker#Configure-Docker-Orchestration-(Docker-Compose)

5. Vera will create the following databases and collections. Ensure the MongoDB user has the appropriate permissions to create the collections, or create them manually if needed:

   1. New Database: vera-worker-qtest

      1. Collection: webhook.subscriptions

   2. New Database: vera-api-gateway

      1. Collection: endpoints

   3. New Database: vera-audithistory

      1. Collection: audit-entries

   4. New Database: tx3-vera-jira

      1. Collection: webhook-calls

6. Pull the images.

7. Restart the containers.

If you are upgrading from 2023.3, please follow these steps to ensure your upgrade is successful.

1. Add the following containers to the docker-compose.yml (or similar) file. A sample file is located here: Vera Deployment with Docker

   1. vera.api.audithistory

   2. vera.worker.audithistory

2. Set the image tags to the highest patch available for 2024.1. See here for more information on setting the image tags: Upgrade the Vera Server Applications

3. Update the vera.api.audithistory service in the docker-compose file with the JWT information. Following environment variables needs to be copied from the vera.server service.

   1. VERA_SERVER_JWT_CERT_NAME

   2. VERA_SERVER_JWT_CERT_PASSWORD

Values of these variables need to be exactly same as in the vera.server service.

4. Set the client secret for the vera.web.portal container. See here for more information on setting the client secret: https://tx3.atlassian.net/wiki/spaces/V20241/pages/546118588/Vera+Deployment+with+Docker#Configure-Docker-Orchestration-(Docker-Compose)

5. Vera will create the following databases and collections. Ensure the MongoDB user has the appropriate permissions to create the collections, or create them manually if needed:

   1. New Database: vera-worker-qtest

      1. Collection: webhook.subscriptions

   2. New Database: vera-api-gateway

      1. Collection: endpoints

   3. New Database: vera-audithistory

      1. Collection: audit-entries

6. Pull the images.

7. Restart the containers.

If you are upgrading from 2023.3, please follow these steps to ensure your upgrade is successful.

1. Set the image tags to the highest patch available for 2024.1. See here for more information on setting the image tags: Upgrade the Vera Server Applications

2. Update the vera.api.audithistory service in the docker-compose file with the JWT information. Following environment variables needs to be copied from the vera.server service.

   1. VERA_SERVER_JWT_CERT_NAME

   2. VERA_SERVER_JWT_CERT_PASSWORD

Values of these variables need to be exactly same as in the vera.server service.

3. Set the client secret for the vera.web.portal container. See here for more information on setting the client secret: https://tx3.atlassian.net/wiki/spaces/V20241/pages/546118588/Vera+Deployment+with+Docker#Configure-Docker-Orchestration-(Docker-Compose)

4. Vera will create the following databases and collections. Ensure the MongoDB user has the appropriate permissions to create the collections, or create them manually if needed:

   1. New Database: vera-worker-qtest

      1. Collection: webhook.subscriptions

5. Pull the images.

6. Restart the containers.