/panel/imports-migrations/migrations

Migrations

What is a migration?

A migration is the operation that allows you to transfer the contents of one or more email accounts from a mail server to Qboxmail systems massively through a specially configured CSV file, making the message transfer procedure easier and faster.

Migrations transfer all messages from the old server to Qboxmail and replicate all the tree structure of the folders and subfolders.

Who can make a migration?

Migrations can be carried out by a Admin, a Team member or a Manager authorized to manage the domains.

What do you need to do a migration?

To perform a migration, the original mail server must allow access to messages via IMAP and prepare a specially configured CSV file.

Create a CSV file for a migration

To perform a migration you need to create a special CSV file in which you must specify the user names and passwords to access the email accounts, present on the old server, which you intend to migrate.

If you know the passwords of the email accounts you want to migrate then carry out a standard migration, if not then carry out a migration with Master User if the functionality is supported by the origin server.

A maximum of 500 lines can be inserted in the CSV file. Each customer can schedule a maximum of 10 migrations simultaneously.

If you do not know the users' passwords and your server supports the IMAP Master User you can transfer the contents of the email accounts even without knowing their password. In this case you need to create a CSV file following the migration instructions with Master User.

If you do not know the passwords of the accounts and your remote server does not have the functionality Master User contact our technical support.

CSV file for a standard migration

To perform a standard migration you need to create a CSV file in which each email account you want to migrate must have 4 fields, divided by the ; field separator (semicolon). In the event that the elements of the fields contain a semicolon, each field must be enclosed by a text separator (double quote).

You must always specify the hostname or IP of the remote IMAP server to which the Qboxmail systems will have to connect to download the messages.

Follow the specifications in the file 0-ENG-README-MIGRATION.txt present in the file Migrations.zip.

We recommend that you always specify an IP address, as the hostname may change due to changes to the DNS.

email@local Destination email account on Qboxmail systems
imap-server-remote Name of the IMAP server to which you need to connect to download messages
email@remote Remote email account from which to retrieve messages
pwdremote Password of the remote email account from which to retrieve messages

email@local;imap-server-remote;email@remote;pwdremote

If the remote server has a username other than the email address, you can specify it in the CSV instead of the "emai @ remote" field

Once the CSV file has been generated, we advise you to always open it with a text editor (ex. Notepad) to verify its correctness.

CSV file for a migration with Master User

Migration with Master User allows you to transfer the contents of email accounts without knowing their password. To perform a migration with Master User you need to create a CSV file in which each email account you want to migrate must have 5 fields, divided by the ; field separator (semicolon). In the event that the elements of the fields contain a semicolon, each field must be enclosed by a text separator (double quote).

You must always specify the hostname or IP of the remote IMAP server to which the Qboxmail systems will have to connect to download the messages.

Follow the specifications in the file 0-ENG-README-MIGRATION.txt present in the file [Migrations.zip] (http://www.qboxmail.com/download/Migrations.zip).

We recommend that you always specify an IP address, as the hostname may change due to changes to the DNS.

email@local Destination email account on Qboxmail systems
imap-server-remote Name of the IMAP server to which you need to connect to download messages
email@remote Remote email account from which to retrieve messages
pwd-master-user Password of the remote master user
master-user-name Name of the remote master user

email@local;imap-server-remote;email@remote;pwd-user-master;master-user-name

If the remote server has a username other than the email address, you can specify it in the CSV instead of the "emai @ remote" field

Once the CSV file has been generated, we advise you to always open it with a text editor (ex. Notepad) to verify its correctness.

Perform a migration

To perform a migration click on the entry Migrations in the control panel sidebar and click on the + Migration button and complete the steps of the planning procedure.

  • Migrations > + Migration
  1. Select the type of remote server to migrate messages from (Standard, Gmail, Exchange, Office 365)

    The access and IMAP settings vary between different providers and servers.

  2. Load the previously prepared CSV file.
  3. Set the date and the time to start the first migration.
  4. At the end of the first run you will receive a confirmation email so you can change your MX records.

    We advise you to change the MX records at the end of the first run so that the second run can transfer the remaining e-mails arrived in the meantime to the old server

  5. Choose when to run the second migration (up to a maximum of 23 hours from the first).

It is possible to set a date and time, at which the migration will be started, or choose to immediately migrate migration with the option Run first migration as soon as possible.

The messages in the folders will not be migrated: Trash, Spam, Junk Email and those larger than 50MB.

To complete the procedure click on the Migrate button. Once the planning process is complete, the migration will be visible on your migration list.

If the migration has been successfully planned it will be performed at the scheduled time and you will receive an email alert when finished.

In case of errors, before planning a new migration, the Qboxmail systems will connect to the IMAP server indicated in the CSV file to attempt authentication, if this fails an error message will appear and you will need to verify any problems with accounts or with the remote server.

Migration errors are generally due to incorrect user name or password, IMAP protocol support from the remote server or incorrect remote server IP address.

Access to the list of migration resources to see the logs of each account for both executions.

  • Migrations > Migration resource number > Migration resource > Log 1 or 2

List of migrations

The migration list contains all the migrations added to the Qboxmail systems belonging to a Admin with the related detailed information. To view the migration list click on the name on the entry Migrations in the control panel sidebar.

Information in the migration list:

  • Status of the migration.
  • Name of the user who made the migration request.
  • Code of migration.
  • Type of migration.
  • Number of resources to be migrated.
  • Date of planning of the first migration.
  • Date of planning of the second migration.

By accessing the migration resource list you will be able to see all the details of the accounts in the migration CSV file and their results or errors.

  • Migrations > Migration resource number > Migration resource > Log 1 or 2

Delete a migration

To delete a migration within the migration list click on the Trash button TrashIcon corresponding to the migration, confirming the operation by clicking on the Delete within the modal.

  • Migrations > Migration name > Trash TrashIcon > Delete
A migration in progress cannot be deleted. Contact our technical support for more information.
Migrations older than 30 days are automatically deleted.

When MX records need to be changed

Planning migration at a distance of at least 4/8 hours from each other, you will be able to change the MX records of your domain and prevent the messages received from accounts during the execution of the first migration to be lost.

At the end of the first migration, the Qboxmail systems will send you an e-mail alert, so you can change the MX records and redirect the accounts to the Qboxmail servers, so that when the second migration takes place it can recover the messages on the old server received during the procedure.

We use cookies to provide you with a better browsing experience, continuing to accept their use.

Accept