Simple Upgrade from Engine Yard Gentoo 2009 (stable-v2) to 12.11 (stable-v4)

Notice: This document was originally published in 2012.

This document provides high level processes for a simple environment upgrade from Engine Yard Gentoo 2009 to Engine Yard Gentoo 12.11 (stable-v2 to stable-v4). It supports the recent addition of the latest generation AWS instance types such as AWS M3AWS C3 and AWS C4.

This is a minimally complicated upgrade, and can be applied to Rails and PHP environments. It does not include instructions for custom Chef. For more complex upgrades, see Upgrade from Engine Yard Gentoo 2009 (stable-v2) to 12.11 (stable-v4) with Custom Chef.

Tip: Use the tools and documentation (which are linked-to in the process steps) to save time.

Get started with Engine Yard Gentoo upgrade


  • This article assumes you have an existing Engine Yard Gentoo 2009 (stable-v2) environment.
  • Your application must be able to use the component versions as described in the Engine Yard Gentoo 12.11 Tech Stack.
  • If your app uses database versions less than MySQL 5.5 and PostgreSQL 9.2, you need to upgrade your database as part of the upgrade. Test the database upgrade in your development environment before proceeding with the stack upgrade.
  • You must use 64-bit instances (32-bit instances are not supported on the Engine Yard Gentoo 12.11 (stable-v4) distribution).

Upgrade your environment from Engine Yard Gentoo 2009 (stable-v2) to 12.11 (stable-v4)

To upgrade from stable-v2 to stable-v4

  1. Snapshot your current environment.
  2. Create a copy of your environment.
  3. Select the new instance types, stable-v4 stack and MySQL 5.6 database.
  4. Backup your database by SSHing into your stable-v2 database instance and follow the On-Demand instructions.
  5. From the stable-v2 environment download your database backup.
  6. From the stable-v2 database instance transfer the backup to your v4 database instance and restore.

    Note: When you're logged into the `deploy` account, you do not need to enter the MySQL password so the command will look like gunzip < [filename] | mysql [dbname].

  7. Verify that your application is working as expected.
  8. If you must retain the EIP, swap the IP address from your old to new environment.

    By default, the swap IP tool automatically puts both environments into maintenance mode during the swap; it takes them out of maintenance mode after (unless there is an error).

  9. Perform a sanity test on your new environment with the restored data.


You might have these questions about upgrades.

Do I need to do all this for weekly cookbook / stack upgrades?

No; minor weekly upgrades have the same upgrade process as usual: Click Upgrade on your environment.

What if the database version is not supported in the new stack?

In this case, it is recommended to use a fresh volume when booting the database rather than a snapshot. Another workaround is to uncheck the "lock minor version control" check box in "edit environment".

More information

This table provides other resources related to upgrades.

For more information about... See...
Upgrade intro and overview Upgrade Guide
Single server (solo) environment upgrades Upgrade a Single Server (Solo) Environment
Multiple server environment upgrades Upgrade a Multiple Server Environment
Complex upgrades from v2 to v4 (for example, Chef 0.6 to Chef 10) Upgrade from Engine Yard Gentoo 2009 (stable-v2) to 12.11 (stable-v4) with Custom Chef
Supported AWS instances on Engine Yard Amazon Instance Type Support
Which version of your stack components you need to use with Engine Yard Gentoo 12.11 Engine Yard Gentoo 12.11 Tech Stack

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


Article is closed for comments.