Differences between revisions 1 and 34 (spanning 33 versions)
Revision 1 as of 2021-06-16 08:38:59
Size: 64
Editor: maegger
Comment:
Revision 34 as of 2021-06-16 16:04:19
Size: 9749
Editor: maegger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
#rev 2021-06-16 maegger
= Migrating your mailbox from ISG to Exchange =
Line 3: Line 5:

== Introduction ==
Some professorships and institutes at D-ITET have decided to use the exchange mail server instead of the D-ITET mail server. This guide is intended to show you the steps to be able to move your mail account to the exchange server. If certain steps in these instructions are unclear, please contact your technical contact first or create a ticket by sending an email to <support@ee.ethz.ch>.

== Pre-migration steps ==
There are some limitations on the Exchange Server which mean that not all emails can be transferred. You must have completed the following steps before you start the actual migration itself:
 * '''Quota''' - In contrast to our mail server, your mailbox on the exchange server has a quota. This quota applies to your mailbox and all folders in it. Employees usually have a storage space limit of 5GB on the exchange server. If your technical contact tells you that you need to reduce the amount of data, you can either delete emails you no longer need or you can export them first, before you delete them afterwards. In Thunderbird you could use the following steps to export emails:
  * Right click on the respective mail and select "Save as ..."
  * Select the storage location. The mail is saved as an .eml file, which is opened and displayed again in Thunderbird with a double click.
  * Afterwards you can delete the email.
  * If you have to export a lot of emails, you should use an export tool. For Thunderbird there is for example the [[https://addons.thunderbird.net/de/thunderbird/addon/importexporttools-ng/|ImportExportTools NG]] by Christopher Leidigh which can export many selectable mails in addition to the EML format also in PDF, HTML or plain text. You can find short instructions for this plugin [[https://www.nucleustechnologies.com/blog/backup-mozilla-thunderbird-emails-to-hard-drive/|here]]
 * '''Mail item limit''' - Every object on the Exchange server (email, contact, appointment entry, etc.) is an item. The Informatik Dienste have defined an upper limit of 50,000 items. Above this limit, performance problems can and will occur with your own mail account. If your technical contact tells you that you need to reduce the mail items, you can either delete emails you no longer need or you can export them first and then delete them. The steps to export your mails are the same as described under quota.
 * '''Single mailsize limitation''' - The maximum size for a single email is 20MB on the exchange server. This limit includes the header, mail text and base64 encoded binary data (which are increased by a factor of about 1.5!). If your technical contact tells you that you have oversized emails, you can either delete them or you can export them first and then delete them. The steps to export oversized emails are the same as described under quota.

You can carry out the steps mentioned above at any time. /!\ But please do only carry out '''the following steps''' one day before or on the day of the migration at the earliest. /!\ Before the account can be migrated, you may have to delete existing forwards on the exchange server and set up new forwards on the ISG mail server. These forwards are necessary in order to receive the mails on the exchange server until the final changeover of the domain to the exchange server.

=== Remove any IAM forward ===
By default we set a forward on the exchange server so that you would not miss any mail sent to your IAM account directly. This forward needs ro be removed. To do so execute the following steps:
 1. visit https://password.ethz.ch/
 1. Login with your username and password<<BR>>
 {{attachment:IAM-login.png||width=320}}
 1. Click {{{Self Service}}} and {{{Manage forward}}} to adjust your forward settings.<<BR>>
 {{attachment:IAM-mngfw.png||width=320}}
 1. Remove any content in the ''Recipient'' Field and make sure ''Save and forward mails'' is not set. Then click {{{Save}}}.<<BR>>
 {{attachment:IAM-removefw.png||width=320}}

=== Set a forward on the ISG mailserver ===
After removing the IAM forward you need to set a forward to the exchange server. The simplest way to do so is by using roundcube:
 1. Visit https://email.ee.ethz.ch/
 1. Login with your username and password<<BR>>
 {{attachment:WEBMAIL-login.png||width=320}}
 1. Select {{{Settings}}} and then {{{Filters}}}<<BR>>
 {{attachment:WEBMAIL-selectfilter.png||width=320}}
 1. By default you would see the '''isgdefault''' Filter set. This set contains the two rules {{{Deduplicate}}} and {{{Vacation}}}. Click the {{{Create}}} Button in the upper right frame and create a sieve rule like in the picture. Replace {{{username}}} in the action field with your username. Afterwards click {{{Save}}}.<<BR>>
 {{attachment:WEBMAIL-filtercreate.png||width=640}}

{{{{#!wiki important
'''Important'''

From this moment on, every incoming email will be redirected to the exchange server. To be able to read any new email you either need to login with your credentials at the exchange webinterface https://mail.ethz.ch/owa or you need to configure a mail client to access the exchange server. If you used thunderbird on our server you should switch to Microsoft Outlook to access the exchange mailserver. Please refer to the '''Instructions / FAQ / How To / Tips''' Section on the [[https://ethz.ch/services/en/it-services/catalogue/email-calendar/mailbox.html|ETH Mailbox Service]] Website to find instructions on how to configure a mail client to use the exchange mailserver.
}}}}

=== Prepare an SSH-Client ===
Prepare an SSH-Client like {{{openssh (linux/mac)}}} or {{{PuTTy (windows)}}} to be able to carry out the synchronization with the assigned credentials (visible on the migration day in the [[https://computing.ee.ethz.ch/Email/IDMigration#Migration_webinterface|Migration webinterface]]).
==== configuring PuTTy on Windows ====
 1. On our managed machines you should find PuTTy in the list of applications or by clicking the Windows Button in the left bottom frame and typing {{{putty}}}. If you are using a self managed machine install PuTTy from https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html .
 1. PuTTy opens a pop-up window. In the Basic Settings make sure to add {{{login.ee.ethz.ch}}} into the Hostname line, the port is set to {{{22}}} and the Connection Type is {{{SSH}}}.<<BR>>
 {{attachment:PuTTy-Basicsettings.png||width=320}}
 1. Select the {{{Window}}} Category on the left side and make sure to use {{{150}}} for Columns and {{{50}}} for Rows.<<BR>>
 {{attachment:PuTTy-Windowsettings.png||width=320}}
 1. Select {{{Window/Translation}}} Category on the left side and make sure to use {{{ISO-8859-1:1998 (Latin-1, West Europe)}}} for the Remote character set.<<BR>>
 {{attachment:PuTTy-Translationsettings.png||width=320}}
 1. Click {{{Open}}} on the bottom of the pop-up window to establish a connection. /!\ Do not login with your personal credentials! Use the migration credentials from the webinterface instead! /!\ <<BR>>
 {{attachment:PuTTy-Connect.png||width=320}}
==== Using openssh on linux / mac ====
Open a terminal and use the following command. Replace {{{migruser}}} by the migration user assigned to you (as seen in the webinterface). The password can also be found in the webinterface, but only on the day of migration.
{{{
ssh migruser@login.ee.ethz.ch
}}}


== Migration webinterface ==
Together with the technical contact of an institute, the ISG creates a list of the users to be migrated and sets a migration date for each account. As soon as the migration begins, all users can log in with their credentials at https://mmigr.ee.ethz.ch . In this interface you can see:<<BR>>

{{attachment:WEBINTERFACE-Overview.png||width=640}}

 1. The accounts you need to migrate (most people will only see their own username here)
 1. The day on which your migration is planned
 1. Your migration credentials (username/password) to access the synctool. These credentials can only be seen the day your migration is planned.
 1. Link to this instruction website

== Syncing ==
{{{{#!wiki important
'''Important'''

Before you start the synchronisation process, make sure you have followed all [[https://computing.ee.ethz.ch/Email/IDMigration#Pre-migration_steps|Pre-migration steps]]!
}}}}

 1. Login to the [[https://mmigr.ee.ethz.ch||migration webinterface]] and make sure to write down the username and the password for the migration account.
 1. Open an SSH connection ([[https://computing.ee.ethz.ch/Email/IDMigration#configuring_PuTTy_on_Windows|Windows]]/[[https://computing.ee.ethz.ch/Email/IDMigration#Using_openssh_on_linux_.2F_mac|Unix]]) and login with the credentials from the webinterface. /!\ If you have multiple accounts to migrate, you need to do these steps for every account! /!\
 1. Enter the accountname which needs to be migrated (''testuser in the example''). Mostly this will be your own username only.<<BR>>
 {{attachment:SYNCTOOL-step01-username.png||width=480}}
 1. Select {{{1}}} if you use the same password on both server (Applies to most users!) or {{{2}}} if you have different passwords.<<BR>>
 {{attachment:SYNCTOOL-step02-password_amount.png||width=480}}
  1. If you selected {{{1}}} you can enter the password. <<BR>>
  {{attachment:SYNCTOOL-step03-Enter_password-one4two.png||width=480}}
  1. If you selected {{{2}}} you need to enter separate passwords for each mailserver <<BR>>
  {{attachment:SYNCTOOL-step03-Enter_password-ISG.png||width=480}}
  {{attachment:SYNCTOOL-step03-Enter_password-ID.png||width=480}}

----
[[CategoryMAIL]]

Migrating your mailbox from ISG to Exchange

Introduction

Some professorships and institutes at D-ITET have decided to use the exchange mail server instead of the D-ITET mail server. This guide is intended to show you the steps to be able to move your mail account to the exchange server. If certain steps in these instructions are unclear, please contact your technical contact first or create a ticket by sending an email to <support@ee.ethz.ch>.

Pre-migration steps

There are some limitations on the Exchange Server which mean that not all emails can be transferred. You must have completed the following steps before you start the actual migration itself:

  • Quota - In contrast to our mail server, your mailbox on the exchange server has a quota. This quota applies to your mailbox and all folders in it. Employees usually have a storage space limit of 5GB on the exchange server. If your technical contact tells you that you need to reduce the amount of data, you can either delete emails you no longer need or you can export them first, before you delete them afterwards. In Thunderbird you could use the following steps to export emails:

    • Right click on the respective mail and select "Save as ..."
    • Select the storage location. The mail is saved as an .eml file, which is opened and displayed again in Thunderbird with a double click.
    • Afterwards you can delete the email.
    • If you have to export a lot of emails, you should use an export tool. For Thunderbird there is for example the ImportExportTools NG by Christopher Leidigh which can export many selectable mails in addition to the EML format also in PDF, HTML or plain text. You can find short instructions for this plugin here

  • Mail item limit - Every object on the Exchange server (email, contact, appointment entry, etc.) is an item. The Informatik Dienste have defined an upper limit of 50,000 items. Above this limit, performance problems can and will occur with your own mail account. If your technical contact tells you that you need to reduce the mail items, you can either delete emails you no longer need or you can export them first and then delete them. The steps to export your mails are the same as described under quota.

  • Single mailsize limitation - The maximum size for a single email is 20MB on the exchange server. This limit includes the header, mail text and base64 encoded binary data (which are increased by a factor of about 1.5!). If your technical contact tells you that you have oversized emails, you can either delete them or you can export them first and then delete them. The steps to export oversized emails are the same as described under quota.

You can carry out the steps mentioned above at any time. /!\ But please do only carry out the following steps one day before or on the day of the migration at the earliest. /!\ Before the account can be migrated, you may have to delete existing forwards on the exchange server and set up new forwards on the ISG mail server. These forwards are necessary in order to receive the mails on the exchange server until the final changeover of the domain to the exchange server.

Remove any IAM forward

By default we set a forward on the exchange server so that you would not miss any mail sent to your IAM account directly. This forward needs ro be removed. To do so execute the following steps:

  1. visit https://password.ethz.ch/

  2. Login with your username and password
    IAM-login.png

  3. Click Self Service and Manage forward to adjust your forward settings.
    IAM-mngfw.png

  4. Remove any content in the Recipient Field and make sure Save and forward mails is not set. Then click Save.
    IAM-removefw.png

Set a forward on the ISG mailserver

After removing the IAM forward you need to set a forward to the exchange server. The simplest way to do so is by using roundcube:

  1. Visit https://email.ee.ethz.ch/

  2. Login with your username and password
    WEBMAIL-login.png

  3. Select Settings and then Filters
    WEBMAIL-selectfilter.png

  4. By default you would see the isgdefault Filter set. This set contains the two rules Deduplicate and Vacation. Click the Create Button in the upper right frame and create a sieve rule like in the picture. Replace username in the action field with your username. Afterwards click Save.
    WEBMAIL-filtercreate.png

Important

From this moment on, every incoming email will be redirected to the exchange server. To be able to read any new email you either need to login with your credentials at the exchange webinterface https://mail.ethz.ch/owa or you need to configure a mail client to access the exchange server. If you used thunderbird on our server you should switch to Microsoft Outlook to access the exchange mailserver. Please refer to the Instructions / FAQ / How To / Tips Section on the ETH Mailbox Service Website to find instructions on how to configure a mail client to use the exchange mailserver.

Prepare an SSH-Client

Prepare an SSH-Client like openssh (linux/mac) or PuTTy (windows) to be able to carry out the synchronization with the assigned credentials (visible on the migration day in the Migration webinterface).

configuring PuTTy on Windows

  1. On our managed machines you should find PuTTy in the list of applications or by clicking the Windows Button in the left bottom frame and typing putty. If you are using a self managed machine install PuTTy from https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html .

  2. PuTTy opens a pop-up window. In the Basic Settings make sure to add login.ee.ethz.ch into the Hostname line, the port is set to 22 and the Connection Type is SSH.
    PuTTy-Basicsettings.png

  3. Select the Window Category on the left side and make sure to use 150 for Columns and 50 for Rows.
    PuTTy-Windowsettings.png

  4. Select Window/Translation Category on the left side and make sure to use ISO-8859-1:1998 (Latin-1, West Europe) for the Remote character set.
    PuTTy-Translationsettings.png

  5. Click Open on the bottom of the pop-up window to establish a connection. /!\ Do not login with your personal credentials! Use the migration credentials from the webinterface instead! /!\
    PuTTy-Connect.png

Using openssh on linux / mac

Open a terminal and use the following command. Replace migruser by the migration user assigned to you (as seen in the webinterface). The password can also be found in the webinterface, but only on the day of migration.

ssh migruser@login.ee.ethz.ch

Migration webinterface

Together with the technical contact of an institute, the ISG creates a list of the users to be migrated and sets a migration date for each account. As soon as the migration begins, all users can log in with their credentials at https://mmigr.ee.ethz.ch . In this interface you can see:

WEBINTERFACE-Overview.png

  1. The accounts you need to migrate (most people will only see their own username here)
  2. The day on which your migration is planned
  3. Your migration credentials (username/password) to access the synctool. These credentials can only be seen the day your migration is planned.
  4. Link to this instruction website

Syncing

Important

Before you start the synchronisation process, make sure you have followed all Pre-migration steps!

  1. Login to the https://mmigr.ee.ethz.ch and make sure to write down the username and the password for the migration account.

  2. Open an SSH connection (Windows/Unix) and login with the credentials from the webinterface. /!\ If you have multiple accounts to migrate, you need to do these steps for every account! /!\

  3. Enter the accountname which needs to be migrated (testuser in the example). Mostly this will be your own username only.
    SYNCTOOL-step01-username.png

  4. Select 1 if you use the same password on both server (Applies to most users!) or 2 if you have different passwords.
    SYNCTOOL-step02-password_amount.png

    1. If you selected 1 you can enter the password.
      SYNCTOOL-step03-Enter_password-one4two.png

    2. If you selected 2 you need to enter separate passwords for each mailserver
      SYNCTOOL-step03-Enter_password-ISG.png SYNCTOOL-step03-Enter_password-ID.png


CategoryMAIL

Email/IDMigration (last edited 2023-10-16 11:11:19 by alders)