Cisco Metro 1500 Software Configuration Guide
File Reference

Table of Contents

File Reference

File Reference

This appendix describes the following files, which are used in the Cisco Metro 1500 series environment.

hosts

This file lists all hosts known to Windows 95/98/NT.

Example
# Copyright (c) 1998 Microsoft Corp.
#
# This is a sample HOSTS file used by Microsoft TCP/IP stack for
# Windows98
#
# This file contains the mappings of IP addresses to host names. Each
# entry should be kept on an individual line. The IP address should
# be placed in the first column followed by the corresponding host 
# name.
# The IP address and the host name should be separated by at least one
# space.
#
# Additionally, comments (such as these) may be inserted on individual
# lines or following the machine name denoted by a '#' symbol.
#
# For example:
#
# 102.54.94.97 rhino.acme.com
# source server
# 38.25.63.10 x.acme.com
# x client host
127.0.0.1 localhost
169.254.178.200 home.colt
169.254.178.41 home.christine christine

snmpd.conf

This file is a configuration file for cmu snmpd.

/etc/snmpd.conf is read on startup by snmpd. The file has two parts. The first part is related to the view, user, and community configuration for snmp v2-usec. The second part is for the Linux port and allows the setting of additional configuration items.

The Linux-specific part consists of lines containing a key followed by a colon (:) and a value. Lines beginning with a number sign (#) and empty lines are ignored. Table B-1 lists the recognized key and value pairs.


Table B-1: Descriptions of snmpd.conf Keywords
Keyword Description

port

The port to open and listen to; default is port 161.

system contact

Return string for a system.sysContact request; default is unknown. This is set by an snmp set-request and saved.

system location

Return string for a system.sysLocation request; default is unknown. This is set by an snmp set-request and saved.

system name

Return string for a system.sysName request; default is the hostname. This is set by an snmp set-request and saved.

interface

The value must have three fields:

  • A string naming the interface.

  • An integer describing the type of interface (that is, RFC 1213).

  • An integer describing the speed of the interface.

Multiple entries are possible.



Example

This is an example snmpd.conf file:

## /etc/snmpd.conf:
##
## view configuration
##
## viewName OID included/excluded
##
## internet
view all .1.3.6.1 included
## internet
view mini .1.3.6.1 included
## for v1 public exclude exclude mib-2.ident.identInfo
## and mib-2.host.hrSWRun in the mini view:
view xmini .1.3.6.1 included
view xmini .1.3.6.1.2.1.24.1 excluded
view xmini .1.3.6.1.2.1.25.4 excluded
## system, snmp, usecAgent, usecStats
view semi .1.3.6.1.2.1.1 included
view semi .1.3.6.1.2.1.11 included
view semi .1.3.6.1.6.3.6.1.1 included
view semi .1.3.6.1.6.3.6.1.2 included
## snmp, usecAgent, usecStats
view semi .1.3.6.1.2.1.11 included
view semi .1.3.6.1.6.3.6.1.1 included
view semi .1.3.6.1.6.3.6.1.2 included
##
## user configuration
##
## noneRV noneWV authRV authWV userName[/authKey]
##
u s e r m i n i - a l l a l l p u b l 
ic/0x05a1483bb7a0b314cc5cf9d27aee2a89
##
## community configuration
##
## commName readV writeV
##
community public xmini -
community private mini mini
##
## now follows the specific section of the linux-port.
##
##
## port to use (default is 161):
##
# port: 161
##
## the entry of system.Contact and system.Location:
##
system contact: name
system location: location
## system name is per default determined from the
hostname:
# system name: chappell
##
## type and speed of interfaces:
##
interface: lo0 24 20000000
interface: eth0 6 10000000
interface: sl0 28 38400
interface: sl1 28 38400
interface: sl2 28 38400
interface: sl3 28 38400
interface: ppp0 23 38400
interface: ppp1 23 38400
interface: ppp2 23 38400
interface: ppp3 23 38400
## end of /etc/snmpd.conf
Caveats

There is currently no documentation for the user-specific part of this file.

snmptrapd.conf

This file is a configuration file for the event manager snmptrapd.

snmptrapd.conf is the configuration file for the event manager. It is located in /etc/. After starting snmptrapd, immediately after powering on, the configuration file is read.

Use an editor or snmpconfig to modify snmptrapd.conf. Changes in snmptrapd.conf are only valid after restarting the event manager. Comment lines start with a number sign (#). Tokens start with a space or tab. The first section describes the different event logging mechanisms:

  • LogFlash is the keyword for the permanent log file.

  • LogRAM is the keyword for the temporary log file.

  • TrapSink is the keyword for the external SNMP managers.

The second section lists all known events.

You can define a priority for every event, where 1 is high and 10 is low. An event is logged if it is of an equal or higher priority than the priority of the logging mechanism.

For example, by default, the ColdStart has a priority of 1, which means "very high." This event is always logged. An event with priority 4 is only logged if the logging mechanism has priority 4 or less.

Table B-2 describes snmpdtrapd.com keywords.


Table B-2: Description of snmptrapd.com Keywords
Keyword Description

LogFlash

Permanent log file, sets the priority and the maximum file size. Format: LogFlash priority, size in bytes.

LogRAM

Temporary log file, sets the priority and the maximum file size. Format: LogRAM priority, size in bytes.

TrapSink

IP addresses of external SNMP managers, up to 10 addresses can be used (09). Format: TrapSink number, priority, community IP address.

Generic

Generic traps, the generic traps are defined in RFC 1067.
Format: Generic number, priority, comment.

Enterprise

Cisco specific traps. Format: Enterprise number, priority, comment.



Example
# Configuration File
# /etc/snmptrapd.conf
# last change: Mon Oct 26 19:44:36 1998
# This file is used to set the configuration for logging on
# Flash Disk, RAM Disk and external System via Traps
# Log Levels for Flash Disk and RAM Disk
LogFlash 1 1000
LogRAM 10 32768
# Trap Sink addresses
TrapSink 0 5 public 192.168.100.44
# Generic Traps
Generic 0 1 ColdStart
Generic 1 10 WarmStart
Generic 2 10 IFDown
Generic 3 10 IFUp
Generic 4 10 InvalidCommunity
Generic 5 10 EGPdown
# Enterprises Traps
Enterprise 1 4 passwordFail
Enterprise 2 4 switchWarning
Enterprise 3 4 switchLOS
Enterprise 4 4 switchErrorLock
Enterprise 5 4 switchBackupLineFail
Enterprise 6 4 switchChangedLine
Enterprise 7 4 snmpFail
Enterprise 8 4 chanFail
Enterprise 9 4 chanLasLocCurrOOR
Enterprise 10 4 chanLasRemCurrOOR
Enterprise 11 4 chanTempOOR
Enterprise 12 4 chanClockrecFail
Enterprise 13 4 chanCommunicationWar
Enterprise 14 4 chanRecremLOS

Enterprise 15 4 chanReclocLOS
Enterprise 16 4 fanFail
Enterprise 17 4 edfaFail
Enterprise 18 4 psFail
Enterprise 19 4 psOK
Enterprise 20 4 chanRecremNoLOS
Enterprise 21 4 chanReclocNoLOS
Enterprise 22 4 chanHardwareAdd
Enterprise 23 4 chanHardwareDel
Enterprise 24 4 chanClockrecNoFail
See Also

snmpconfig, RFC 1065, RFC 1066, RFC 1067

Caveats

Not all traps are supported.