Configuring the Gateway

Network Communication Bridge/Interface Modules are the communication links between OI Gateway and its supported Data Sources (OPC Server, Application Server, InTouch, DDE/SuiteLink, and OPC UA). You must create these links within the OI Server Manager hierarchy to bridge/route control and information data between different networks to target data sources.

Important: To run OI Gateway as a service, right-click OI Gateway name (OI.Gateway.1) under OI Server Manager and select Configure As Service from the shortcut menu. You can configure it as an auto service or manual service. (For more information about configuring as a service see the Activation/Deactivation/ Service Component of the OI Server Manager documentation.) OI Gateway must be run as a service if you are using a DDE/SuiteLink client.

OI Gateway is hosted by the OI Server Manager, a Microsoft Management Console (MMC) snap-in, which is part of the ArchestrA System Management Console (SMC) suite of utilities. Many high-level functions and user-interface elements of the OI Server Manager are universal to numerous products created with the ArchestrA DAS Toolkit. Only the documentation for the OI Server Manager contains descriptions of those universal functions/UI elements. Therefore, reading the documentation for both the MMC and the OI Server Manager is critical to understanding this user’s guide. To read the documentation about the MMC and OI Server Manager, click the Help command on the SMC’s Action menu. Both the MMC’s help and the OI Server Manager’s help are displayed. An Adobe Acrobat version of the OI Server Manager documentation (filename: OIServerManager.pdf) is also available in the CD-ROM folder \User Docs\English.

Note: The shortcut menu items described in this document typically represent only a subset of any actual shortcut menu. Most items in each shortcut menu are standard Microsoft Windows or MMC-specific commands. For more information about those commands, please see MMC help.

To prepare OI Gateway

1. Install OI Gateway by double-clicking the Setup-OI-Gateway.msi file.

2. Start the System Management Console. by clicking Start, pointing to Programs and then Wonderware, and then clicking System Management Console.

3. From the System Management Console, find the Operations Integration Server Manager and then OI Gateway below in the hierarchy tree.

   • Click on Default Group, then the Local node.

   • Under the Local node, find Operations Integration Supervisory Servers, then Wonderware - Gateway, then OI.Gateway.1.

   • See the OI Server Manager documentation for general information about working in this snap-in environment.

     Important: Selecting the Configuration object of the hierarchy tree displays the Global Parameters configuration view for OI Gateway. The default Poke Mode settings for OI Gateway is Optimization mode. If you intend to put more than 5,000 items on advise, we recommend that you set Transaction Message Timeout to 120 seconds. Configure all other global parameters as required. For more information about the Global Parameters configuration view, including descriptions of the different Poke Modes, see the OI Server Manager documentation. Global parameters that appear dimmed are either not supported or cannot be configured in OI Gateway. Simulation Mode is not supported.

4. Before activating OI Gateway for connection, you must first build and configure a hierarchy of one or more data sources to establish communications between sources and clients.

   Note: For step-by-step procedures on how to build and configure this hierarchy, please see OI Gateway Data Source Hierarchy.

5. You may create desired groups and topics for each data source by:

   • Navigating to a data source object in the OI Server Manager tree view.

   • Right-clicking the object and selecting the group/topic object provided. Each data source has only one type of group or topic object that can be added to the hierarchy.

   • Configure the group or topic.

6. Finally, you may create desired device items for each group or topic by:

   • Selecting the group or topic object.

   • Clicking the Device Items tab.

   • Right-clicking anywhere in the Device Items configuration view and clicking Add from the shortcut menu.

     Important: For step-by-step procedures on configuring Device Items, please see Configuring Device Item Definitions.

     Note: When you are viewing the configuration hierarchy of OI Gateway and someone views the same OI Gateway in another instance of the OI Server Manager, the second instance is displayed in read-only mode. To gain configuration access in this second instance, you must close the first instance of the OI Server Manager (or just remove focus from OI Gateway hierarchy) and then toggle focus away from and then on OI Gateway hierarchy of the second instance.

OI Gateway is now ready for use. In order to use it, you must activate it. The following rules apply:

• If you are using an OPC Client, OI Gateway can be auto-started.

• If you are using DDE/SuiteLink, you must start OI Gateway either as a manual or automatic service.

• To activate OI Gateway, right-click OI.Gateway.1 and click Activate Server on the shortcut menu.