91 lines
2.8 KiB
Plaintext
91 lines
2.8 KiB
Plaintext
===============
|
|
Upgrading Nag
|
|
===============
|
|
|
|
:Contact: nag@lists.horde.org
|
|
|
|
.. contents:: Contents
|
|
.. section-numbering::
|
|
|
|
|
|
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.
|
|
|
|
|
|
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
|
|
|
|
|
|
Upgrading Nag from 2.1.x to 2.2.x
|
|
=================================
|
|
|
|
|
|
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
|
|
|
|
|
|
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
|
|
|
|
|
|
.. _INSTALL: INSTALL
|