Migrating from Zentyal 2.2 to 3.0

This page contains instructions on how to import some of the configuration from a previously exported 2.2 configuration backup into a freshly installed Zentyal 3.0 server.

Before you start

• If you want to deploy Zentyal 3.0 on a new server, just make sure you don't switch off your working 2.2 server until the 3.0 server is ready. That is, all the configuration has been restored automatically or manually and you have done some tests to make sure everything works as desired.

• If you want to reinstall using the same hardware, we strongly recommend to try this first on a test machine (a VM for example) , installing Zentyal 3.0 and restoring the Zentyal 2.2 configuration backup, if everything works as expected then you can keep the 2.2 backup and repeat the process reinstalling Zentyal 3.0 on the same hardware. In any case, please make sure you have everything backed up.

• If you don't want to reinstall your server and prefer to do a full distribution upgrade (from Ubuntu 10.04 to 12.04), you can try, but we don't recommend it, if you go ahead, you will probably need to purge the whole set of Zentyal 2.2 packages manually, and also others like the ldap ones.

Limitations

Due to the deep changes in Zentyal 3.0 we can't provide a full migration procedure, these are the current limitations of the process:

• Only a set of basic modules can be imported at the moment: objects, services, network and firewall.

• Users and groups can be migrated, but without the original passwords. This won't change as passwords are stored hashed and to generate the new hashes required for Kerberos in Zentyal 3.0 the original password in plain text would be needed. What we do is to reset all the passwords with autogenerated ones, giving the possibility to modify them before importing.

Procedure

• Export a configuration backup of your Zentyal 2.2 server and copy it to a freshly installed Zentyal 3.0.

• Download the following script to import the basic modules:
  •  https://raw.github.com/Zentyal/zentyal/3.0/extra/migrate-2.2-to-3.0/import-basic-modules

• Download also these two scripts if you want to import the users:
  •  https://raw.github.com/Zentyal/zentyal/3.0/extra/migrate-2.2-to-3.0/dump-users-from-backup
  •  https://raw.github.com/Zentyal/zentyal/3.0/extra/migrate-2.2-to-3.0/restore-users-from-dump

• Make sure the downloaded scripts and your configuration backup are all in the same directory and execute:

sudo perl import-basic-modules confbackupname.tar
sudo perl dump-users-from-backup confbackupname.tar users.csv

• Your users data will be exported to the users.csv file in CSV format with the autogenerated passwords, at this point, you can use any text editor to modify this file before importing it.

• To import users.csv:

sudo perl restore-users-from-dump users.csv

• Go to the Zentyal interface, make sure that the imported configuration is correct, and then save changes.

• Continue with the manual configuration of the rest of the modules.

Known issues

Basic modules

• If your default gateway is DHCP and you have more gateways, one of the static gateways will be set as default, but you can modify this from the Zentyal interface.
• Services including "any" or "any tcp/udp" are not imported.
• Any configuration in the imported modules not present in the 2.2 backup will be lost. This should not be a problem if you are using a freshly installed Zentyal 3.0.

Users and groups

• Currently this only works for master servers, not for slaves.