Configuring an ArchestrA Data Source Object

o add an ArchestrA data source object to your OI Gateway hierarchy

1. Right-click Configuration in the hierarchy, and select Add ArchestrA Object from the shortcut menu.

   • A new object is created in the hierarchy tree and is named New_ArchestrA_000 by default (in "edit mode"). Rename it, if desired. You are allowed to add only one ArchestrA data source.

     The New_ArchestrA_000 Parameters configuration view (right pane) is displayed.

2. Configure the new ArchestrA object according to the following option definitions:

   • Device Group Name – Name of the topic to which DDE or SuiteLink clients of OI Gateway connect in order to access items in the ArchestrA data source.

     Default value is ArchestrA (this cannot be edited).

   • Reconnect Attempts – Number of times OI Gateway attempts to reconnect to the specified data source if a connection fails.

     Default value is 3.

     Minimum/maximum range is -1 to 1,000,000. Entry of a value that is excessively out of the allowed range will display an error message about illegal format.

     The value (-1) means no limit to the number of attempts. The value Zero (0) means no attempts.

   • Reconnect Period – Delay (in ms) between reconnection attempts if a connection fails.

     Default value is 30000 ms. Minimum/maximum range is 10,000 to 300,000 ms (corresponding to the range of 10 sec to 5 min).Entry of a value that is excessively out of the allowed range will display an error message about illegal format.

   • Write Credentials – User credentials created in ArchestrA for write qualifications.

   • Read Only – Check this box to make all items connected through the ArchestrA data source read only. This qualification is in addition to any read-only condition that ArchestrA imposes. Unchecking this box only removes OI Gateway-imposed read-only qualifications. In other words, items inherently read-only in the data source remain so. Default value is checked.

   • Domain – This option, along with User Name and Password, comprise the credentials used to logon to ArchestrA if the Read Only box is unchecked and ArchestrA has security enabled. In such a case, you must enter valid credentials as configured in ArchestrA. Default value is blank.

     Note: The Domain option should have a valid domain name when the ArchestrA security authentication mode is "OS Users" or "OS Groups". This option should be left empty when the ArchestrA security authentication mode is "Galaxy".

   • User Name and Password – This option, along with Domain and Password, comprise the credentials used to logon to ArchestrA if the Read Only box is unchecked and ArchestrA has security enabled. In such a case, you must enter valid credentials as configured in ArchestrA. Default value is blank..

     Note: ArchestrA user login data is not hot-configurable. OI Gateway must be restarted for the new values to take affect.