cc/td/doc/product/mels/15501/4_1
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table Of Contents

Command Reference

add-snmp-com

add-snmp-mgr

alarm

boot-bank

copyright

del-snmp-com

del-snmp-mgr

ethmode

gain

gainmean

gaintrig

get-snmp-com

get-snmp-mgr

help

hide-trap

host-config

inpwr

inpwrmean

inpwrtrig

ip-config

logout

neighbor-in

neighbor-out

ntp

ntp-ip

optoutpwr

outsigpwr

outsigpwrmean

outsigpwrtrig

ping

ps1

ps2

reboot

resetmeantrig

restore

setgainmean

setgaintrig

setinpwrmean

setinpwrtrig

set-master-pwd

setoutsigpwrmean

setoutsigpwrtrig

settempmean

settemptrig

set-time

set-user-pwd

sgain

show-trap

sinpwr

soutsigpwr

sps1

sps2

spump

status

stemp

sw-download

sys-info

temp

tempmean

temptrig

time

timeout

timezone


Command Reference


This chapter describes the commands used in the Cisco ONS 15501 environment. The commands are listed alphabetically.


Note To display a list of available commands, enter help. To obtain the syntax for any individual command, enter help [command].



Note All commands are case insensitive.



Note Commands that change the configuration of the control module are protected by the master password. Commands that allow access to information but do not change the configuration are protected by the user password.


add-snmp-com

To add an SNMP community string to the system, use the add-snmp-com command.

add-snmp-com community-string [ro | rw]

Syntax Description

community-string

Specifies the SNMP community string to be added to the system. The string can be comprised of any alphanumeric combination. The maximum number of characters allowed is 21.

[ro | rw]

(Optional) Specifies read only or both read and write access associated with the community string.


Defaults

The default access mode is ro.

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The Cisco ONS 15501 supports up to 16 SNMP community strings.

Examples

The following example shows how to add an SNMP community string to the system.

edfa > add-snmp-com abcd

Related Commands

Command
Description

del-snmp-com

Deletes an SNMP community string from the system.

get-snmp-com

Displays an SNMP community string in the system.


add-snmp-mgr

To add or modify an SNMP manager entry to the system, use the add-snmp-mgr command.

add-snmp-mgr manager-ip [version]

Syntax Description

manager-ip

Specifies the IP address of the host running the SNMP manager.

version

(Optional) Specifies the SNMP version. Valid values are v1 or v2c.


Defaults

The default version is v2c.

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.

EDFA 4.0

Added version option.


Usage Guidelines

The Cisco ONS 15501 uses the SNMP manager address to direct SNMP trap and inform notifications. No notifications are sent unless at least one SNMP manager address is configured. The Cisco ONS 15501 accepts a maximum of 16 IP managers.

Examples

The following example shows how to add an SNMP manager entry to the system.

edfa > add-snmp-mgr 10.1.2.71

Related Commands

Command
Description

del-snmp-mgr

Deletes an SNMP manager entry from the system.

get-snmp-mgr

Displays an SNMP manager entry in the system.


alarm

To display a list of alarms in the system, use the alarm command.

alarm

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.

EDFA 4.0

Added time index to output.


Examples

The following example shows how to display a list of alarms in the system.

edfa > alarm Power Supply voltage level out of range (PS1) - @ 9

boot-bank

To display the active and planned boot bank or to modify the active boot bank, use the boot-bank command.

boot-bank [flash-bank]

Syntax Description

flash-bank

(Optional) Specifies the Flash bank from which the system is booted. This should be 1, 2, or 3.


Defaults

Displays the active boot bank

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The active boot bank is the Flash bank from which the system was booted. The planned boot bank is the Flash bank from which the system will next be booted.

Examples

The following example shows how to modify the active boot bank.

edfa > boot-bank 2

The following example shows how to display the active boot bank.

edfa > boot-bank Active flash bank number: 1 Planned flash bank number: 1

copyright

To display the copyright information, use the copyright command.

copyright

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 2.0

This command was introduced.


Examples

The following example shows the copyright information.

edfa > copyright **************************************************************************** * * Copyright © 2002, Cisco Systems, Inc. * Cisco Systems, Inc. * 170 West Tasman Drive * San Jose, CA 95134 * * Based on software developed by, licensed under or Copyright * by one or more of * - GNU GENERAL PUBLIC LICENSE Version 2, June 1991 * - Carnegie Mellon University * - Regents of the University of California * - University of California, Berkeley and its contributors. * ****************************************************************************

del-snmp-com

To delete an SNMP community string from the system, use the del-snmp-com command.

del-snmp-com community-string

Syntax Description

community-string

Specifies the SNMP community string to be deleted from the system.


Defaults

None

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to delete an SNMP community string from the system.

edfa > del-snmp-com abcd

Related Commands

Command
Description

add-snmp-com

Adds an SNMP community string to the system.

get-snmp-com

Displays an SNMP community string in the system.


del-snmp-mgr

To delete an SNMP manager entry from the system, use the del-snmp-mgr command.

del-snmp-mgr manager-ip

Syntax Description

manager-ip

Specifies the IP address of the host running the SNMP manager.


Defaults

None

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The Cisco ONS 15501 uses the SNMP manager address to direct SNMP trap and inform notifications. No notifications are sent unless at least one SNMP manager address is configured.

Examples

The following example shows how to delete an SNMP manager entry from the system.

edfa > del-snmp-mgr 10.1.2.71

Related Commands

Command
Description

add-snmp-mgr

Adds or modifies an SNMP manager entry.

get-snmp-mgr

Displays the SNMP manager entries on the system.


ethmode

To display or modify the Ethernet boot mode, use the ethmode command.

ethmode [mode]

Syntax Description

mode

Specifies the Ethernet boot mode. The boot mode is specified as 0 for auto-sense; 1 for full-duplex at 100 Mbps; 2 for half-duplex at 100 Mbps; 3 for full-duplex at 10 Mbps; or 4 for half-duplex at 10 Mbps.


Defaults

Displays the current Ethernet boot mode.

The default mode value is 4.

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

To display the current Ethernet boot mode, enter the command without the mode argument.

The system default Ethernet boot mode is 4 for half-duplex at 10 Mbps.

After setting a new Ethernet boot mode, the system must be rebooted for the change to take affect.

Examples

The following example shows how to display the Ethernet boot mode.

edfa > ethmode ethernet init-mode 4

The following example shows how to modify the Ethernet boot mode.

edfa > ethmode 3 ethernet init-mode updated to 3

gain

To display the measured optical signal gain, use the gain command.

gain

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for measured optical signal gain is displayed in decibels (dBs).

Examples

The following example shows how to display the measured optical signal gain.

edfa > gain 17.50 (dB)

Related Commands

Command
Description

gainmean

Displays the configured signal gain and alarm mean level.

gaintrig

Displays the gain alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setgainmean

Sets the signal gain and alarm mean level.

setgaintrig

Sets the gain alarm trigger level.

sgain

Displays the state of the gain error monitor.


gainmean

To display the configured signal gain and alarm mean level, use the gainmean command.

gainmean

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for configured Cisco ONS 15501 signal gain and alarm mean level is displayed in decibels (dB).

Examples

The following example shows how to display the configured signal gain and alarm mean level.

edfa > gainmean 17.50 (dB)

Related Commands

Command
Description

gain

Displays the measured optical signal gain.

gaintrig

Displays the gain alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setgainmean

Sets the signal gain and alarm mean level.

setgaintrig

Sets the gain alarm trigger level.


gaintrig

To display the gain alarm trigger level, use the gaintrig command.

gaintrig

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for Cisco ONS 15501 gain alarm trigger level is displayed in decibels (dB).

Examples

The following example shows how to display the gain alarm trigger level.

edfa > gaintrig 1.00 (dB)

Related Commands

Command
Description

gain

Displays the measured optical signal gain.

gainmean

Displays the configured signal gain and alarm mean level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setgainmean

Sets the signal gain and alarm mean level.

setgaintrig

Sets the gain alarm trigger level.


get-snmp-com

To display the SNMP community strings in the system, use the get-snmp-com command.

get-snmp-com community-string

Syntax Description

community-string

Specifies the SNMP community string to be displayed.


Defaults

Displays all SNMP community strings in the system

Command Types

Does not change configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display an SNMP community string in the system.

edfa > get-snmp-com abcd A list of the SNMP community string ======================================= private abcd

Related Commands

Command
Description

add-snmp-com

Adds an SNMP community string to the system.

del-snmp-com

Deletes an SNMP community string from the system.


get-snmp-mgr

To display the SNMP manager entries on the system, use the get-snmp-mgr command.

get-snmp-mgr

Syntax Description

This command has no arguments or keywords.


Defaults

Displays all IP values of the SNMP manager

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

This command displays SNMP manager configuration information for all entries on the system.

Examples

The following example shows how to display the values of SNMP managers.

edfa > get-snmp-mgr A list of the SNMP manager IP addresses =========================================== 209.128.68.147 10.1.2.71

Related Commands

Command
Description

add-snmp-mgr

Adds or modifies an SNMP manager entry to the system.

del-snmp-mgr

Deletes an SNMP manager entry from the system.


help

To display the syntax for an individual command or to display a list of available user commands, use the help command.

help [command]

Syntax Description

command

(Optional) Specifies the command.


Defaults

Displays the list of available commands

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

If there is a command specified, the corresponding help for that command is printed. Without any command specified, a list of all commands is shown.

Examples

The following example shows the list of available commands when logged on with the user password.

edfa > help STATUS: Alarm, Gain, GainMean, GainTrig, InPwr, InPwrMean, InPwrTrig, OptOutPwr, OutSigPwr, OutSigPwrMean, OutSigPwrTrig, SGain, SInPwr, SOutSigPwr, SPs1, SPs2, SPump, Status, STemp, Temp, TempMean, TempTrig

SYSTEM: copyright, ethmode, get-snmp-mgr, help, host-config, ip-config, logout, neighbor-in, neighbor-out, ntp, ntp-ip, sys-info, time, timeout, timezone

MAINTENANCE: hide-trap, show-trap

The following example shows the list of available commands when logged on with the master password.

edfa > help      STATUS: Alarm, Gain, GainMean, GainTrig, InPwr, InPwrMean, InPwrTrig, OptOutPwr, OutSigPwr, OutSigPwrMean, OutSigPwrTrig, SGain, SInPwr, SOutSigPwr, SPs1  SPs2, SPump, Status, STemp, Temp, TempMean, TempTrig

SETUP: ResetMeanTrig, SetGainMean, SetGainTrig, SetInPwrMean,   SetInPwrTrig, SetOutSigPwrMean, SetOutSigPwrTrig, SetTempMean, SetTempTrig

SYSTEM: add-snmp-com, add-snmp-mgr, copyright, del-snmp-com, del-snmp-mgr, ethmode, get-snmp-com, get-snmp-mgr, help, host-config, ip-config, logout, neighbor-in, neighbor-out, ntp, ntp-ip, ping, set-master-pwd, set-time, set-user-pwd, sys-info, time, timeout, timezone

MAINTENANCE: boot-bank, hide-trap, reboot, show-trap, sw-download

hide-trap

To hide the trap message, use the hide-trap command.

hide-trap

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Changes configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to hide the trap message.

edfa > hide-trap

Related Commands

Command
Description

show-trap

Displays the trap message.


host-config

To display or modify the current host name, use the host-config command.

host-config [hostname]

Syntax Description

hostname

(Optional) Specifies the host name. The hostname argument can have a maximum of 15 characters. Use only alphanumeric characters, hyphens, periods, and underscores.


Defaults

Displays the current host name

Command Types

Changes configuration

Command Modes

Master password protected. User password allows access to the current host name, but does not allow modifications.

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to modify the current host name.

edfa > host-config ADM-EAST ADM-EAST >

inpwr

To display the measured optical input power, use the inpwr command.

inpwr

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for optical input power is displayed in decibels per milliwatt (dBm).

Examples

The following example shows how to display the optical input power.

edfa > inpwr -46.03 (dBm)

Related Commands

Command
Description

inpwrmean

Displays the optical input alarm mean level.

inpwrtrig

Displays the optical input alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setinpwrmean

Sets the optical input alarm mean level.

setinpwrtrig

Sets the optical input alarm trigger level.

sinpwr

Displays the state of the optical input level alarm monitor.


inpwrmean

To display the optical input alarm mean level, use the inpwrmean command.

inpwrmean

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for optical input alarm mean level is displayed in decibels per milliwatt (dBm).

Examples

The following example shows how to display the optical input alarm mean level.

edfa > inpwrmean -38.00 (dBm)

Related Commands

Command
Description

inpwr

Displays the measured optical input power.

inpwrtrig

Displays the optical input alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setinpwrmean

Sets the optical input alarm mean level.

setinpwrtrig

Sets the optical input alarm trigger level.


inpwrtrig

To display the optical input alarm trigger level, use the inpwrtrig command.

inpwrtrig

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for optical input alarm trigger level is displayed in decibels (dB).

Examples

The following example shows how to display the optical input alarm trigger level.

edfa > inpwrtrig 1.00 (dB)

Related Commands

Command
Description

inpwr

Displays the measured optical input power.

inpwrmean

Displays the optical input alarm mean level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setinpwrmean

Sets the optical input alarm mean level.

setinpwrtrig

Sets the optical input alarm trigger level.


ip-config

To display or modify the IP address, IP subnet mask and IP default gateway, use the ip-config command.

ip-config [ip-addr [ip-subnet-mask [def-gateway-ip]]]

Syntax Description

ip-addr

(Optional) Specifies the IP address.

ip-subnet-mask

(Optional) Specifies the IP subnet mask.

def-gateway-ip

(Optional) Specifies the IP address of the default gateway.


Defaults

If no values are entered, the command displays the current IP address, IP subnet mask, and default IP gateway.

If a value is entered for ip-addr, but not for ip-subnet-mask, the default IP subnet mask is 255.255.255.0.

If a value is entered for ip-addr, but not for def-gateway-ip, the default IP gateway is xx.yy.zz.1, where xx.yy.zz is obtained by binary AND of first three bytes of ip-addr and ip-subnet-mask.

Command Types

Changes configuration

Command Modes

User password protected for display; master password protected for modification.

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the IP address, IP subnet mask, and default IP gateway.

edfa > ip-config 10.1.2.221 255.255.255.0 10.1.2.1

The following example shows how to modify the IP address, IP subnet mask, and default IP gateway.

edfa > ip-config 192.168.0.10 255.255.255.240 192.168.0.1

logout

To log out of the system, use the logout command.

logout

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


neighbor-in

To display or modify the neighboring equipment details for optical input, use the neighbor-in command.

neighbor-in [[host link-host] [ip link-ip] [port link-port]] | [disable]

Syntax Description

host link-host

(Optional) Specifies the host name for input neighbor. The maximum length is 32 characters.

ip link-ip

(Optional) Specifies the IP address for input neighbor.

port link-port

(Optional) Specifies the name for the port on the remote host providing the input optical signal. The maximum length is 32 characters.

Note If the host or ip keywords are not present, the port keyword is not allowed.

disable

(Optional) Deletes the input neighbor information.

Note The disable option is not allowed with any other options.


Defaults

If no values are entered, the command displays the current input neighbor details.

Command Types

Changes configuration

Command Modes

User password protected for read; master password protected for write.

Command History

Release
Modification

EDFA 2.0

This command was introduced.


Usage Guidelines

In the absence of all arguments, the configured input neighbor network element (NE) information is shown.

To include space characters in the host or port, use double quotes (for example, neighbor-in host "DWDM phoenix 10"). Excluding the disable keyword, whenever a keyword is present, the keyword value must be given. Either host or ip are required, while port is optional. The disable keyword deletes the neighbor NE information.

Examples

The following example shows how to modify and display the input neighbor equipment information.

edfa > neighbor-in host box1 ip 192.168.0.4 port box1-port edfa > neighbor-in host box1 edfa > neighbor-in ip 192.168.0.4 edfa > neighbor-in host box1 port box1-port edfa > neighbor-in host box1 ip 192.168.0.4 edfa > neighbor-in ip 192.168.0.4 port box1-port edfa > neighbor-in disable edfa > neighbor-in                HOST: source1                PORT: out-2 IP ADDRESS: 10.1.5.41

The following example shows how to issue the neighbor-in command with all the parameters.

edfa > neighbor-in source1 ip 10.1.5.41 port out-2 edfa > neighbor-in HOST: source1 PORT: out-2 IP ADDRESS: 10.1.5.41

Related Commands

Command
Description

neighbor-out

Displays and modifies the neighboring equipment information for optical output.


neighbor-out

To display or modify the neighboring equipment details for optical output, use the neighbor-out command.

neighbor-out [[host link-host] [ip link-ip] [port link-port]] | [disable]

Syntax Description

host link-host

(Optional) Specifies the host name for the output neighbor. The maximum length is 32 characters.

ip link-ip

(Optional) Specifies the IP address for the output neighbor.

port link-port

(Optional) Specifies the name for the port on the remote host receiving the output optical signal. The maximum length is 32 characters.

Note If the host or ip keywords are not present, the port keyword is not allowed.

disable

(Optional) Deletes the output neighbor information.

Note The disable option is not allowed with any other options.


Defaults

If no values are entered, the command displays the current output neighbor details.

Command Types

Changes configuration

Command Modes

User password protected for read. Master password protected for write.

Command History

Release
Modification

EDFA 2.0

This command was introduced.


Usage Guidelines

In the absence of all arguments, the configured output neighbor network element (NE) information is shown.

To include space characters in the host or port, use double quotes (for example, neighbor-out host "DWDM phoenix 10"). Excluding the disable keyword, whenever a keyword is present, the keyword value must be given. Either host or ip are required, while port is optional. The disable keyword deletes the neighbor NE information.

Examples

The following example shows how to modify and display the output neighboring equipment information.

edfa > neighbor-out host box1 ip 192.168.0.4 port box1-port edfa > neighbor-out host box1 edfa > neighbor-out ip 192.168.0.4 edfa > neighbor-out host box1 port box1-port edfa > neighbor-out host box1 ip 192.168.0.4 edfa > neighbor-out ip 192.168.0.4 port box1-port edfa > neighbor-out disable edfa > neighbor-out                HOST: dest1                PORT: in-2 IP ADDRESS: 10.1.71.41

The following example shows how to issue the neighbor-out command with all the parameters.

edfa > neighbor-out dest1 ip 10.1.7.31 port in-1 edfa > neighbor-out HOST: dest1 PORT: in-1 IP ADDRESS: 10.1.5.41

Related Commands

Command
Description

neighbor-in

Displays and modifies the neighboring equipment information for optical input.


ntp

To modify or display the NTP (Network Time Protocol) status for the system, use the ntp command.

ntp [status]

Syntax Description

status

(Optional) Specifies on to enable the NTP or off to disable the NTP.


Defaults

Displays the current configuration of the NTP (that is, on or off), as well as the current IP addresses of the primary and secondary NTP servers

Command Types

Changes configuration

Command Modes

User password protected for display; master password protected for modification.

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

When the NTP is on, the status (up or down) of the NTP servers is displayed if no argument is provided for the command.

Examples

The following example shows how to enable the NTP for the system.

edfa > ntp on

The following example shows how to display the current configuration of the NTP.

edfa > ntp ON, 209.128.68.149:UP, 209.128.68.147:DOWN

Related Commands

Command
Description

ntp-ip

Modifies or displays the IP addresses of the NTP server.


ntp-ip

To modify or display the IP addresses of the NTP (Network Time Protocol) server, use the ntp-ip command.

ntp-ip [ip-addr1 [ip-addr2]]

Syntax Description

ip-addr1

(Optional) Specifies the IP address of the primary NTP server.

ip-addr2

(Optional) Specifies the IP address of the secondary NTP server.


Defaults

Displays the current IP addresses of the primary and secondary NTP servers.

If only one value is entered, that value is applied to the IP address of the primary NTP server.

Command Types

Changes configuration

Command Modes

User password protected for display; master password protected for modification.

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to modify the IP address of the primary and secondary NTP servers.

edfa > ntp-ip 209.128.68.149 209.128.68.147

The following example shows how to display the current IP addresses of the primary and secondary NTP servers.

edfa > ntp-ip 209.128.68.149, 209.128.68.147

Related Commands

Command
Description

ntp

Enables or disables the NTP for the system.


optoutpwr

To display the optical output power, use the optoutpwr command.

optoutpwr

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for optical output power is displayed in decibels per milliwatt (dBm).

Examples

The following example shows how to display the optical output power.

edfa > optoutpwr -28.53 (dBm)

outsigpwr

To display the calculated output signal power, use the outsigpwr command.

outsigpwr

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for calculated output signal power is displayed in decibels per milliwatt (dBm).

Examples

The following example shows how to display the calculated output signal power.

edfa > outsigpwr -28.53 (dBm)

Related Commands

Command
Description

outsigpwrmean

Displays the output signal alarm mean level.

outsigpwrtrig

Displays the output signal alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setoutsigpwrmean

Sets the output signal alarm mean level.

setoutsigpwrtrig

Sets the output signal alarm trigger level.

soutsigpwr

Displays the state of the signal output power monitor.


outsigpwrmean

To display the output signal alarm mean level, use the outsigpwrmean command.

outsigpwrmean

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for output signal alarm mean level is displayed in decibels per milliwatt (dBm).

Examples

The following example shows how to display the output signal alarm mean level.

edfa > outsigpwrmean 2.00 (dBm)

Related Commands

Command
Description

outsigpwr

Displays the calculated output signal power.

outsigpwrtrig

Displays the output signal alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setoutsigpwrmean

Sets the output signal alarm mean level.

setoutsigpwrtrig

Sets the output signal alarm trigger level.


outsigpwrtrig

To display the output signal alarm trigger level, use the outsigpwrtrig command.

outsigpwrtrig

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The value for output signal alarm trigger level is displayed in decibels (dB).

Examples

The following example shows how to display the output signal alarm trigger level.

edfa > outsigpwrtrig 20.00 (dB)

Related Commands

Command
Description

outsigpwr

Displays the calculated output signal power.

outsigpwrmean

Displays the output signal alarm mean level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setoutsigpwrmean

Sets the output signal alarm mean level.

setoutsigpwrtrig

Sets the output signal alarm trigger level.


ping

To ping an IP address, use the ping command.

ping ip-address [count]

Syntax Description

ip-address

Specifies the IP address of the host to ping.

count

(Optional) Specifies the number of ping packets to be sent. The range is 1 to 20.


.

Defaults

The default count is 5.

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

If no value is entered for the count, the system defaults to 5. The system accepts a maximum count of 20.

If the ping command is issued from a Telnet session, pressing Ctrl-c stops the ping. If the ping command is issued from a serial port, pressing Ctrl-c does not stop the ping.

Examples

The following example shows how to ping an IP address.

edfa > ping 192.168.0.1 PING 192.168.0.1 (192.168.0.1): 56 data bytes

--- 192.168.0.1 ping statistics --- 5 packets transmitted, 0 packets received, 100% packet loss

ps1

To display the voltage of DC power supply 1, use the ps1 command.

ps1

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the voltage of power supply 1.

edfa > ps1 -49.51 (vDC)

Related Commands

Command
Description

ps2

Displays the voltage of DC power supply 2.

sps1

Displays the status of the power supply 1 alarm monitor.

sps2

Displays the status of the power supply 2 alarm monitor.


ps2

To display the voltage of DC power supply 2, use the ps2 command.

ps2

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the voltage of power supply 2.

edfa > ps2 -49.43 (vDC)

Related Commands

Command
Description

ps1

Displays the voltage of DC power supply 1.

sps1

Displays the status of the power supply 1 alarm monitor.

sps2

Displays the status of the power supply 2 alarm monitor.


reboot

To reboot the software on the Cisco ONS 15501, use the reboot command.

reboot

Syntax Description

This command has no arguments or keywords.


Defaults

The system reboots using the image for planned boot bank.

Command Types

Does not change configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


resetmeantrig

To reset the alarm mean and trigger levels for signal gain, optical input power, output signal power, and internal case temperature to the manufacturer's default settings, use the resetmeantrig command.

resetmeantrig

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The manufacturer's default setting can be found in Table 1-2.

Related Commands

Command
Description

gainmean

Displays the configured signal gain and alarm mean level.

gaintrig

Displays the gain alarm trigger level.

inpwrmean

Displays the optical input alarm mean level.

inpwrtrig

Displays the optical input alarm trigger level.

outsigpwrmean

Displays the output signal alarm mean level.

outsigpwrtrig

Displays the output signal alarm trigger level.

setgainmean

Sets the signal gain and alarm mean level.

setgaintrig

Sets the gain alarm trigger level.

setoutsigpwrmean

Sets the output signal alarm mean level.

setoutsigpwrtrig

Sets the output signal alarm trigger level.

setinpwrtrig

Sets the optical input alarm trigger level.

settempmean

Sets the internal case temperature alarm mean level.

settemptrig

Sets the internal case temperature alarm trigger level.

tempmean

Displays the internal case temperature alarm mean level.

temptrig

Displays the internal case temperature alarm trigger level.


restore

To restore the system and network settings of the control module, including all passwords, to the manufacturer's default settings, use the restore command.

restore

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Changes configuration

Command Modes

No password is required.

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

This command can be used only from a serial port, not in a Telnet session.

Once connected to the serial port, you must press the Enter key within 15 seconds after the password prompt appears following a system reboot.

The command resets the user password to edfa.

The command does not reset any of the module settings; use the resetmeantrig command for that purpose.

We recommend rebooting the system after using this command; the default settings are not activated until the system reboots.

The restore command does not appear in the help command output, because the restore command is only a valid command during the first 15 seconds after a reboot.

Related Commands

Command
Description

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.


setgainmean

To modify the signal gain and alarm mean, use the setgainmean command.

setgainmean mean

Syntax Description

mean

Specifies the desired signal gain and alarm mean.


Defaults

17.5 dB

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The signal gain and alarm mean are measured in decibels (dB). The system accepts a minimum value of 7 dB and a maximum value of 17.5 dB. If a value entered falls outside of this acceptable range, the command is ignored and has no effect.

Examples

The following example shows how to modify the signal gain and alarm mean.

edfa > setgainmean 17.00

Related Commands

Command
Description

gain

Displays the measured optical signal gain.

gainmean

Displays the configured signal gain and alarm mean level.

gaintrig

Displays the gain alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setgaintrig

Sets the gain alarm trigger level.


setgaintrig

To modify the signal gain alarm trigger level, use the setgaintrig command.

setgaintrig trigger

Syntax Description

trigger

Specifies the desired signal gain and alarm trigger.


Defaults

1.00 dB

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The signal gain alarm trigger level is measured in decibels (dB). See Table 1-2 for the minimum and maximum values. If a value entered falls outside of this acceptable range, the command is ignored and has no effect.

Examples

The following example shows how to modify the gain alarm trigger level.

edfa > setgaintrig 2.00

Related Commands

Command
Description

gain

Displays the measured optical signal gain.

gainmean

Displays the configured signal gain and alarm mean level.

gaintrig

Displays the gain alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setgainmean

Sets the signal gain and alarm mean level.


setinpwrmean

To set the optical input alarm mean level, use the setinpwrmean command.

setinpwrmean mean

Syntax Description

mean

Specifies the desired optical input alarm mean level.


Defaults

-20.00 dB

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The optical input alarm mean is measured in decibels per milliwatt (dB). See Table 1-2 for the minimum and maximum values. If a value entered falls outside of this acceptable range, the command is ignored and has no effect.

Examples

The following example shows how to set the optical input alarm mean level.

edfa > setinpwrmean -28.00

Related Commands

Command
Description

inpwr

Displays the measured optical input power.

inpwrmean

Displays the optical input alarm mean level.

inpwrtrig

Displays the optical input alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setinpwrtrig

Sets the optical input alarm trigger level.


setinpwrtrig

To set the optical input alarm trigger level, use the setinpwrtrig command.

setinpwrtrig trigger

Syntax Description

trigger

Specifies the desired optical input alarm trigger level.


Defaults

10.00 dB

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The optical input alarm trigger is measured in decibels (dB). See Table 1-2 for the minimum and maximum values. If a value entered falls outside of this acceptable range, the command is ignored and has no effect.

Examples

The following example shows how to set the optical input alarm trigger level.

edfa > setinpwrtrig 2.00

Related Commands

Command
Description

inpwr

Displays the measured optical input power.

inpwrmean

Displays the optical input alarm mean level.

inpwrtrig

Displays the optical input alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setinpwrmean

Sets the optical input alarm mean level.


set-master-pwd

To modify the master password for the system, use the set-master-pwd command.

set-master-pwd

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

This command prompts the user for the old password, and then prompts twice for the new password. The new password entered for both prompts must match. The default master password is edfa1.

Examples

The following example shows how to modify the master password for the system.

edfa > set-master-pwd Old Master Password: New Password: New Password:

Related Commands

Command
Description

set-user-pwd

Sets a new user password for the system.


setoutsigpwrmean

To set the output signal alarm mean level, use the setoutsigpwrmean command.

setoutsigpwrmean mean

Syntax Description

mean

Specifies the desired output signal alarm mean level.


Defaults

2.00 dBm

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The output signal alarm mean is measured in decibels per milliwatt (dBm). See Table 1-2 for the minimum and maximum values. If a value entered falls outside of this acceptable range, the command is ignored and has no effect.

Examples

The following example shows how to set the output signal alarm mean level.

edfa > setoutsigpwrmean 1.00

Related Commands

Command
Description

outsigpwr

Displays the calculated output signal power.

outsigpwrmean

Displays the output signal alarm mean level.

outsigpwrtrig

Displays the output signal alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setoutsigpwrtrig

Sets the output signal alarm trigger level.


setoutsigpwrtrig

To set the output signal alarm trigger level, use the setoutsigpwrtrig command.

setoutsigpwrtrig trigger

Syntax Description

trigger

Specifies the desired output signal alarm trigger level.


Defaults

20.00 dB

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The output signal alarm trigger is measured in decibels (dB). See Table 1-2 for the minimum and maximum values. If a value entered falls outside of this acceptable range, the command is ignored and has no effect.

Examples

The following example shows how to set the output signal alarm trigger level.

edfa > setoutsigpwrtrig 18.00

Related Commands

Command
Description

outsigpwr

Displays the calculated output signal power.

outsigpwrmean

Displays the output signal alarm mean level.

outsigpwrtrig

Displays the output signal alarm trigger level.

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

setoutsigpwrmean

Sets the output signal alarm mean level.


settempmean

To modify the internal case temperature alarm mean level, use the settempmean command.

settempmean mean

Syntax Description

mean

Specifies the desired internal case temperature alarm mean level.


Defaults

30°C

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The internal case temperature mean is measured in degrees Celsius. See Table 1-2 for the minimum and maximum values. If the value falls outside the acceptable range, the command is ignored and has no side effect.

Examples

The following example shows how to modify the internal case temperature alarm mean level.

edfa > settempmean 29.00

Related Commands

Command
Description

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

settemptrig

Sets the internal case temperature alarm trigger level.

temp

Displays the internal case temperature level.

tempmean

Displays the internal case temperature alarm mean level.

temptrig

Displays the internal case temperature alarm trigger level.


settemptrig

To set the internal case temperature alarm trigger level, use the settemptrig command.

settemptrig trigger

Syntax Description

trigger

Specifies the desired internal case temperature alarm trigger level.


Defaults

30°C

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The internal case temperature trigger is measured in degrees Celsius. See Table 1-2 for the minimum and maximum values. If a value entered falls outside of this acceptable range, the command is ignored and has no effect.

Examples

The following example shows how to set the internal case temperature alarm trigger level.

edfa > settemptrig 29.00

Related Commands

Command
Description

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

settempmean

Sets the internal case temperature alarm mean level.

temp

Displays the internal case temperature level.

tempmean

Displays the internal case temperature alarm mean level.

temptrig

Displays the internal case temperature alarm trigger level.


set-time

To display or modify the time of the system, use the set-time command.

set-time time

Syntax Description

time

Specifies the desired time of the system. The time must be entered in the same format as this example:

Fri Aug 24 20:50:31 2001 PST

PST is the time zone. See "Time Zone Codes," for a list of time zones and correlating abbreviations.


Defaults

The default time zone is GMT, Greenwich Mean Time.

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The day of the week must be specified as mon, tue, wed, thu, fri, sat, or sun. The system accepts entries with a capitalized first character, such as Mon, or entries entirely in lowercase, such as mon.

The month must be specified as jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, or dec. The system accepts entries with a capitalized first character, such as Jan, or entries entirely in lowercase, such as jan.

The day, hour, minute and second can all be specified by a one- or two-digit number. For example, the system accepts 1 and 01 as the same value.

The year must be a four-digit number, such as 2002.

See "Time Zone Codes," for a list of time zones and correlating abbreviations. The system accepts entries entirely in uppercase, such as PST, or entirely in lowercase, such as pst.

Examples

The following example shows how to display the time of the system.

edfa > time Time zone is set to PST Thu Jan 01 00:00:00 1970 PST

The following example shows how to modify the time of the system. edfa > set-time fri feb 8 1:2:30 2002 pst Time zone is set to PST Fri Feb 08 01:02:30 2002 PST

Related Commands

Command
Description

time

Displays the time of the system.

timezone

Displays or modifies the time zone of the system.


set-user-pwd

To modify the user password for the system, use the set-user-pwd command.

set-user-pwd

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

This command prompts the user for the old password, and then prompts twice for the new password. The new password entered for both prompts must match. The default user password is edfa.

Examples

The following example shows how to set the time of the system.

edfa > set-user-pwd Old Master Password: New Password: New Password:

Related Commands

Command
Description

set-master-pwd

Sets a new master password for the system.


sgain

To display the state of the gain error monitor, use the sgain command.

sgain

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 4.0

This command was introduced.


Usage Guidelines

Display values for this command are NORMAL and OUT-OF-RANGE.

Examples

The following example shows how to display the state of the gain error monitor.

edfa > sgain NORMAL

Related Commands

Command
Description

gain

Displays the measured optical signal gain.


show-trap

To display the trap message, use the show-trap command.

show-trap

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the trap message.

edfa > show-trap

Related Commands

Command
Description

hide-trap

Hides the trap message.


sinpwr

To display the state of the optical input level alarm monitor, use the sinpwr command.

sinpwr

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 4.0

This command was introduced.


Usage Guidelines

Display values for this command are NORMAL and OUT-OF-RANGE.

Examples

The following example shows how to display the state of the optical input level alarm monitor.

edfa > sinpwr NORMAL

Related Commands

Command
Description

inpwr

Displays the measured optical input power.


soutsigpwr

To display the state of the signal output power monitor, use the soutsigpwr command.

soutsigpwr

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 4.0

This command was introduced.


Usage Guidelines

Display values for this command are NORMAL and OUT-OF-RANGE.

Examples

The following example shows how to display the state of the signal output power monitor.

edfa > soutsigpwr NORMAL

Related Commands

Command
Description

outsigpwr

Displays the calculated output signal power.


sps1

To display the status of the power supply 1 alarm monitor, use the sps1 command.

sps1

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 4.0

This command was introduced.


Usage Guidelines

Display values for this command are NORMAL and OUT-OF-RANGE.

Examples

The following example shows how to display the status of the power supply 1 alarm monitor.

edfa > sps1 NORMAL

Related Commands

Command
Description

ps1

Displays the voltage of DC power supply 1.

sps2

Displays the status of the power supply 2 alarm monitor.


sps2

To display the status of the power supply 2 alarm monitor, use the sps2 command.

sps2

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 4.0

This command was introduced.


Usage Guidelines

Display values for this command are NORMAL and OUT-OF-RANGE.

Examples

The following example shows how to display the status of the power supply 2 alarm monitor.

edfa > sps2 NORMAL

Related Commands

Command
Description

ps2

Displays the voltage of DC power supply 2.

sps2

Displays the status of the power supply 2 alarm monitor.


spump

To display the state of the laser pump, use the spump command.

spump

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 4.0

This command was introduced.


Usage Guidelines

Display values for this command are GOOD and BAD.

Examples

The following example shows how to display the state of the laser pump.

edfa > spump GOOD

status

To display the measured, alarm mean and alarm trigger values for input power, internal case temperature, optical gain and output signal power, as well as the measured values for optical output power, use the status command.

status

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the status of the system.

edfa > status =============================================================================== Status Measured Mean Trigger

Input Optical Power NORMAL -15.84 (dB) -10.00 (dB) 15.00 (dB) Optical Gain NORMAL 6.99 (dB) 7.00 (dB) 0.50 (dB) Optical Output Power -8.72 (dBm) Output Signal Power NORMAL -8.77 (dB) -6.00 (dB) 18.00 (dB) Pump Laser GOOD Temperature NORMAL 29.53 (C) 25.10 (C) 29.90 (C) ===============================================================================

stemp

To display the state of the case temperature monitor, use the stemp command.

stemp

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 4.0

This command was introduced.


Usage Guidelines

Display values for this command are NORMAL and OUT-OF-RANGE.

Examples

The following example shows how to display the state of the case temperature monitor.

edfa > stemp NORMAL

Related Commands

Command
Description

temp

Displays the internal case temperature.


sw-download

To download a software image using FTP or TFTP and to burn the image to a specified Flash bank, use the sw-download command.

sw-download ftp server-ip username password path filename flashbank [passive]

sw-download tftp server-ip filepath flashbank

sw-download terminate

sw-download

Syntax Description

ftp

Specifies an FTP download.

server-ip

Specifies the IP address of the FTP or TFTP server that contains the image.

username

Specifies the username to log in to the FTP server.

password

Specifies the password of the user on the FTP server.

path

Specifies the path of the directory that contains the image on the FTP server.

filename

Specifies the name of the image file.

flashbank

Specifies the Flash bank where the image is to be transferred. It should be designated as 1, 2, or 3.

passive

(Optional) Specifies the string for FTP across a firewall. This is not required for FTP.

tftp

Specifies a TFTP download.

filepath

Specifies the fully qualified filename for the TFTP transfer.

terminate

Ends the software transfer in progress.


Defaults

None

Command Types

Changes configuration

Command Modes

Master password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

Use the terminate keyword to end the current download. For FTP failures across firewalls, try using the passive option. When burning a new image, the Flash bank specified cannot be the current Flash bank.

Examples

The following example shows how to download an image using FTP and burn the image to a specified Flash bank.

edfa > sw-download ftp 209.128.68.145 opruser oprpassword /home/load/bin EdfaImg.0.2 2

The following example shows how to download an image using TFTP and to burn the image to a specified Flash bank.

edfa > sw-download tftp 209.128.68.145 EdfaImg.0.2 2

sys-info

To display basic information about the system, including CLEI (Common Language Equipment Identifier) code, model number, serial number, MAC address, firmware version, and firmware build date, use the sys-info command.

sys-info

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

This command retrieves the information about the system. This include the manufacturer's name, firmware version, amplifier model number, serial number, Ethernet MAC address, and firmware update date.

Examples

The following example shows how to display basic system information.

edfa > sys-info CLEI: WMM8T00BRA Amplifier model number: ONS15501 Serial number: MOR0643001G MAC Address: 00044DFFCC75 Firmware version: 4.0 Hardware Revision: 414141 Software build date: Thu Jan 2 17:15:07 PST 2003 System Up Time: 89839 seconds Software in various Banks: 1)ons15501-sw.4.1 2)ons15501-sw.4.1 3)ons15501-sw.4.1 Active bank: 1 Planned bank: 1

temp

To display the internal case temperature, use the temp command.

temp

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the internal case temperature.

edfa > temp 33 (C)

Related Commands

Command
Description

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

settempmean

Sets the internal case temperature alarm mean level.

settemptrig

Sets the internal case temperature alarm trigger level.

stemp

Displays the state of the case temperature monitor.

tempmean

Displays the internal case temperature alarm mean level.

temptrig

Displays the internal case temperature alarm trigger level.


tempmean

To display the internal case temperature alarm mean level, use the tempmean command.

tempmean

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the internal case temperature alarm mean level.

edfa > tempmean 29.00 (C)

Related Commands

Command
Description

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

settempmean

Sets the internal case temperature alarm mean level.

settemptrig

Sets the internal case temperature alarm trigger level.

temp

Displays the internal case temperature level.

temptrig

Displays the internal case temperature alarm trigger level.


temptrig

To display the internal case temperature alarm trigger level, use the temptrig command.

temptrig

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Examples

The following example shows how to display the internal case temperature alarm trigger level.

edfa > temptrig 29.00 (C)

Related Commands

Command
Description

resetmeantrig

Resets the signal gain and alarm mean level, gain alarm trigger level, optical input alarm mean level, optical input alarm trigger level, output signal alarm mean level, output signal alarm trigger level, internal case temperature alarm mean level, and internal case temperature alarm trigger level to the manufacturer's default settings.

settempmean

Sets the internal case temperature alarm mean level.

settemptrig

Sets the internal case temperature alarm trigger level.

temp

Displays the internal case temperature level.

tempmean

Displays the internal case temperature alarm mean level.


time

To display the time of the system, use the time command.

time

Syntax Description

This command has no arguments or keywords.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

The time is displayed in the same format as this example.

Fri Aug 24 10:50:31 2001 PST

PST is the time zone. See "Time Zone Codes," for a list of time zones and correlating abbreviations.

Examples

The following example shows how to display the time of the system.

edfa > time Wed Jan 29 14:20:07 2003 GMT

Related Commands

Command
Description

set-time

Sets the time of the system.

timezone

Displays or modifies the time zone of the system.


timeout

To display or modify the timeout interval, use the timeout command.

timeout [seconds]

Syntax Description

seconds

(Optional) Specifies the number of seconds for the timeout interval.


Defaults

600 secs

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

If there is no activity from the user for a given amount of time (the timeout period), the system automatically logs the user off. The value for the timeout period is displayed in seconds. The default setting is 600 sec. Any modification to this setting applies only to the user session in progress; once the user logs off, the setting automatically resets to the default value.

Examples

The following example shows how to modify the timeout period setting.

edfa > timeout 500

The following example shows how to view the timeout period setting.

edfa > timeout Timeout period is 500 seconds

timezone

To display or modify the time zone of the system, use the timezone command.

timzone [zone]

Syntax Description

zone

(Optional) Specifies the time zone at which to set the system.


Defaults

None

Command Types

Does not change configuration

Command Modes

User password protected

Command History

Release
Modification

EDFA 1.0

This command was introduced.


Usage Guidelines

See "Time Zone Codes," for a list of time zones and correlating abbreviations.

Examples

The following example shows how to display the time zone of the system.

edfa > timezone GMT

The following example shows how to modify the time zone of the system.

edfa > timezone PST

Related Commands

Command
Description

set-time

Sets the time of the system.

time

Displays the time of the system.



hometocprevnextglossaryfeedbacksearchhelp

Posted: Thu Jun 24 09:49:26 PDT 2004
All contents are Copyright © 1992--2004 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.