|
Table Of Contents
6.1 Summary of Security Permissions for ASH Commands
6.2.1 srom cfg boot display Command
6.2.2 srom cfg boot modify Command
6.2.3 srom cfg ip display Command
6.2.4 srom cfg ip modify Command
6.2.5 pdm busmode display Command
6.2.6 pdm busmode modify Command
6.2.7 pdm cfg threshold bus display Command
6.2.8 pdm cfg threshold bus modify Command
6.2.9 gain gain display Command
6.2.10 gain gain modify Command
6.2.11 voa power input display Command
6.3.5 login and logoff Commands
6.4.2 shell more enable and disable Commands
6.4.3 shell status display Command
6.4.4 shell type modify Command
6.5 Flash File System Commands
6.6.1 snmp attribute get Command
6.6.2 snmp attribute list Command
6.6.3 snmp attribute set Command
6.6.4 snmp mib display Command
6.6.7 snmp row display Command
6.6.10 snmp subtree display Command
6.6.11 snmp subtree get Command
6.6.12 snmp subtree list Command
6.6.13 snmp table display Command
6.6.15 snmp table list Command
6.6.16 snmp tree attribute list Command
6.7.1 user entry create Command
6.7.3 user entry delete Command
6.7.4 user file display and user name display Commands
6.7.5 user inactivity modify and user inactivity display Commands
6.7.7 user active list Command
6.7.8 user active message send Command
6.8 Manufacturing Information Access Commands
6.8.1 snmp table display local entPhysicalEntry Command
6.8.2 snmp table display local cerent15216EdfaCommTrapEntry Command
6.10.1 manufacturer restore defaults passwords Command
6.10.2 manufacturer restore defaults all Command
ASH Commands
ASH commands are available in the ASH shell command line interface. ASH commands consist of proprietary commands and command-line SNMP instructions. This chapter is a reference of ASH commands that are used in advanced setup and troubleshooting. For provisioning the Cisco ONS 15216 EDFA2 using ASH commands, see Chapter 4, "Provisioning Using ASH and SNMP."
All commands discussed in this chapter are available to the default CISCO15 user and any other user with read_write_admin (RWA) access privileges. Users with read_write (RW) and read (R) access levels have access to a subset of the commands, as shown in Table 6-1.
6.1 Summary of Security Permissions for ASH Commands
Table 6-1 ASH Commands Security Permissions (Access Levels)
Command Description User Access Levels R RW RWAclear
Clears the shell screen.
See clear Command.Yes
Yes
Yes
debug memory display
Displays memory.
Yes
Yes
Yes
error log display
Displays current error log.
No
Yes
Yes
exit
Exits the shell.
See exit Command.Yes
Yes
Yes
ffs bams display
Displays flash file system BAMS.
No
Yes
Yes
ffs block compress
Compresses flash file system block into spare.
No
Yes
Yes
ffs block display
Displays flash file system blocks.
No
Yes
Yes
ffs file copy
Copies flash file.
No
Yes
Yes
ffs file delete
Delete flash file.
No
Yes
Yes
ffs file display
Displays contents of flash file.
No
Yes
Yes
ffs file list
Displays the files in flash memory.
See ffs file list Command.No
Yes
Yes
ffs file rename
Renames flash file.
No
Yes
Yes
ffs format
Formats flash file system.
No
Yes
Yes
ffs status display
Displays current flash file system status.
No
Yes
Yes
ffs tftp get
Copies TFTP file to flash file system.
No
Yes
Yes
ffs tftp put
Copies flash file to TFTP file system.
No
Yes
Yes
ffs tftp record get
Copies record-based TFTP file to flash file.
No
Yes
Yes
ffs tftp record put
Copies record-based flash file to TFTP file.
No
Yes
Yes
flash block display
Displays flash memory.
No
No
Yes
flash block erase
Erases specified flash block.
No
No
Yes
flash block modify
Modifies flash memory.
No
No
Yes
flash boot erase
Erases flash boot sector.
No
No
Yes
flash boot program tftp
Programs flash from TFTP file.
No
No
Yes
flash chip block display
Displays chip block flash memory.
No
No
Yes
flash chip block erase
Erases specified flash chip block.
No
No
Yes
flash chip block modify
Modifies chip block flash memory.
No
No
Yes
flash chip display
Displays flash chip information.
No
No
Yes
flash chip erase
Erases specified flash chip.
No
No
Yes
flash chip reset
Resets flash chip.
No
No
Yes
gain attenuation display
Displays target attenuation.
Yes
Yes
Yes
gain attenuation modify
Modifies target attenuation.
No
Yes
Yes
gain gain display
Displays gain setting.
See gain gain display Command.Yes
Yes
Yes
gain gain modify
Modifies gain setting.
See gain gain modify Command.No
Yes
Yes
help
Gives help about commands.
See help Command.Yes
Yes
Yes
history
Displays the history list.
See history Command.Yes
Yes
Yes
login
Allows the user to log into shell.
See login and logoff Commands.Yes
Yes
Yes
logoff
Allows the user to log off of the shell.
See login and logoff Commands.Yes
Yes
Yes
manufacturer clei display
Displays CLEI code.
Yes
Yes
Yes
manufacturer mode enable
Enables access to manufacturer commands.
No
No
Yes
manufacturer restore defaults all
Restores all settings to manufacturer defaults.
See manufacturer restore defaults all Command.No
No
Yes
manufacturer restore defaults passwords
Restores manufacturer password defaults.
See manufacturer restore defaults passwords Command.No
No
Yes
network host ftp
FTPs to remote host.
No
Yes
Yes
network host ping
Pings remote host.
No
Yes
Yes
network host telnet
Telnets to remote host
No
Yes
Yes
pdm busmode display
Displays the bus mode (simplex or duplex).
See pdm busmode display CommandYes
Yes
Yes
pdm busmode modify
Modifies the bus mode (simplex or duplex).
See pdm busmode modify CommandNo
Yes
Yes
pdm cfg threshold bus display
Displays bus threshold configuration.
Yes
Yes
Yes
pdm cfg threshold bus modify
Modifies bus threshold configuration.
No
Yes
Yes
pdm cfg threshold display
Display threshold configuration.
Yes
Yes
Yes
processor reset
Resets the CPU.
See processor reset Command.No
Yes
Yes
shell lines set
Sets the number of shell lines.
See shell lines set Command.Yes
Yes
Yes
shell more disable
Disables more.
See shell more enable and disable Commands.Yes
Yes
Yes
shell more enable
Enables more.
See shell more enable and disable Commands.Yes
Yes
Yes
shell rows set
Sets the number of shell rows.
Yes
Yes
Yes
shell status display
Displays the shell status.
See shell status display Command.Yes
Yes
Yes
shell type display
Displays the default shell type.
Yes
Yes
Yes
shell type modify
Modifies the default shell type.
See shell type modify Command.No
No
Yes
snmp attribute get
Gets an attribute.
See snmp attribute get Command.No
Yes
Yes
snmp attribute list
Lists an attribute.
See snmp attribute list Command.No
Yes
Yes
snmp attribute oid get
get an attribute
No
Yes
Yes
snmp attribute oid set
set an attribute
No
Yes
Yes
snmp attribute set
Sets an attribute.
See snmp attribute set Command.No
Yes
Yes
snmp host ip get
Gets the IP address from host name.
No
Yes
Yes
snmp host name get
Gets the host name from IP address.
No
Yes
Yes
snmp mib display
Displays a MIB.
See snmp mib display Command.No
Yes
Yes
snmp mib get
Gets a MIB.
See snmp mib get Command.No
Yes
Yes
snmp mib list
Lists a MIB.
See snmp mib list Command.No
Yes
Yes
snmp pdu send
Sends a SNMP protocol data unit (PDU).
No
Yes
Yes
snmp row display
Displays a row.
See snmp row display Command.No
Yes
Yes
snmp row get
Gets a row.
See snmp row get Command.No
Yes
Yes
snmp row line set
Dumps a row.
No
Yes
Yes
snmp row oid display
Displays a row.
No
Yes
Yes
snmp row oid get
Gets a row.
No
Yes
Yes
snmp row oid set
Dumps a row.
No
Yes
Yes
snmp row set
Sets a row.
See snmp row set Command.No
Yes
Yes
snmp session version v1
Sets default SNMP session version to v1.
No
Yes
Yes
snmp session version v2C
Sets default SNMP session version to v2C.
No
Yes
Yes
snmp subtree display
Displays a subtree.
See snmp subtree display Command.No
Yes
Yes
snmp subtree get
Gets a subtree.
See snmp subtree get Command.No
Yes
Yes
snmp subtree list
Lists a subtree.
See snmp subtree list Command.No
Yes
Yes
snmp table display
Displays a table.
See snmp table display Command. See also Display Trap Command, page 5-20, IP Address, page 5-22, and Alarm Entry, page 5-33.No
Yes
Yes
snmp table get
Gets a table.
See snmp table get Command.No
Yes
Yes
snmp table list
Lists a table.
See snmp table list Command.No
Yes
Yes
snmp trap send
Sends a SNMP trap.
No
Yes
Yes
snmp tree attribute list
Lists the attributes in the MIB.
See snmp tree attribute list Command.No
Yes
Yes
snmp tree mib list
Lists the MIBs in the MIB tree.
No
Yes
Yes
snmp tree oid display
Displays object identifier (OID) for a MIB tree object.
No
Yes
Yes
snmp tree syntax display
Displays the syntax of a MIB tree object.
No
Yes
Yes
snmp tree table provided list
Lists provided tables in the MIB tree.
No
Yes
Yes
srom cfg boot display
Displays the serial ROM boot content.
See srom cfg boot display Command.No
Yes
Yes
srom cfg boot modify
Modifies the serial ROM boot contents.
See srom cfg boot modify Command.No
Yes
Yes
srom cfg debug display
Displays one config (CFG) ROM byte.
No
No
Yes
srom cfg debug modify
Modifies one CFG ROM byte.
No
No
Yes
srom cfg display
Displays CFG ROM contents.
No
Yes
Yes
srom cfg ip display
Displays the serial ROM IP contents.
See srom cfg ip display Command.No
Yes
Yes
srom cfg ip modify
Modifies the serial ROM IP contents.
See srom cfg ip modify CommandNo
Yes
Yes
srom cfg modify
Modifies CFG ROM contents.
No
Yes
Yes
srom id display
Displays serial ROM contents.
No
Yes
Yes
tl1c
TL1s to host.
Yes
Yes
Yes
user active list
Lists the active users.
See user active list Command.No
Yes
Yes
user active message send
Sends the message to all active users.
See user active message send Command.No
Yes
Yes
user entry create
Creates a new user.
See user entry create Command.No
No
Yes
user entry delete
Deletes the user.
See user entry delete Command.No
No
Yes
user entry edit
Edits an existing user entry.
See user entry edit Command.No
No
Yes
user file display
Displays the user names and information.
See user file display and user name display Commands.No
Yes
Yes
user inactivity display
Displays user inactivity times.
See user inactivity modify and user inactivity display Commands.Yes
Yes
Yes
user inactivity modify
Modifies user inactivity time.
See user inactivity modify and user inactivity display Commands.No
No
Yes
user name display
Displays the user name.
See user file display and user name display Commands.Yes
Yes
Yes
user passwd set
Sets the user password.
See user passwd set Command.Yes
Yes
Yes
user passwd set username
Sets another user's password.
See user passwd set Command.No
No
Yes
voa power input display
Displays VOA power input.
See voa power input display Command.Yes
Yes
Yes
6.2 Configuration Commands
The following commands are useful in configuring the ONS 15216 EDFA2:
• srom cfg boot display Command
• srom cfg boot modify Command
• pdm cfg threshold bus display Command
• pdm cfg threshold bus modify Command
• voa power input display Command
6.2.1 srom cfg boot display Command
Command
srom cfg boot display
Syntax Description
srom cfg boot display
Displays the serial ROM boot contents. Data displayed includes the IP address and file names. See Example 6-1.
Example 6-1 srom cfg boot display Command
ash:hostname:ONS15216 EDFA2> srom cfg boot display
Boot Count 2
Boot Record 0 type 2 Flash
IP Address 0.0.0.0
Filename 15216EdfaSw_x.x.x_bin
Boot Record 1 type 2 Flash
IP Address 0.0.0.0
Filename 15216EdfaSw_y.y.y_bin
CRC-32 8bd3cb56
6.2.2 srom cfg boot modify Command
Command
srom cfg boot modify
Syntax Description
srom cfg boot modify
Modifies the contents of the ROM boot. See Example 6-2.
Example 6-2 srom cfg boot modify Command
ash:hostname:ONS15216 EDFA2> srom cfg boot modify
Boot Count = 2
Boot Record 0 type 1 TFTP
2
Filename = users/name/15216EdfaSw_x.x.x_bin
15216EdfaSw_x.x.x_bin
Boot Record 1 type 2 Flash
2
Filename = orion427
15216EdfaSw_y.y.y_bin
Note Boot type 1 = TFTP and boot type 2 = Flash.
6.2.3 srom cfg ip display Command
Command
srom cfg ip display
Syntax Description
srom cfg ip display
Displays the serial ROM IP contents. The ROM IP contents are shown, including IP address, subnet mask, default router address, and hostname. See Example 6-3.
Example 6-3 srom cfg ip display Command
ash:hostname:ONS15216 EDFA2> srom cfg ip display
Shelf ID = 1
IP Address = 192.168.60.168
Subnet Mask = 255.255.255.0
Default Router IP Address = 192.168.60.254
Hostname = hostname
SW Config = 0x00000000
CRC32 = 0x54f863a2
6.2.4 srom cfg ip modify Command
Command
srom cfg ip modify
Syntax Description
srom cfg ip modify
Modifies the serial ROM IP contents. The user is prompted, row by row, to change the items listed in Example 6-4 .
Example 6-4 srom cfg ip modify Command
ash:hostname:ONS15216 EDFA2> srom cfg ip modify
Shelf ID = 1
IP Address = 192.168.60.168
Subnet Mask = 255.255.255.0
Default Router IP Address = 192.168.60.254
Hostname = hostname
SW Config = 0x00000000
6.2.5 pdm busmode display Command
Command
pdm busmode display
Syntax Description
pdm busmode display
Displays power bus mode (simplex or duplex).
6.2.6 pdm busmode modify Command
Command
pdm busmode modify
Syntax Description
pdm busmode modify {simplex | duplex}
Modifies power bus mode to simplex (single power source-Bus A) or duplex (redundant power source-Bus A and B).
6.2.7 pdm cfg threshold bus display Command
Command
pdm cfg threshold bus display
Syntax Description
pdm cfg threshold bus display
Displays the minimum and maximum allowable power bus DC voltage.
Example 6-5 pdm cfg threshold bus display Command
ash:hostname:ONS15216 EDFA2> pdm cfg threshold bus display
BUS Threshold Low = 40000(mV)
BUS Threshold High = 57000(mV)
6.2.8 pdm cfg threshold bus modify Command
Command
pdm cfg threshold bus modify
Syntax Description
pdm cfg threshold bus modify
Modifies minimum and maximum allowable power bus DC voltage.
Example 6-6 pdm cfg threshold bus modify Command
ash:hostname:ONS15216 EDFA2> pdm cfg threshold bus modify
BUS Threshold Low = 40000(mV)
40500
BUS Threshold High = 57000(mV)
6.2.9 gain gain display Command
Command
gain gain display
Syntax Description
gain gain display
Displays the gain setting for the ONS 15216 EDFA2.
Example 6-7 gain gain display Command
ash:hostname:ONS15216 EDFA2> gain gain display
Target = 22000(mdB), Actual = 21985(mdB)
6.2.10 gain gain modify Command
Command
gain gain modify
Syntax Description
gain gain modify value
Modifies the gain setting for the ONS 15216 EDFA2.
Example 6-8 gain gain modify Command
ash:hostname:ONS15216 EDFA2> gain gain modify 22000
Target = 22000(mdB), Actual = 21996(mdB)
6.2.11 voa power input display Command
Command
voa power input display
Syntax Description
voa power input display
Displays variable optical attenuator (VOA) power input.
6.3 Administrative Commands
The following commands are useful in administering the ONS 15216 EDFA2:
6.3.1 clear Command
Command
clear
Syntax Description
clear
Clears content from the terminal window. An empty screen with a cursor appears.
6.3.2 exit Command
Command
exit
Syntax Description
exit
Ends the session with the ONS 15216 EDFA2.
6.3.3 help Command
Command
help
Syntax Description
help
Displays a list of all CLI commands for current user security level.
6.3.4 history Command
Command
history
Syntax Description
history
Displays a list of commands issued by the user during that specific session. See Example 6-9.
Example 6-9 history Command
ash:hostname:ONS15216 EDFA2> history
user active list
user active message send hi
user file display
user entry create
user entry delete albert
user file display
user name display
user passwd set
help
history
6.3.5 login and logoff Commands
Command
login or logoff
Syntax Description
login or logoff
Used to access and exit communication with the ONS 15216 EDFA2. Logging into the module requires both a user name and a password. Only use these commands if you have stopped the booting process or are displaying the format for logging into the module. Type the command, the first few letters of the attribute, and press the Tab key to view a list of attributes that can be set. See Example 6-10.
Example 6-10 login Command
ash:hostname:ONS15216 EDFA2> login
Parameters
user_name (string[0..16]) name of user
password (string[0..16]) password of user
6.3.6 processor reset Command
Command
processor reset
Syntax Description
processor reset
Resets the processor on the CLI card. Although the performance of the amplifier is not affected, communication with the module is ended and the user must log in again.
6.4 Shell Commands
The following commands are useful in working with the shell within the ONS 15216 EDFA2 SNMP manager:
• shell more enable and disable Commands
• shell status display Command
6.4.1 shell lines set Command
Command
shell lines set
Syntax Description
shell lines set #lines
Sets the number of lines that can be viewed on the screen without pressing Enter. 40 lines per screen is recommended (maximum is 999).
6.4.2 shell more enable and disable Commands
Command
shell more enable or shell more disable
Syntax Description
shell more {enable | disable}
The shell more enable command enables the more function, limiting the output that appears on the screen. When the more function is enabled, press Enter to view additional information on the screen.
The shell more disable command disables the more function.
6.4.3 shell status display Command
Command
shell status display
Syntax Description
shell status display
Displays the current shell settings, including the number of shell lines, the number of shell rows, and whether the more setting is enabled or disabled. See Example 6-11.
Example 6-11 shell status display Command
ash:hostname:ONS15216 EDFA2> shell status display
Shell Lines: 22
Shell Rows : 80
More : On
6.4.4 shell type modify Command
Command
shell type modify
Syntax Description
shell type modify {tl1 | ash}
Sets the shell type to TL1 or ASH for the ONS 15216 EDFA2's RS-232 (EIA/TIA-232) port (accessed via HyperTerminal) and the default TCP/IP port on the ONS 15216 EDFA2's LAN port (accessed via Telnet). The default is TL1. This command requires a system reboot using the processor reset command for changes to take effect.
To return to the ASH shell from the TL1 shell, use the command ED-NE-GEN. (See Step 3. in "Log In via LAN Port Using Telnet (Optional), page 4-3" section on page 4-1.)6.5 Flash File System Commands
The flash file system (FFS) file commands allow the user to manage the number of files that are on the ONS 15216 EDFA2 Flash memory. Never erase the following files:
•Two current versions of software (15216EdfaSw_x.x.x)
•snmp.cfg
Because the snmp.cfg file contains important SNMP attributes, deleting this file would mean that the community and view tables would have to be reset before a remote user could access the ONS 15216 EDFA2 via SNMP.
EDFA software image files are named using a special naming convention. Do not to change the file name when image files are downloaded from an FTP server onto the box in the field when using the FTP command shell of the ONS 15216 EDFA2.
6.5.1 ffs file list Command
Command
ffs file list
Syntax Description
ffs file list
List the files on the ONS 15216 EDFA2 Flash memory. See Example 6-12.
Example 6-12 ffs file list Command
ash:hostname:ONS15216 EDFA2> ffs file list
--------name-------- type status length rename_bam attributes
15216EdfaSw_2.2.0 1 fffc 1684899 ffffffff ffffffff
snmp.bak 1 fffc 1709 00140001 ffffffff
passwd 2 fffc -1 ffffffff ffffffff
snmp.cfg 1 fffc 1709 ffffffff ffffffff
15216EdfaSw_2.1.0 1 fffc 1681923 ffffffff ffffffff
6.6 SNMP Commands
The SNMP commands are useful in working with the SNMP protocol to provision and configure the ONS 15216 EDFA2. When issuing these SNMP commands, the command syntax requires that the command must be followed by either the ONS 15216 EDFA2 IP address or the word "local".
SNMP commands are listed as follows:
• snmp subtree display Command
• snmp tree attribute list Command
6.6.1 snmp attribute get Command
Command
snmp attribute get
Syntax Description
snmp attribute get {IP_address | local} attribute_name index
Accesses and displays a specific MIB attribute. See Example 6-13.
Example 6-13 snmp attribute get Command
ash:hostname:ONS15216 EDFA2> snmp attribute get local sysDescr
attributes
sysDescr "hostname, Hardware Rev B0, ONS15216 EDFA2, v2.1.9, Serial No DIT05470008, MAC Addr 00059a383d11"
Type the command, the first few letters of the attribute, and press Tab to view a list of attributes that can be set. See Example 6-14.
Example 6-14 snmp attribute get Command List
ash:hostname:ONS15216 EDFA2> snmp attribute get local cerent
cerent15216EdfaCommIndex
cerent15216EdfaCommName
cerent15216EdfaCommViewIndex
cerent15216EdfaCommPrivileges
cerent15216EdfaCommSrcIPAddr
cerent15216EdfaCommNetMask
cerent15216EdfaCommStatus
cerent15216EdfaCommTrapIndex
cerent15216EdfaCommTrapCommunity
cerent15216EdfaCommTrapDestIPAddress
cerent15216EdfaCommTrapDestUDPPort
cerent15216EdfaCommTrapViewIndex
cerent15216EdfaCommTrapVersion
cerent15216EdfaCommTrapStatus
cerent15216EdfaViewIndex
cerent15216EdfaViewSubtree
cerent15216EdfaViewMask
cerent15216EdfaViewType
cerent15216EdfaViewStatus
cerent15216EdfaAgentTrapEnable
...
6.6.2 snmp attribute list Command
Command
snmp attribute list
Syntax Description
snmp attribute list {IP_address | local} attribute_name
Lists the value of an attribute for all table rows. See Example 6-15.
Example 6-15 snmp attribute list Command
ash:hostname:ONS15216 EDFA2> snmp attribute list local cerent15216EdfaAlarmID
cerent15216EdfaAlarmID.1 = lcrnt1;
cerent15216EdfaAlarmID.2 = lcrnt2;
cerent15216EdfaAlarmID.3 = ltmp1;
cerent15216EdfaAlarmID.4 = ltmp2;
cerent15216EdfaAlarmID.5 = lpout;
cerent15216EdfaAlarmID.6 = lpin;
cerent15216EdfaAlarmID.7 = gain;
cerent15216EdfaAlarmID.8 = ctmp;
cerent15216EdfaAlarmID.9 = powerBusA;
cerent15216EdfaAlarmID.10 = powerBusB;
6.6.3 snmp attribute set Command
Command
snmp attribute set
Syntax Description
snmp attribute set {IP_address | local} attribute_name index new_value
Description: Sets the attribute for a MIB item. Type the command, the first few letters of the attribute, and press Tab to view a list of attributes that can be set. See Example 6-16.
Example 6-16 snmp attribute set Command
ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaAgentTrapEnable enabled
sysContact
sysName
sysLocation
ifAdminStatus
atIfIndex
atPhysAddress
atNetAddress
ipForwarding
ipDefaultTTL
ipRouteDest
ipRouteIfIndex
ipRouteMetric1
ipRouteMetric2
ipRouteMetric3
ipRouteMetric4
ipRouteNextHop
ipRouteType
ipRouteAge
ipRouteMask
ipRouteMetric5
...
6.6.4 snmp mib display Command
Command
snmp mib display
Syntax Description
snmp mib display {IP_address | local} -all
Displays all writable MIB attributes (or all accessible attributes if the -all option is used).
6.6.5 snmp mib get Command
Command
snmp mib get
Syntax Description
snmp mib get {IP_address | local}
Displays all MIB attributes. The data is output in two columns. The first column lists the attributes and indices and the second column lists the data. See Example 6-17.
Example 6-17 snmp mib get Command
ash:hostname:ONS15216 EDFA2> snmp mib get local
attributes
sysDescr "mntuboot v0.0.0 ONS15216 EDFA2 v1.3.0, MAC Addr 0010b4000525"
sysObjectID cerent15216EdfaNode
sysUpTime 24703705
sysContact ""
sysName "sysname"
sysLocation ""
sysServices 0
sysORLastChange 90
index
sysORIndex 1
attributes
sysORID snmpBasicCompliance
sysORDescr ""
sysORUpTime 24704075
6.6.6 snmp mib list Command
Command
snmp mib list
Syntax Description
snmp mib list {IP_address | local}
Displays the values of all attributes supported by the SNMP agent. Example 6-18.
Example 6-18 snmp mib list Command
ash:hostname:ONS15216 EDFA2> snmp mib list local
sysDescr.0 = "hostname v3.0.0 ONS15216 EDFA2 v2.1.1, Serial No DIT0533000P, MAC
Addr 00059a383d10";
sysObjectID.0 = { cerent15216EdfaNode };
sysUpTime.0 = 355920;
sysContact.0 = "";
sysName.0 = "sysname";
sysLocation.0 = "";
sysServices.0 = 0;
sysORLastChange.0 = 135;
sysORID.1 = { snmpBasicCompliance };
sysORID.2 = { rs232Compliance };
sysORDescr.1 = "";
sysORDescr.2 = "";
sysORUpTime.1 = 355925;
sysORUpTime.2 = 355925;
ifNumber.0 = 3;
ifIndex.300 = 300;
ifIndex.302 = 302;
ifIndex.350 = 350;
ifDescr.300 = "Intra-machine interface";
ifDescr.302 = "Ethernet Interface";
ifDescr.350 = "RS232 Interface";
ifType.300 = softwareLoopback;
ifType.302 = ethernetCsmacd;
ifType.350 = rs232;
ifMtu.300 = 0;
ifMtu.302 = 1500;
ifMtu.350 = 0;
ifSpeed.300 = 0;
ifSpeed.302 = 10000000;
ifSpeed.350 = 19171;
...
6.6.7 snmp row display Command
Command
snmp row display
Syntax Description
snmp row display {IP_address | local} row_name index
Displays a row. Use this command to obtain information to use with other commands. Type the command, the first few letters of the attribute, and press Tab to view a list of attributes that can be set. Type an attribute from the list to view its row data. See Example 6-19.
Example 6-19 snmp row display Command
ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216Edfa
cerent15216EdfaCfgGroup
cerent15216EdfaPumpCfgEntry
cerent15216EdfaAlarmControl
cerent15216EdfaStatusGroup
cerent15216EdfaPumpStatusEntry
cerent15216EdfaAlarmEntry
cerent15216EdfaOpGroup
ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaCfgGroup
CLASS CERENT-MIB.cerent15216EdfaCfgGroup ::=
{
cerent15216EdfaCfgSaved = true;
cerent15216EdfaLpoutSetpoint = 1000;
cerent15216EdfaLpoutDeviation = 200;
cerent15216EdfaLpoutHysteresis = 100;
cerent15216EdfaLOSThreshold = -2400;
cerent15216EdfaLOSHysteresis = 100;
cerent15216EdfaCtmpMin = 5;
cerent15216EdfaCtmpMinHysteresis = 1;
cerent15216EdfaCtmpMax = 65;
cerent15216EdfaCtmpMaxHysteresis = 1;
cerent15216EdfaCLEI = "CLEI";
cerent15216EdfaPowerBusMode = duplex;
cerent15216EdfaPowerBusDCVoltageMin = 480;
cerent15216EdfaPowerBusDCVoltageMax = 570;
6.6.8 snmp row get Command
Command
snmp row get
Syntax Description
snmp row get {IP_address | local} row_name index
Accesses a row. Use this command to obtain information to use with other commands. See Example 6-20.
Example 6-20 snmp row get Command
ash:hostname:ONS15216 EDFA2> snmp row get local cerent15216EdfaCfgGroup
CfgSa Lpo Lpo Lpo LOST LOS C C Ct C CLEI PowerBu Pow Pow
false 0 200 100 -3000 100 -5 1 65 1 "CLEI" duplex 480 570
6.6.9 snmp row set Command
Command
snmp row set
Syntax Description
snmp row set {IP_address | local} row_name index
Sets data within a row. Use the snmp row display command first to view the contents of data within a row. See Example 6-21.
Example 6-21 snmp row set Command
ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaAlarmEntry 1
cerent15216EdfaAlarmEnableStatus disabled
6.6.10 snmp subtree display Command
Command
snmp subtree display
Syntax Description
snmp subtree display {IP_address | local} subtree
Displays the attributes below a node in a SNMP tree. See Example 6-22.
Example 6-22 snmp subtree display Command
ash:hostname:ONS15216 EDFA2> snmp subtree display local cerent15216EdfaCommunityEntry
BEGIN-HOST "testhost" 0.0.0.0 "private"
CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCommunityEntry ::=
{
cerent15216EdfaCommIndex = 1;
cerent15216EdfaCommName = "public";
cerent15216EdfaCommViewIndex = 1;
cerent15216EdfaCommPrivileges = 247;
cerent15216EdfaCommSrcIPAddr = 0.0.0.0;
cerent15216EdfaCommNetMask = 255.255.255.255;
cerent15216EdfaCommStatus = active;
};
CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCommunityEntry ::=
{
cerent15216EdfaCommIndex = 2;
cerent15216EdfaCommName = "private";
cerent15216EdfaCommViewIndex = 1;
cerent15216EdfaCommPrivileges = 255;
cerent15216EdfaCommSrcIPAddr = 0.0.0.0;
cerent15216EdfaCommNetMask = 255.255.255.255;
cerent15216EdfaCommStatus = active;
...
6.6.11 snmp subtree get Command
Command
snmp subtree get
Syntax Description
snmp subtree get {IP_address | local} subtree
Accesses a subtree. See Example 6-23.
Example 6-23 snmp subtree get Command
ash:hostname:ONS15216 EDFA2> snmp subtree get local sysDescr
index
sysORIndex 1
attributes
sysORID snmpBasicCompliance
sysORDescr ""
sysORUpTime 391985
index
sysORIndex 2
attributes
sysORID rs232Compliance
sysORDescr ""
sysORUpTime 391990
3
index
ifIndex 300
attributes
ifDescr "Intra-machine interface"
ifType softwareLoopback
ifMtu 0
...
6.6.12 snmp subtree list Command
Command
snmp subtree list
Syntax Description
snmp subtree list {IP_address | local}
Lists the attributes below a node in a SNMP tree. See Example 6-24.
Example 6-24 snmp subtree list Command
ash:hostname:ONS15216 EDFA2> snmp subtree list local
Root
ccitt
zeroDotZero
iso
org
dod
internet
directory
mgmt
mib-2
system
sysDescr
sysObjectID
sysUpTime
sysContact
sysName
sysLocation
sysServices
sysORLastChange
sysORTable
...
ash:hostname:ONS15216 EDFA2> snmp subtree list local internet
sysDescr.0 = "hostname v3.0.0 ONS15216 EDFA2 v2.2.0, Serial No DIT0533000P, MAC
Addr 00059a383d10";
sysObjectID.0 = { cerent15216EdfaNode };
sysUpTime.0 = 35913255;
sysContact.0 = "";
sysName.0 = "sysname";
sysLocation.0 = "";
sysServices.0 = 0;
sysORLastChange.0 = 120;
sysORID.1 = { snmpBasicCompliance };
...
6.6.13 snmp table display Command
Command
snmp table display
Syntax Description
snmp table display {IP_address | local}
Displays table data for the ONS 15216 EDFA2. Example 6-25 displays the command entered without a table. After typing the command without a table and pressing the Tab key, a list of tables appears. Type the command with a table name to display the table and its data. Data displayed using this command are per rows. Attributes are grouped together in rows. See Example 6-25.
Example 6-25 snmp table display Command
ash:hostname:ONS15216 EDFA2> snmp table display local
system
sysOREntry
interfaces
ifEntry
atEntry
ip
ipAddrEntry
ipRouteEntry
ipNetToMediaEntry
ipForward
ipForwardEntry
ipCidrRouteEntry
icmp
tcp
tcpConnEntry
udp
udpEntry
egp
...
ash:hostname:ONS15216 EDFA2> snmp table display local system
CLASS SNMPv2-MIB.system ::=
{
sysDescr = "hostname v3.0.0 ONS15216 EDFA2 v2.2.0, Serial No DIT0533000P, MA
C Addr 00059a383d10";
sysObjectID = { cerent15216EdfaNode };
sysUpTime = 35942955;
sysContact = "";
sysName = "sysname";
sysLocation = "";
sysServices = 0;
sysORLastChange = 120;
};
6.6.14 snmp table get Command
Command
snmp table get
Syntax Description
snmp table get {IP_address | local} table
Accesses table data. See Example 6-26.
Example 6-26 snmp table get Command
ash:hostname:ONS15216 EDFA2> snmp table get local system
attributes
sysDescr "hostname, Hardware Rev A1, ONS15216 EDFA2,
v2.2.0, Serial No DIT0533000P, MAC Addr 00059a383d10"
sysObjectID cerent15216EdfaNode
sysUpTime 1330310
sysContact "username"
sysName "sysname"
sysLocation "Lab"
sysServices 0
sysORLastChange 125
6.6.15 snmp table list Command
Command
snmp table list
Syntax Description
snmp table list {IP_address | local} table
Lists all the data within a table. Example 6-27 below displays the command for the UDP (User Datagram Protocol) table. This command displays data by attribute.
Example 6-27 snmp table list Command
ash:hostname:ONS15216 EDFA2> snmp table list local udp
udpInDatagrams.0 = 11341;
udpNoPorts.0 = 135;
udpInErrors.0 = 1983;
udpOutDatagrams.0 = 9233;
udpLocalAddress.172.22.82.19.161 = 172.22.82.19;
udpLocalPort.172.22.82.19.161 = 161;
6.6.16 snmp tree attribute list Command
Command
snmp tree attribute list
Syntax Description
snmp tree attribute list
Lists all the attributes implemented by the SNMP agent. See Example 6-28.
Example 6-28 snmp tree attribute list Command
ash:hostname:ONS15216 EDFA2> snmp tree attribute list
sysDescr
sysObjectID
sysUpTime
sysContact
sysName
sysLocation
sysServices
sysORLastChange
sysORIndex
sysORID
sysORDescr
sysORUpTime
ifNumber
ifIndex
ifDescr
ifType
ifMtu
ifSpeed
ifPhysAddress
ifAdminStatus
ifOperStatus
...
6.7 User Commands
The following commands are useful in setting up and maintaining user accounts for the ONS 15216 EDFA2:
• user file display and user name display Commands
• user inactivity modify and user inactivity display Commands
• user active message send Command
6.7.1 user entry create Command
Command
user entry create
Syntax Description
user entry create name user_mode
Creates a new user. The parameters required to create a new user are user name, access level, and password.
The user_mode (access privilege level) is set by entering either read, read_write, or read_write_admin. See Table 6-1 for the command privileges of each user level. The password must be an ASCII string of up to 10 characters, where at least 2 are non-alphabetic characters with at least one special character. Legal and special characters are as defined in Telcordia GR-831-CORE. See Example 6-29.
Example 6-29 user entry create Command
ash:hostname:ONS15216 EDFA2> user entry create jdoe read_write
New Password =
**********
Confirm New Password =
**********
6.7.2 user entry edit Command
Command
user entry edit
Syntax Description
user entry edit username
Edit a user's parameters (name, password, and access level). This command uses the optional parameters shown at the beginning of Example 6-30. The -user_mode parameter changes the access level (read, read_write, or read_write_admin). If the password is not to be changed, hit the Enter key when the new password is requested and confirmed, as shown in Example 6-31.
Example 6-30 user entry edit Command (Change Password)
ash:hostname:ONS15216 EDFA2> user entry edit
Options
-new_user_name (string[0..10]) new name of user
-user_mode (string[0..16]) mode of user
Parameters
user_name (string[0..10]) name of user
ash:hostname:ONS15216 EDFA2> user entry edit jsmith
New Password =
******
Confirm New Password =
******
Example 6-31 user entry edit Command (Change Access Level)
ash:hostname:ONS15216 EDFA2> user entry edit jsmith -user_mode read_write
New Password =
Confirm New Password =
6.7.3 user entry delete Command
Command
user entry delete
Syntax Description
user entry delete username
Delete users. See Example 6-32.
Example 6-32 user entry delete Command
ash:hostname:ONS15216 EDFA2> user entry delete jdoe
6.7.4 user file display and user name display Commands
Command
user file display or user name display
Syntax Description
user file display or user name display
Type the user file display command to display a list of all the users and user information. Type the user name display command to display the name of the current user.
The access privilege level is set by entering either read, read_write, or read_write_admin. See Table 6-1 for the command privileges of each user level. Inactivity is the length of time of user inactivity before the user is automatically logged off. See Example 6-33.
Example 6-33 user file display Command
ash:hostname:ONS15216 EDFA2> user file display
User Mode Inactivity
CISCO15 read_write_admin 15
janedoe read_write 30
jdoe read_write 30
johndoe read 60
6.7.5 user inactivity modify and user inactivity display Commands
Command
user inactivity modify or user inactivity display
Syntax Description
user inactivity modify levelvalue or user inactivity display
Inactivity is the length of time of user inactivity before the user is automatically logged off. Type the user inactivity modify command to change the inactivity values. Type the user inactivity display command to display the current inactivity values.
The default inactivity values for the read, read_write, and read_write_admin user access levels are 60, 30, and 15 minutes, respectively. Possible values are 0 to 99 (in minutes). A value of 0 means no timeout. See Example 6-34 and Example 6-35.
Example 6-34 user inactivity modify Command
ash:hostname:ONS15216 EDFA2> user inactivity modify read 75
Example 6-35 user inactivity display Command
ash:hostname:ONS15216 EDFA2> user inactivity display
Mode Inactivity
read_write_admin 15
read_write 30
read 75
6.7.6 user passwd set Command
To restrict access to the ONS 15216 EDFA2, use the user passwd set command to change the default user password. Example 6-36 displays the user passwd set syntax for a current user. Example 6-37 displays the user passwd set username command for changing another user's password.
The password must be an ASCII string of up to 10 characters, where at least 2 are non-alphabetic characters with at least one special character. Legal and special characters are as defined in Telcordia GR-831-CORE. With the exception of the read_write_admin level user, the user can only modify their own password.
Example 6-36 Changing Current User's Password
ash:hostname:ONS15216 EDFA2> user passwd set
Password =
*****
New Password =
*******
Confirm New Password =
*******
Example 6-37 Changing Another User's Password
ash:hostname:ONS15216 EDFA2> user passwd set jdoe
Password =
****
New Password =
******
Confirm New Password =
******
Note The default user name for the administrator level is CISCO15 with no default password. To start a session for this user name, press Enter.
6.7.7 user active list Command
Command
user active list
Syntax Description
user active list
Displays a list of the active users. See Example 6-38.
Example 6-38 user active list Command
ash:hostname:ONS15216 EDFA2> user active list
Users
CISCO15
6.7.8 user active message send Command
Command
user active message send
Syntax Description
user active message send ["message"]
Sends a message to all current users on the system. See Example 6-39.
Example 6-39 user active message send Command
ash:hostname:ONS15216 EDFA2> user active message send
Parameters
message (string[0..32]) message to send
ash:hostname:ONS15216 EDFA2> user active message send "hello world"
*** Broadcast Message:
*** hello world
6.8 Manufacturing Information Access Commands
6.8.1 snmp table display local entPhysicalEntry Command
Command
snmp table display local entPhysicalEntry
Syntax Description
snmp table display local entPhysicalEntry
Displays the entity information. See Example 6-40.
Example 6-40 snmp table display local entPhysicalEntry Command
ash:hostname:ONS15216 EDFA2> snmp table display local entPhysicalEntry
CLASS ENTITY-MIB.entPhysicalEntry ::=
{
entPhysicalIndex = 1;
entPhysicalDescr = "ONS15216 EDFA2";
entPhysicalVendorType = { cerent15216EdfaChassis };
entPhysicalContainedIn = 0;
entPhysicalClass = chassis;
entPhysicalParentRelPos = -1;
entPhysicalName = "hostname";
entPhysicalHardwareRev = "v3.0.0";
entPhysicalFirmwareRev = "v2.3.14";
entPhysicalSoftwareRev = "v2.2.0";
entPhysicalSerialNum = "DIT0533000P";
entPhysicalMfgName = "Cisco Systems";
entPhysicalModelName = "ONS15216";
entPhysicalAlias = "";
entPhysicalAssetID = "";
entPhysicalIsFRU = true;
};
6.8.2 snmp table display local cerent15216EdfaCommTrapEntry Command
Command
snmp table display local cerent15216EdfaCommTrapEntry
Syntax Description
snmp table display local cerent15216EdfaCommTrapEntry
Displays information about autonomous messages (SNMP traps) going to destination manager's location (IP address).
Example 6-41 snmp table display local cerent15216EdfaCommTrapEntry Command
ash:hostname:ONS15216 EDFA2> snmp table display local cerent15216EdfaCommTrapEntry
CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCommTrapEntry ::=
{
cerent15216EdfaCommTrapIndex = 1;
cerent15216EdfaCommTrapCommunity = "private";
cerent15216EdfaCommTrapDestIPAddress = 172.22.87.50;
cerent15216EdfaCommTrapDestUDPPort = 162;
cerent15216EdfaCommTrapViewIndex = 1;
cerent15216EdfaCommTrapVersion = v2;
cerent15216EdfaCommTrapStatus = active;
};
CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCommTrapEntry ::=
{
cerent15216EdfaCommTrapIndex = 2;
cerent15216EdfaCommTrapCommunity = "private";
cerent15216EdfaCommTrapDestIPAddress = 172.22.87.254;
cerent15216EdfaCommTrapDestUDPPort = 162;
cerent15216EdfaCommTrapViewIndex = 1;
cerent15216EdfaCommTrapVersion = v2;
cerent15216EdfaCommTrapStatus = active;
};
6.9 Manufacturer Mode
A manufacturer mode enable command is available. It raises the root access level to the fifth and highest manufacturer level to allow undocumented commands that are used only for manufacturing purposes.
Warning Customers are strongly cautioned not to use this mode.
6.10 Restore Commands
6.10.1 manufacturer restore defaults passwords Command
Command
manufacturer restore defaults passwords
Syntax Description
manufacturer restore defaults passwords
Restores the manufacturing factory default passwords to the ONS 15216 EDFA2.
Note If the password for the CISCO15 user is lost and there are not other users with read_write_admin access level in the system, the password for CISCO15 can be reset by following the procedure in "Recover Default Password" section on page 4-12.
6.10.2 manufacturer restore defaults all Command
Command
manufacturer restore defaults all
Syntax Description
manufacturer restore defaults all
Restores the manufacturing factory settings to the ONS 15216 EDFA2. The files on the flash file system (FFS), the date and time, and the values of manufacturing calibration are not affected. This command must be followed by the processor reset command to take effect.
Warning This command resets the IP address, resets the hostname, deletes the user directory, reverts CISCO15 to the default password, and resets other parameters to restore the unit to its state as shipped from manufacturing.
Posted: Sun Apr 2 03:08:21 PDT 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.