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 <file name>.
WARNING MESSAGES
----------------
PC AGENT/SNMP Configuration file error :
invalid MIB variable <name>.
Line : < erroneous line in configuration file >
PC AGENT/SNMP Configuration file error :
invalid IP address <the 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 <name> 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.
