Configuring an OSI PI Distributor

About this task

To configure an OSI PI Distributor:

Procedure

  1. Start the Historian Administrator.
  2. Select the Collectors screen.
  3. Select the OSI PI Distributor you want to configure.
  4. Configure the OSI PI Distributor's General options.
    1. Enter a description for your OSI PI Distributor.
    2. In the Computer Name field, enter the hostname of the computer your distributor is running on, for example, localhost.
    3. If you wish to set limits on memory usage and free disk space, change the values in the Memory Buffer Size and Minimum Free Space fields.
  5. Configure the OSI PI Distributor-specific options:
    1. Click the Configuration tab.
    2. In the PI Server field, enter the name of the machine where the OSI PI server is running. For example, localhost.
    3. In the PI Username field, enter the OSI PI user name. For example, PIAdmin.
    4. Enter the OSI PI password into the OSI PI Password field. The password is required to authenticate the OSI PI Data Archive.
      If no password is configured for the OSI PI user, this field can be left blank. Passwords are case-sensitive.
    5. In the Max Recovery Time (hr) field, enter a new maximum recovery time, in hours.
      Recovery logic is activated when the OSI PI Distributor and Historian re-establish a connection after a connection loss, or when the distributor is restarted. The OSI PI Distributor will attempt to recover all data samples between the current time and the last known write time, up to a maximum number of hours configured for the distributor. New distribution resumes only after the previous data has been recovered.

      The default recovery time available is 4 hours. You can disable recovery mode by setting the Maximum Recovery Time to 0 hours.

  6. Configure the default distribution options.
    1. Click on the Tags tab.
    2. Enter a prefix to add to OSI PI tags in Historian. For example, PI_
    3. Enter a value for the Collection Interval. The default collection interval is 1 second.
  7. Configure the distributor's advanced settings.
    To delay distribution when the distributor starts up, enter a value into the Delay Collection at Startup (sec) field.