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 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.14 snmp table get Command

6.6.15 snmp table list Command

6.6.16 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 Restore Commands

6.9.1 backup system Command

6.9.2 restore system Command

6.10 Manufacturer Mode

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	RWA
clear	Clears the shell screen. See clear Command.	Yes	Yes	Yes
backup system	Backs up configuration information to file. See backup system Command.	No	No	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. See FTP Command Line, page 7-1	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
restore system	Restores configuration from backup file. See restore system Command.	No	No	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-22, IP Address, page 5-24, and Alarm Entry, page 5-36.	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 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:

• clear Command

• exit Command

• help Command

• history Command

• login and logoff Commands

• processor reset Command

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..10])         name of user

6.3.6 processor reset Command

Command

processor reset

Syntax Description

processor reset

Resets the processor on the ONS 15216 EDFA2. Although the performance of the amplifier is not affected, 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 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 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.3.0     1   fffc  xxxxxxx    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 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 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 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

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.3.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.3.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.3.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 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 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. Special characters are +, #, and %, 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. Special characters are +, #, and %, 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.3.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 Restore Commands

6.9.1 backup system Command

Command

backup system

Syntax Description

backup system filename

Creates a backup file on the FFS with the configuration information of the ONS 15216 EDFA2. This file contains manufacturing information about the unit that is being backed up (such as part number and serial number), setup information for the unit (such as IP address and host name), all configuration information (such as alarm thresholds and pump mode), and the user database.

6.9.2 restore system Command

Command

restore system

Syntax Description

restore system filename

Restores the configuration information from a backup file on the FFS to the ONS 15216 EDFA2. During this process, all configuration information (such as alarm thresholds and pump mode) and the user database from the file are replaced in the ONS 15216 EDFA2 memory and FFS. Before the restore begins, a cyclic redundancy code (CRC) check is performed to ensure data integrity.

6.10 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.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-14.

---

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.

---