Atlas: Checklist for Upgrading Atlas Versions

Looking to upgrade to a new Atlas version? We keep the latest versions in our Ethyca Atlas docker repository with supplementary release notes. To ensure a smooth upgrade, we recommend following the steps below:

Step 1: Drain requests in the processing queue

If there are any requests in Processing, they will get "stuck" in this state and not complete. Therefore, You will want to make sure your Processing queue is down to 0 during deployment

Alert your internal team who manages requests to pause on approvals until this is complete

If you have automated approvals turned on - you will want to turn off automated approvals, so no new requests come in during the deployment process

Step 2: Deploy to the latest version to QA

Use the following command to pull down the latest image from the public Ethyca Atlas docker repository:

docker pull ethyca/atlas:latest

When using the latest tag above, this will pull down the most recent Ethyca released version available in Docker hub. If you are looking for an specific version, replace "latest" with an explicit version number, ie:

docker pull ethyca/atlas:1.5.8

Step 3: Run a round trip test for a Download Your Data (SAR) in QA

Follow our instructions for testing a Download Your Data request. Pro tip: you will want to make sure you have a handful of test user in your database to pull back data from and verify testing results.

Step 4: Run a round trip test for an Delete Your Data request in QA

Follow our instructions for testing an Delete Your Data request on the same test user. Pro tip: you will not want to kick off an erasure until you have validated the Download Your Data request.

Step 5: Deploy to the latest version to Production

If everything looks good, you can deploy the latest version to Production using the same command above.

Step 6: Run a round trip test for a Subject Access Request in Production

Step 7: Run a round trip test for an Erasure request in Production

Once testing is complete and both environments have been validated, you can resume normal operations and let the relevant stakeholders know to proceed with approving DSRs!

Support

Please contact [email protected] or your dedicated Customer Success Manager if you require any technical assistance.