Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AVEVA™ Historian

aaIODriverInsert

  • Last UpdatedMar 10, 2025
  • 4 minute read

Inserts an IDAS.

Syntax

aaIODriverInsert StorageNodeKey, ComputerName, StoreForwardMode, StoreForwardPath, MinMBThreshold, AltComputerName, Enabled, StoreForwardDuration, AutonomousStartupTimeout, BufferCount, FileChunkSize, ForwardingDelay, ConnectionTimeout

where:

Argument

Description

StorageNodeKey

The unique numerical identifier for the storage node. This value is of data type int, with a default of 1.

ComputerName

The name of the computer on which the IDAS runs. This value is of data type nvarchar(255), with a default of the name of the local server running Microsoft SQL Server.

StoreForwardMode

Used to specify whether or not store-and-forward capability is enabled. If enabled, and the network connection between the IDAS and the storage node fails, data will be "buffered" to the location specified by the store-and-forward path. Valid values are:

= Disabled

1 = Enabled

2 = Autonomous

The Autonomous mode (2) is an extension of the normal store-and-forward mode (1). It allows the IDAS to start up using an IDAS configuration file and collect data in store-and-forward mode if the network connection to the AVEVA Historian is not available. This value is of data type tinyint, with a default of 0.

StoreForwardPath

Used to specify the path for the IDAS data buffer on the local hard drive of the IDAS computer. The path should be absolute (for example, c:\IDASBuffer). Data is written to this path until the minimum threshold for the buffer is reached. Remote buffer paths are not supported. When the store-and-forward path specified for the IDAS is invalid, the default path picked by the system is: <public folder>\ArchestrA\Historian\IDAS\SF where the <public folder> is dependent on the operating system. For example, for the Windows 2008 operating system, the path is C:\ProgramData\ArchestrA\Historian\IDAS\SF. When the store-and-forward path specified for the IDAS is just a folder name (without any path characters like \ and :), the default path picked by the system is: <Windows system path>\<folder name specified by the user>. For example, for the Windows Server 2008 32-bit operating system, the path is C:\WINDOWS\system32\<folder name>. This value is of data type nvarchar(255), with a default of an empty string.

MinMBThreshold

The minimum amount of free disk space, in megabytes, at which IDAS stops collecting data in the store-and-forward buffer. This value is of data type int, with a default of 16.

AltComputerName

The name of the computer on which an optional, redundant IDAS runs. You must use the fully qualified name of the computer. You could also use the IP address. This should be set to an empty string if no redundant IDAS is specified. Make sure that the IDAS software is installed on the target failover computer. If the failure of the primary IDAS is detected by the system, the failover IDAS is automatically started. The failover IDAS is shut down after the primary IDAS is back online. This value is of data type nvarchar(255), with a default of an empty string.

Enabled

Used to specify whether the IDAS is enabled or not.

0 = Not enabled

1 = Enabled

Disabling the IDAS allows for the configuration to be retained in the database, even though the IDAS is removed from the system. This value is of data type bit, with a default of 1.

StoreForwardDuration

The minimum duration, in seconds, for the IDAS to function in store-and-forward mode. The IDAS functions in store-and-forward mode for this length of time even if the condition that caused IDAS to function in store-and-forward mode no longer exists. The maximum duration is 3600 seconds, and the minimum is 0 seconds. This value is of data type int, with a default of 180.

AutonomousStartupTimeout

The amount of time, in seconds, that the autonomous IDAS should wait for configuration commands when started by the Configuration service before going to the autonomous mode. This timeout may need to be increased only if you have a large number of IDASs configured as autonomous on a slow network. This value is of data type int, with a default of 60.

BufferCount

The number of 64 KB buffers pre-allocated for buffering data. This number may need to be increased to accommodate high data rates. This value is of data type int, with a default of 128.

FileChunkSize

The size, in bytes, of the data "chunks" that are sent to the historian when store-and-forward data is forwarded. The size of the chunks can be decreased to accommodate slower networks. Decrease this number only if the forwarding delay is greater than zero. This value is of data type int, with a default of 65536.

ForwardingDelay

The interval, in milliseconds, at which "chunks" of store-and-forward data are forwarded to the historian. The length of the interval may need to be increased to accommodate slower networks. This value is of data type int, with a default of 0.

ConnectionTimeout

The amount of time, in seconds, that the Configuration service attempts to communicate with an IDAS for configuration/reconfiguration. If this timeout elapses, the Configuration service assumes that the IDAS connection has been dropped. This number may need to be increased to accommodate slower networks. This value is of data type int, with a default of 30.

Permission

Execute permission defaults to the aaPowerUsers and aaAdministrators groups.

In This Topic
Related Links
TitleResults for “How to create a CRG?”Also Available in