Migrating from Zentyal 2.0 to 2.2

This page contains a guide to migrating from a working Zentyal 2.0 to 2.2 (latest version). A tool has been developed to automatize the process, so you only need to run it and wait.

Before you start

• Backup! You must take a backup of your system before starting. Migrations are complex processes that can fail at some point.
• Check your Internet connectivity. Migration tool will need a working Internet connection to download new packages and upgrade old ones.
• Upgrade to last package versions. In console:

$ sudo apt-get update
$ sudo apt-get dist-upgrade

Migration tool

• Download the Zentyal 2.0 to 2.2 Migration Tool (TODO link)
• Extract migration tool and run it

tar -xvzf zentyal-migrate-2.0-to-2.2.tar.gz
sudo ./migrate.sh

Migration tool will ask for confirmation before beginning. After that it will follow this steps, it is an automatic process but you can check everything is correct:

• Replace zentyal ppa from your /etc/apt/sources.list
• Get the list for your installed packages
• Save current configuration (redis database)
• Remove 2.0 packages (remove only, not purge)
• Update, upgrade everything and install Zentyal 2.2 packages
• Stop every Zentyal module
• Migration:
  • Copy 2.0 data to 2.2 dir
  • Import previously saved configuration (redis)
  • Upgrade objects schema to new format
  • Upgrade LDAP configuration (if present)
  • Create new core SQL tables
• Purge 2.0 packages
• Start Zentyal 2.2 modules

Known issues

No known issues by now