- Cisco IOS Configuration Fundamentals Command Reference, Release 12.1
Table Of Contents
System Controller and Managed Shelves Commands
show syscon sdp (managed shelf)
show syscon sdp (system controller)
System Controller and Managed Shelves Commands
This chapter describes the commands used to configure a system controller and managed shelves.
For system controller configuration tasks, refer to the "System Management Using System Controllers" chapter in the Cisco IOS Configuration Fundamentals Configuration Guide.
attach shelf
To start a session on a manager dial or router shelf, use the attach shelf EXEC command.
attach shelf shelf-number
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
If you are connected to a system controller, use this command to start a session with a managed shelf. In a session, you can execute commands specifically on the specified shelf.
If you are already connected to a shelf unit, this command disconnects from the current shelf and connects to the specified shelf.
Examples
In the following example, a user connects to a managed shelf from the system controller from user EXEC mode. Notice that the user connects to the shelf at the current user privilege level.
systemcont> show sysconShelf# 2 172.23.66.102 SDB update 09:09:16 PST Jan 27 1998systemcont> attach shelf 2Trying 172.23.66.102 ... Openshelf2> show sysconCurrent uptime 09:10:00 PST Jan 27 1998, system controller 172.23.66.100Last hello packet received at 09:09:16 PST Jan 27 19988625 Total SDP packets0 packets with bad MD5 hash4311 Hello packets received4314 Hello packets sent0 Command packets received0 Command packets sentshelf2> quit[Connection to 172.23.66.102 closed by foreign host]systemcont>Related Commands
execute-on
Allows the executing of commands directly on a line card.
Specifies the system controller for a managed shelf.
Specifies a shelf ID for a managed shelf.
enable (poll-group)
To start data collection for a performance data set, use the enable command in system controller poll-group configuration mode. The no form of this command disables data collection.
enable
no enable
Syntax Description
This command has no arguments or keywords.
Defaults
The system controller does not collect data.
Command Modes
System controller poll-group configuration
Command History
Usage Guidelines
Use the enable command as the last entry in a system contoller poll-group configuration mode sequence to enable data collection for a specific poll group. This command is required for performance data collection. You must also set the transfer mode with the transfer-mode command in order to collect data.
The no form of this command disables data collection, but it does not delete the poll-group configuration. To reenable data collection, reconfigure the enable system controller poll-group configuration command. You do not need to reenter the other poll-group configuration commands.
Examples
The following example configures and enables data collection for the cmlineinfo poll group:
SysCont# configure terminalEnter configuration commands, one per line. End with CNTL/Z.SysCont(config)# syscon poll-group cmlineinfoSysCont(config-poll-gr)# oid cmLineInfo.1.*SysCont(config-poll-gr)# oid cmLineInfo.2.*SysCont(config-poll-gr)# oid cmLineInfo.3.*SysCont(config-poll-gr)# oid cmLineInfo.4.*SysCont(config-poll-gr)# transfer-mode bulkSysCont(config-poll-gr)# enableSysCont(config-poll-gr)# exitSysCont(config)# exitSysCont#Jan 23 17:47:05: %SYS-5-CONFIG_I: Configured from console by consoleRelated Commands
ftp-server enable
To enable the File Transfer Protocol (FTP) server, use the ftp-server enable global configuration command. The no form of this command disables the FTP server.
ftp-server enable
no ftp-server enable
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global configuration
Command History
Usage Guidelines
When the FTP server is enabled, you can use FTP to transfer files to and from the router. For example, you can FTP performance data sets or syslog data subfiles to a network management station.
In order for clients to access files on the FTP server, you must configure both this command and the ftp-server topdir command.
Examples
The following example enables the FTP server and limits client access to the syslogd.dir directory on disk0:
ftp-server enableftp-server topdir disk0:/syslogd.dirRelated Commands
ftp-server topdir
To restrict the region where FTP clients can read or write files, use the ftp-server topdir global configuration command. The no form of this command disables access completely.
ftp-server topdir directory
no ftp-server topdir
Syntax Description
Defaults
Denies read and write access to any location.
Command Modes
Global configuration
Command History
Usage Guidelines
You must specify a top-level directory in order for clients to use the FTP server. If you do not configure this command, clients will not be able to access any files or directories on the router.
You must also configure the ftp-server enable command to enable the FTP server on the router.
Examples
The following example enables the FTP server and limits client access to the syslogd.dir directory on disk0:
ftp-server enableftp-server topdir disk0:/syslogd.dirRelated Commands
logging syslog-server
To create subfiles for syslog-server logging, use the logging syslog-server command in global configuration mode. Use the no form of this command to stop storage of syslog messages in the subfiles.
logging syslog-server size number dir-name
no logging syslog-server
Syntax Description
Defaults
No subfiles are created.
Command Modes
Global configuration
Command History
Usage Guidelines
Use this command to create subfiles to store syslog messages the system controller receives from its managed shelves. The system controller will create subfiles using the name specified with a different extension to differentiate the subfiles. The current subfile is name.cur. The first archived subfile is name.1; the second is name.2. The last (oldest) archived subfile's extension is one less than the maximum number of subfiles.
After the subfiles are created, the system controller will add any syslog messages it receives to the current subfile. If the current subfile is full, all of the subfiles are renamed to use the next (higher) extension and a new current subfile is created.
The no form of this command stops the storage of syslog messages in the subfiles. However, the subfiles are not erased and remain on the disk.
Examples
The following example creates five subfiles. Each subfile has a maximum size of 2000 KB. Thus, the total available size is 10000 KB. The subfiles are named mysyslog.cur, mysyslog.1, mysyslog.2, mysyslog.3, and mysyslog.4.
Router# configure terminalEnter configuration commands, one per line. End with CNTL/Z.Router(config)# logging syslog-server 2000 5 mysyslogRouter(config)# end%SYS-5-CONFIG_I: Configured from console by consoleRouter# dir disk0:Directory of disk0:/3 drw- 0 Jan 17 1998 07:03:53 syslogd.dir4 drw- 0 Jan 12 1998 11:02:29 performance12 drw- 0 Jan 12 1998 11:56:37 configs242 drw- 0 Jan 21 1998 17:51:29 mysyslog.dir340492288 bytes total (336560128 bytes free)Router# dir disk0:/mysyslog.dirDirectory of disk0:/mysyslog.dir/0 -rw- 0 Jan 21 1998 17:51:29 mysyslog.10 -rw- 0 Jan 21 1998 17:51:29 mysyslog.20 -rw- 0 Jan 21 1998 17:51:29 mysyslog.30 -rw- 0 Jan 21 1998 17:51:31 mysyslog.40 -rw- 0 Jan 21 1998 17:51:31 mysyslog.cur340492288 bytes total (336560128 bytes free)Related Commands
oid
To specify MIB variables for the system controller to collect, use the oid system controller poll-group configuration command. The no form of this command disables collection of the specified MIB variable.
oid object-id
no oid [object-id]
Syntax Description
Defaults
Only the sysUptime MIB variable is collected.
Command Modes
system controller poll-group configuration
Command History
Usage Guidelines
Use this command to specify which MIB variables to collect for a specific data collection set. Enter this command once for each MIB variable you wish to collect. In order for the system controller to collect data, you must specify at least one object ID.
For descriptions of supported MIBs and how to use MIBs, see Cisco's MIB website on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
The no form of this command disables data collection for the specified MIB variable. If you do not specify an object ID, data collection is disabled for every variable except sysUptime.
Use the following guidelines when specifying object IDs:
•
Scalar MIB objects are specified with a ".n.0" instance. For example, oid lsystem.57.0 or oid 1.3.6.1.4.1.9.2.1.57.0 specifies avgBusy1.
•
Note
•
Examples
The following example configures the system controller to collect the rows specified by cmLineInfo.1.*, cmLineInfo.2.*, cmLineInfo.3.*, and cmLineInfo.4.* using the bulk transfer mode:
SysCont# configure terminalEnter configuration commands, one per line. End with CNTL/Z.SysCont(config)# syscon poll-group cmlineinfoSysCont(config-poll-gr)# oid cmLineInfo.1.*SysCont(config-poll-gr)# oid cmLineInfo.2.*SysCont(config-poll-gr)# oid cmLineInfo.3.*SysCont(config-poll-gr)# oid cmLineInfo.4.*SysCont(config-poll-gr)# transfer-mode bulkSysCont(config-poll-gr)# enableSysCont(config-poll-gr)# exitSysCont(config)# exitSysCont#Jan 23 17:47:05: %SYS-5-CONFIG_I: Configured from console by consoleRelated Commands
poll-interval
To change the interval for data collection by system controller, use the poll-interval command in system controller poll-group configuration mode. The no form of this command returns the data collection interval to the default value.
poll-interval minutes
no poll-interval
Syntax Description
Defaults
10 minutes
Command Modes
System controller poll-group configuration
Command History
Usage Guidelines
Use this command to specify how often the system controller collects data for a particular performance data set from its managed shelves.
When the poll group is enabled or the first shelf in a poll group is discovered, the system controller acts as if the data collection started at midnight. The system controller will then collect data at the next scheduled data collection time. The data collection for a poll group is synchronized; the system controller collects data from all managed shelves for a poll group at the same time.
Examples
The following example configures the system controller to collect data every 20 minutes. The system controller will store a maximum of five data sets for this poll group. Thus, data will be stored for 100 minutes after it is collected.
SysCont# configure terminalEnter configuration commands, one per line. End with CNTL/Z.SysCont(config)# syscon poll-group cmlineinfoSysCont(config-poll-gr)# oid cmLineInfo.1.*SysCont(config-poll-gr)# oid cmLineInfo.2.*SysCont(config-poll-gr)# oid cmLineInfo.3.*SysCont(config-poll-gr)# oid cmLineInfo.4.*SysCont(config-poll-gr)# transfer-mode bulkSysCont(config-poll-gr)# poll-interval 20SysCont(config-poll-gr)# samples 5SysCont(config-poll-gr)# enableSysCont(config-poll-gr)# exitSysCont(config)# exitSysCont#Jan 23 17:47:05: %SYS-5-CONFIG_I: Configured from console by consoleRelated Commands
samples
To specify the maximum number of performance data sets to store on the disk for a poll group, use the samples poll-group configuration command. The no form of this command returns the value to the default.
samples number
no samples
Syntax Description
number
Maximum number of performance data log files to store on the system controller disk for a particular poll group. The value ranges from 2 to 1000. The default is 10.
Defaults
A maximum of 10 performance data sets are stored.
Command Modes
Poll-group configuration
Command History
Usage Guidelines
Use this command to limit the number of performance data log files residing on the system controller disk for that poll group. Once the limit is reached, the oldest file will be deleted after a new file is successfully written.
Use this command and the poll-interval command to determine how long it will take for a file to be deleted and how much disk space the files will require. If you set the sample number too low, files will be deleted soon after they are created, leaving you with little time to transfer the files to a network management station. If you set the sample number too high, the files may fill the disk.
Examples
The following example configures the system controller to store a maximum of five data sets for this poll group. The system controller will collect data every 20 minutes. Thus, data will be stored for 100 minutes after it is collected.
SysCont# configure terminalEnter configuration commands, one per line. End with CNTL/Z.SysCont(config)# syscon poll-group cmlineinfoSysCont(config-poll-gr)# oid cmLineInfo.1.*SysCont(config-poll-gr)# oid cmLineInfo.2.*SysCont(config-poll-gr)# oid cmLineInfo.3.*SysCont(config-poll-gr)# oid cmLineInfo.4.*SysCont(config-poll-gr)# transfer-mode bulkSysCont(config-poll-gr)# poll-interval 20SysCont(config-poll-gr)# samples 5SysCont(config-poll-gr)# enableSysCont(config-poll-gr)# exitSysCont(config)# exitRelated Commands
shelf-type
To specify which shelf types the system controller collects data from, use the shelf-type command in system controller poll-group configuration mode. The no form of this command removes the command from the configuration.
shelf-type sysObjectID
no shelf-type sysObjectID
Syntax Description
Defaults
The system controller collects data from all discovered shelves.
Command Modes
System controller poll-group configuration
Command History
Usage Guidelines
If this command is not configured, the system controller will collect data from all known shelves. However, if you configure this command with a particular shelf type, the system controller will only collect data from the specified shelves. To collect data from multiple shelf types, enter this command once for each shelf type.
The no form of this command removes the corresponding command from the configuration. If no other shelf-type commands remain, the system controller will collect data from all known shelves. If one or more shelf-type commands remain in the configuration, the system controller will collect data only from the remaining configured shelf types.
In order to turn off data collection for one shelf when you are currently collecting data from all shelves, enter the shelf-type command for each of the remaining shelves.
Examples
The following example collects data from Cisco 7204 routers using the bulk transfer method:
SysCont# configure terminalEnter configuration commands, one per line. End with CNTL/Z.SysCont(config)# syscon poll-group cmlineinfoSysCont(config-poll-gr)# oid cmLineInfo.1.*SysCont(config-poll-gr)# oid cmLineInfo.2.*SysCont(config-poll-gr)# oid cmLineInfo.3.*SysCont(config-poll-gr)# oid cmLineInfo.4.*SysCont(config-poll-gr)# transfer-mode bulkSysCont(config-poll-gr)# shelf-type 125SysCont(config-poll-gr)# enableSysCont(config-poll-gr)# exitSysCont(config)# exitSysCont#Jan 23 17:47:05: %SYS-5-CONFIG_I: Configured from console by consoleRelated Commands
show syscon discover
To display information about discovered shelves, use the show syscon discover EXEC command.
show syscon discover [brief | full]
Syntax Description
brief
(Optional) Displays a list of discovered shelves. This is the default.
full
(Optional) Displays detailed information about discovered shelves.
Defaults
Brief
Command Modes
EXEC
Command History
Usage Guidelines
The show syscon discover full command includes output from the show syscon perfdata and show syscon monitor commands.
Examples
The following is sample output from the show syscon discover brief command:
Syscon# show syscon discover briefShelf# 3 10.0.1.2 Last update 11:15:29 PST Jan 22 1998Table 109 describes the fields shown in this display.
Table 111
Shelf# 3
The identification number for this shelf.
10.0.1.2
IP address for this shelf.
Last update
Time and date of the last update from the shelf.
The following is sample output from the show syscon discover full command:
Syscon# show syscon discover fullShelf# 3 10.0.1.2 Last update 11:16:27 PST Jan 22 1998 type products.108ifIndex Type OperStatus Speed Last Changed1 1 down 9000 2492 1 down 9000 2493 1 down 9000 2494 1 down 9000 2495 1 down 9000 2496 1 down 9000 2497 1 down 9000 2498 1 down 9000 2499 1 down 9000 24910 1 down 9000 249...Performance Data Collection:Poll Last Total Get GetBulk Bulk XferShelf# Group File Requests Requests Requests Requests Errors2 chassis 886010845 151 0 0 151 0popmgmt 886011146 5180 148 5032 0 0Health monitor process is not running.Table 110 describes the fields shown in this display.
Related Commands
show syscon mibpoll
To display information about managed shelves contained in the Health Monitor MIB, use the show syscon mibpoll EXEC command.
show syscon mibpoll
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
This command displays the shelf statistics contained in the Health Monitor MIB on the system controller. The system controller collects this information from its managed shelves.
Examples
The following is sample output from the show syscon mibpoll command:
Router# show syscon mibpollHealthmon MIB count entry status:Shelf ID 1 MIB entries last update 18:22:06 EDT Jan 12 1998.T1E1 Lines DS0s ModemsUp Down Active Total Total Inuse Unavailable1 1 23 46 24 0 0IO Mem CPU EgressPort EgressPortUsed Free Busy1 InOctetUtil OutOctetUtil1378476 7010132 20 0 0Healthmon MIB summary of count entry status:Total Total Total TotalShelves T1E1 Lines DS0s ModemsUp Down Active Total Total Inuse Unavailable1 1 1 23 46 24 0 0Table 111 describes the fields shown in this display.
Related Commands
show syscon monitor
To display information about monitored shelf attributes, use the show syscon monitor EXEC command.
show syscon monitor
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
This command is useful in determining the current status of monitored shelves.
Examples
The following example is sample output from the show syscon monitor command. The first group of lines show attributes being monitored separately on each shelf. The second group of lines show monitored attributes for all shelves combined.
Router# show syscon monitorHealth Monitor setup status on the shel(f,ves):Shelf# Shelf IP Address Monitoring Type Threshold Value Status1 172.27.32.173 IO-Mem 11 ActiveHealth Monitor setup status on the system controller:Monitoring Type Threshold Value StatusTrunk 12 ActiveModem 50 ActiveTable 112 describes the fields shown in this display.
Related Commands
show syscon perfdata
To display information about performance data collection, use the show syscon perfdata EXEC command.
show syscon perfdata
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
The output from this command also appears in the show syscon discover full command output.
Examples
The following is sample output from the show syscon perfdata command:
SysCont# show syscon perfdataPerformance Data Collection:Poll Last Total Get GetBulk Bulk XferShelf# Group File Requests Requests Requests Requests Errors2 chassis 886010845 151 0 0 151 0popmgmt 886011146 5180 148 5032 0 0Table 113 describes the fields shown in this display.
Related Commands
show syscon sdp (managed shelf)
To display information about the Shelf Discovery Protocol, use the show syscon sdp EXEC command.
show syscon sdp
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Examples
The following is sample output from the show syscon sdp command:
Shelf# show syscon sdpCurrent time 10:46:32 PST Jan 28 1998, system controller 172.23.66.100Last hello packet received at 10:45:38 PST Jan 28 199811773 Total SDP packets0 packets with bad MD5 hash5884 Hello packets received5889 Hello packets sent0 Command packets received0 Command packets sentTable 112 describes the fields shown in the sample display.
Related Commands
Specifies the system controller for a managed shelf.
Specifies the interface to use for the source address in SDP packets.
show syscon sdp (system controller)
To display information about the Shelf Discovery Protocol, use the show syscon sdp EXEC command.
