# --
# UPGRADING - upgrading OTRS
# Copyright (C) 2001-2006 OTRS GmbH, http://otrs.org/
# --
# $Id: UPGRADING,v 1.23 2007/04/02 15:36:53 martin Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY. For details, see
# the enclosed file COPYING for license information (GPL). If you
# did not receive this file, see http://www.gnu.org/licenses/gpl.txt.
# --

These instructions are for people upgrading OTRS from "2.1" to "2.2".

*) Stop all your services (e. g. rcotrs stop-force)

*) Backup everything (database, Kernel/Config.pm, Kernel/Config/GenericAgent.pm, var/*)
   (Remember: 5% of all config settings are renamed in OTRS 2.1, so may some of the
   Kernel/Config.pm settings will not be compatible)

*) Make sure that you have backed up everything ,-)

*) If possible try this install on a separate machine, althoug
   I had always only production machines to upgrade

*) Install the new release (tar or RPM)

*) If you use the tar:

    a) the OTRS themes between 2.1 and 2.2 are _not_ compatible
       (don't use the old themes)!

*) Update the database changes with:
    MySQL:
      cat $OTRS_HOME/scripts/DBUpdate-to-2.2.mysql.sql | mysql -p -f -u root otrs
    PostgreSQL:
      cat $OTRS_HOME/scripts/DBUpdate-to-2.2.postgresql.sql | psql otrs

   (Don't worry about the error messages, you can update all previous version
   with this script and in the most cases your database has already the most changes!)

*) If _no_ RPM is used, execute $OTRS_HOME/bin/SetPermissions.sh!

*) Restart your services (e. g. rcotrs restart-force or each service manually)

*) Log in as 'root@localhost' and select Admin -> SysConfig to make sure that
   OTRS updates the configuration files.
