Upgrade Steps Template

This is an initial template you can use for your upgrade steps.

Upgrade steps template

1. Put up your maintenance page on your current environment.
2. Stop the application.
3. Stop all background jobs, cron jobs, etc. that update data.
4. Ensure that there are no longer any connections to the database.
5. Dump and compress the database.
6. scp it to your database instance.
7. rsync any assets over to your new instance(s).
8. Load your the DB dump into the database.
9. Test the new setup on Engine Yard Cloud (this is the final step before sending your users over to the new setup).
10. Update DNS to point to your Engine Yard Cloud IP.
11. Update your Nginx config to redirect any traffic hitting your old IP to the new IP.

Before you start your upgrade, we recommend that you walk through the above steps, modify them as needed for your particular environment and add/remove steps as needed. For a running production environment, you can just document and simulate steps 1–4 and 10–11 and walk through the remaining steps.

Tip: Listing out or scripting any commands needed for each step can save time and prevent human errors.

If you have feedback or questions about this page, add a comment below. If you need help, submit a ticket with Engine Yard Support.