cc/td/doc/product/ong/15216/216edf
hometocprevnextglossaryfeedbacksearchhelp
PDF

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.

hometocprevnextglossaryfeedbacksearchhelp

Posted: Sun Apr 2 01:56:47 PST 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.