How to Manually Migrate Horde Data to Roundcube

This element (ia-generated) isn't supported, or may require an update to be displayed. You can try to refresh the app.

Overview

Warning:
This procedure is only valid for cPanel & WHM version 118 and earlier. We removed the  /usr/local/cpanel/scripts/export_horde_calendars_to_ics  and  /usr/local/cpanel/scripts/export_horde_contacts_to_vcf  scripts in cPanel & WHM version 120. For more information, read the Horde webmail interface section of our  cPanel Deprecation Plan  documentation.
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:
    .1Run the  /usr/local/cpanel/scripts/export_horde_calendars_to_ics  script to export the Horde calendars to .ics files.
    .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:
    .1Download the .ics file you exported  in the previous step .
    .2Log in to Roundcube for the email account whose calendar you wish to import into a different calendar.
    .3Click the Calendar icon
    .4Click Import in the top panel.
    .5In the Calendar menu, select the calendar to import.
    .6Select All in the Events from menu.
    .7Select the .ics file you exported  in the previous step .
    .8Click Import.

Move a single calendar event

To move a calendar event from the default calendar to a non-default calendar, perform the following steps:
    .1Log in to Roundcube for the email account whose calendar you wish to import into a different calendar.
    .2Click the Calendar icon
    .3Enable both the default calendar and the target calendar.
    .4Select the event you wish to move.
    .5Click Edit.
    .6In the Calendar menu, select the target calendar.
    .7Click Save.
    .8Disable, then re-enable the target calendar.
The event will appear in the target calendar.

Migrate Horde contacts

To migrate the Horde contacts, perform the following steps.

Export contacts

To export the Horde contacts, perform the following steps:
    .1Run the  /usr/local/cpanel/scripts/export_horde_contacts_to_vcf  script to export the Horde contacts to .vcf files.
    .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
    .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).
    .6Click Import.