Keeping your Installation Up To Date

Upgrading your existing TangoCMS installation to the current latest version is highly recommended, this is because of possible critical security fixes, bug fixes and feature improvements that are generally made in later versions. Sticking with an older version could open your self up to security risks.

Following this guide will upgrade your installation to the latest version of TangoCMS, stable 2.5.0 or unstable/development 2.5.50. There are 2 methods that can be used, depending on how you originally got TangoCMS:

Method 1:

Upload and overwrite the files from the latest archives. Users who downloaded the archives initially should use this method.

Method 2 (SVN Users)

If you originally checked out the SVN repository, you can simply switch to the new repository.

Method 1

You will first need to download the latest release and extract it to a directory of your choice. Once done you will need to upload all of the files (see warning below) to your web server (or move them, which ever you need to do), making sure you overwrite all of the files.

Warning: Do NOT upload the 'config' directory, as that will result in you loosing your configuration details!

A common way to do this is via an FTP application, such as FileZilla, however, using FileZilla and uploading the files via FTP is not within the scope of this manual page.

Method 2 (SVN Users)

Users of SVN can easily upgrade their code base to the latest version by using a simple 'svn switch' command within their working copy, an example is shown below:

chmod 0755 install
svn up
svn switch svn://tangocms.org/tangocms/tags/2.5.0/final
svn up

Using the Upgrader

After you have successfully upgraded all of the files, you will then need to run the Upgrader to do some (possible) database changes. Due to the changes that may be made to your database, we highly suggest you backup your database before continuing - if you don't backup and something goes wrong, we can't help you.

To run the upgrader, simple go to http://example.com/install/ and select 'Upgrade TangoCMS'. From here you can then follow the 5 simple stages of the Upgrader.

Once complete, your TangoCMS installation will be fully upgraded and you can now either:

• Delete the 'install' directory.
• Alter the permissions (e.g, via 'chmod') of the 'install' directory so the webserver can not read it.

Your TangoCMS installation is now upgraded to the latest and greatest version.