=================
 Upgrading Mnemo
=================

:Contact: horde@lists.horde.org

.. contents:: Contents
.. section-numbering::


General instructions
====================

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

Upgrading Mnemo is as easy as running::

   pear upgrade -a -B horde/mnemo

If you want to upgrade Mnemo 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/mnemo

If you want to upgrade to an alpha or beta version of Mnemo, 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/mnemo

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

After updating to a newer Mnemo 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 Mnemo from 2.2.1 to 2.2.2
===================================

The group_uid field in the SQL share driver groups table has been changed from
an INT to a VARCHAR(255). 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.1_to_2.2.2.sql


Upgrading Mnemo from 2.2 to 2.2.1
=================================

The share_owner field in the SQL share driver table has been changed from a
VARCHAR(32) to a VARCHAR(255). 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.2.1.sql


Upgrading Mnemo from 2.x to 2.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. To create the new tables needed for this driver, execute the provided SQL
script::

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

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::

   mnemo-convert-datatree-shares-to-sql


.. _INSTALL: INSTALL
