If you are using a directory service for user management, you must install Kerio Connect Multi-Server, connect it to a directory service, and migrate users from the original server.

Connecting Kerio Connect Multi-Server to a directory service

1. Install the Kerio Connect Multi-Server puppet master server.
2. Install the Kerio Connect Multi-Server directory server.
3. Install one Kerio Connect Multi-Server back-end server. This is the master server.
4. Log in to the back-end server administration and go to the Configuration > Domains section.
5. Double-click your domain and go to the Directory Service tab.
6. Configure the connection to your directory server. 
7. Continue installing the remaining servers: additional back-ends, instant messaging, front-end, and Zabbix. The directory server configuration is automatically distributed to all servers.

If you use Kerberos authentication, you must configure it on each back-end server separately. For more information refer to Joining Kerio Connect running on Linux to Open Directory or Active Directory.

Migrating users and data from your Kerio Connect

To migrate your users and their data to the new Kerio Connect Multi-Server installation:

1. On the original Kerio Connect server, go to Configuration > Domains.
2. Click the Distributed Domains button.
3. Click Next.
4. Type the hostname of the first back-end server (master server) of your Kerio Connect Multi-Server, and the username and password of its admin.
5. Click Connect. The original server is now connected to your Kerio ConnectMulti-Server.
6. On a back-end server, go to Accounts > Users and migrate all users from the original to the back-end server. For more information refer to Migrating users between the back-end servers.
7. Disconnect the original server from the distributed domain in Kerio ConnectMulti-Server.

Now you can start using Kerio Connect Multi-Server.

If you are using a Kerio Connect distributed domain, you must install Kerio Connect Multi-Server, connect it to a directory service, and migrate users from the original servers.

To install Kerio Connect Multi-Server and connect it to a directory service, read Connecting Kerio Connect Multi-Server to a directory service, above.

Migrating users and data from your distributed domain

To migrate your users and their data to the new Kerio Connect Multi-Server installation, do the following for each server in your distributed domain:

1. Disconnect the server from the distributed domain. 
2. On that server, go to Configuration > Domains.
3. Click the Distributed Domains button.
4. Click Next.
5. Type the hostname of the first back-end server (master server) of your Kerio Connect Multi-Server, and the username and password of its admin.
6. Click Connect. The server is now connected to your Kerio Connect Multi-Server.
7. On a back-end server, go to Accounts > Users and migrate all users from the original to the back-end server. For more information refer to Migrating users between the back-end servers.
8. Disconnect the server from the distributed domain in Kerio Connect Multi-Server.

Now you can start using Kerio Connect Multi-Server.

If you have Kerio Connect with a local database of users, you must install Kerio Connect Multi-Server, connect it to a directory service, create users in the directory service and migrate the users from the original server.

Follow the instructions in Connecting Kerio Connect Multi-Server to a directory service (above), then perform the migration using the steps below.

Migrating users and data from your server with a local database

To migrate your users and their data to the new Kerio Connect Multi-Server, you must remove the users from the original server, connect this server to Kerio Connect Multi-Server directory server, create the same users on the original server, and then migrate them to a back-end server.

1. On the original Kerio Connect server, go to Accounts > Users.
2. Remove all local users.

While removing users, in the Remove User dialog box, select Do not delete user's message folder and uncheck the Also delete aliases of this user...option.

3. Connect the server to the Kerio Connect Multi-Server directory server by editing the configuration file.
4. On the original server, create users with the same usernames as before. For more information refer to Creating users in Kerio Connect Multi-Server.
5. On that server, go to Configuration > Domains.
6. Click Distributed Domains.
7. Click Next.
8. Type the hostname of the first back-end server (master server) of your Kerio Connect Multi-Server, and the username and password of its admin.
9. Click Connect. The original server is now connected to your Kerio ConnectMulti-Server.
10. On a back-end server, go to Accounts > Users and migrate all users from the original to the back-end server. For more information refer to Migrating users between the back-end servers.
11. Disconnect the original server from the distributed domain in Kerio ConnectMulti-Server.

Now you can start using Kerio Connect Multi-Server.