Table Of Contents

SNMP MIB Installation and Configuration

SNMP Overview

SNMP Components

ONS 15216 EDFA2 SNMP Elements

SNMP MIBs and Message Types

Command Syntax Using the SNMP Agent

Enabling SNMP Remote Management Community Strings

Creating a View

Creating a Community Entry

Tables and Groups

cerent15216EdfaCfgGroup Table

cerent15216EdfaPumpCfgEntry Table

cerent15216EdfaOverallStatusGroup Table

cerent15216EdfaOverallControl Table

cerent15216EdfaPumpStatusEntry

cerent15216EdfaAlarmEntry Table

cerent15216EdfaOpGroup Table

cerent15216EdfaVersionGroup Table

Setting Up Traps

Trap Display Command

Trap Set Command

Set Agent Trap Enable

Get Agent Trap Enable

Retrieving Information

IP Address

Date and Time

Power Gain

Case Temperature

Temperature Alarm Threshold

Case Temperature Alarm Hysteresis

Power BUS Mode

Loss of Input Power Value (Input Power)

Loss of Input Power Alarm Threshold

Loss of Input Power Alarm Hysteresis

Loss of Output Power Value (Output Power)

Loss of Output Power Alarm Setpoint

Loss of Output Power Alarm Hysteresis

SNMP MIB Installation and Configuration

---

This chapter explains how to read and understand SNMP MIB as it relates to the ONS 15216 EDFA2. This chapter is a reference of all ONS 15216 EDFA2 SNMP commands that are used in a network management system (NMS). For provisioning the ONS 15216 EDFA2, see Chapter 4, "Provisioning".

SNMP Overview

SNMP is an application-layer communication protocol that allows network devices to retrieve and modify the value of management information, as well as provide event notification to a n NMS.

The ONS 15216 EDFA2 SNMP implementation uses standard Internet Engineering Task Force (IETF) MIBs to convey inventory, fault, and performance management information.

SNMP allows limited management of the ONS 15216 EDFA2 by a generic, third-party SNMP manager (for example, HP OpenView Network Node manager [NNM] or Open Systems Interconnection [OSI] NetExpert).

The ONS 15216 EDFA2 supports SNMP Version 1 (SNMPv1) and SNMP Version 2c (SNMPv2c) protocols.

SNMP Components

An SNMP-managed network consists of three primary components:

•Managed devices

•Agents

•Management systems

A managed device is a network node that contains an SNMP agent and resides on an SNMP-managed network. Managed devices collect and store management information and use SNMP to make this information available to management systems that use SNMP. Managed devices include routers, access servers, switches, bridges, hubs, computer hosts, and network elements such as the ONS 15216 EDFA2.

ONS 15216 EDFA2 SNMP Elements

The following three SNMP elements are used with the ONS 15216 EDFA2:

•SNMP agent

•SNMP MIB

•SNMP manager

Figure 5-1 SNMP Elements

SNMP Agent

An agent is an entity that assumes an operation role to receive, process, and respond to requests, as well as generated event reports. The SNMP agent gathers data from the MIB, which is the repository for device parameter and network data. To respond to requests, the agent must have network management information access. To generate reports, an agent must be notified of internal events.

Cisco provides both an SNMP agent (installed on the ONS 15216 EDFA2) and SNMP MIB to monitor the ONS 15216 EDFA2. The SNMP agent software and MIB are pre-installed on each module.

Figure 5-2 SNMP Agent and MIB

SNMP MIB

The SNMP MIB (CERENT-15216-EDFA-MIB.mib) is a file written in ASN.1 syntax. This MIB specifies what ONS 15216 EDFA2 information needs to be monitored. This MIB is pre-installed on the SNMP agent and is accessible via the CLI.

The cerent15216Edfa.mib and other MIBs can also be installed on a third-party SNMP manager located at a network management center. The SNMP manager at the network management center or the SNMP manager, accessible via the CLI, (see SNMP Manager) uses the SNMP MIBs to communicate with the SNMP agent.

SNMP Manager

The ONS 15216 EDFA2 comes with a pre-installed SNMP manager accessible via the CLI. This SNMP manager can be accessed and used to communicate with the SNMP agent that is also pre-installed on each ONS 15216 EDFA2. This manual displays examples of issuing SNMP commands to the amplifier using the built-in SNMP manager.

Third-party, Vendor-Specific SNMP Managers

SNMP managers from third-party vendors running on a separate computer located at a network management center are often used to manage network elements. If a third-party SNMP manager is used, it must be able to communicate with the SNMP agent pre-installed on the ONS 15216 EDFA2.

If a third-party SNMP manager is used, it is assumed that the SNMP manager is pre-installed prior to the SNMP MIB installation. Each vendor-specific SNMP manager has an unique set of instructions for SNMP MIB installation. For directions on loading the SNMP MIBs, refer to SNMP manager documentation.

Cisco does not provide or recommend a standard third-party SNMP manager.

SNMP MIBs and Message Types

SNMP operations can be quite powerful. A manager can retrieve or modify the value of management information accessible by an agent, an agent can report an event to a manager, and the manager can inform another manager of the value of management information on an agent. Using retrieval and modification operations, a manager can cause an agent to perform an action or execute a command. The manager can also create new and delete existing instances of management information.

An MIB is a hierarchically-organized collection of information. Network-management protocols, such as SNMP, gain access to these MIBs. MIBs consist of managed objects and are identified by object identifiers (OID).

The ONS 15216 EDFA2 SNMP agent communicates with an SNMP management application (a third-party application or the built-in SNMP manager) using SNMP messages.

Table 5-1 describes SNMP operation types.

Table 5-1 SNMP Operation Types

Operation	Description
get-request	Retrieves a value from a specific variable.
get-next-request	Retrieves the value following the named variable; this operation is often used to retrieve variables in a Table. With this operation, an SNMP agent does not need to know the exact variable name. The SNMP manager searches sequentially to find the needed variable in the MIB.
get-response	The reply to a get-request, get-next-request, get-bulk-request, or set-request sent by an NMS.
get-bulk-request	Similar to a get-next-request, but this operation fills the get-response with up to the max-repetition number of get-next interactions.
trap	An unsolicited message sent by an SNMP agent to an SNMP manager indicating that an event has occurred.
set-request	Sets a value of a specific variable.

Command Syntax Using the SNMP Agent

Although Cisco has its own separate SNMP manager (Cisco Transport Manager [CTM]), communication with the ONS 15216 EDFA2 is also possible using the built-in SNMP manager, its agent, and the MIB. (See Figure 5-1.)

The commands and command syntax displayed in this manual are the result of using the built-in ONS 15216 EDFA2 SNMP manager included with the CLI card.

Commands can be issued via Telnet over a LAN or directly through the RS-232 port on the module. (See Chapter 3, "Installation".) After setting up a connection to the module and entering a password and user name, the following prompt appears:

hostname:ONS15216 EDFA2>

To communicate with the module using SNMP, the command must begin with "snmp".

---

Note To view a list of possible SNMP operations, enter "snmp" followed by a space and press the Tab key.

---

Example 5-1 snmp Command Followed by the Tab Key

hostname:ONS15216 EDFA2> snmp

        agent

        attribute

        host

        mib

        pdu

        row

        session

        subtree

        table

        trap

        tree

Continue to enter a specific operation from the list until the complete command is created. (See Example 5-2.)

Example 5-2 snmp Table display Command

hostname:ONS15216 EDFA2> snmp table display local cerent

        cerent15216EdfaCommunityEntry

        cerent15216EdfaCommTrapEntry

        cerent15216EdfaViewEntry

        cerent15216EdfaAgentControlGroup

        cerent15216EdfaActionOpGroup

        cerent15216EdfaLogEventControl

        cerent15216EdfaLogEventEntry

        cerent15216EdfaBootEntry

        cerent15216EdfaBootImageEntry

        cerent15216EdfaRtcDateAndTime

        cerent15216EdfaSromIpMgmtGroup

        cerent15216EdfaSromRingGroup

        cerent15216EdfaCfgGroup

        cerent15216EdfaOverallControl

        cerent15216EdfaPumpCfgEntry

        cerent15216EdfaOverallStatusGroup

        cerent15216EdfaPumpStatusEntry

        cerent15216EdfaAlarmEntry

        cerent15216EdfaVersionGroup

        cerent15216EdfaOpGroup

hostname:ONS15216 EDFA2> snmp Table display local cerent15216Edfa

Use these commands to set up community strings ( Enabling SNMP Remote Management Community Strings) and traps ( cerent15216EdfaVersionGroup Table).

Enabling SNMP Remote Management Community Strings

SNMP communities are groupings of workstations and servers (or gateways) that can manage the ONS 15216 EDFA2. NMS's also use SNMP communities to enforce security. SNMP enforces security through password-like community strings. Access to the SNMP agent and the ONS 15216 EDFA2 can be limited by both IP address and community string.

The CLI SNMP manager (local SNMP manager) must be used to setup remote management (via a Telnet connection or terminal server). A third-party, vendor-specific SNMP manager cannot be used to setup remote management.

The process for setting up community entries consists of:

• Creating a View

• Creating a Community Entry

The ONS 15216 EDFA2 has the two default community strings listed in Table 5-2.

Table 5-2 Default Community Strings

Community String	Default Privileges
public	read operations for all MIBs
private	read and write operations for all MIBs

The privileges assigned to the default strings can be modified or new communities with custom privileges can be created.

Creating a View

The following command describes how to set a view entry. A view defines and restricts the MIB attributes that a particular community can access. The view entry and the community entry are set to factory defaults. Users should consult with a Cisco Systems Engineer before modifying these settings.

Set View Entry

Command: snmp row set local cerent15216EdfaViewEntry

Syntax: snmp row set local cerent15216EdfaViewEntry view index # subtree

Description: To create a community entry, a view must first be created. A MIB view can restrict the MIBs that a particular community can access. To create a view, type the command. # is an integer (1 to 2048) assigned to this view entry and subtree is the MIB subtree to which this view applies. Multiple view entries can be used for each view index.

This command creates a new row in the ViewEntry Table. The SNMP manager prompts the user for each attribute.

To display a list of possible values, press the Spacebar followed by the Tab key. (See Example 5-3.)

Example 5-3 cerent15216EdfaViewEntry Set Command

hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaViewEntry cerent

cerent15216EdfaViewMask '0'H

cerent15216EdfaViewType included

cerent15216EdfaViewStatus

        active

        notInService

        notReady

        createAndGo

        createAndWait

        destroy

cerent15216EdfaViewStatus createAndGo

hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaViewEntry 1 cerent

CLASS cerent15216Edfa-AGENT-MIB.cerent15216EdfaViewEntry ::=

{

    cerent15216EdfaViewIndex =  1;

    cerent15216EdfaViewSubtree =  { cerent };

    cerent15216EdfaViewMask =  '00'H;

    cerent15216EdfaViewType =  included;

    cerent15216EdfaViewStatus =  active;

Access to the ONS 15216 EDFA2 can be restricted by IP address or community string using this command.

Table 5-3 describes the command and MIB view prompts.

Table 5-3 Creating a View

Data Prompt	Command	Description
cerent15216EdfaViewIndex	snmp row set local cerent15216EdfaViewEntry 1 zeroDotZero	View Index: A unique value for each MIB view. This value is the number entered with the command.
cerent15216EdfaViewSubTree	Sub-Tree Object Indentifier	Sub-Tree Object Indentifier: An object identifier that designates a sub-tree element in the MIB hierarchy. zeroDotZero specifies the entire CLI MIB hierarchy.
cerent15216EdfaViewMask	`O'H	A bit mask that identifies objects in the subtree.
cerent15216EdfaViewType	included	A flag that specifies the status of the view. Valid entries are included and excluded.
cerent15216EdfaViewStatus	createAndGo	If the entry currently exists, use active (createAndGo cannot be used if any entry exists).

Creating a Community Entry

SNMP communities are groupings of workstations and servers (or gateways) that can manage the ONS 15216 EDFA2. NMS's use SNMP communities to enforce security. Because access to the SNMP agent is controlled by a community entry, every SNMP agent must be configured to recognize one or more community names, and to provide the appropriate level of access to managers according to the community name. The following commands describe the commands for displaying or setting community entries. Users should consult with a Cisco Systems Engineer before modifying these settings.

Set CommunityEntry

Command: snmp row set local cerent15216EdfaCommunityEntry

Syntax: snmp row set local cerent15216EdfaCommunityEntry community index

Description: After creating a view, use the snmp row set local cerent15216EdfaCommunityEntry command to create a community entry for that view.

The SNMP manager prompts the user for each attribute. Press the Spacebar and then the Tab key after a prompt to view possible data inputs ( Example 5-4). Refer to Table 5-4 for information concerning data for each prompt.

Example 5-4 cerent15216EdfaCommunityEntry Set Command

hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaCommunityEntry 1

cerent15216EdfaCommName ""

cerent15216EdfaCommViewIndex 0

cerent15216EdfaCommPrivileges 35

cerent15216EdfaCommSrcIPAddr 0.0.0.0

cerent15216EdfaCommNetMask 0.0.0.0

cerent15216EdfaCommStatus 0

    cerent15216EdfaCommStatus OBJECT-TYPE

        SYNTAX INTEGER

        {

            active(1),

            notInService(2),

            notReady(3),

            createAndGo(4),

            createAndWait(5),

            destroy(6)

        }

        MAX-ACCESS read-create

        DESCRIPTION

        ::= { cerent15216EdfaCommunityEntry 7 }

Table 5-4 displays the definitions for the community entry values.

Table 5-4 Creating a Community Entry 

Data Prompt	Description
cerent15216EdfaCommIndex	Community Index: An index that uniquely identifies a particular SNMP community. This community index is part of the command. In Example 5-4, it is "1".
cerent15216EdfaCommName	Community Name: The community string.
cerent15216EdfaCommViewIndex	View Index: The view index specifies which MIBs this particular community string can access.
cerent15216EdfaCommPrivileges	Privileges: A bitmap of access privileges that govern what management operations a particular community can perform. These privileges are expressed as a sum of values, where each value represents a particular operation. Refer to Table 5-5 for the SNMP Operation Decimal Values.
cerent15216EdfaCommSrcIPAddr	Source IP Address: The IP address from which network management traffic for this community originates.
cerent15216EdfaCommNetMask	NetMask: The subnet mask for the source IP address.
cerent15216EdfaCommStatus	Status: The status of this conceptual row in the community table.Use createAndGo to create a new row. Use active to modify an existing row.

Display CommunityEntry

Command: snmp row display local cerent15216EdfaCommunityEntry

Syntax: snmp row display local cerent15216EdfaCommunityEntry community index

Description: After creating a community string, use this command to view its parameters. The number in the command refers to the community index number created in the previous section.

Example 5-5 cerent15216EdfaCommunityEntry Display Command

hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaCommunityEntry 1

CLASS cerent15216Edfa-AGENT-MIB.cerent15216EdfaCommunityEntry ::=

{

    cerent15216EdfaCommIndex =  1;

    cerent15216EdfaCommName =  "private";

    cerent15216EdfaCommViewIndex =  1;

    cerent15216EdfaCommPrivileges =  255;

    cerent15216EdfaCommSrcIPAddr =  0.0.0.0;

    cerent15216EdfaCommNetMask =  255.255.255.255;

    cerent15216EdfaCommStatus =  active;

};

Table 5-5 displays the decimal values for the following SNMP operations.

Table 5-5 SNMP Operation Decimal Values

SNMP Operation	Decimal Values
Get	1
GetNext	2
Response (enable for all community strings)	4
Set	8
SNMPv1-Trap	16
GetBulk	32
Inform (enable for all community strings)	64
SNMPv2-Trap (enable for all community strings)	128

For example, 255 is the sum of all decimal values and specifies access to all SNMP operations. This sum is the default private community. 247 is the sum for all SNMP operations with the exception of the Set operation. This sum is the default public community.

Tables and Groups

The cerent15216Edfa.mib contains several key tables that are used to review and provision the ONS 15216 EDFA2. The following tables are listed and described in the following sections:

• cerent15216EdfaCfgGroup Table

• Use the snmp attribute set local cerent15216EdfaOpSaveConfig perform command to save changes.

• cerent15216EdfaOverallStatusGroup Table

• cerent15216EdfaOverallControl Table

• cerent15216EdfaPumpStatusEntry

• cerent15216EdfaAlarmEntry Table

• cerent15216EdfaOpGroup Table

• cerent15216EdfaVersionGroup Table

cerent15216EdfaCfgGroup Table

The cerent15216EdfaCfgGroup Table is used to set or get alarm threshold configuration. The associated table command provides a summary of all alarm thresholds. See Table 5-6 for variable definitions. For more information on alarm thresholds, see the "Set Alarm Thresholds" section on page 4-4.

Table 5-6 cerent15216EdfaCfgGroup Variable Descriptions 

Variable	Syntax	Maximum Access	Description
cerent15216EdfaCfgSaved	True Value	Read-only	Indicates whether the current configuration has been saved.
cerent15216EdfaLpoutSetpoint	Integer (0 to 1000)	Read-only	Laser pump output power setpoint for the Lpout alarm (*10 mW). This is set when the cerent15216EdfaPumpCfgConstOutPower attribute is set for pump 2.
cerent15216EdfaLpoutDeviation	Integer (0 to 1000)	Read-write	Amount that the output power must deviate from the setpoint to set the Lpout alarm (*100 dBm).
cerent15216EdfaLpoutHysteresis	Integer (0 to 1000)	Read-write	Amount that the output power must move towards the setpoint before the Lpout alarm is cleared (*100 dBm).
cerent15216EdfaLOSThreshold	Integer (-3100 to -1500)	Read-write	Loss of signal threshold (*100 dBm).
cerent15216EdfaLOSHysteresis	Integer (0 to 1000)	Read-write	Amount above cerent15216EdfaLOSThreshold that the input signal must rise before the Lpin alarm is cleared (*100 dBm).
cerent15216EdfaCtmpMin	Integer (-10 to 10)	Read-write	Minimum allowable case temperature in degrees Celsius.
cerent15216EdfaCtmpMinHysteresis	Integer (0 to 10)	Read-write	Amount above cerent15216EdfaCtmpMin that the case temperature must rise before the Ctmp alarm is cleared in degrees Celsius.
cerent15216EdfaCtmpMax	Integer (20 to 70)	Read-write	Maximum allowable case temperature in degrees Celsius.
cerent15216EdfaCtmpMaxHysteresis	Integer (0 to 10)	Read-write	Amount below cerent15216EdfaCtmpMax that the case temperature must drop before the Ctmp alarm is cleared in degrees Celsius.
cerent15216EdfaPowerBusDCVoltageMin	Integer (0 to 70)	Read-write	Minimum allowable power bus DC voltage. The default minimum power bus voltage is set at -40 VDC. Valid entries are between 0 and 70 and are in V times -10. For example, if the voltage required is -50 VDC, the power bus DC voltage is 500.
cerent15216EdfaPowerBusDCVoltageMax	Integer (0 to 70)	Read-write	Maximum allowable power bus DC voltage. The default maximum power bus voltage is set at -57 VDC. Valid entries are between 0 and 70 and are in V times -10. For example, if the voltage required is -50 VDC, the power bus DC voltage is 500.

Use the snmp attribute set local cerent15216EdfaOpSaveConfig perform command to save changes.

cerent15216EdfaPumpCfgEntry Table

The cerent15216EdfaPumpCfgEntry table is used to set or get pump operation mode configuration. The associated table command displays a settings summary or allows you to set pumps. See Table 5-7 for variable definitions. The factory default mode of operation for the ONS 15216 EDFA2 is constant gain temperature compensated. Cisco recommends that users contact Cisco Engineering prior to changing this mode of operation.

Table 5-7 cerent15216EdfaPumpCfgEntry Variable Descriptions

Variable	Syntax	Maximum Access	Description
cerent15216EdfaPumpCfgPumpNum	cerent15216EdfaPumpNumber	Not Accessible	Laser pump number (1 or 2).
cerent15216EdfaPumpCfgControlMode	cerent15216EdfaControlMode	Read-write	Laser pump control mode. When the mode is set directly to constCurrent, constPower, or constOutputPower, the current value of ConstPumpCurrent, ConstPumpPower, or ConstOutPower is used as the constant parameter for the new mode.
cerent15216EdfaPumpCfgConstPumpCurrent	Integer (0 to 300)	Read-write	Laser pump constant pump current (mA). The current that is used when the control mode is changed to constCurrent.
cerent15216EdfaPumpCfgConstPumpPower	Integer (0 to 100)	Read-write	Laser pump constant pump power (mW). The power that is used when the control mode is changed to constPumpPower.
cerent15216EdfaPumpCfgConstOutPower	Integer (0 to 650)	Read-write	Laser pump constant output power (*10 mW). The power that is used when the control mode is changed to constOutputPower.

cerent15216EdfaOverallStatusGroup Table

The cerent15216EdfaOverallStatusGroup Table allows users to display the input and output of the ONS 15216 EDFA2 amplifier. Table 5-8 describes cerent15216EdfaOverallStatusGroup Table variables.

Table 5-8 cerent15216EdfaOverallStatusGroup

Variable	Syntax	Maximum Access	Description
cerent15216EdfaInPoweruW	Integer (0 to 99999)	Read-only	EDFA input power (*10 microwatts)
cerent15216EdfaInPowerdBm	Integer (-99999 to 99999)	Read-only	EDFA input power (*100 dBm)
cerent15216EdfaOutPowermW	Integer (0 to 999999)	Read-only	EDFA output power (*100 mW)
cerent15216EdfaOutPowerdBm	Integer (-999999 to 99999)	Read-only	EDFA output power (*100 dBm)

cerent15216EdfaOverallControl Table

The cerent15216EdfaOverallControl Table allows the user to display and configure overall gain and preattenuation. Table 5-9 describes cerent15216EdfaOverallControl variables.

Table 5-9 cerent15216EdfaOverallControl Variable Descriptions

Variable	Syntax	Maximum Access	Description
cerent15216EdfaConstGainOverallGain	Integer (130 to 220)	Read-write	The overall gain (*10 dBm) that is used when the control mode in the PumpCfgTable is set to constGain or constOutputPower.
cerent15216EdfaVariableGainPreAttenuation	Integer (10 to 100)	Read-write	The preattenuation (*10 dBm) that is used when the control mode in the PumpCfgTable is neither constGain nor constOutputPower.

cerent15216EdfaPumpStatusEntry

The cerent15216EdfaPumpStatusEntry Table is used to display optical amplification module data. Table 5-10 displays information regarding the cerent15216EdfaPumpStatusEntry Table variables.

Table 5-10 cerent15216EdfaPumpStatusEntry Variable Descriptions

Variable	Syntax	Maximum Access	Description
cerent15216EdfaPumpStatusPumpNum	cerent15216EdfaPumpNumber	Read-only	Laser pump number
cerent15216EdfaPumpStatusLaserChipTemp	Integer (-9999 to 9999)	Read-only	Laser chip temperature (*10°C)
cerent15216EdfaPumpStatusLaserChipTempSetpoint	Integer (0 to 999)	Read-only	Laser chip temperature setpoint (*10°C)
cerent15216EdfaPumpStatusLaserTECCurrent	Integer (0 to 99999)	Read-only	Laser TEC current (mA)
cerent15216EdfaPumpStatusLaserPower	Integer (0 to 99999)	Read-only	Laser power (*100 mW)
cerent15216EdfaPumpStatusLaserCurrent	Integer (0 to 999999)	Read-only	Laser current (*100 mA)
cerent15216EdfaPumpStatusAmbientTemp	Integer (-9999 to 9999)	Read-only	Ambient temperature (*100°C)
cerent15216EdfaPumpStatusDCVoltage	Integer (0 to 9999)	Read-only	DC voltage (*10V)
cerent15216EdfaPumpStatusInPoweruW	Integer (0 to 99999)	Read-only	Input power (*10 microwatts)
cerent15216EdfaPumpStatusInPowerdBm	Integer (-999999 to 999999)	Read-only	Input power (*100 dBm)
cerent15216EdfaPumpStatusOutPowermW	Integer (0 to 999999)	Read-only	Output power (*100 mW)
cerent15216EdfaPumpStatusOutPowerdBm	Integer (-99999 to 99999)	Read-only	Output power (*100 dBm)
cerent15216EdfaPumpStatusGain1	Integer (-9999 to 9999)	Read-only	Gain (*10 dBm)

1. The value of the cerent15216EdfaPumpStatusGain variable should always be around 23 dB. This variable is the internal amplifier module gain. The cerent15216EdfaPumpStatusGain variable should not be confused with the cerent15216EdfaConstGainOverallGain variable that is used to set the gain of the ONS 15216 EDFA2.

cerent15216EdfaAlarmEntry Table

The cerent15216EdfaAlarmEntry Table is used to display alarm status. The associated table command provides a summary of all alarms. Table 5-11describes the cerent15216EdfaAlarmEntry Table variables.

Table 5-11 cerent15216EdfaAlarmEntry Variable Descriptions

Variable	Syntax	Maximum Access	Description
cerent15216EdfaAlarmIndex	cerent15216EdfaIndex	Not Accessible	A unique value to identify this entry.
cerent15216EdfaAlarmID	AutonomousType	Read-only	The alarm this entry refers to.
cerent15216EdfaAlarmPriority	cerent15216EdfaAlarmPriority	Read-only	The priority of this alarm.
cerent15216EdfaAlarmState	cerent15216EdfaAlarmState	Read-only	The reporting state of this alarm.
cerent15216EdfaAlarmEnableStatus	cerent15216EdfaControl	Read-write	If the alarm is enabled/disabled.
cerent15216EdfaAlarmDateAndTime	Cerent15216EdfaDateAndTimeString	Read-only	The local date and time when the alarm entered its current state.

cerent15216EdfaOpGroup Table

The cerent15216EdfaOpGroup Table is used to display or set operation actions, such as saving configuration or loading new software. The individual variables in Table 5-12 are generally used instead of the Table command. That is, when performing a cutover command, the user would use the snmp attribute set local cerent15216EdfaOpCutover perform command.

Table 5-12 cerent15216EdfaOpGroup Variable Descriptions 

Variable	Syntax	Maximum Access	Description
cerent15216EdfaOpStatus	cerent15216EdfaActionStatus	Read-only	The status of the current operation.
cerent15216EdfaOpResult	Integer	Read-only	This value is used to save the error result (if any) of the last operation. Success is indicated by a value of 0.
cerent15216EdfaOpRequestId	Integer	Read-write	The request identifier for this operation. This is provided to allow managers to match actions and results.
cerent15216EdfaOpCutover	cerent15216EdfaAction	Read-write	When "perform" is written to this object, firmware is executed from the current plane and the alternate plane status is changed to the default active plane.
cerent15216EdfaOpLoad	cerent15216EdfaAction	Read-write	When "perform" is written to this object, new firmware is downloaded. Before setting this attribute, the source of the new firmware should be specified by setting cerent15216EdfaOpSrcFileName and cerent15216EdfaOpTftpSrvAddr.
cerent15216EdfaOpSrcFileName	DisplayString (SIZE (0 to 127))	Read-write	Source file name for the Load operation.
cerent15216EdfaOpTftpSrvAddr	IpAddress	Read-write	TFTP file server address for the Load operation.
cerent15216EdfaOpReset	cerent15216EdfaAction	Read-write	When "perform" is written to this object, a software reset is performed.
cerent15216EdfaOpSaveConfig	cerent15216EdfaAction	Read-write	To save the configuration of the optical module, write "perform" to this object.

cerent15216EdfaVersionGroup Table

The cerent15216EdfaVersionGroup Table allows users to display the currently loaded image and the image to be loaded after cutover. Table 5-13 describes cerent15216EdfaVersionGroup Table variables.

Table 5-13 cerent15216EdfaVersionGroup

Variable	Syntax	Maximum Access	Description
cerent15216EdfaCurrentVersion	DisplayString (0 to 255 characters)	Read-only	The version of the currently loaded image.
cerent15216EdfaAlternateVersion	DisplayString (0 to 255 characters)	Read-only	The version of the image to be loaded after a cutover is performed.

Setting Up Traps

Traps are asynchronous notifications sent from the ONS 15216 EDFA2 to a predetermined location (IP address, subnet mask, etc.). A community entry must be created prior to remotely setting up traps using either Telnet or a terminal server. Table 5-14 displays the alarm notification types in the cerent15216Edfa.mib that initiate a trap.

Table 5-14 Notification Types that Initiate a Trap

Notification	MIB Items	Description
cerent15216EdfaOpFinished	cerent15216EdfaOpSaveConfig cerent15216EdfaOpCutover cerent15216EdfaOpLoad cerent15216EdfaOpReset	"CerentOp Finished" This trap indicates that an operation has completed or, in the case of cerent15216EdfaOpReset, the operation is about to be performed.
cerent15216EdfaAlarmActivated	cerent15216EdfaAlarmID cerent15216EdfaAlarmPrioriy cerent15216EdfaAlarmDateAndTime	"Alarm Activate"A notification indicating that an alarm has changed to an active state.
cerent15216EdfaAlarmCleared	cerent15216EdfaAlarmID cerent15216EdfaAlarmPrioriy cerent15216EdfaAlarmDateAndTime	"Alarm Cleared" A notification indicating that an alarm has changed to a cleared state.

Trap Display Command

Command: snmp Table display local cerent15216EdfaCommTrapEntry

Syntax: snmp Table display local cerent15216EdfaCommTrapEntry #

Description: Displays the communities for traps.

Example 5-6 cerent15216EdfaCommTrapEntry Display Command

hostname:ONS15216 EDFA2> snmp Table display local cerent15216EdfaCommTrapEntry

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCommTrapEntry ::=

{

    cerent15216EdfaCommTrapIndex =  0;

    cerent15216EdfaCommTrapCommunity =  "";

    cerent15216EdfaCommTrapDestIPAddress =  0.0.0.0;

    cerent15216EdfaCommTrapDestUDPPort =  0;

    cerent15216EdfaCommTrapViewIndex =  0;

    cerent15216EdfaCommTrapVersion =  0;

    cerent15216EdfaCommTrapStatus =  notReady;

};

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCommTrapEntry ::=

{

    cerent15216EdfaCommTrapIndex =  1;

    cerent15216EdfaCommTrapCommunity =  "private";

    cerent15216EdfaCommTrapDestIPAddress =  172.22.87.50;

    cerent15216EdfaCommTrapDestUDPPort =  162;

    cerent15216EdfaCommTrapViewIndex =  1;

    cerent15216EdfaCommTrapVersion =  v2;

    cerent15216EdfaCommTrapStatus =  active;

};

Trap Set Command

Command: snmp row set local cerent15216EdfaCommTrapEntry

Syntax: snmp row set local cerent15216EdfaCommTrapEntry #

Description: The command followed by a community number permits the user to set the parameters for the SNMP trap. Example 5-7 displays the prompts that appear after entering this command.

Prompts appear for the following settings:

•cerent15216EdfaCommTrapCommunity: The trap destination community name.

•cerent15216EdfaCommTrapDestIPAddress: The trap destination IP address.

•cerent15216EdfaCommTrapDestUDPPort: The trap destination UDP port.

•cerent15216EdfaCommTrapViewIndex: The trap destination MIB view index. A trap may be sent to this destination if it is contained in this MIB view. A 0 implies no MIB view.

•cerent15216EdfaCommTrapVersion: The trap version number.

•cerent15216EdfaCommTrapStatus: The status of this conceptual row in the cerent15216EdfaCommunityTrapTable.

If the data needs to be changed, enter new data after the prompt.

Example 5-7 cerent15216EdfaCommTrapEntry Set Command

hostname:ONS15216 EDFA2> snmp row set local CommTrapEntry 1

cerent15216EdfaCommTrapCommunity ""

cerent15216EdfaCommTrapDestIPAddress 0.0.0.0

cerent15216EdfaCommTrapDestUDPPort 162

cerent15216EdfaCommTrapViewIndex 0

cerent15216EdfaCommTrapVersion v1

cerent15216EdfaCommTrapStatus 0

    cerent15216EdfaCommTrapStatus OBJECT-TYPE

        SYNTAX INTEGER

        {

            active(1),

            notInService(2),

            notReady(3),

            createAndGo(4),

            createAndWait(5),

            destroy(6)

        }

        MAX-ACCESS read-create

        DESCRIPTION

        ::= { cerent15216EdfaCommTrapEntry 7 }

Set Agent Trap Enable

Command: snmp attribute set local cerent15216EdfaAgentTrapEnable

Syntax: snmp attribute set local cerent15216EdfaAgentTrapEnable control

Description: Enables or disables SNMP traps depending on whether the parameter control is "enabled" or "disabled".

Get Agent Trap Enable

Command: snmp attribute get local cerent15216EdfaAgentTrapEnable

Syntax: snmp attribute get local cerent15216EdfaAgentTrapEnable

Description: Ensures that the SNMP traps are enabled. The system responds with "enabled".

Retrieving Information

The following SNMP commands access ONS 15216 EDFA2 information.

IP Address

Command: snmp Table display local cerent15216EdfaSromIpMgmtGroup

Syntax: snmp Table display local cerent15216EdfaSromIpMgmtGroup

Description: Displays the ONS 15216 EDFA2 IP address.

The following SNMP commands display the ONS 15216 EDFA2's IP address and other networking information:

•snmp row display local cerent15216EdfaSromIpMgmtGroup command ( Example 5-8)

Example 5-8 cerent15216EdfaSromIpMgmtGroup Display Command

hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaSromIpMgmtGroup

CLASS cerent15216Edfa-SROM-IP-ADDRESS-MIB.cerent15216EdfaSromIpMgmtGroup ::=

{

    cerent15216EdfaSromIpMgmtEnetAddress =  172.22.82.19;

    cerent15216EdfaSromIpMgmtEnetSubNetMask =  255.255.0.0;

    cerent15216EdfaSromIpMgmtDefaultRouterAddress =  172.22.82.1;

    cerent15216EdfaSromIpMgmtHostName =  "Hostname";

Table 5-15 describes the other attributes displayed by these commands.

Table 5-15 cerent15216EdfaSromIpMgmtGroup Command Attributes

Attribute	Description
cerent15216EdfaSromIpMgmtEnetAddress	The IP address used by the system Ethernet management port. If set to 0.0.0.0 IP traffic is not supported over the Ethernet interface. The system must have at least one IP address, either for the Ethernet management port, or for IP over ATM.
cerent15216EdfaSromIpMgmtEnetSubNetMask	The IP subnetwork mask for the Ethernet management port.
cerent15216EdfaSromIpMgmtHostName	The host name of the system.

Date and Time

Command: snmp attribute get local cerent15216EdfaRtcDateAndTime

Syntax: snmp attribute get local cerent15216EdfaRtcDateAndTime

Description: Displays the date and time for the ONS 15216 EDFA2.

The following SNMP commands display the date and time for the ONS 15216 EDFA2 and other time data:

•snmp row display local cerent15216EdfaRtcDateAndTime command

Example 5-9 displays the ONS 15216 EDFA2 command for displaying the date and time.

Example 5-9 cerent15216EdfaRtcDateAndTime Display Command

hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaRtcDateAndTime

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaRtcDateAndTime ::=

{

    cerent15216EdfaRtcDateAndTimeLocal =  '07d1060711242d052d07c4'H; 

    cerent15216EdfaRtcDateAndTimeGMT =  '07d1060717242d052b0000'H; 

    cerent15216EdfaRtcDateAndTimeLocalString =  "2001-6-7,17:36:45.5 -7:-60"; 

    cerent15216EdfaRtcDateAndTimeGMTString =  "2001-6-7,23:36:45.5 +0:0"; 

    cerent15216EdfaRtcDateAndTimeTimezone =  -7; 

    cerent15216EdfaRtcDateAndTimeSaving =  -60; 

    cerent15216EdfaRtcDateAndTimeFormsString =  "06/07/2001 17:36:45"; 

};

Table 5-16 describes the attributes displayed by these commands.

Table 5-16 cerent15216EdfaRtcDateAndTime Command Attributes

Attribute	Description
cerent15216EdfaRtcDateAndTimeLocal	The current local time. Setting this value changes the time according to the cerent15216EdfaRtcDateAndTimeTimezone and cerent15216EdfaRtcDateAndTimeSaving values. The time zone and saving fields of this attribute are in the set command.
cerent15216EdfaRtcDateAndTimeGMT	The current GMT time.
cerent15216EdfaRtcDateAndTimeLocalString	The current local time.
cerent15216EdfaRtcDateAndTimeGMTString	The current GMT time.
cerent15216EdfaRtcDateAndTimeTimezone	The time zone in hours from GMT.
cerent15216EdfaRtcDateAndTimeSaving	The current daylight saving offset in minutes.
cerent15216EdfaRtcDateAndTimeFormsString	The current local time.

Power Gain

Command: snmp attribute get local cerentEdfa15216EdfaConstGainOverallGain

Syntax: snmp attribute get local cerentEdfa15216EdfaConstGainOverallGain #

Description: Displays the ONS 15216 EDFA2 overall power gain when the EDFA is in a constant gain mode.

The following commands access overall power gain when in the constant gain mode:

•snmp row display local cerent15216EdfaOverallControl command

•snmp row get local cerent15216EdfaOverallControl command

The cerent15216EdfaConstGainOverallGain attribute in cerent15216EdfaOverallControl display command shows the ONS 15216 EDFA2 power gain ( Example 5-10).

Example 5-10 cerent15216EdfaOverallControl Display Command

hostname:ONS15216 EDFA2>snmp row display local cerent15216EdfaOverallControl 

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaOverallControl ::= {

    cerent15216EdfaConstGainOverallGain =  230;

    cerent15216EdfaVariableGainPreAttenuation =  0;

};

For information about all of the parameters in the cerent15216EdfaStatusGroup, refer to Table 5-8.

Case Temperature

Command: snmp attribute get local cerent15216EdfaPumpStatusAmbientTemp

Syntax: snmp attribute get local cerent15216EdfaPumpStatusAmbientTemp pump#

Description: Displays case temperature value (where # is the pump number).

The following commands display the temperature value (where # is the pump number) and other pump status data:

•snmp row display local cerent15216EdfaPumpStatusAmbientTemp pump # command

The cerent15216EdfaPumpStatusAmbientTemp attribute of the cerentEdfaPumpStatusEntry display command shows the case temperature ( Example 5-11).

Example 5-11 cerent15216EdfaPumpStatusEntry Display Command

hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaPumpStatusEntry 1

CLASS cerent15216Edfa--MIB.cerent15216EdfaPumpStatusEntry ::=

{

    cerent15216EdfaPumpStatusPumpNum =  1;

    cerent15216EdfaPumpStatusLaserChipTemp =  260;

    cerent15216EdfaPumpStatusLaserChipTempSetpoint =  260;

    cerent15216EdfaPumpStatusLaserTECCurrent =  20;

    cerent15216EdfaPumpStatusLaserPower =  8503;

    cerent15216EdfaPumpStatusLaserCurrent =  17010;

    cerent15216EdfaPumpStatusAmbientTemp =  2272;

    cerent15216EdfaPumpStatusDCVoltage =  52;

    cerent15216EdfaPumpStatusInPoweruW =  1;

    cerent15216EdfaPumpStatusInPowerdBm =  -4003;

    cerent15216EdfaPumpStatusOutPowermW =  3195;

    cerent15216EdfaPumpStatusOutPowerdBm =  1504;

    cerent15216EdfaPumpStatusGain =  550;

};

Refer to Table 5-10 for information about all of the parameters in the cerent15216EdfaPumpStatusEntry Table.

Temperature Alarm Threshold

CtmpMin

Command: snmp attribute get local cerent15216EdfaCtmpMin

Syntax: snmp attribute get local cerent15216EdfaCtmpMin

Description: This command displays minimum case temperature alarm threshold.

CtmpMax

Command: snmp attribute get local cerent15216EdfaCtmpMax

Syntax: snmp attribute get local cerent15216EdfaCtmpMax

Description: This command displays maximum case temperature alarm threshold.

The following commands display case temperature alarm threshold and other temperature data:

•snmp row display local cerent15216EdfaCfgGroup command

Example 5-12 cerent15216EdfaCfgGroup Display Command

hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaCfgGroup

CLASS cerent15216Edfa--MIB.cerent15216EdfaCfgGroup ::=

{

    cerent15216EdfaCfgSaved =  true;

    cerent15216EdfaLpoutSetpoint =  1000;

    cerent15216EdfaLpoutDeviation =  200;

    cerent15216EdfaLpoutHysteresis =  100;

    cerent15216EdfaLOSThreshold =  -2400;

    cerent15216EdfaLOSHysteresis =  100;

    cerent15216EdfaCtmpMin =  5;

    cerent15216EdfaCtmpMinHysteresis =  1;

    cerent15216EdfaCtmpMax =  65;

    cerent15216EdfaCtmpMaxHysteresis =  1;

};

Refer to Table 5-8 for information about all of the parameters in cerent15216EdfaStatusGroup.

Case Temperature Alarm Hysteresis

CtmpMaxHysteresis

Command: snmp attribute get local cerent15216EdfaCtmpMaxHysteresis

Syntax: snmp attribute get local cerent15216EdfaCtmpMaxHysteresis

Description: Displays maximum case temperature alarm hysteresis.

The cerent15216EdfaCtmpMaxHysteresis attribute in the cerent15216EdfaCfgGroup display command shows the maximum case hysteresis temperature alarm threshold ( Example 5-12). Refer to Table 5-6 for information about all of the parameters in cerent15216EdfaCfgGroup.

CtmpMinHysteresis

Command: snmp attribute get local cerent15216EdfaCtmpMinHysteresis

Syntax: snmp attribute get local cerent15216EdfaCtmpMinHysteresis

Description: Displays the minimum case hysteresis temperature alarm threshold.

The following commands display case temperature alarm hysteresis and other data:

•snmp row display local cerent15216EdfaCfgGroup command

The cerent15216EdfaCfgGroup command is shown in Example 5-12. For information about all of the parameters in the cerent15216EdfaCfgGroup table, see Table 5-6.

Power BUS Mode

PowerBusMode

Command: snmp attribute get local cerent15216EdfaPowerBusMode

Syntax: snmp attribute get local cerent15216EdfaPowerBusMode

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

The following commands display power bus voltage and other data:

•snmp row display local cerent15216EdfaCfgGroup command

PowerBusDCVoltageMax

Command: snmp attribute get local cerent15216EdfaPowerBusDCVoltageMax

Syntax: snmp attribute get local cerent15216EdfaPowerBusDCVoltageMax

Description: Displays the maximum allowable power bus DC voltage (multiplied by -10V).

The following commands display power bus voltage and other data:

•snmp row display local cerent15216EdfaCfgGroup command

PowerBusDCVoltageMin

Command: snmp attribute get local cerent15216EdfaPowerBusDCVoltageMin

Syntax: snmp attribute get local cerent15216EdfaPowerBusDCVoltageMin

Description: Displays the minimum allowable power bus DC voltage (multiplied by -10V).

The following commands display power bus voltage and other data:

•snmp row display local cerent15216EdfaCfgGroup command

Loss of Input Power Value (Input Power)

InPowerduW

Command: snmp attribute get local cerent15216EdfaInPoweruW

Syntax: snmp attribute get local cerent15216EdfaInPoweruW

Description: Displays loss of input power value and displays the data in microwatts.

The following command displays the Cisco ONS 15216 EDFA's input power value and other status information:

•snmp row display local cerent15216EdfaOverallStatusGroup command

For information about all of the parameters in the cerent15216EdfaOverallStatusGroup table, see Table 5-8.

InPowerdBm

Command: snmp attribute get local cerent15216EdfaInPowerdBm

Syntax: snmp attribute get local cerent15216EdfaInPowerdBm

Description: Displays the ONS 15216 EDFA2 loss of input power value in dBm.

The following command displays input power value and other status information:

•snmp row display local cerent15216EdfaOverallStatusGroup command

Refer to Table 5-8 for information about all of the parameters in the cerent15216EdfaOverallStatusGroup Table.

Loss of Input Power Alarm Threshold

LOSThreshold

Command: snmp attribute get local cerent15216EdfaLOSThreshold

Syntax: snmp attribute get local cerent15216EdfaLOSThreshold

Description: Displays the loss of input power alarm threshold.

The following commands display the loss of input power alarm threshold and other laser power and temperature data:

•snmp row display local cerent15216EdfaCfgGroup command

The cerent15216EdfaLOSThreshold attribute in the cerent15216EdfaCfgGroup display command shows the loss of input power alarm threshold ( Example 5-12).

For information about all of the parameters in the cerent15216EdfaCfgGroup table, refer to Table 5-6.

Loss of Input Power Alarm Hysteresis

Command: snmp attribute get local cerent15216EdfaLOSHysteresis

Syntax: snmp attribute get local cerent15216EdfaLOSHysteresis

Description: Displays the loss of input power value.

The following commands display the loss of input power hysteresis value and other laser power and temperature data:

•snmp row display local cerent15216EdfaCfgGroup command

The cerent15216EdfaLOSHysterisis attribute in the cerent15216EdfaCfgGroup display command shows the loss of input power alarm threshold ( Example 5-12). For information about all of the parameters in in the cerent15216EdfaCfgGroup table, refer to Table 5-6.

Loss of Output Power Value (Output Power)

OutPoweruW

Command: snmp attribute get local cerent15216EdfaOutPoweruW

Syntax: snmp attribute get local cerent15216EdfaOutPoweruW

Description: Displays loss of output power value in microwatts.

The snmp row display local cerent15216EdfaOverallStatusGroup command displays the Cisco ONS 15216 EDFA2 loss of output power value and additional pump status. For information about all of the parameters in the cerent15216EdfaOverallStatusGroup table, refer to Table 5-8.

OutPowerdBm

Command: snmp attribute get local cerent15216EdfaOutPowerdBm

Syntax: snmp attribute get local cerent15216EdfaOutPowerdBm

Description: Displays loss of output power value in dBm. This command displays loss of output power value and additional pump status data.

For information about all of the parameters in the cerent15216EdfaOverallStatusGroup table, refer to Table 5-8.

Loss of Output Power Alarm Setpoint

LpoutSetpoint

Command: snmp attribute get local cerent15216EdfaLpoutSetpoint

Syntax: snmp attribute get local cerent15216EdfaLpoutSetpoint

Description: This attribute notifies network operations personnel notification if the output power of the ONS 15216 EDFA2 drops below a level that impacts proper operation of the optical network.

Typically, network operations personnel should set the loss of output power alarm threshold at a value that is appropriate for the intended network application so that the alarm condition is meaningful. Consult with a Cisco Systems Engineer to determine threshold value for your application. As a guideline, Cisco recommends that loss of output power alarm threshold value be set at 1 dBm below the current output power level of the amplifier.

When the ONS 15216 EDFA2 is set to constant gain operation (factory default), the value for loss of output power alarm threshold cannot be changed. To display the loss of output power alarm threshold and other power and temperature alarm data, use the snmp table display local cerent15216EdfaCfgGroup command (shown in Example 5-12). This command returns the current alarm threshold default values.

LpoutDeviation

Command: snmp attribute get local cerent15216EdfaLpoutDeviation

Syntax: snmp attribute get local cerent15216EdfaLpoutDeviation

Description: This attribute is not required when operating in factory default, constant gain mode. Setting of the loss of output power alarm deviation is only necessary when the amplifier is used in constant output power.

This attribute is used to set the amount by which the output power must vary from the threshold setpoint before the alarm is activated. This attribute, in conjunction with the loss of output power alarm threshold and hysteresis, enables notification of network operations personnel if the output power of the ONS 15216 EDFA2 drops below a level that would impact proper operation of the optical network.

Typically, network operations personnel should set the loss of output power alarm deviation at a value that is appropriate for the intended network application so that the alarm condition is meaningful. Consult with a Cisco Systems Engineer to determine the deviation value for your application. As a guideline, Cisco recommends that the loss of output power alarm deviation value be set at 2 dBm. The module triggers an alarm if it detects a signal level of 2 dBm below the current output power alarm level threshold value set for the amplifier.

When the ONS 15216 EDFA2 is set to constant gain operation (factory default), the value for the loss of output power alarm threshold cannot be changed. To display the loss of output power alarm deviation and other power and temperature alarm data, use the snmp table display local cerent15216EdfaCfgGroup command as shown in Example 5-12. This command returns the current alarm threshold default values.

To set the loss of output power alarm deviation when the ONS 15216 EDFA2 is configured for operation in constant output power or constant pump power operation mode, type snmp attribute set local cerent15216EdfaLpoutDeviation at the command prompt followed by a number (as shown in Example 5-13). Valid entries are between 0 and 1000 and are in dBm times 100. For example, if the loss of output power deviation required were 0.2 dBm, the number input as the loss of output power alarm deviation would be 20.

The user is prompted to modify the attribute. If no changes are required, press Enter to return to command prompt.

Example 5-13 cerent15216EdfaLpoutDeviation Set Command

Username:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaLpoutDeviation 20

Username:ONS15216 EDFA2> snmp row display local cerent15216EdfaCfgGroup

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCfgGroup ::=

{

 cerent15216EdfaCfgSaved = true;

cerent15216EdfaLpoutSetpoint = 400;

cerent15216EdfaLpoutDeviation = 20;

cerent15216EdfaLpoutHysteresis = 100;

cerent15216EdfaLOSThreshold = -3000;

cerent15216EdfaLOSHysteresis = 100;

cerent15216EdfaCtmpMin = 1;

cerent15216EdfaCtmpMinHysteresis = 1;

cerent15216EdfaCtmpMax = 65;

cerent15216EdfaCtmpMaxHysteresis = 1;

cerent15216EdfaCLEI = "";

}

Changes must be saved before terminating the session. See the "Save Changes" section on page 4-11.

Loss of Output Power Alarm Hysteresis

LpoutHysteresis

Command: snmp attribute get local cerent15216EdfaLpoutHysteresis

Syntax: snmp attribute get local cerent15216EdfaLpoutHysteresis

Description: This attribute is not required when operating in factory default, constant gain mode. Setting of the loss of output power alarm deviation is only necessary when the amplifier is used in constant output power or constant pump power modes of operation.

This attribute is used to set the amount by which the output power must increase from the threshold setpoint before the alarm is cleared. This attribute, in conjunction with the loss of output power alarm threshold and deviation, enables efficient processing and clearing of the alarm condition.

Typically, network operations personnel should set the loss of output power alarm hysteresis at a value that is appropriate for the intended network application so that the alarm condition is meaningful. Consult with Cisco Systems Engineer to determine the hysteresis value for your application. As a guideline, Cisco recommends that loss of output power alarm hysteresis value be set at 0.2 dBm. The module clears the alarm if it detects a signal level of 0.2 dBm above the current output power alarm level threshold value set for the amplifier.

When ONS 15216 EDFA2 is set to constant gain operation (factory default), the value for loss of output power alarm threshold cannot be changed. To display the loss of output power alarm deviation and other power and temperature alarm data, use the snmp Table display local cerent15216EdfaCfgGroup command as shown in Example 5-12. This command returns the current alarm threshold default values.

To set the loss of output power alarm hysteresis when Cisco ONS 15216 is configured for operation in constant output power or constant pump power operation mode, type snmp attribute set local cerent15216EdfaLpoutHysteresis at the command prompt followed by a number. Valid entries are between 0 and 1000 and are in dBm times 100. For example, if the loss of output power hysteresis required were 0.2 dBm, the number input as loss of output power alarm hysteresis would be 200.

The user is prompted to modify the attribute. If changes are not required, press Enter to return to command prompt.

Changes must be saved before terminating the session. See the "Save Changes" section on page 4-11.

AlarmEntry

Command: snmp Table display local cerent15216EdfaAlarmEntry

Syntax: snmp Table display local cerent15216EdfaAlarmEntry

Description: Accesses the alarm status. Example 5-22 shows the cerent15216EdfaAlarmEntry display command.

Example 5-14 cerent15216EdfaAlarmEntry Display Command

hostname:ONS15216 EDFA2> snmp table display local cerent15216EdfaAlarmEntry

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaAlarmEntry ::=

{

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;

cerent15216EdfaAlarmID.11 =  isolationDiode;

For information about all of the parameters in the cerent15216EdfaAlarmEntry table, refer to Table 5-11.