Update Guide (Espanol)

From toendaCMS Wiki

Back to documentation

{{translateme}}

Requirements

Every version of toendaCMS >= 0.5.9 can be updated without great effort. Older version require a fresh install! The general requirements have to be met again:

• round about 15MB of free web-space
• PHP (Version 4 or 5) with GD, mbstring and zlib. Register_Globals should be deactived for security reasons.
• (optional) a SQL-database.

Update in a nutshell

This short version is adressed to experienced users! A more detailed description will be given in the next chapter.

1. download the latest version and unzip it.
2. copy the directories engine/, setup/ and the files in the root directory to the server.
3. check file and directory permissions.
4. call the setup manually using http://yourdomain/pathToCMS/setup/
5. follow the configuration steps
6. delete the setup/ folder after updating

Afterwards the new version is ready to serve.

A step by step description

A backup of all data should be at hand before starting any update! The content of a possibly used database should be dumped, too. Those backups can be used to come back to a previous state if updating did not work the expected way. The described update routines are carefully tested, but there is no guarantee it works the way expected, ie. don't blame us if you didn't do backups and lost all your data.

The following steps should be executed in the described order:

1. download the latest version of toendaCMS from www.toendacms.com and unzip to your system.
2. Delete the following directories from the unzipped archive: cache/, data/, theme/ and tmp/. The remaining directories should be engine/ and setup/ (with there subdirectories) and everything inside the root directory, ie. files like browse.php and index.php for example.
3. The remaining files and directories must be uploaded to your webspace using a tool like ftp. It is very important the new files and directories are used to overwrite the old ones, ie. if your asked to overwrite then acknowledge.
4. After copying the data you've to check all file and directory permissions. They all must be accessible for the process of the webserver. In almost all cases this means read and write access has to be granted for everyone for the following directories: data/, cache/, tmp/ and engine/admin/sessions/. The permissions have to be set for all files and directories within the mentioned ones! Permissions can be set using chmod 0777
5. If you want to edit or remove the preinstalled themes of toendaCMS you have to set permissions in the themes/ directory, too!
6. Now it's time to call the configuration routines with your browser using http://yourdomain/path_to_toendaCMS/setup.
7. On the welcome screen select your favourite language
8. The next page the displayes results of certain tests to your system. You can see if all directory permissions are set correct. All tests except Register_gobals must pass for the system to work properly.
9. Next you've to accept the licence of toendaCMS. You must read, understand and accept this licence to be allowed to use toendaCMS! If you don't want to accept the licence, cancel the update, and reinstall the backup you previously made.
10. You accept the licence? Fine. No it's time to configure the type of storage. At the lower part of the site there are options to update a mySQL, PostgreSQL or XML installation. Be sure to select the correct one, ie. selecting XML if mySQL is installed won't work!
11. Now you've to select the version you want to update from. It's important to select the correct version of the installed toendaCMS-system for the update process to work! If your version is not in the list, it's either too old or an update isn't possible for any other reason. A fresh installation may be needed at that point, if nothing can be found to this topic on http://www.toendacms.com or in the forum.
12. Now your almost done. Leave the update center and be sure to delete the setup/ folder from the webserver to grant users access to you new version of toendaCMS.

Conclusion

If there are any questions regarding updates don't mind to use the forum. If there are remarks, questions, comments, criticism or whatsoever regarding this update guide, don't mind to ask.

The toendaCMS Crew