How to Migrate the Canary Historian to a New Server with the Same Machine Name (version 23)

The following article explains the steps that can be taken when migrating the Canary historian to a new server using the same machine name. Note, each environment is unique and additional steps may be required to complete the migration. If wishing to move the historian to a new server with a different machine name, see How to Migrate the Canary Historian to a New Server with a Different Machine Name.

1. Contact support@canarylabs.com or your Canary representative to request a temporary license to place on the old server. A new license will then be generated for you to place onto the new server once the temporary license has been applied.
2. Stop ALL Canary services on old server.
   • This will cause all data that is currently being logged from remote Collectors to buffer in the Sender until the new server is created.
   • Any clients wishing to connect to consume data will be temporarily disabled. Ideally, this migration should be performed off hours or during downtime.
3. Rename the old server.
4. Create the new server using the original name of the old server.
5. Install the desired components from the Canary Installer.
   • Ensure that the Installation Location, Historian Data Location, and Canary Base Path match the old server. If you are not sure where these are located on the old server, you can check the following registry keys:
     • Installation Location - Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Canary Labs
     • Historian Data Location - Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Canary Labs\Historian
     • Canary Base Path - Computer\HKEY_CLASSES_ROOT\CanaryLabs.
6. Once installed, stop ALL Canary services on the new server.
7. Copy the historical data (.hdb2 files) from the old server to the new. By default, this is located in C:\Historian Data.
8. Copy and replace the ProgramData\Canary [Labs] folder from the old server to the new.
   • This will contain config files for local Collectors, Calculations, and/or Axiom applications and charts.
9. Start ALL Canary services.
10. Apply new license onto the new server. See How to License Canary System Components.

Once the license is applied, data should start flowing into the new historian.

Note: It may be useful to take screenshots or have the Canary Admin opened on the old server to compare the settings for each service regarding endpoints and access lists.