Node Setup and Redundancy

The Hyper Historian installation initializes the Node Setup and Redundancy configuration. Its default settings are for a non-redundant single workstation setup (that is, a non-redundant Hyper Historian Logger with one local Collector).

 

The Node Setup and Redundancy configuration forms are used to perform any of the following changes:

NOTE: For additional information about Remote Collectors, refer to the Remote Collectors topic. For information about redundancy for OPC UA servers, refer to the Redundancy Setup Options in Hyper Historian topic.

Collector

To Configure Redundancy and Store-and-Forward Options for a Collector:

  1. Start the Workbench, then expand your project. Next, expand the Historical Data node to show the Hyper Historian node. Expand the Hyper Historian node to show the Node Setup and Redundancy node.

  2. Right-click Node Setup and Redundancy in the navigation tree and select Add Collector, as shown below, or double-click an existing collector to edit it.

Add Collector from Project Explorer

 

-OR-

 

Select Node Setup and Redundancy, then click on the Add Collector button, shown below, in the Edit section of the Home ribbon in the Workbench.

 

Add Collector Button

  1. The Hyper Historian Collector Form appears. Enter a name for the collector in the Hyper Historian Collector Name text entry field.

    Hyper Historian Collector Form - Properties Tab

General

  1. Ensure that the Enabled check box is checked.

  2. Enter a Collector Instance Name in the following text entry field.

  3. Enter a Description, making it informative enough so that anyone maintaining the collector will understand its use.

Collectors

  1. Next, you select either In-Process Collector (to run the "local" collector) or Standalone Collector (to run the "remote" collector). Click the radio button next to your desired choice.

Note: Hyper Historian will not run with Standalone/Remote Collectors if used with a Standard License. Only users with an Enterprise License can use this type of collector.

  1. If you selected In-Process Collector, the local collector is used. If you selected Standalone Collector, you must do the following:

    1. Use the Protocol drop-down list to select from Http Direct, Tcp Direct, Http over FrameWorX, Tcp over FrameWorX, Https over FrameWorX, WSHttps over FrameWorX, or Use Local FrameWorX as Mediator.

Primary Node

  1. Enter a Name for the Primary Node or select one from the drop-down list. The URL field is pre-filled from your primary node selection.

Secondary Node

  1. You now have the option to click the Enable Redundancy check box within to Secondary Node to identify a backup node in case the primary node becomes unavailable. The following steps assume you have proceeded with configuring a backup node.

  2. Enter a Name for the Secondary Node or select one from the drop-down list. The URL field is pre-filled from your backup node selection. (Alternatively, you can use the Advanced Configuration option at the bottom of the form to manually enter the URLs of the primary and secondary nodes.)

  3. Click the check box next to Auto Fail-back if you want Hyper Historian to automatically switch from the backup (secondary) node to the primary node when the primary node becomes active again.

Heartbeat

  1. Click the Enable Heartbeat checkbox to enable a heartbeat for the given collector.

  2. Enter a data point for the heartbeat in the Data Point text entry field or click on the button to open the data browser to navigate to your selected data point.

  3. In the Period text entry field, enter the heartbeat period for failure detection (in seconds).

  4. In the Recovery Period text entry field, enter the period for the recovery after heartbeat failure (in seconds).

Advanced Configuration

  1. Click the checkbox next to Use Advanced Configuration to manually specify node URLs (and allow further configuration). You can then specify the primary node URL in the Primary Node URL text entry field. If you clicked the Enable Redundancy checkbox in the Secondary Node section, you can also specify the secondary node URL in the Secondary Node URL text entry field.

Compression

  1. The Compress Data pulldown menu sets the type of compression of data packages sent from data collector to data logger. This compression can reduce network traffic between these components. None = no compression. Fast = Fast compression using the Deflate algorithm. Optimal = Optimal compression using the Deflate algorithm.

  2. The Compress Configuration pulldown menu sets the type of compression of the configuration data sent from logger to collector. None = no compression. Fast = Fast compression using the Deflate algorithm. Optimal = Optimal compression using the Deflate algorithm.

Advanced Configuration Cache

  1. Click the check box next to Use Advanced Configuration Cache to manually specify the location of the configuration cache (and allow further configuration). Configuration cache location can be specified separately for the primary and secondary nodes, if needed. To specify primary cache location other than the default, enter it in the Primary Cache Location text entry field or click on the button to open the Browse files or folders window to navigate to your desired location. If you clicked the Enable Redundancy checkbox in the Secondary Node section, you can also specify the location of the configuration cache on the secondary node in the Secondary Cache Location text entry field or click on the button to open the Browse files or folders window to navigate to your desired location.

Store and Forward Tab

  1. Go to the Store and Forward tab. The Store and Forward feature caches data if the connection to a collector is lost. When the connection to the collector is restored, the cache will be flushed, and the two (primary and secondary) databases will be automatically synchronized.

    Hyper Historian Collector Properties - Store and Forward Tab

     

  2. Enter your Store and Forward settings, which are:

General

Primary Node Buffer Storage Location

Secondary Node Buffer Storage Location

  1. Click the Apply button to save your changes.

Note that, alternatively, you can import collector node configuration information from an Excel spreadsheet, an XML file, or a CSV file. For more information, refer to the Importing and Exporting Hyper Historian Configurations topic. Once imported, you can edit imported information as needed.

Logging Server

To Configure Redundancy and Store-and-Forward Options for the Local Logging Server:

  1. Start the Workbench, then expand your project. Next, expand the Historical Data node to show the Hyper Historian node. Expand the Hyper Historian node to show the Node Setup and Redundancy node.

  2. Expand the Node Setup and Redundancy node. Right-click the Local Logger Server node in the navigation tree and select Edit or Edit on a new tab, as shown below.

Edit Local Logging Server from Project Explorer

 

-OR-

 

Select the Local Logging Server, then click on the Edit button, shown below, in the Edit section of the Home ribbon in the Workbench.

 

Edit Button

 
This opens the Local Logging Server properties, as shown below.

 

Local Logging Server Properties

General

  1. Ensure the Enabled check box is checked.

  2. Optionally, to make the server's historical data read-only, put a check mark in the Disable HDA Editing check box. If you do this, you won't be able to edit any Historical data being logged on the server using any programmatic interfaces.

  3. Enter the optional Description, if desired.

Redundancy

  1. To use redundancy, click the check mark next to Enable Redundancy to enable it, and follow these steps:

  1. Use the Protocol drop-down list to select from Http Direct, Tcp Direct, Http over FrameWorX, Tcp over FrameWorX, Https over FrameWorX, WSHttps over FrameWorX, or Use Local FrameWorX as Mediator.

Primary Node

  1. Enter a Name for the Primary Node or select one from the drop-down list. The URL field is pre-filled from your primary node selection.

Secondary Node

  1. You now have the option to click the Enable Redundancy check box within to Secondary Node to identify a backup node in case the primary node becomes unavailable. The following steps assume you have proceeded with configuring a backup node.

  2. Enter a Name for the Secondary Node or select one from the drop-down list. The URL field is pre-filled from your backup node selection. (Alternatively, you can use the Advanced Configuration option at the bottom of the form to manually enter the URLs of the primary and secondary nodes.)

  3. Click the check box next to Auto Fail-back if you want Hyper Historian to automatically switch from the backup (secondary) node to the primary node when the primary node becomes active again.

Advanced Configuration

  1. Click the checkbox next to Use Advanced Configuration to manually specify node URLs (and allow further configuration). You can then specify the primary node URL in the Primary Node URL text entry field. If you clicked the Enable Redundancy checkbox in the Secondary Node section, you can also specify the secondary node URL in the Secondary Node URL text entry field.

Compression

  1. The Compress Data pulldown menu sets the type of compression of the data packages sent to peer logger. As such, it can reduce network traffic between redundant loggers. None = no compression. Fast = Fast compression using the Deflate algorithm. Optimal = Optimal compression using the Deflate algorithm.

Advanced Configuration Cache

  1. Click the check box next to Use Advanced Configuration Cache to manually specify the location of the configuration cache (and allow further configuration). You can specify the location of the configuration cache on the primary node by entering it in the Primary Cache Location text entry field or click on the button to open the Browse files or folders window to navigate to your desired location. If you clicked the Enable Redundancy checkbox in the Secondary Node section, you can also specify the location of the configuration cache on the secondary node in the Secondary Cache Location text entry field or click on the button to open the Browse files or folders window to navigate to your desired location.

Store and Forward Tab

  1. When redundancy is enabled, Store and Forward buffer can be configured in the Store and Forward tab. The Store and Forward buffer feature stores data packages until these are safely stored by connected peer server. When the connection to the peer logger node is restored, the buffer will be flushed, and the primary and secondary logger nodes will be automatically synchronized.

Hyper Historian Local Logging Server Properties - Store and Forward Tab

  1. Enter your Store and Forward settings, which are:

General

Primary Node Buffer Storage Location

Secondary Node Buffer Storage Location

[Click HERE for more info on Store and Forward settings.]

  1. Click the Apply button to save your changes.

Note that, alternatively, you can import logging server configuration information from an Excel spreadsheet, an XML file, or a CSV file. For more information, refer to the Importing and Exporting Hyper Historian Configurations topic. Once imported, you can edit imported information as needed.

 

See Also:

Welcome to Hyper Historian