Configure Advanced Settings of a System

Before you begin

You can now configure a few advanced settings for the Archiver, Collector, and Data Store to achieve some specific functionality in Historian. You must be careful while modifying the configuration as this might impact the stability and security of the Historian System.

Ensure that you are a member of the iH Security Admins group.

Procedure

  1. Access Configuration Hub.
  2. In the NAVIGATION section, under the Configuration Hub plugin for Historian, select Systems.
    A list of systems appears in the main section.
  3. Right-click the system whose advanced settings you want to configure, and then select Advanced Configuration.
    The advanced settings of the system appear, displaying the Server section by default.
  4. Enter values as described in the following table.
    Note: If you have changed the values of any * marked fields, restart the Historian Data Archiver service. Only then will your changes be reflected.
    Field Description
    ALARM TIMESTAMP CHECK Specify whether you want to speed up, slow down, or disable alarm timestamp checking:
    • 0 - Disabled: Select this option if you want to disable alarm timestamp checking. Only the data is sent to the alarm archiver.
    • 1 - Fast: Select this option if you want to check the timestamp of the alarm data for the last 10 minutes.
    • 2 - Slow: Select this option if you want to check the timestamp of the alarm data beyond the last 10 minutes.
    ALLOW DATA OVERWRITES Switch the toggle to enable or disable overwriting data.
    ARCHIVER MEMORY SIZE Enter the memory usage in MB that you want to allocate to an archive. If you enter 0, Data Archiver will dynamically allocate the memory usage. If Data Archiver is running on a 32-bit operating system, you can allocate upto 1800 MB. If Data Archiver is running on a 64-bit operating system, we recommend that you use the default value.
    BUFER MEMORY MAX Enter the maximum memory buffer size in MB that an archiver queue can use before switching to disk buffer.
    COLLECTOR IDLE TIME (SECONDS) Enter the number of seconds of no data collection after which a collector is considered idle.
    DEBUG MODE Specify whether you want to enable or disable the debug mode. If you enable this option, the debug information is included in the Historian log files, which helps you troubleshoot issues. However, this can result in large size of the log files.
    DISABLE CA HOSTING Enable CA Hosting to continue using the Client Access API based clients when you have converted a Mirror Primary to a standalone server while installing the Historian server.
    DO NOT ZIP ARCHIVES Switch the toggle to store the archive files as .zip files. This will help optimize the storage space of the archive files. However, if you are collecting alarm data as well, the alarm data may not be backed up. Also, you cannot export alarm data to another Data Archiver. Therefore, exercise caution while enabling this option if you are collecting alarm data as well.
    FIREWALL PERMISSION Use this parameter to disable port 14000 in the firewall. By default, Historian installation enables port 14000 in the firewall.
    MAINTAIN AUTO RECOVERY FILE Switch the toggle if you want to back up the archive and configuration files (.iha and .ihc files) every hour. This will prevent data loss. However, these files are used by Historian internally. Also, exercise caution in enabling this option because it can impact Historian performance.
    MAX QUERY TIME (SECONDS) Enter the maximum time in seconds that a query can take to process. After this time limit exceeds, the query is terminated.
    MAXIMUM QUERY INTERVALS Enter the maximum number of samples per tag that Historian can return from a query on non-raw data. You can use this setting to limit the number of query results on non-raw data.
    NUMBER OF READ THREADS Enter the number of read threads to use parallel reading of data. The minimum number you can enter is 8.
    NUMBER OF WRITE THREADS Enter the number of write threads to use parallel writing of data.
    USE ADSI CALLS Switch the toggle to allow Data Archiver to use Active Directory Service Interfaces (ADSI) calls.
  5. Select Save.
  6. Expand Collector, and then select the collector whose settings you want to configure.
    The fields specific to the selected collector appear.
  7. Enter values as described in the following table.
    Field Description
    BUFFER FLUSH MULTIPLIER Select the multiplier to the buffer flow speed while using the store-and-forward feature:
    • 0: Select this option if you want to disable throttling.
    • 1: Select this option if you want normal speed.
    • 2: Select this option if you want the collector to never send data faster than twice the normal speed.
    NUM INTERVALS FLUSH Specify how quickly you want the collector to send data to Data Archiver. The value you enter in this field is multiplied by 100 milliseconds. For example, if you enter 5, the collector sends data to Data Archiver every 500 milliseconds. We recommend that you enter 5.
  8. Select Save.
    A message appears, asking you whether you want to save and restart the collector as well.
  9. If you want to save your changes and restart the collector as well, select Save and Restart. If you want to just save your changes, select Save. In that case, you must restart the collector later for the changes to reflect.
    Your changes are saved. If you have selected Save and Restart, the collector is restarted.
  10. Expand Datastore, and then, select the data store whose settings you want to configure.
    The fields specific to the selected data store appear,
  11. Enter values as described in the following table.
    Field Description
    ALLOW FUTURE DATA Switch the toggle to enable storing future data.
    CREATE OFFLINE ARCHIVES Switch the toggle to create offline archives. This is to avoid receiving an outside-active-hours error. It happens if you attempt to store data when the current archive file is set to read-only.
  12. Select Save.
    The advanced settings are configured for the data store.