Create an iFIX Collector

Before you begin

  1. Deploy Proficy Historian for Azure Cloud.
  2. Install collectors. You can install them on-premises or on an Azure Virtual Machine in a VNet (which can be the same one as the Historian server or a different one).
  3. Ensure that the iFIX server is running.

About this task

The iFIX collectors collect data from iFIX and store it in the Historian server.

They use the Easy Data Access (EDA) protocol to retrieve data from a running iFIX system.

Features:
  • You can browse the source for tags and their attributes.
  • Only the polled data collection is supported; unsolicited collection is not supported. The minimum poll interval is 100ms.
  • The supported timestamp resolution is milliseconds or seconds.
  • The collector accepts device timestamps.
  • Floating point, integer, string, and binary data are supported.
  • You can create Python Expression Tags for those collectors that support them.
Supported tag attributes:
  • Tagname
  • Source Address
  • Engineering Unit Description
  • Data Type
  • Hi Engineering Units
  • Lo Engineering Units

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.
    A list of collectors that you can create appears.
  4. Enter the number corresponding to the collector that you want to create.
  5. 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 at the time of deployment.
    iFIX Server Enter the host name or IP address of the iFIX server. A value is required. The default value is FIX, which indicates the local machine.
    The iFIX collector is created.

What to do next

Start the collector: Add the collector to the iFIX System Configuration (SCU) startup list. The collector then starts automatically whenever you start iFIX. To do so, set the task parameters to NOSERVICE REG=<collector name>, as shown in the following image for a collector with the interface name win2019dj2_iFix_1.
Note: If an error occurs, stating that the collector fails to start and prompting you to delete the collector:
  1. Select No.
  2. In iFIX System Configuration (SCU), set the task parameters as follows:
    • Filename: Enter <installation drive>:\Program Files (x86)\GE Digital\Historian iFix Collector.
    • Command Line: Enter NOSERVICE REG=<collector name>.