Table Of Contents

ASH Commands

6.1 Summary of Security Permissions for ASH Commands

6.2 Configuration 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 Administrative Commands

6.3.1 clear Command

6.3.2 exit Command

6.3.3 help Command

6.3.4 history Command

6.3.5 login and logoff Commands

6.3.6 processor reset Command

6.4 Shell Commands

6.4.1 shell lines set Command

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.5.1 ffs file list Command

6.6 SNMP 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.5 snmp mib get Command

6.6.6 snmp mib list Command

6.6.7 snmp row display Command

6.6.8 snmp row get Command

6.6.9 snmp row set Command

6.6.10 snmp session version get Command

6.6.11 snmp subtree display Command

6.6.12 snmp subtree get Command

6.6.13 snmp subtree list Command

6.6.14 snmp table display Command

6.6.15 snmp table get Command

6.6.16 snmp table list Command

6.6.17 snmp tree attribute list Command

6.7 User Commands

6.7.1 user entry create Command

6.7.2 user entry edit 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.6 user passwd set Command

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.9 Manufacturer Mode

6.10 Restore Commands

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 in the ASH Shell."

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	RWA
clear	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 Command	Yes	Yes	Yes
pdm busmode modify	Modifies the bus mode (simplex or duplex). See pdm busmode modify Command	No	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 get	Displays the default SNMP session version. See snmp session version get 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-18, IP Address, page 5-20, and Alarm Entry, page 5-29.	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 Command	No	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

• srom cfg ip display Command

• srom cfg ip modify Command

• pdm busmode display Command

• pdm busmode modify Command

• pdm cfg threshold bus display Command

• pdm cfg threshold bus modify Command

• gain gain display Command

• gain gain modify Command

• voa power input display Command

6.2.1 srom cfg boot display Command

Command: srom cfg boot display

Syntax: srom cfg boot display

Description: 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 4

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

Boot Record 2 type 2 Flash

IP Address 0.0.0.0

Filename

Boot Record 3 type 2 Flash

IP Address 0.0.0.0

Filename

CRC-32 8bd3cb56

6.2.2 srom cfg boot modify Command

Command: srom cfg boot modify

Syntax: srom cfg boot modify

Description: 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 = 4




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

Boot Record 2 type 2 Flash




Boot Record 3 type 2 Flash




---

Note Boot type 1 = TFTP and boot type 2 = Flash.

---

6.2.3 srom cfg ip display Command

Command: srom cfg ip display

Syntax: srom cfg ip display

Description: 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: srom cfg ip modify

Description: 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: pdm busmode display

Description: Displays power bus mode (simplex or duplex).

6.2.6 pdm busmode modify Command

Command: pdm busmode modify

Syntax: pdm busmode modify {simplex | duplex}

Description: 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: pdm cfg threshold bus display

Description: 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: pdm cfg threshold bus modify

Description: 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: gain gain display

Description: 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: gain gain modify value

Description: 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: voa power input display

Description: Displays variable optical attenuator (VOA) power input.

6.3 Administrative Commands

The following commands are useful in administering the ONS 15216 EDFA2:

• clear Command

• exit Command

• help Command

• history Command

• login and logoff Commands

• processor reset Command

6.3.1 clear Command

Command: clear

Syntax: clear

Description: Clears content from the terminal window. An empty screen with a cursor appears.

6.3.2 exit Command

Command: exit

Syntax: exit

Description: Ends the session with the ONS 15216 EDFA2.

6.3.3 help Command

Command: help

Syntax: help

Description: Displays a list of all CLI commands for current user security level.

6.3.4 history Command

Command: history

Syntax: history

Description: 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: login or logoff

Description: 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: processor reset

Description: 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 lines set Command

• shell more enable and disable Commands

• shell status display Command

• shell type modify Command

6.4.1 shell lines set Command

Command: shell lines set

Syntax: shell lines set #lines

Description: 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: shell more {enable | disable}

Description: 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: shell status display

Description: 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: shell type modify {tl1 | ash}

Description: Sets the shell type to TL1 or ASH for the ONS 15216 EDFA2's 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: ffs file list

Description: 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.1.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.0.1 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 attribute get Command

• snmp attribute list Command

• snmp attribute set Command

• snmp mib display Command

• snmp mib get Command

• snmp mib list Command

• snmp row display Command

• snmp row get Command

• snmp row set Command

• snmp session version get Command

• snmp subtree display Command

• snmp subtree get Command

• snmp subtree list Command

• snmp table display Command

• snmp table get Command

• snmp table list Command

• snmp tree attribute list Command

6.6.1 snmp attribute get Command

Command: snmp attribute get

Syntax: snmp attribute get {IP_address | local} attribute_name index

Description: 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 "ONS15216 vx.x.x ONS15216 vx.x.x, Serial No

00000000100520, MAC Addr 0010b4000b12"

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: snmp attribute list {IP_address | local} attribute_name

Description: 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: 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: snmp mib display {IP_address | local} -all

Description: 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: snmp mib get {IP_address | local}

Description: 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: snmp mib list {IP_address | local

Description: 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: snmp row display {IP_address | local} row_name index

Description: 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;

6.6.8 snmp row get Command

Command: snmp row get

Syntax: snmp row get {IP_address | local} row_name index

Description: 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

true 1000 200 100 -2400 100 5 1 65 1

6.6.9 snmp row set Command

Command: snmp row set

Syntax: snmp row set {IP_address | local} row_name index

Description: 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 session version get Command

Command: snmp session version get

Syntax: snmp session version get {IP_address | local}

Description: Displays the SNMP version for the session. See Example 6-22.

Example 6-22 snmp session version get Command

ash:hostname:ONS15216 EDFA2> snmp session version get local




host 172.22.82.19

version v1

6.6.11 snmp subtree display Command

Command: snmp subtree display

Syntax: snmp subtree display {IP_address | local} subtree

Description: Displays the attributes below a node in a SNMP tree. See Example 6-23.

Example 6-23 snmp subtree display Command

ash:hostname:ONS15216 EDFA2> snmp subtree display local cerent




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.12 snmp subtree get Command

Command: snmp subtree get

Syntax: snmp subtree get {IP_address | local} subtree

Description: Accesses a subtree. See Example 6-24.

Example 6-24 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

...

6.6.13 snmp subtree list Command

Command: snmp subtree list

Syntax: snmp subtree list {IP_address | local}

Description: Lists the attributes below a node in a SNMP tree. See Example 6-25.

Example 6-25 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.1.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.14 snmp table display Command

Command: snmp table display

Syntax: snmp table display {IP_address | local}

Description: Displays table data for the ONS 15216 EDFA2. Example 6-26 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-26.

Example 6-26 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.1.0, Serial No DIT0533000P, MA

C Addr 00059a383d10";

sysObjectID = { cerent15216EdfaNode };

sysUpTime = 35942955;

sysContact = "";

sysName = "sysname";

sysLocation = "";

sysServices = 0;

sysORLastChange = 120;

};

6.6.15 snmp table get Command

Command: snmp table get

Syntax: snmp table get {IP_address | local} table

Description: Accesses table data. See Example 6-27.

Example 6-27 snmp table get Command

ash:hostname:ONS15216 EDFA2> snmp table get local system

attributes

sysDescr "hostname, Hardware Rev A1, ONS15216 EDFA2,

v2.1.0, Serial No DIT0533000P, MAC Addr 00059a383d10"

sysObjectID cerent15216EdfaNode

sysUpTime 1330310

sysContact "username"

sysName "sysname"

sysLocation "Lab"

sysServices 0

sysORLastChange 125

6.6.16 snmp table list Command

Command: snmp table list

Syntax: snmp table list {IP_address | local} table

Description: Lists all the data within a table. Example 6-28 below displays the command for the UDP (User Datagram Protocol) table. This command displays data by attribute.

Example 6-28 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.0.0.0.0.7 = 0.0.0.0;

udpLocalAddress.172.22.82.19.161 = 172.22.82.19;

udpLocalPort.0.0.0.0.7 = 7;

udpLocalPort.172.22.82.19.161 = 161;

6.6.17 snmp tree attribute list Command

Command: snmp tree attribute list

Syntax: snmp tree attribute list

Description: Lists all the attributes implemented by the SNMP agent. See Example 6-29.

Example 6-29 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 entry create Command

• user entry edit Command

• user entry delete Command

• user file display and user name display Commands

• user inactivity modify and user inactivity display Commands

• user passwd set Command

• user active list Command

• user active message send Command

6.7.1 user entry create Command

Command: user entry create

Syntax: user entry create name user_mode

Description: 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-30.

Example 6-30 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: user entry edit username

Description: Edit a user's parameters (name, password, and access level). This command uses the optional parameters shown at the beginning of Example 6-31. 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-32.

Example 6-31 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-32 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: user entry delete username

Description: Delete users. See Example 6-33.

Example 6-33 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: user file display or user name display

Description: 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-34.

Example 6-34 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: user inactivity modify levelvalue or user inactivity display

Description: 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-35 and Example 6-36.

Example 6-35 user inactivity modify Command

ash:hostname:ONS15216 EDFA2> user inactivity modify read 75

Example 6-36 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-37 displays the user passwd set syntax for a current user. Example 6-38 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-37 Changing Current User's Password

ash:hostname:ONS15216 EDFA2> user passwd set

Password =

*****

New Password =

*******

Confirm New Password =

*******

Example 6-38 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: user active list

Description: Displays a list of the active users. See Example 6-39.

Example 6-39 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: user active message send ["message"]

Description: Sends a message to all current users on the system. See Example 6-40.

Example 6-40 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: snmp table display local entPhysicalEntry

Description: Displays the trap destination database. See Example 6-41.

Example 6-41 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 = "v1.2.0";

entPhysicalSoftwareRev = "v1.3.0";

entPhysicalSerialNum = "DIT0533000P";

entPhysicalMfgName = "Cisco";

entPhysicalModelName = "ONS216EDFA";

entPhysicalAlias = "";

entPhysicalAssetID = "";

entPhysicalIsFRU = true;

};

6.8.2 snmp table display local cerent15216EdfaCommTrapEntry Command

Command: snmp table display local cerent15216EdfaCommTrapEntry

Syntax: snmp table display local cerent15216EdfaCommTrapEntry

Description: Displays information about autonomous messages (SNMP traps) going to destination manager's location (IP address).

Example 6-42 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: manufacturer restore defaults passwords

Description: 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: manufacturer restore defaults all

Description: Restores the manufacturing factory settings to the ONS 15216 EDFA2.

Posted: Sun Apr 2 12:12:55 PDT 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.