How to Manually Migrate Horde Data to Roundcube

Valid for versions 108 through the latest version

Version:

108


Last modified: November 8, 2022

Overview

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:

  1. Export the data from Horde.
  2. Import 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:

  1. Run the /usr/local/cpanel/scripts/export_horde_calendars_to_ics script to export the Horde calendars to .ics files.

  2. Copy 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 cpanelicsimport plugin imports all Horde calendar events into the default Roundcube calendar. To import a Horde calendar into a different Roundcube calendar, perform the following steps:

  1. Download the .ics file you exported in the previous step.

  2. Log in to Roundcube for the email account whose calendar you wish to import into a different calendar.

  3. Click the Calendar icon (Calendar icon).

  4. Click Import in the top panel.

  5. In the Calendar field, select the calendar to import.

  6. Select All in the Events dropdown menu.

  7. Choose the .ics file you exported in the previous step.

  8. Click Import.

Migrate Horde contacts

To migrate the Horde contacts, perform the following steps.

Export contacts

To export the Horde contacts, perform the following steps:

  1. Run the /usr/local/cpanel/scripts/export_horde_contacts_to_vcf script to export the Horde contacts to .vcf files.

  2. Copy 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 events into a single address book. To import Horde contacts into additional address books, perform the following steps:

  1. Log in to Roundcube for the email account whose contacts you wish to import into additional address books.

  2. Click the Contacts icon (Contacts icon).

  3. Click Import in the top panel.

  4. In the Import from file field, select the .vcf file you exported in the previous step.

  5. In the Import group assignments field, select All (create groups if necessary).

  6. Click Import.

Additional Documentation