Migrate Data Using an AWS Transfer Family

Before you begin

  1. Deploy Proficy Historian for AWS.
  2. Install collectors.

About this task

This topic describes how to migrate data from an on-premises Historian server to Proficy Historian for AWS using a Transfer Family.

Procedure

  1. Create an SFTP-enabled server.
  2. After the server is running (online), you need to add a user. To create a user, generate an ssh key-pair (using powershell or ubuntu):
    For both the private and public key:
    ssh-keygen -t rsa
    To copy the id_rsa.pub (using the public key):
    cat ~/.ssh/id_rsa.pub
  3. Add a user.
  4. While adding user we need to provide User ID, Group ID, Secondary Group IDs as 999.
  5. Specify the Home directory path as: <File system ID(EFS)>/archiver/archives:

    When creating a user, it is required that IAM role with specific permissions be applied.

  6. To create an IAM role, from the IAM screen, click Roles and then Create Role. The following screen appears.
  7. In the Use Cases for Other AWS Services, select Transfer and then click Next.
  8. To create the IMA policy, select Service as EFS, Actions as ClientMount and ClientWrite, Resources as All Resources, and leave the rest of the settings with the defaults.

    The IMA role and policy is created:

  9. Provide the home directory and the VPC and public key using an application.
  10. To transfer data we can use an application like sftp or WinSCP.
    Using sftp:
    1. Login to the sftp to the server.
      sftp -i <pravate_key_along with path> <name of the user created>@<endpoint generated in transfer family>
    2. After you successfully login, transfer the file using the put command:
      put <source file> <destination file>
    Using WinSCP:
    1. Open WinSCP.

    2. In the Host Name field, enter the hostname as Endpoint.
    3. In the User Name field, enter the User from the AWS transfer family server.
    4. Click Advance to add the private key.
    5. Under Authentication, add the private key that you generated using ssh key-pair and click OK.

    Now WinSCP will be connected with the server and you can transfer files to EFS.
  11. While connected to EFS, go to the historian/archiver/archives folder and drag-and-drop the .iha and .ihc files.
    Note: Rename the local .ihc file as historian-archiver-sts-0_Config.ihc.
  12. Change the mode of operation to reload:
    1. Run Command Prompt as an administrator.
    2. Run the CloudHistorianConfigurationUtility.exe file. It is provided along with the collectors installer. After you install collectors, it will be available in the C:\Program Files\GE Digital\Historian Cloud Config folder by default.
    3. Enter the number corresponding to changing the configuration of Historian Data Archiver. For example, see the following figure.
    4. Enter the username and password to connect to Proficy Historian for AWS.
      Tip: For the default user, ihCloudHistAdmin, this is the value you entered in the Password field under UAA Configuration when you created the stack.
    5. For the debug mode, enter on or off.
    6. For the mode of operation, enter reload.
    A message appears when the operations completes: "Successfully updated Historian Configuration." The mode of operation is changed to reload.