Historical reference
This page describes a legacy upgrade path that pre-dates XOOPS 2.7.0. It is preserved for users who are still on a very old version and need to step through intermediate releases. For upgrading any 2.5.x site to XOOPS 2.7.0, see Chapter 9 instead.
(using the full package)
-
Unpack the archive to your LOCAL computer (e.g. PC) in a temporary directory.
-
Move the "upgrade" folder inside the "htdocs" folder (it's been kept out as it's not needed for full installs) on your local computer
-
Delete htdocs/mainfile.php, htdocs/install/, htdocs/cache/, htdocs/template_c/, htdocs/themes/, htdocs/uploads/, and htdocs/modules/system from the "htdocs" folder on your LOCAL computer - if you have created XOOPS_TRUST_PATH folder on your server, copy the content of /xoops_lib to that directory, and delete /xoops_lib from the "htdocs" folder on your LOCAL computer
-
Upload the content of the /htdocs folder on your LOCAL computer over your existing files on your server
-
For security considerations, you are encouraged to move directories xoops_lib (for XOOPS libraries) and xoops_data (for XOOPS data) out of Document Root, and change the folder names.
-
Make the directory of xoops_data/ writable; Create and make the directories of xoops_data/caches/, xoops_data/caches/xoops_cache/, xoops_data/caches/smarty_cache/ and xoops_data/caches/smarty_compile/ writable.
-
Ensure the server can write to mainfile.php
-
If you have Protector previously installed, open the "mainfile.php" file , and remove the Pre-check and Post-check lines (if they exist):
include XOOPS_TRUST_PATH.'/modules/protector/include/precheck.inc.php' ;
include XOOPS_TRUST_PATH.'/modules/protector/include/postcheck.inc.php' ;
-
Access /upgrade/ with a browser, and follow the instructions
-
Follow the instructions to update your database
-
Write-protect mainfile.php again (permission 0444 on Linux)
-
Delete the "upgrade" folder from your server
-
Update the "system" module from the modules administration interface, other modules are recommended to update as well