Upgrade to 2025.2
Note: For upgrades from versions prior to 2023.1, you must follow a three-step upgrade process. You need to upgrade to 2023.1 first, then upgrade to the latest 2025.1 patch version, and finally upgrade to this version. Not following these two steps prevents the proper import of the connections from the Synchronization Policy and the one time necessary Vera record status repair on startup.
Enable workflows microservices
As part of the technical preview, Vera now has two new microservices which allow for customizing workflows for qTest Requirements. Follow these steps to enable the new containers:
-
Open the docker-compose.yml file on the server.
-
Add the following containers:
-
vera.api.workflows
-
vera.worker.workflows
-
-
Update the logging-settings.json file with the following:
Copy"API Workflows": {
"MinimumLevel": {
"Default": "Information",
"Override": {
"Microsoft": "Warning",
"System": "Error"
}
},
"WriteTo": [
{
"Name": "File",
"Args": {
"path": "%VERA_SERVER_DATA_DIR%/Logs/vera-server-api-workflows-.txt",
"outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message}{NewLine}",
"rollingInterval": "Day",
"rollOnFileSizeLimit": true,
"hooks": "Vera.Logging.SerilogHooks::ArchiveHooks, Vera.Logging"
}
}
}
]
},
"Worker Workflows": {
"MinimumLevel": {
"Default": "Information",
"Override": {
"Microsoft": "Warning",
"System": "Error"
}
},
"WriteTo": [
{
"Name": "File",
"Args": {
"path": "%VERA_SERVER_DATA_DIR%/Logs/vera-server-worker-workflows-.txt",
"outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message}{NewLine}",
"rollingInterval": "Day",
"rollOnFileSizeLimit": true,
"hooks": "Vera.Logging.SerilogHooks::ArchiveHooks, Vera.Logging"
}
}
}
]
}, -
Make sure that the MongoDB user has the correct permissions to create collections so that Vera can create these databases and collections:
| New database | Collection |
|---|---|
| vera-workflows |
|
Additional upgrade tasks
To ensure a smooth upgrade, follow the steps for your current Vera version.
Upgrade from 2025.1
When upgrading from 2025.1, you don't need to follow any extra steps.
Upgrade from 2024.3
If you are upgrading from 2024.3, follow these steps to ensure your upgrade is successful
-
Add the following containers to the docker-compose.yml file. For more information on setting the image tags, see Upgrade the Vera Server Applications.
-
vera.api.domains
-
vera.worker.domains
-
vera.api.verification
-
vera.worker.verification
-
-
Add the following logging settings definitions to the logging-settings.json file:
-
API Domains
-
Worker Domains
-
API Verification
-
Worker Verification
-
Upgrade from 2024.2
If you are upgrading from 2024.2, follow these steps to ensure your upgrade is successful
-
Add the following containers to the docker-compose.yml file. For more information on setting the image tags, see Upgrade the Vera Server Applications.
-
vera.api.domains
-
vera.worker.domains
-
vera.api.verification
-
vera.worker.verification
-
-
Add the following logging settings definitions to the logging-settings.json file:
-
API Domains
-
Worker Domains
-
API Verification
-
Worker Verification
-
Upgrade from 2024.1
If you are upgrading from 2024.1, follow these steps to ensure your upgrade is successful:
-
Add the following containers to the docker-compose.yml file. For more information on setting the image tags, see Upgrade the Vera Server Applications.
-
vera.api.documents
-
vera.worker.documents
-
vera.worker.carbone
-
vera.query.engine
-
vera.api.qtest
-
vera.api.traceability
-
vera.worker.traceability
-
-
Remove the following container from the docker-compose.yml file.
-
vera.api.qtest.routeactions
-
-
Add the following environment variable to the vera.worker.qtest container in the docker-compose.yml file. Be sure to replace the your.vera.url with your actual Vera FQDN and port, if needed.
-
Vera.Worker.QTest.WebhookUrl=http://your.vera.url/api/qtest/webhook
-
-
Add the following logging settings definitions to the logging-settings.json file.
-
API Documents
-
Worker Documents
-
API qTest
-
API Traceability
-
Worker Traceability
-
-
Ensure the database user has the correct permissions to create the following databases and collections (or manually create them as needed):
New database Collection vera-documents -
document-definitions
-
document-template-revisions
-
document-templates
-
document-types
vera-documents-templates-messagedata -
fs.chunks
-
fs.files
vera-documents-template-files -
fs.chunks
-
fs.files
vera-qtest -
fs.chunks
-
fs.files
-
qtest-active-linkage-detections
-
qtest-record-imports
-
qtest-record-link-syncs
-
qtest-record-syncs
-
qtest-release-syncs
-
webhook-subscriptions
vera-traceability -
project-releases
-
vera-record-links
-
vera-releases
-
-
Add the Jira-qTest Requirement record type to your Records Management Policies that will use the traceability feature from qTest.
-
Set the image tags to the highest patch available for 2025.1. For more information on setting the image tags, see Upgrade the Vera Server Applications. Start the Vera containers and allow the startup processes to run one time and then follow the standard steps listed at the top of the page to upgrade to Vera 2025.2.
Upgrade from 2023.4
If you are upgrading from 2023.4, follow these steps to ensure your upgrade is successful:
-
Set the image tags to the highest patch available for 2024.1. For more information on setting the image tags, see Upgrade the Vera Server Applications.
-
Update the vera.api.audithistory service in the docker-compose.yml file with the JWT information.
The following environment variables need to be copied from the vera.server service:
-
VERA_SERVER_JWT_CERT_NAME -
VERA_SERVER_JWT_CERT_PASSWORD
Values of these variables need to be exactly same as in the vera.server service.
-
-
Set the client secret for the vera.web.portal container. For more information on setting the client secret, see Configure Docker Orchestration (Docker Compose).
-
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:
New database Collection vera-worker-qtest webhook.subscriptions -
Configure Web Portal timeout settings.
-
Configure Identity Provider Settings and Login Options.
-
Follow the steps in Upgrade from 2024.1.
Upgrade from 2023.3
If you are upgrading from 2023.3, follow these steps to ensure your upgrade is successful:
-
Add the following containers to the docker-compose.yml (or similar) file. A sample file is located here: Vera Deployment with Docker.
-
vera.api.audithistory
-
vera.worker.audithistory
-
-
Set the image tags to the highest patch available for 2024.1. For more information on setting the image tags, see Upgrade the Vera Server Applications.
-
Update the vera.api.audithistory service in the docker-compose.yml file with the JWT information.
The following environment variables need to be copied from the vera.server service:
-
VERA_SERVER_JWT_CERT_NAME -
VERA_SERVER_JWT_CERT_PASSWORD
Values of these variables need to be exactly same as in the vera.server service.
-
-
Set the client secret for the vera.web.portal container. For more information on setting the client secret, see Configure Docker Orchestration (Docker Compose).
-
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:
New database Collection vera-worker-qtest webhook.subscriptions vera-api-gateway endpoints vera-audithistory audit-entries -
Configure Web Portal timeout settings.
-
Configure Identity Provider Settings and Login Options.
-
Follow the steps in Upgrade from 2024.1.
Upgrade from 2023.2
If you are upgrading from 2023.2, follow these steps to ensure your upgrade is successful:
-
Add the following containers to the docker-compose.yml (or similar) file. A sample file is located here: Vera Deployment with Docker.
-
vera.api.audithistory
-
vera.api.jira.routeactions
-
vera.worker.audithistory
-
vera.worker.jobservice
-
vera.worker.jira
-
-
Set the image tags to the highest patch available for 2024.1. For more information on setting the image tags, see Upgrade the Vera Server Applications.
-
Update the vera.api.audithistory service in the docker-compose.yml file with the JWT information.
The following environment variables need to be copied from the vera.server service:
-
VERA_SERVER_JWT_CERT_NAME -
VERA_SERVER_JWT_CERT_PASSWORD
Values of these variables need to be exactly same as in the vera.server service.
-
-
Set the client secret for the vera.web.portal container. For more information on setting the client secret, see Configure Docker Orchestration (Docker Compose).
-
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:
New database Collection vera-worker-qtest webhook.subscriptions vera-api-gateway endpoints vera-audithistory audit-entries tx3-vera-jira webhook-calls -
Configure Web Portal timeout settings.
-
Configure Identity Provider Settings and Login Options.
-
Follow the steps in Upgrade from 2024.1.
Upgrade from 2023.1
If you are upgrading from 2023.1, follow these steps to ensure your upgrade is successful:
-
Upgrade MongoDB, if needed.
-
Add the following containers to the docker-compose.yml (or similar) file. A sample file is located here: Vera Deployment with Docker
-
vera.server: replace the tx3/vera-server image with the tricentis/vera-server-legacy image
-
rabbitmq
-
vera.api.audithistory
-
vera.api.connections.testconnection
-
vera.api.jira.routeactions
-
vera.api.qtest.routeactions
-
vera.api.routes.routeevents
-
vera.worker.audithistory
-
vera.worker.jobservice
-
vera.worker.jira
-
vera.worker.qtest
-
-
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.
-
Update the vera.api.audithistory service in the docker-compose.yml file with the JWT information.
The following environment variables need to be copied from the vera.server service:
-
VERA_SERVER_JWT_CERT_NAME -
VERA_SERVER_JWT_CERT_PASSWORD
Values of these variables need to be exactly same as in the vera.server service.
-
-
Set the client secret for the vera.web.portal container. For more information on setting the client secret, see Configure Docker Orchestration (Docker Compose).
-
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:
New database Collection vera-worker-qtest webhook.subscriptions vera-api-gateway endpoints vera-audithistory audit-entries tx3-vera-connections connections tx3-vera-webhooks webhook-callbacks vera-qtest-routeactions-sagas job-attempts
job-types
jobs
tx3-vera-jira webhook-calls vera-worker-jobservice-sagas job-attempts
job-types
jobs
-
Configure Web Portal timeout settings.
-
Configure Identity Provider Settings and Login Options.
-
Follow the steps in Upgrade from 2024.1.
Upgrade from a version prior to 2023.1
If you are upgrading from any version prior to 2023.1, please follow these steps for a successful upgrade:
-
Upgrade MongoDB according to the “MongoDB compatibility update” table.
-
Follow the steps to upgrade to 2022.3, if needed: Vera 2022.3 Upgrade Tasks
-
Perform the upgrade to 2023.1:
-
Set the docker container tags to the latest patch for 2023.1: Vera 2023.1
-
Pull the images.
-
Restart the docker containers.
-
-
Once the server has successfully started up, follow these steps to upgrade to 2023.1.
MongoDB compatibility update
Vera now requires a minimum MongoDB version of 6.0. Please ensure your MongoDB is updated prior to upgrading Vera to the latest version.