Upgrading phpCMS

From phpCMS

[edit] Upgrading phpCMS

These instructions assume that you have an older version of phpCMS running on your server that you do not want to interfere with during upgrade.
(If you want to make a fresh installation instead, please refer to the section "Installation and configuration".)

The instructions are based on an upgrade from version 1.1.x to version 1.2.0 and a standard installation (i.e. the phpCMS parser directory is called /parser).
If your setup is different, you have to adapt the instructions accordingly.

To upgrade your installation follow these steps:

1. Download the latest package from the phpCMS download page.
2. Unpack the archive (phpcms-x.x.x.zip or phpcms-x.x.x.tar.gz) as explained under "Extract the files" on your local computer, maintaining the directory structure of the archive.
3. Rename the directory /parser that you now have on your computer into /parser_new.
4. Upload that complete directory and its contents to your server. There you now have these two directories:
   • /parser (your current phpCMS)
   • /parser_new (the new phpCMS).
5. Your current settings and HTTP-Indexer profiles can be easily transferred to the new parser. To do so, copy the two files default.php and defaults_indexer.php from the directory /parser/include into the new directory /parser_new/include.
6. Copy any plug-ins and scripts you are using from your old directory /parser/plugs into the new directory /parser_new/plugs.
7. Make sure that all new directories and files are given appropriate permissions (to find out more, see the chapter "Set the permissions").
8. Login into the parser graphical interface (GUI) with your old password by calling http://www.mydomain.net/parser_new/parser.php.
9. When you first access "Configuration" from the GUI menu, the file default.php is automatically converted to the format of the upgrade version, and new settings (if there are any) are added. The file defaults_indexer.php is not converted at this point, since its format has not changed. (Two new settings in version 1.2.0 are automatically added when you edit your indexing profiles.)
10. Check all of your settings:
    1. Change all instances of /parser into /parser_new.
    2. Turn off Stealth Mode for now.
11. Read the section "Notes regarding various changes" in the file UPGRADE_README.txt in the root directory of the upgrade package and make changes where necessary.
12. Now you may check to see whether the new parser correctly processes your pages: Call http://www.mydomain.net/parser_new/parser.php?file=/demo/index.htm (or replace /demo/index.htm with any other page name of your website.
13. When you are satisfied with the results of your test, go back to "Configuration" in the GUI, and change all instances of /parser_new back to /parser. If you are using Stealth Mode, turn it back on now.
14. Finally rename your old and the new parser directory:
    • for the old phpCMS: from /parser to /parser_old
    • for the new phpCMS: from /parser_new to /parser

All set and ready to go!