This document describes how to manually migrate Horde calendars and contacts to Roundcube in cPanel & WHM version 108 and higher. The migration process consists of two steps:
.1Export the data from Horde.
.2Import the data into Roundcube.
In cPanel & WHM version 108, we removed the Horde webmail client. We also created a set of scripts and plugins to migrate Horde contacts and calendar data from Horde to Roundcube. The scripts run automatically when the server updates to cPanel & WHM version 108, and the plugins run automatically each time the user logs in to Roundcube.
Some Horde calendar events and contacts may not migrate automatically to Roundcube or appear correctly in the Roundcube interface. If this occurs, perform the steps in this document to manually migrate the calendars and contacts from Horde to Roundcube.
Note:
Only the root user can run the scripts in this document.
You can review the $HOME/logs/.php.error.log and $HOME/logs/roundcube/errors.log files for plugin errors, where $HOME is the user’s home directory.
If the Horde contacts and calendars do not display correctly after you follow the steps in this document, open a ticket with cPanel Support.
Migrate Horde calendars
To migrate the Horde calendars, perform the following steps.
Export calendars
To export the Horde calendars, perform the following steps:
.2Copy the .ics files into the cPanel user’s icals directory in $HOME/.cpanel/icals, where $HOME is the user’s home directory. For example, if you exported the cptest user’s calendars to /home/cptest/calendars, run this command to copy the .ics files:
cp -a /home/cptest/calendars/*.ics /home/cptest/.cpanel/icals
Import calendars
To import the Horde calendars, log in to Roundcube for each email account whose calendars you wish to import. The cpanelicsimport plugin automatically imports the calendars from the $HOME/.cpanel/icals directory into Roundcube, where $HOME is the user’s home directory.
The plugin imports all Horde calendar events into the default Roundcube calendar.
Import all calendar events
To import all Horde calendar events into a non-default Roundcube calendar, perform the following steps:
.2Copy the .vcf files into the cPanel user’s vcards directory in $HOME/.cpanel/vcards, where $HOME is the user’s home directory. For example, if you exported the cptest user’s calendars to /home/cptest/contacts, run this command to copy the .vcf files:
cp -a /home/cptest/contacts/*.vcf /home/cptest/.cpanel/vcards
Import contacts
To import the Horde contacts, log in to Roundcube for each email account whose contacts you wish to import. The cpanelvcfimport plugin automatically imports the contacts from the $HOME/.cpanel/vcards directory into Roundcube, where $HOME is the user’s home directory.
The cpanelvcfimport plugin imports all Horde contacts into a single address book. To import Horde contacts into additional address books, perform the following steps:
.1Log in to Roundcube for the email account whose contacts you wish to import into additional address books.
.2Click the Contacts icon
Add a caption...
.3Click Import in the top panel.
.4In the Import from file field, select the .vcf file you exported in the previous step.
.5In the Import group assignments field, select All (create groups if necessary).