========================
 Upgrading to Turba 2.0
========================

:Last update:   $Date: 2004/11/24 22:15:59 $
:Revision:      $Revision: 1.3 $
:Contact:       turba@lists.horde.org


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

.. Important:: These upgrade instructions assume that you are upgrading from
               at least Turba 1.2.  If you have an older version of Turba,
               follow the 'upgrade steps'_ described in Turba 1.2 or higher
               first.

.. _'upgrade steps': http://cvs.horde.org/annotate.php/turba/docs/Attic/UPDATE?sa=1&rev=1.1.2.6


SQL Backends
============

Four new fields have been added to the default SQL table layout, one being
mandatory.  The new ``object_uid`` field provides a global unique ID to
objects.

Execute the provided SQL script to update your data to the new Turba version::

   mysql --user=root --password=<MySQL-root-password> <db name> < 1.2_to_2.0.mysql.sql


History
=======

The contacts history is now being maintained by the global Horde History
backend.  To create default history entries execute the provided PHP script::

   php scripts/upgrades/2004-10-26_create_default_histories.php
