Migrating Remote Advanced Historian Data

About this task

This section describes how to migrate your Advanced Historian Data from a remote machine.

Before you begin

Ensure that you have installed the required software correctly. Refer to the Recommended Software Installation Order section for more information.

If this procedure is not run as listed, you may experience problems inserting a chart control into the iFIX WorkSpace, running any programs using fixtools.dll or fixhdadll.dll, or running certain Historian features. Several *.dll(s) are replaced by older versions by the Advanced Historian . When Advanced Historian is removed, it replaces the older versions with the originals and Historian works correctly.

Procedure

  1. Ensure that PI services are running on the remote machine.
    1. Double-click the Services icon in the Control Panel.
      The Services window appears.
    2. Locate the Services beginning with 'PI'. Start all PI services except the PI Shutdown service.
  2. Ensure that all needed archives are listed as registered. a.
    1. Open the MSDOS prompt.
    2. Navigate to the ...Dynamics\AdvancedHistorian\adm directory.
    3. Enter `piartool al' to list the registered archive files. –
    4. Register any unregistered archive files that you need to migrate by typing `piartool ar ` + {fully qualified archive name.} –
    Example - piartool ar C:\Program Files (x86)\GE\iFIX\archives\DynamicArchive.001–
  3. On the local machine (machine with Historian loaded), run the Migration Utility.
    1. From the Start menu, select the Migration Tool for Historian in the Historian directory.
    2. Enter the name of the remote computer you are migrating the Advanced Historian data from.
    3. If you configured Advanced Historian security, enter the username and password for security.
    4. The Advanced Historian Migration Tool automatically detects and displays the default server in the Historian Connection Information Computer Name field.
      If you want to change the server to which you will migrate data, enter that server name in the Computer Name field of the Historian Connection Information section.
    5. If you have set up security on your Historian Server, enter a username and password in the Historian Connection Information Username and Password fields. If you do not provide a username and password, security defaults to check the currently logged in user.
      If you are already logged into Windows Server 2003 or Windows Serve 2008 with an account with rights to the Historian Server, you do not need to supply a new username and password.

      You must have Write, Tag Administrator, and Read privileges in order to run the migration. It is recommended that Security Administrators run the migration, for best performance.

    6. If you do not wish to migrate all tags, enter a tagname mask for selected tags.
    7. Select a start and end date from the drop-down calendars.
      It is recommended migrating data in two month time blocks, from the oldest data to the newest. For more information on estimating migration time, please refer to the Estimate Migration Time section of this manual.
    8. If you want the Migration Tool to create tags automatically when they don't exist, leave the Con-figure New Tags as Required option selected.
      For more information on this setting, refer to the Plan Migrations with Online Systems section.
    9. If you do not wish to overwrite any information in existing tags, clear the Allow Updates to Existing Data option.
    10. If you do not want your trend applications to display a continuous plot of the last good sample for that Historian tag, select the End of Collection marker.
      For more information on this setting, refer to Migration Options
    11. Select the Start Migration button.
    12. Refer to the Migration History window and the log file for information on the success of the tag migration and any errors or problems encountered during migration.