Upgrade Instructions

From GeeklogWiki
Jump to: navigation, search

Upgrading is no different than a fresh installation except your database already exists and needs to be upgraded.

  1. Back up any files with custom code in them and back up your database.


    Please pay special attention to the older config.php and lib-common.php files, as these files contain database and path information you entered the last time you installed Geeklog and this information MUST be copied over to the NEW config.php and lib-common.php files.

  2. You can choose to either rename or remove your current Geeklog directory. Although in the end you will be deleting the older install it's probably safer to keep the old copy around for a few days *just* in-case you forgot to transfer some files.
  3. Uncompress the new version and copy the result to the same path that your old installation had. 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. As with a fresh install, edit your config.php and lib-common.php, basically just copying over the information from your old copies of these files.
  5. 'If' you are upgrading from Geeklog 1.2 or earlier, change to /path/to/geeklog/sql/updates and apply all needed database updates. For example, if you are upgrading from Geeklog 1.1, you will need to apply 1.1_to_1.2.sql and 1.2_to_1.2.2.sql which will upgrade your database to Geeklog 1.2.5-1. I say 1.2.5-1 because there were no database changes from 1.2.2 to 1.2.5-1 (e.g. a 1.2.2 database is the same as a 1.2.5-1 database). If you are uncomfortable using the MySQL command line to do this, you can do it via phpMyAdmin as well. If you are upgrading from Geeklog 1.3 or later, you can skip this step.
  6. Open your browser and navigate to http://yourgeeklogsite/admin/install/install.php. Enter your path to Geeklog and make sure you select Upgrade Database as the installation type, before you click on the "Next" button. The second step of the installation script should have an option to convert your database to the current version. Please note that only "basic" version numbers are listed, because, for example, Geeklog 1.3.7 and 1.3.7sr2 use the same database. So if you're upgrading from Geeklog 1.3.7sr2, just select "1.3.7" (the same applies to 1.3.5 / 1.3.5sr1 / 1.3.5sr2 and all the various 1.3.8 versions).
  7. Once you see the success message, your upgrade is complete. You can now delete the admin/install directory (and all files within it).
Personal tools