Microsoft Exchange Server via IMAP (Outlook)

You can migrate your employees' emails from Microsoft Exchange Server mailboxes to Yandex 360 for Business using the IMAP protocol. To avoid collecting user passwords, use a separate account in the local Active Directory environment and grant it full access to employee mailboxes.

Create and configure an account for migration

  1. Connect the domain and prepare employee accounts in Yandex 360 for Business if you haven't done it before. Target mailboxes will be created for these accounts.
  2. Make sure that the IMAP4 service and SSL protocol are enabled and configured in Exchange Server.
  3. Create an account for migration in the local Active Directory environment, for example migration@example.com. Link an Exchange Server mailbox to this account.
    Tip. Create a separate account for migration without Exchange administrator rights. In the latest versions of Exchange Server, the admin has limited access to user mailboxes via the IMAP protocol, so migration may not work.
  4. Grant to this account full access rights to mailboxes that you want to migrate.
    1. Open the Exchange Admin Center in the browser.
    2. Go to Recipients → Mailboxes.
    3. Select a mailbox.
    4. In the properties window that opens, select Mailbox delegation.
    5. In the Full access section in the lower-right corner of the window, click Add.
    6. In the window that opens, specify the account for migration, such as migration@example.com.
    7. Click OK. The account will be added to the Full access section.
    8. In the mailbox properties window, click OK.

Prepare a CSV file

  1. Following the example, add the following information to the file:
    1. Employee username in Yandex 360 for Business.
    2. Account for migration, such as example.com/migration/user, where:
      • example.com is the domain of the source mailbox.
      • user is part of the employee's email address in Microsoft Exchange Server without the SMTP domain (up to @).
    3. Admin account password.

The resulting file should have the following structure:

"yandex_login";"external_email";"external_password"
"user1";"example.com/migration/user1";"Password"
"user2";"example.com/migration/user2";"Password"
"user3";"example.com/migration/user3";"Password"

Start migration

  1. Go to the Migration tab in the left menu.
  2. Select what you want to migrate: click Migrate email.
  3. Select where you want to migrate email from: click Other server.
  4. Set the connection parameters:
    • Domain name or IP address of the mail server.
    • Server port (for example, 993).

  5. Upload the CSV file.
  6. Click Start migration.
Note. If you plan to run multiple migrations, save the log file before each run (you can download it by clicking Details). If errors occur during migration, you'll be able to track at which run they appeared.

Troubleshooting

Take note of the following possible errors and ways to fix them.

Authentication error
Connect to the user mailbox using the account for migration: Use the account name from the external_mail column (for example, example.com/migration/user) and the password from the external_password column. If you can't connect, check your IMAP settings in Exchange Server and full access rights.
The first line in the CSV file has been deleted or changed
Download the CSV file template and copy the first line from it to your CSV file. Make sure that the previous import is completed and start a new import with the corrected CSV file.

To view the report with a detailed description of errors, click Details in the top right corner of the active migration page. For information on how to fix them, see Migration error report.