The steps below are based on information from Bob's Guides and some of it is straight repetition (hope you don't mind, Bob). The differences are specific to my setup (an Ubuntu based web-server) which I access via the command line using Putty (I don't have cPanel). I also don't go into as much detail as Bob, so I urge you to check out his FAQ also.
- Clear the site cache and the error log (under the Reports menu).
- Log out of the Manager after ensuring no-one else is logged in. This is very important.
- Back up your site (Bob goes into more detail).
- Download the current stable version of MODX Revolution from the Modx site to your local machine.
- Extract all files in the archive.
- Navigate into the directory that was just created — you should see the assets, core, manager, and setup directories. Select all files and directories and create a new archive using your own unique name (e.g., MyModx2.1.11.zip)
- On the web-server, delete all files in the core/cache directory:
cd core/cache sudo rm -rf *
- Go up two levels to the MODX root directory — you should see the assets, core, and manager directories.
- Upload the .zip file you created from your local machine (e.g., MyModx2.1.11.zip)
- Rename index.php to index.php.bak. The site will be down from this point on.
- Extract the files in the .zip file. This will overwrite existing Modx core system files (it won't touch any files or directories you created as part of the site):
unzip -o MyModx2.1.11.zip rm MyModx2.1.11.zip
- Make the file config.inc.php writable:
cd core/config chmod 775 config.inc.php
- Open a new browser window and go to http://yoursite.com/setup
- Follow the prompts (make sure that the Upgrade Install check-box is checked — if not, don't proceed!) At the end of the upgrade you should get a success message.
- Make config.inc.php read only again:
chmod 644 config.inc.php
- Manually delete the setup directory (the installer/ upgrader does not do this automatically on Ubuntu):
cd ../.. sudo rm -rf setup
- Once Setup is finished, the site should be back up and using the new version. Log in to test.