Create an OSI PI Collector

Before you begin

  1. Deploy Proficy Historian for AWS.
  2. Install collectors. You can install them on-premises or on a VPC (which can be different from the one on which Proficy Historian for AWS is deployed).
  3. Install PI AF SDK version 2.7.5 or later.

About this task

The OSI PI collector collects data from an OSI PI data server and sends it to Data Archiver. Data is collected directly from OSI PI Data Archive v3.2 or later via OSI PI AOSI PI v1.3.4 or later.

One OSI PI collector can collect data from a single OSI PI data server. To collect from multiple OSI PI data servers, you must create multiple OSI PI collector instances.

Features
  • You can browse the source for tags and their attributes.
    Note: Tag browsing performance with OSI PI has been confirmed as satisfactory up to 130,000 tags. Beyond that threshold, OSI PI may take a long time to return the large number of tags. In such a case, we recommend that you first export the tags to an Excel worksheet.
  • Only unsolicited data collection is supported.
  • The supported timestamp resolution is milliseconds or seconds.
  • Python expression tags are supported.
  • Floating point, integer, and string data are supported.
  • Device timestamps are accepted.

Procedure

  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 creating a collector instance.
  4. Enter the following details:
    Field Description
    Interface Name Enter the name that you want to provide for the collector instance. A value is required and must be unique in the DNS.
    NLB DNS

    Enter the Amazon Network Load Balancer (NLB) DNS.

    Tip: To find the NLB DNS:
    1. Access the EKS cluster on which you have deployed Proficy Historian for AWS.
    2. Access the EC2 instance.
    3. In the navigation pane, under Load Balancing, select Load Balancers.
    4. Select the load balancer for which you want to find the DNS.
    5. In the Description section, copy the DNS name.
    Username Enter the username to connect to Proficy Historian for AWS. A value is required.
    Password Enter the password to connect to Proficy Historian for AWS. A value is required.
    Tip: For the default user, ihCloudHistAdmin, this is the value you entered in the Password field under UAA Configuration when you created the stack.
    OSI PI server Enter the host name or IP address of the machine on which the OSI PI server is installed. A value is required.
    OSI PI username Enter the username to connect to the OSI PI server. If you just press ENTER, the default username is used.
    OSI PI password Enter the password to connect to the OSI PI server. If you just press ENTER, the default password is used.
    PI source Specify whether the OSI PI source is archive or snapshot. If you just press ENTER, archive is considered as the PI source.
    The OSI PI collector is created and started.