Upgrade Instructions

From GeeklogWiki
Jump to: navigation, search

Upgrading is no different than a New Installation except your database already exists and needs to be updated.

Take extreme care to back up any files from your current Geeklog installation that have any custom code in them, especially lib-custom.php (where all custom code should reside). Be sure to back up any modified themes, images, and static pages from your current installation.

Also, please be sure to back up your database. We can't stress the importance of backing up your files and database enough.

YOU HAVE BEEN WARNED.

1. Download the current version of Geeklog from Geeklog.net.
2. Unpack the downloaded tarball file by running:
tar -zxvf geeklog-2.0.0.tar.gz
Note: Some users have reported that WinZip corrupts certain Geeklog files during decompression. This will cause errors during the installation process. You are strongly urged not to use WinZip. Try 7-Zip or WinRAR if you must decompress the file locally.
3. Place the contents of geeklog-2.0.0/ into the same directory your old installation was located. For instance, if your old Geeklog was in /usr/home/www/geeklog/, then your new installation should also be in /usr/home/www/geeklog/.
4. Depending on the version you're upgrading from:
  • When upgrading from Geeklog 1.4.1 or earlier: Put the config.php files from your old install back into their place now (the main config.php and those for the plugins). The install script will read these files during the upgrade to pre-populate the new Configuration admin panel with your settings. If you skip this step, you will end up with default settings for Geeklog and the pre-installed plugins.
  • When upgrading from Geeklog 1.5.0 or later: Put the db-config.php and siteconfig.php from your old install back into their place now, overwriting the files of the same name that came in the tarball. Otherwise, you would have to enter your database credentials and other information during the upgrade process again.
5. Open your browser and navigate to the Geeklog installation wizard file admin/install/index.php on your web server. The path to this file will depend on where you chose to put the Geeklog files on your web server. The default location is:
http://[your_geeklog_site]/admin/install/index.php
6. The Geeklog installation wizard was designed to automate the upgrade process. Simply follow the installation steps.

Once you have completed the upgrade be sure to delete the admin/install directory.