Chatee ahora con Soporte
Chat con el soporte

Binary Tree Migrator for Notes 20.13 - Installation and Configuration Guide

Section 1. Introduction Section 2. Installing Binary Tree Migrator for Notes Section 3. Setting Up the Migrator for Notes Domino Database Section 4. Configuring Settings in Migrator for Notes About us Technical support resources Appendix A: Preparing for Office 365 Migrations Appendix B: Preparing for Office 365 Modern Authentication Appendix C: Creating a Migration Farm Appendix D: Securing Migrator for Notes Web Services with Windows Authentication Third-party Contributions

Monitoring the Website

The monitor can be accessed from any machine on the LAN to observe the status of the workstations. The workstation named local is the migration engine installed on the Migration Control Center machine. This should not be used for AWD migrations and should be left as Offline.


The Internet Information Server (IIS) included with Windows Client Operating Systems has a 10-connection limit. The additional workstations periodically connect to the master machines IIS to get work and report status, effectively tying up one connection per workstation. Connecting to the monitor website also consumes one connection. If you exceed 10 connections, then the extra workstations may not work correctly. Install the Migrator for Notes software on Windows Server operating system if you need more than 10 simultaneous connections.

 

The Machine info page displays an overview of the migration workstations status and performance.

The Migration info page displays what each workstation is currently doing

The Monitor website is refreshed approximately every 30 seconds. Throughput figures are calculated after a migration is completed.

To manage the worker application on any machine, right-click the respective icon in the system tray. If the workstation is currently running a migration, the Finish and Exit selection allows the migration to complete and report its status before shutting down the worker application. The Exit Now option disconnects the worker application. If a migration is in progress, the status is not updated on the server.

 

Mapping System Folder Names

The migration worker does allow for a mapping of mailbox system folder names based on the language type used in the source mail file. This is not required in general but is available if there are language conflicts between the source Notes mail file and the target Mailbox folder names.

The mapping is stored in the NMFolderNames.xml on the migration worker and can be updated as required for language mappings. The language is specified by a two character language code, for example. fr for French or de for German.

The migration system defaults to English (en) and does not require changes for most migration systems. It is recommended to test a migration system to determine if any mappings would be required prior to performing production migrations.

This does not impact on personal folders in the source or target systems, these folders will be mapped based on the folder name regardless of the language used.

 

 

Upgrading a Migration Farm

Perform the following steps to upgrade your existing farm.

Upgrades are tested and verified for two versions prior to the current GA release. Older releases will generally complete an upgrade but are not tested and are not covered by product support for direct upgrades, these may require interim upgrade versions to be performed.

  1. Run an in-place upgrade on the controller by clicking the "Migrator for Notes Setup XX.XX. This will upgrade the controller machine. Ensure that there are no migrations running or pending during this process. After the upgrade completes, restart the controller server.


Make sure to make a backup copy of your Migrator for Notes SQL database. This can be done through the SQL Management Studio by right clicking the database and selecting Tasks | Backup.

  1. Make a design template of the "Notes Migrator.nsf" which will be located in C:\Program Files\Binary Tree\CMT for Exchange\Notes Tools after the upgrade.  This can be accomplished by:

    1. Double clicking on the Notes Migrator.nsf file located in the C:\Program Files\Binary Tree\CMT for Exchange\Notes Tools on the controller machine.

    2. This will load the notes client and open the database on the controller.  From the Notes client menu choose File/Application/New copy.  The file copy dialog window will open.  Make a copy of the database giving it a "NTF" extension instead of a "NSF" extension.

    3. Open your Migrator for Notes database on your domino server.  With the file open, choose from the Notes client menu, File/Application/Design Replace.  The design template dialog will open, choose your newly created template from the list of templates and hit ok.

    4. Sign the Migrator for Notes database with your current Notes ID, this on the Progress Summary page.


Make sure to make a backup copy of your Notes Migrator.nsf database on the domino server for safety purposes. This can be a Notes copy of the .nsf database to the Local Notes workstation.

  1. The workers will automatically upgrade.  The workers check in with the controller and when the worker finds it’s at a lower release then the controller, it will automatically upgrade itself by automatically running the Migrator for Notes Worker XX.XX MSI.


The existing status for all migration accounts will be retained including the migration system licensing.

 

Upgrading from 5.x, 19.03.x, 19.09.x, 20.11.x, 20.12.x.

For upgrades of versions prior to 20.13 the steps for upgrading are the same as the above but will require some additional steps.

  1. The requirements software on the migration workers will have to be updated to include the new .Net 4.8 and Visual C++ 2019 with a workstation restart after these are updated. This will not be automatically done by the installer and must be completed before performing the upgrade on the controller.

  2. For Office 365 migrations that are using a Modern Auth configuration any accounts that are already imported into the migration system and matched will require re-matching using the PowerShell processing in the Match step. The accounts can be changed to the Match step by using the ‘Change Step To’ button on the Import or Migration | Advanced views.

 

Upgrading from 4.6.X

The process is the same as above except step 3.  You must manually run the Migrator for Notes Worker XX.XX.msi on all workers to upgrade to the latest software.

 

Upgrading from 3.8x, 4.0, 4.5

For these releases,  the worker software will need to be completely removed first, along with uninstalling the controller as well.

  1. Uninstall all the workers by going to each worker and running the uninstall program from the control panel.  This will remove the worker installation and unregister the workers from the controller.

  2. Uninstall the Migrator for Notes program the control panel on the controller.  This will remove all the software from the controller machine.   Run the Migrator for Notes Setup XX.XX on the controller machine.

 

Upgrading from 5.x, 19.03.x, 19.09.x, 20.11.x, 20.12.x.

Upgrading a Migration Farm

Perform the following steps to upgrade your existing farm.

Upgrades are tested and verified for two versions prior to the current GA release. Older releases will generally complete an upgrade but are not tested and are not covered by product support for direct upgrades, these may require interim upgrade versions to be performed.

  1. Run an in-place upgrade on the controller by clicking the "Migrator for Notes Setup XX.XX. This will upgrade the controller machine. Ensure that there are no migrations running or pending during this process. After the upgrade completes, restart the controller server.


Make sure to make a backup copy of your Migrator for Notes SQL database. This can be done through the SQL Management Studio by right clicking the database and selecting Tasks | Backup.

  1. Make a design template of the "Notes Migrator.nsf" which will be located in C:\Program Files\Binary Tree\CMT for Exchange\Notes Tools after the upgrade.  This can be accomplished by:

    1. Double clicking on the Notes Migrator.nsf file located in the C:\Program Files\Binary Tree\CMT for Exchange\Notes Tools on the controller machine.

    2. This will load the notes client and open the database on the controller.  From the Notes client menu choose File/Application/New copy.  The file copy dialog window will open.  Make a copy of the database giving it a "NTF" extension instead of a "NSF" extension.

    3. Open your Migrator for Notes database on your domino server.  With the file open, choose from the Notes client menu, File/Application/Design Replace.  The design template dialog will open, choose your newly created template from the list of templates and hit ok.

    4. Sign the Migrator for Notes database with your current Notes ID, this on the Progress Summary page.


Make sure to make a backup copy of your Notes Migrator.nsf database on the domino server for safety purposes. This can be a Notes copy of the .nsf database to the Local Notes workstation.

  1. The workers will automatically upgrade.  The workers check in with the controller and when the worker finds it’s at a lower release then the controller, it will automatically upgrade itself by automatically running the Migrator for Notes Worker XX.XX MSI.


The existing status for all migration accounts will be retained including the migration system licensing.

 

For upgrades of versions prior to 20.13 the steps for upgrading are the same as the above but will require some additional steps.

  1. The requirements software on the migration workers will have to be updated to include the new .Net 4.8 and Visual C++ 2019 with a workstation restart after these are updated. This will not be automatically done by the installer and must be completed before performing the upgrade on the controller.

  2. For Office 365 migrations that are using a Modern Auth configuration any accounts that are already imported into the migration system and matched will require re-matching using the PowerShell processing in the Match step. The accounts can be changed to the Match step by using the ‘Change Step To’ button on the Import or Migration | Advanced views.

 

Upgrading from 4.6.X

The process is the same as above except step 3.  You must manually run the Migrator for Notes Worker XX.XX.msi on all workers to upgrade to the latest software.

 

Upgrading from 3.8x, 4.0, 4.5

For these releases,  the worker software will need to be completely removed first, along with uninstalling the controller as well.

  1. Uninstall all the workers by going to each worker and running the uninstall program from the control panel.  This will remove the worker installation and unregister the workers from the controller.

  2. Uninstall the Migrator for Notes program the control panel on the controller.  This will remove all the software from the controller machine.   Run the Migrator for Notes Setup XX.XX on the controller machine.

 

Documentos relacionados

The document was helpful.

Seleccionar calificación

I easily found the information I needed.

Seleccionar calificación