Upgrading KBPublisher

To upgrade KBPublisher use the installation wizard.

Before you start
Please note that upgrading via the wizard is possible only for version 2.0 and above. If you are currently using an older version of KBPublisher upgrade to version 2.0 first.

Option 1 (retain current installation until you have tested the upgrade)

1. Make a copy of your previous KBPublisher installation database. This database will be modified during the upgrade.


2. Unpack the distribution package to a directory with a different name to your current knowledgebase directory, for example to "kb_new".  This ensures that the previous installation is not overwritten.


3. Open your browser and go to http://<your_domain>/<kb_installation_path>/setup/index.php, where <your_domain> is your domain name, and <kb_installation_path> is the path where KBPublisher is installed that you created in step 2. e.g. http://mydomainname.com/kb_new/setup/index.php. The installation wizard comes up.


4. Follow the installation wizard instructions.


5. After testing the new installation, rename your current (old) KBPublisher installation directory to something appropriate, for example to "kb_old".


6. Rename new KBPublisher installation directory to your previous installtion directory name.


7. Update configuration file <kb_installation_path>/admin/config.inc.php by setting new values for $conf['admin_home_dir'] and $conf['client_home_dir'].

Note that this option creates a new database. If you wish to continue to use the original database, then once you have tested that everything is working, backup the old database, rename the new one and change the database name in config.inc.php to match the name of the original.

Option 2 (upgrade directly into the current knowledgebase)

1. Rename your current KBPublisher installation directory. For example to "kb_old".


2. Backup your database.


3. Unpack the distribution package to directory where the previous version of KBPublisher was installed.


4. Open your browser and go to http://<your_domain>/<kb_installation_path>/setup/index.php, where <your_domain> is your domain name, and <kb_installation_path> is the path where KBPublisher is installed. e.g. http://mydomainname.com/kb/setup/index.php. The installation wizard comes up.


5. Follow the installation wizard instructions.

Notes:

• The original installation will already have kb_file and kb_upload directories. Check where these are, and during the upgrade make sure that your kb_file and kb_upload directory paths are the same as for original installation
• Here is a recommended directory structure for KBPublisher
  
  
  
  kb_file - is for uploads via 'Files' module
  kb_cache - is for cache files
  kb_upload - is for uploads via the HTML editor
  
  kb_file, kb_cache and kb_upload directories must be writeable by PHP.
  On a Windows system this generally is not a problem, but on Linux systems you will need to CHMOD these directories to 0777.