Community  »  Applications  »  Nag

Upgrading Nag

Contact: nag@lists.horde.org

1   General instructions

These are instructions to upgrade from earlier Nag versions. Please backup your existing data before running any of the steps described below. You can't use the updated data with your old Nag version anymore.

Upgrading Nag is as easy as running:

pear upgrade -a -B horde/nag

If you want to upgrade Nag with all binary dependencies, you need to remove the -B flag. Please note that this might also try to install PHP extensions through PECL that might need further configuration or activation in your PHP configuration:

pear upgrade -a horde/nag

If you want to upgrade to an alpha or beta version of Nag, you need to tell the PEAR installer to prefer non-stable package versions. Please note that this might also install pre-release 3rd-party PEAR packages:

pear -d preferred_state=alpha upgrade -a horde/nag

If you want to upgrade from a Nag version prior to 3.0, please follow the instructions in INSTALL to install the most recent Nag version using the PEAR installer.

After updating to a newer Nag version, you always need to update configurations and database schemes. Log in as an administrator, go to Administration => Configuration and update anything that's highlighted as outdated.

2   Upgrading Nag from 2.2.x to 2.3.x

Some fields in the SQL share driver tables have been changed. Execute the provided SQL script to update your database if you are using the native SQL share driver.

mysql --user=root --password=<MySQL-root-password> <db name> < scripts/upgrades/2.2_to_2.3.sql

3   Upgrading Nag from 2.1.x to 2.2.x

3.1   SQL Backends

A few new fields have been added to the default SQL table layout.

Execute the provided SQL script to update your data to the new Nag version, e.g.:

mysql --user=root --password=<MySQL-root-password> <db name> < scripts/upgrades/2.1_to_2.2.sql

You also have to execute the provided PHP script:

php scripts/upgrades/2006-04-18_add_creator_and_assignee_fields.php

3.2   New Beta SQL Share Driver Support

A new beta-level SQL Horde_Share driver has been added in Horde 3.2. This driver offers significant performance improvements over the existing Datatree driver, but it has not received the same level of testing, thus the beta designation. In order to make use of this driver, you must be using Horde 3.2-RC3 or later. The new tables needed for this driver already should have been created by the step above.

If you want to use the new SQL Share driver, you must also execute the provided PHP script to migrate your existing share data to the new format:

nag-convert-datatree-shares-to-sql