{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"codeGuideFiles":[],"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Catena Upgrade Procedure","description":"Catena Tools - Your game backend tool kit. Built by game developers, for game developers to simplify your game's backend workflow."},"dynamicMarkdocComponents":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"catena-upgrade-procedure"},"children":["Catena Upgrade Procedure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the event a new version of Catena is released and needs to be patched or upgraded, the following steps can be followed:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"1.-follow-instructions-to"},"children":["1. Follow instructions to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/installation/aws-backup-management"},"children":["manually backup Catena data"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"2.-destroy-the-existing-catena-infrastructure"},"children":["2. Destroy the existing Catena infrastructure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["infrastructure"]}," repo, under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aws/catena-core-tools"]},", issue the command:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"terraform destory -var-file=\"vars.tfvars\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"3.-re-deploy-the-catena-infrastructure-following-the-same-deployment-steps-as"},"children":["3. Re-deploy the Catena infrastructure following the same deployment steps as ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/installation/aws-ec2#3.-deploy-catena"},"children":["initial setup"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"4.-follow-instructions-to-from-the-previous-catena-installation"},"children":["4. Follow instructions to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/installation/aws-backup-management"},"children":["restore the Catena database backups"]}," from the previous Catena installation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any needed database migrations required by the new Catena installation will be automatically applied at runtime"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"note-about-ec2-host-os-upgrades"},"children":["Note about EC2 host OS upgrades:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The EC2 host OS should be kept up-to-date through the standard ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://ubuntu.com/aws/docs/aws-how-to/instances/automatically-update-ubuntu-instances/"},"children":["AWS System Manager (SSM) automatic update best practices and procedures"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"note-about-downtime"},"children":["Note about downtime:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a typical upgrade procedure, it's recommended to plan a maintenance window of about two hours"]}]},"headings":[{"value":"Catena Upgrade Procedure","id":"catena-upgrade-procedure","depth":1},{"value":"1. Follow instructions to","id":"1.-follow-instructions-to","depth":4},{"value":"2. Destroy the existing Catena infrastructure","id":"2.-destroy-the-existing-catena-infrastructure","depth":4},{"value":"3. Re-deploy the Catena infrastructure following the same deployment steps as","id":"3.-re-deploy-the-catena-infrastructure-following-the-same-deployment-steps-as","depth":4},{"value":"4. Follow instructions to from the previous Catena installation","id":"4.-follow-instructions-to-from-the-previous-catena-installation","depth":4},{"value":"Note about EC2 host OS upgrades:","id":"note-about-ec2-host-os-upgrades","depth":4},{"value":"Note about downtime:","id":"note-about-downtime","depth":4}],"frontmatter":{"markdown":{"toc":{"depth":3}},"seo":{"title":"Catena Upgrade Procedure"}},"lastModified":"2026-08-05T17:41:35.000Z"},"slug":"/installation/upgrade-procedure","userData":{"isAuthenticated":false,"teams":["anonymous"]}}