STANDARD MICROSYSTEMS CORPORATION PC AGENT/SNMP For EtherCard PLUS Family LAN adapters and TokenCard EliteSeries LAN adapters INSTALLATION GUIDE This software is licensed by SMC for use by its customers only. Copyright (c) 1992 Standard Microsystems Corporation. All rights reserved. INTRODUCTION ------------ The PC AGENT/SNMP is a TSR(Terminate but Stay Resident program) which allows the targeted PC workstation to be remotely managed by a SNMP manager station(e.g a work station running SMC/EliteView) on the network through SNMP(Simple Network Management Protocol). The PC AGENT/SNMP collects and maintains system and statistic information about the PC. The SNMP manager can set and retrieve these information from the PC station with PC AGENT/SNMP loaded. SYSTEM REQUIREMENTS ------------------- The PC AGENT/SNMP can run on any XT/AT, EISA, or Micro Channel PC. An MSDOS or PCDOS operating system is required, version 3.1 or above. An agent-compatible network driver must be resident in memory. The SMC network drivers that are compatible with the PC AGENT/SNMP are : NDIS Token_Ring driver - SMC8100.DOS (ver 1.00m and above) NDIS Ethernet driver - SMCMAC.DOS (ver2.00n and above) ODI Token_Ring driver - SMC8100.COM (ver 1.03 and above) ODI Ethernet driver - SMC8000.COM (ver 3.03 and above) IPX driver - IPX.COM (ver 1.00ab and above) The PC AGENT/SNMP TSR will occupy approximately 24K bytes and can be loaded into either high or low memory. An IP address must be available if the agent needs to communicate with SNMP network management stations using TCP/IP protocol. The PC AGENT/SNMP does not require any network operating system or protocol stack to be loaded. INSTALLATION PROCEDURE ---------------------- To load PC AGENT/SNMP, type PCAGENT [configuration file] The parameters in [] are optional. A configuration file can be specified for the PC AGENT/SNMP. For details, see CONFIGURATION FILE CONTENTS. The PC AGENT/SNMP consists of a single executable file, PCAGENT.EXE. It can be executed at any time once an appropriate IPX, ODI or NDIS driver is in memory. For example, the following lines in AUTOEXEC.BAT would be adequate to load the SMC Ethernet ODI driver(SMC8000) and PC AGENT/SNMP with PCDATA.CFG as the configuration file: LSL SMC8000 PCAGENT PCDATA.CFG The following lines in AUTOEXEC.BAT would be adequate to load the SMC Token Ring ODI driver(SMC8100) and PC AGENT/SNMP: LSL SMC8100 PCAGENT PCDATA.CFG The following lines in CONFIG.SYS and AUTOEXEC.BAT would be adequate to load a Token Ring NDIS driver and PC AGENT/SNMP: In CONFIG.SYS: DEVICE=C:\NDIS\PROTOCOL.DOS /I:C:\NDIS DEVICE=C:\NDIS\SMC8100.DOS In AUTOEXEC.BAT : NETBIND PCAGENT PCDATA.CFG Note that PC AGENT/SNMP may be executed immediately after the driver is loaded, as in the examples above, or at any later time. It may be convenient to have the PC AGENT/SNMP configuration files for the various PCs on a network server where they are controlled by a network administrator. In this case, for example in a NetWare environment, the network administrator has allocated an user area on network drive F: for the various users' configuration files; the following lines might be in user Kathy's AUTOEXEC.BAT file: LSL SMC8000 IPXODI NETX LOGIN PCAGENT F:\USERS\AGTSTUFF\KATHY.CFG CONFIGURATION FILE CONTENTS --------------------------- The PC AGENT/SNMP maintains a data base of configuration and statistical information in its RAM space. The agent itself discovers or otherwise controls most of the data. A few pieces of configuration information are assigned by the owner of the PC or by the network administrator, such as the name of the person who uses the PC and its location. The configuration file is the mechanism by which these data are given to the agent. Each line in the configuration file specifies the default value of a configuration entry. These data are mostly optional. If they aren't supplied to the agent, it won't supply them to network management workstations who query. One item, the IP address of the agent (smcDosWsIpAdr), must be given if the agent has to be addressed across the cable by network management stations which use TCP/IP protocol. When PC AGENT/SNMP is executed, it first examines its PC, initializing its data base accordingly. After that, if the operator has given it a configuration file to look at, it reads the configuration file data, initializes those uninitialized data in its data base and in some cases, overwrites initialized data in the data base. For example, the agent may initialize its description of display type to "EGA/VGA" (generic and non-descript) which the installer, via the configuration file, might replace with "ATI VGA Wonder w/512KB" to be more specific. The syntax of lines in the configuration file is very simple: DataItemName = DataItemValue where DataItemName is a data variable name and DataItemValue is the value the variable should have. Data variable names which can be set in the configuration file are listed below. Variable names are case sensitive. An example of a possible configuration file might be: ComStr = mypassword => Read/write password for SNMP sysName = Sally Jones => Person who uses the PC smcDosWsIpAdr = 129.254.2.3 => IP address of PC AGENT/SNMP sysLocation = somewhere on earth => Location of PC smcDosWsPcTyp = IBM AT => PC make and model smcDosWsTrapDstAdr.1 = 129.254.2.1 => First IP address to send alerts(traps) to smcDosWsTrapDstPro.1 = 2 => Protocol for alerts (2=TCP/IP) Required data element : This data element is required if the agent has to communicate with SNMP network management stations using TCP/IP protocol. Otherwise, it is only optional. smcDosWsIpAdr This is the IP address for the PC AGENT/SNMP. If the PC also has a TCP/IP stack, the agent may be given the same or a different IP address than the TCP/IP stack. It is often convenient to assign the agent its own IP address to avoid confusion about who is who. Note that the agent must be given its IP address in the configuration file regardless of whether a stack is loaded on the PC with the same IP address. Since TCP/IP stacks vary widely in the way their IP addresses are specified, the agent has no way of discovering the IP address of such a stack. Optional data elements : Data elements which an installer might desire to initialize via the configuration file. ComStr This is the password which SNMP manager uses for read/write operations. sysContact This is usually the person to call for help. It is initialized by the agent with SMC's technical support telephone number in the USA. sysName This is usually the owner/user of the PC. It is not initialized by the agent. sysLocation This is usually the physical location of the PC. It is not initialized by the agent. smcDosWsPcTyp This is the make and model of the PC. It is not initialized by the agent. smcDosWsPcProc This is the processor type and whether there is a co-processor. The agent initializes it according to the processor it discovers on the PC. smcDosWsPcBios This is the BIOS manufacturer and version number. The PC tries to discern this by scanning for copyright notices in the BIOS area. smcDosWsPcVideo This is the type of video adapter on the PC. smcDosWsTrapDstAdr.1 In a TCP/IP network environment, this is the IP address(in decimal) of a network management station to which traps(alerts) should be sent in case an alarm situation occurs. In an IPX network environment, this is the IPX network address(in decimal) of the network management station where traps should be sent. There is a maximum of 3 management stations where traps can be sent(Adr.1, Adr.2, and Adr.3). smcDosWsTrapDstPro.1 This indicates the protocol in which traps should be sent to the network management station with IP address or IPX network address specified by smcDOSWsTrapDstAdr.1 A number is used to specified the protocol used : 2 = TCP/IP(Ethernet & TokenRing) 3 = IPX with Ethernet II frame type(Ethernet ONLY) 4 = IPX with 802.2(LLC) frame type(Ethernet & TokenRing) 5 = IPX with SNAP frame type(Ethernet & TokenRing) 6 = IPX with 802.3 frame type(Ethernet ONLY) smcDosWsTrapDstAdr.2 This is the second IP address or IPX network address of a network management station to which traps (alerts) should be sent in case an alarm situation occurs. smcDosWsTrapDstPro.2 This indicates the protocol in which traps should be sent to the network management station with IP address or IPX network address specified by smcDOSWsTrapDstAdr.2 See smcDosWsTrapDstPro.1 for the number used to specify the protocol. smcDosWsTrapDstAdr.3 This is the third IP address or IPX network address of a network management station to which traps (alerts) should be sent in case an alarm situation occurs. smcDosWsTrapDstPro.3 This indicates the protocol in which traps should be sent to the network management station with IP address or IPX address specified by smcDOSWsTrapDstAdr.3 See smcDosWsTrapDstPro.1 for the number used to specify the protocol. ERROR MESSAGES -------------- PC AGENT/SNMP was not installed. Too many parameters in command line. PC AGENT/SNMP was not installed. Invalid parameter in command line. PC AGENT/SNMP was already installed. PC AGENT/SNMP was not installed. DOS version too old (below 3.10); need DOS 3.10 or above. PC AGENT/SNMP was not installed. Internal error (1) : Call SMC Technical Support. PC AGENT/SNMP was not installed. Internal error (2) : Call SMC Technical Support. PC AGENT/SNMP was not installed. PC AGENT/SNMP compatible network driver was not loaded. PC AGENT/SNMP was not installed. There is no network adapter for the driver. PC AGENT/SNMP was not installed. Unable to open configuration file . WARNING MESSAGES ---------------- PC AGENT/SNMP Configuration file error : invalid MIB variable . Line : < erroneous line in configuration file > PC AGENT/SNMP Configuration file error : invalid IP address . Line : < erroneous line in configuration file > PC AGENT/SNMP Configuration file error : invalid numeric value for MIB variable. Line : < erroneous line in configuration file > PC AGENT/SNMP Configuration file error : MIB variable cannot be set from configuration file. Line : < erroneous line in configuration file > ***************************************************************** Warning: PC AGENT/SNMP was not able to find a free interrupt vector for application trap API. External application programs will not be able to issue traps. ***************************************************************** EtherCard PLUS, TokenCard, and SuperDisk are trademarks, and SMC and Standard Microsystems are registered trademarks of Standard Microsystems Corporation. Other trademarks mentioned herein belong to their respective companies.