Create an OSI PI Distributor

About this task

The OSI PI distributor collects data from a Historian server and sends it to an OSI PI server. You can use OSI PI v1.3.4 or greater.

The OSI PI distributor uses unsolicited distribution, whereby changes in Historian tags values are detected, and are forwarded to a remote OSI PI data server. The distributor duplicates data from a Historian archive to an OSI PI data archive.

One OSI PI distributor can distribute data to a single OSI PI data archive. To distribute to multiple OSI PI archives from an Historian archive, you must create multiple instances of the OSI PI distributor. You can also configure multiple OSI PI distributors for a single OSI PI data archive.
Note: The OSI PI distributor can send data only to PI Archive, not to PI Snapshot.
Features:
  • You can browse the source for tags and their attributes on an OSI PI server.
  • Only unsolicited data collection is supported.

    For unsolicited data collection, if collector compression is disabled, all new values produce an exception. And, the deadband percentage is determined by the collector deadband percent. You can only configure the collector deadband percent by enabling compression.

  • The supported timestamp resolution is milliseconds or seconds.
  • Floating point, integer, and string data are supported.
  • Device timestamps are accepted.

Procedure

  1. Run Command Prompt as an administrator.
  2. Run the AzureCloudHistorianConfigurationUtility.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.
    Azure Load Balancer IP

    Enter the Azure Load Balancer IP. A value is required.

    Tip: To find the Azure Load Balancer IP:
    1. Go to the Azure portal.
    2. Go to the Resource Group that was specified during deployment.
    3. Select the cluster_name-IP to access the resource of type Public IP Address.
    4. Select or copy the IP Address.
    Username Enter the username to connect to Proficy Historian for Azure Cloud. A value is required.
    Password Enter the password to connect to Proficy Historian for Azure Cloud. A value is required.
    Tip: For the default user, ihCloudHistAdmin, this is the value you entered in the Password field at the time of deployment.
    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 distributor is created and started.