OPC/SNMP Agent Manual s Siemens Building Technologies Helping your building work for you.
Table of Contents Table of Contents About This Manual.................................................................................................................................iv Document Organization ......................................................................................................................................iv Document Conventions.......................................................................................................................................
About This Manual About This Manual The OPC/SNMP Agent Manual provides information for installing and configuring the OPC/SNMP Agent—the OPC/SNMP Solution for Insight. Document Organization The OPC/SNMP Agent Manual consists of the following chapters: Chapter 1 – About the OPC/SNMP Agent Provides descriptions of SNMP, the OPC/SNMP Agent, system components, and system requirements.
Chapter 1 – About the OPC/SNMP Agent Chapter 1 – About the OPC/SNMP Agent Chapter 1 contains the following topics: • What is SNMP? • What is the OPC/SNMP Agent? • System Components • System Requirements What is SNMP? Simple Network Management Protocol (SNMP) is a standard protocol that enables information exchange between devices on a TCP/IP network. What is the OPC/SNMP Agent? The OPC/SNMP Agent receives Insight OPCServer information and makes it available via SNMP.
Chapter 1 – About the OPC/SNMP Agent System Components Accessing Insight point information via SNMP requires Insight with the OPCServer Option, the OPC/SNMP Agent, an SNMP manager, and a Management Information Base (MIB). Figure 1 shows the connections between each system component. Figure 1. System Components. Insight OPCServer Using Insight with the OPCServer Option, you define the Insight points that you want to access via SNMP.
Chapter 1 – About the OPC/SNMP Agent SNMP Manager and MIB To access Insight point information via SNMP, a computer must have an SNMP manager and a Management Information Base (MIB) file. The SNMP manager uses an MIB to interpret the information received from the OPC/SNMP Agent. An MIB file contains group, variable, and trap information that correlates to Insight point definitions and alarm settings.
Chapter 1 – About the OPC/SNMP Agent 8 Siemens Building Technologies, Inc.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent Chapter 2 – Installing and Configuring the OPC/SNMP Agent Chapter 2 contains the following topics: • Before You Install the OPC/SNMP Agent • Getting IP Addresses • Setting Up SNMP Services • Installing the OPC/SNMP Agent • Requesting a License • Setting Up the SNMP Database • Setting Up the OPC Engineering Tool • Setting Up the SNMP Engineering Tool Before You Install the OPC/SNMP Agent Before you install the OPC/SNMP Agent, install
Chapter 2 – Installing and Configuring the OPC/SNMP Agent Setting Up SNMP Services To set up the SNMP services on the Insight workstation, do the following steps: 1. Click Start, Settings, Control Panel, and Add/Remove Programs. 2. In the Add/Remove Programs window, click Add/Remove Windows Components. The Windows Components Wizard is displayed. 3. In the Components box, select Management and Monitoring Tools, and then click Details. 4.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent Installing the OPC/SNMP Agent The OPC/SNMP Agent must be installed on the Insight workstation with the OPCServer. It is recommended that you create desktop shortcuts for the engineering tools to make them easy to start. To install the OPC/SNMP Agent, do the following steps: 1. Log on to the Insight workstation using a user account with Administrator privileges. 2. Unzip ZIPCD.zip to the root directory.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent Setting Up the SNMP Database An SNMP database must be created to link Insight OPCServer and MIB information. To set up the SNMP database, do the following steps: 1. Click Start, Settings, Control Panel, Administrative Tools, and Data Sources (ODBC). The ODBC Data Source Administrator dialog box is displayed. 2. Click the System DSN tab, and then click Add. 3.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent 5. In the top-left pane, right-click Insight OPCServerDA.1, and then click Add Group. 6. In the Group Definition dialog box, just click OK. A group, with the default name of Group1, is added and is displayed in the top-left pane. 7. Right-click the new group (Group1), and then click Add Item. 8. In the Add Item dialog box, do the following: a. Click Find now. The points in the Insight OPCServer database are listed.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent 11. On the Add menu, click Add Group. 12. In the Add Group dialog box, do the following: a. In the Group Name box, type a name for the group. b. In the Update Rate box, type a number of milliseconds. It is recommended to use 100. c. In the Percent Deadband box, leave 0. d. Select the Set Active check box. e. Click OK. You cannot modify a vendor or group once it is created.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent Setting Up the SNMP Engineering Tool The SNMP Engineering Tool is used to define the information accessed via SNMP. To set up the SNMP Engineering Tool, you do the following: • Enter general settings for the SNMP Engineering Tool • Add MIB references Entering General Settings for the SNMP Engineering Tool To enter general settings, do the following steps: 1. Start the SNMP Engineering Tool (SNMPEngTool.exe). The SNMPEngTool window is displayed.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent Adding MIB References In the SNMP Engineering Tool, you create MIB references to link OPCServer point information to information in an MIB. You will need to refer to the MIB file thoughout this procedure. To add MIB references, do the following steps: 1. Open the MIB file in Microsoft WordPad or other text editor, and find the group information (see Figure 2). 2. In the top-left pane of the SNMPEngTool window, click the top node. 3.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent 6. Find a variable in the MIB file, and then determine its group (see Group Name in Figure 3). 7. In the top-left pane of the SNMPEngTool window, click the group (branch), and then click Add Variable from the MIB menu. 8. In the New Mib Variable dialog box, do the following: a. In the OID box, type the variable’s object identification number. b. In the Point Type box, select the appropriate type. c.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent 10. On the MIB menu, click Add Trap. 11. In the Trap dialog box, do the following: a. In the Trap Enterprise ID box, type the trap enterprise identification number. Each trap is associated with a variable. A trap’s Enterprise ID is the same number as the associated variable’s OID. b. In the Trap Name box, type the trap name. c. From the Monitoring Variable list, select the name of the associated variable.
Chapter 2 – Installing and Configuring the OPC/SNMP Agent 12. In the MIB, find the information for the associated variable, and then identify the Send Trap When information. Figure 5. Example of Trap Information Provided with Variable Information. 13. In the Trap dialog box, click Set Trap Conditions. 14. In the Build Condition for Trap dialog box, enter the information to describe trap conditions, and then click OK. For example, [FROM] = 0 OR = 1 [TO] = 1 OR = 0 15.
Siemens Building Technologies Inc. 1000 Deerfield Parkway Buffalo Grove, IL. 60089-4513 U.S.A. 1-847-215-1000 www.sbt.siemens.com © 2003 Siemens Building Technologies, Inc. Printed in the U.S.A.