update-craft-installation.md

Safely updating a Craft installation

1. Download correct version

• Put in ~/tmp/ folder and don't forget to erase afterwards
• Download URL: http://download.buildwithcraft.com/craft/{version}/{version}.{build}/Craft-{version}.{build}.zip
• Download wget DOWNLOAD_URL and unzip

2. Backup database

• Craft usually backsup the database on update but I've found that if you have a large database, this can cause the update script to timeout.
• Craft should be set to 'backupDbOnUpdate' => false
• This means that you'll be responsible for updating previous to updating

create database [databasename];
grant all privileges on [databasename] to 'user'@'localhost';
FLUSH PRIVILEGES;

3. (OPTIONAL) Be proactive and create a second database before everything goes to hell

4. Increase your memory_limit

• Check ~/etc/php5/php.ini
• Check ../craft/config/general.php
• Drop a ../public/info.php file just in case

5. To update we will replace the ../craft/app directory for the new one

• Move existing one to app.old
• Copy new one from the tmp directory onto ../craft/

6. Go to the admin panel and go through the update process

7. If everything went well, then you're good to go and you can

• Lower memory limit back to 512M (check performance)
• Erase database backup and secondary databases
• Erase downloaded files
• Celebrate!

8. Otherwise

• Turn on dev mode and find out what's going on
• Worst case scenario restore back to normal removing new app directory and restoring database