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

Table Of Contents

SNMP MIB Configuration

5.1  SNMP Overview

5.1.1  SNMP Components

5.1.2  ONS 15216 EDFA2 SNMP Elements

5.1.3  SNMP MIBs and Message Types

5.1.4  Command Syntax Using the SNMP Agent

5.2  Enabling SNMP Remote Management Community Strings

5.2.1  Creating a View

5.2.2  Creating a Community Entry

5.3  Setting Up for CTM Access

5.4  Tables and Groups

5.4.1  ActionOpGroup

5.4.2  AgentControlGroup

5.4.3  AlarmEntry

5.4.4  BootEntry

5.4.5  BootImageEntry

5.4.6  CfgGroup

5.4.7  FfsFileEntry

5.4.8  FfsOpGroup

5.4.9  LogEventControl

5.4.10  LogEventEntry

5.4.11  OpGroup

5.4.12  OverallControl

5.4.13  OverallStatusGroup

5.4.14  PumpCfgEntry

5.4.15  PumpStatusEntry

5.4.16  RtcDateAndTime

5.4.17  SromIpMgmtGroup

5.4.18  VersionGroup

5.5  Setting Up Traps

5.5.1  Display Trap Command

5.5.2  Set Trap Command

5.5.3  Set Agent Trap Enable

5.5.4  Get Agent Trap Enable

5.6  Retrieving Information

5.6.1  IP Address

5.6.2  Date and Time

5.6.3  Power Gain

5.6.4  Case Temperature

5.6.5  Power Bus

5.6.6  Input Power (Signal)

5.6.7  Output Power

5.6.8  Database Backup and Restore

5.6.9  Alarm Entry

5.7  Summary of SNMP Alarms and Events


SNMP MIB Configuration


This chapter explains how to read and understand SNMP MIB as it relates to the Cisco 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 "Provisioning with ASH and SNMP."

5.1  SNMP Overview

Simple Network Management Protocol (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 NMS.

The ONS 15216 EDFA2 SNMP implementation uses proprietary and 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.

5.1.1  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.

5.1.2  ONS 15216 EDFA2 SNMP Elements

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

SNMP agent

SNMP MIB

SNMP manager

The SNMP elements are shown in Figure 5-1.

Figure 5-1 SNMP Elements

5.1.2.1  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 shows the relationship between the SNMP agent and the MIB.

Figure 5-2 SNMP Agent and MIB

5.1.2.2  SNMP MIBs

The SNMP MIBs are files written in ASN.1 syntax. The MIBs specify what ONS 15216 EDFA2 information needs to be controlled and monitored. The MIBs are pre-installed on the SNMP agent and are accessible via the CLI. Table 5-1 lists the proprietary MIBs for the ONS 15216 EDFA2.

Table 5-1 SNMP MIB Files

File Name
MIB Name
Description

CERENT-15216-EDFA-MIB.mib

CERENT-15216-EDFA-MIB

The definitions of objects for managing and monitoring the ONS 15216 EDFA2.

CERENT-GLOBAL-REGISTRY.mib

CERENT-GLOBAL-REGISTRY

The global registrations for all other Cisco OTBU MIB modules.


The ONS 15216 EDFA2 also supports the RFC MIBS listed in Table 5-2. Note that some attributes and tables from these MIBS are not applicable or not implemented in the ONS 15216 EDFA2.

Table 5-2 Supported RFC SNMP MIB Files

File Name
MIB Name
Description

rfc1213.mib

RFC1213-MIB

The system MIB.

rfc1659.mib

RS-232-MIB

The MIB module for RS-232-like hardware devices.

rfc1907.mib

SNMPv2-MIB

The MIB module for SNMPv2 entities.

rfc2011.mib

IP-MIB

The MIB module for managing IP and ICMP implementations, but excluding their management of IP routes.

rfc2012.mib

TCP-MIB

The MIB module for managing TCP implementations.

rfc2013.mib

UDP-MIB

The MIB module for managing UDP implementations.

rfc2233.mib

IF-MIB

The MIB module to describe generic objects for network interface sub-layers. This MIB is an updated version of MIB-II's ifTable, and incorporates the extensions defined in RFC 1229.

rfc2737.mib

ENTITY-MIB

The MIB module for representing multiple logical entities supported by a single SNMP agent.


The CERENT-15216-EDFA-MIB.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, uses the SNMP MIBs to communicate with the SNMP agent.

5.1.2.3  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.

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.

5.1.3  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.

A 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-3 describes SNMP operation types.

Table 5-3 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.


5.1.4  Command Syntax Using the SNMP Agent

Although Cisco has its own separate SNMP manager (Cisco Transport Manager [CTM]), management of the ONS 15216 EDFA2 is also possible using the built-in SNMP manager via the command line in the ASH shell, as described in the "6.6  SNMP Commands" section on page 6-14. The example commands and command syntax described in this manual are based on using the built-in ONS 15216 EDFA2 SNMP manager through the ASH shell CLI.

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

ash:hostname:ONS15216 EDFA2>

To communicate with the module using SNMP, the command must begin with "snmp". To view a list of possible SNMP operations, enter "snmp" followed by a space and press the Tab key. (See Example 5-1.)

Example 5-1 snmp Command Followed by the Tab Key

ash:hostname:ONS15216 EDFA2> snmp
attribute
host
mib
pdu
row
session
subtree
table
trap
tree

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

Example 5-2 snmp table display Command

ash:hostname:ONS15216 EDFA2> snmp table display local cerent
cerent15216EdfaCommunityEntry
cerent15216EdfaCommTrapEntry
cerent15216EdfaViewEntry
cerent15216EdfaAgentControlGroup
cerent15216EdfaActionOpGroup
cerent15216EdfaLogEventControl
cerent15216EdfaLogEventEntry
cerent15216EdfaBootEntry
cerent15216EdfaBootImageEntry
cerent15216EdfaRtcDateAndTime
cerent15216EdfaSromIpMgmtGroup
cerent15216EdfaCfgGroup
cerent15216EdfaOverallControl
cerent15216EdfaPumpCfgEntry
cerent15216EdfaOverallStatusGroup
cerent15216EdfaPumpStatusEntry
cerent15216EdfaAlarmEntry
cerent15216EdfaVersionGroup
cerent15216EdfaFfsFileEntryGroup
cerent15216EdfaFfsOpGroup
...

Use these commands to set up community strings and traps (see the "Enabling SNMP Remote Management Community Strings" section and the "Setting Up Traps" section).

5.2  Enabling SNMP Remote Management Community Strings

SNMP communities are groupings of workstations and servers (or gateways) that can manage the ONS 15216 EDFA2. NMSs 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-4.

Table 5-4 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.

5.2.1  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 the Cisco TAC before modifying these settings.

5.2.1.1  Set View Entry

Command Types

snmp row set local cerent15216EdfaViewEntry

Syntax Description

snmp row set local cerent15216EdfaViewEntry view_index_# subtree

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. view_index_# 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

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaViewEntry 1 cerent

cerent15216EdfaViewMask '0'H
cerent15216EdfaViewType included
cerent15216EdfaViewStatus
active
notInService
notReady
createAndGo
createAndWait
destroy
cerent15216EdfaViewStatus createAndGo

ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaViewEntry 1 sample
CLASS cerent15216Edfa-AGENT-MIB.cerent15216EdfaViewEntry ::=
{
cerent15216EdfaViewIndex = 1;
cerent15216EdfaViewSubtree = { sample };
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-5 describes the command and MIB view prompts.

Table 5-5 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 Identifier

Sub-Tree Object Identifier: An object identifier that designates a sub-tree element in the MIB hierarchy. zeroDotZero specifies the entire CLI MIB hierarchy.

cerent15216EdfaViewMask

`0'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.)


5.2.2  Creating a Community Entry

SNMP communities are groupings of workstations and servers (or gateways) that can manage the ONS 15216 EDFA2. NMSs 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 the Cisco TAC before modifying these settings.

5.2.2.1  Set CommunityEntry

Command Types

snmp row set local cerent15216EdfaCommunityEntry

Syntax Description

snmp row set local cerent15216EdfaCommunityEntry community_index_#

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-6 for information concerning data for each prompt.

Example 5-4 cerent15216EdfaCommunityEntry Set Command

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaCommunityEntry 3

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-6 displays the definitions for the community entry values.

Table 5-6 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 "3".

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



Note To create a community entry that is restricted to a single IP address, set the community attribute cerent15216EdfaCommNetMask to 255.255.255.255.


5.2.2.2  Display CommunityEntry

Command Types

snmp row display local cerent15216EdfaCommunityEntry

Syntax Description

snmp row display local cerent15216EdfaCommunityEntry community_index_#

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

ash: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-7 displays the decimal values for the following SNMP operations.

Table 5-7 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.

5.3  Setting Up for CTM Access

Use the following procedure to configure a new ONS 15216 EDFA2 for Cisco Transport Manager (CTM) access:


Step 1 Log into the serial port. Use 19,000 bps, 8 bits, no parity, 1 stop, and no flow control over a male-to-female straight 9-pin cable.

Amp01:ONS15216 EDFA2> ACT-USER::CISCO15:123::;

Step 2 Set the default user password to admin15##:

Amp01:ONS15216 EDFA2> ED-PID::CISCO15:124::,admin15##;

Step 3 Enter the IP address and node name configuration information:

Amp01:ONS15216 EDFA2> ED-NE-GEN:::125:::NAME= ,IPADDR= ,IPMASK= ,DEFRTR= ;

Step 4 Set the date and time:

Amp01:ONS15216 EDFA2> ED-DAT:::126::2003-06-18,08-49-00;

Step 5 Activate the new IP address by rebooting:

Amp01:ONS15216 EDFA2> INIT-SYS::ALL:127::1;

Step 6 Telnet to the ASH shell by typing the following:

telnet <ONS 15216 EDFA2 IP address> 8023

Step 7 Login using the user name CISCO15 and the password admin15##.

Step 8 Enter the community information:

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaCommunityEntry 2 (Do not use Entry 1 which is the RO public community)
cerent15216EdfaCommIndex = 2 (if the CommunityEntry is 2)
cerent15216EdfaCommName = "private" (must match the CTM community string entry)
cerent15216EdfaCommViewIndex = 1
cerent15216EdfaCommPrivileges = 255
cerent15216EdfaCommSrcIPAddr = 0.0.0.0 (for more security, enter CTM A's IP address)
cerent15216EdfaCommNetMask = 255.255.255.255
cerent15216EdfaCommStatus = 4 (active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6))

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaCommunityEntry 3

cerent15216EdfaCommIndex = 3 (if the CommunityEntry is 3)
cerent15216EdfaCommName = "private" (must match the CTM community string entry)
cerent15216EdfaCommViewIndex = 1
cerent15216EdfaCommPrivileges = 255
cerent15216EdfaCommSrcIPAddr = 0.0.0.0 (for more security, enter CTM B's IP address)
cerent15216EdfaCommNetMask = 255.255.255.255
cerent15216EdfaCommStatus = 4 (active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6))

Step 9 Verify the community information:

ash:hostname:ONS15216 EDFA2> snmp table display local cerent15216EdfaCommunityEntry

Step 10 Enter the trap destination information. The Trap Community must match the SNMP Community string used in CTM:

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaCommTrapEntry 1

cerent15216EdfaCommTrapCommunity "private"
cerent15216EdfaCommTrapDestIPAddress <CTM A's IP address>
cerent15216EdfaCommTrapDestUDPPort 162
cerent15216EdfaCommTrapViewIndex 1
cerent15216EdfaCommTrapVersion v2
cerent15216EdfaCommTrapStatus 4

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaCommTrapEntry 2

cerent15216EdfaCommTrapCommunity "private"
cerent15216EdfaCommTrapDestIPAddress <CTM B's IP address>
cerent15216EdfaCommTrapDestUDPPort 162
cerent15216EdfaCommTrapViewIndex 1
cerent15216EdfaCommTrapVersion v2
cerent15216EdfaCommTrapStatus 4

Step 11 Verify the trap destination information:

ash:hostname:ONS15216 EDFA2> snmp table display local cerent15216EdfaCommTrapEntry

Step 12 Enable traps:

ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaAgentTrapEnable 1

Step 13 Verify that traps are enabled:

ash:hostname:ONS15216 EDFA2> snmp attribute get local cerent15216EdfaAgentTrapEnable

Step 14 Set network element (NE) ID:

ash:hostname:ONS15216 EDFA2> snmp attribute set local sysName <NE ID>

Step 15 Save the new settings:

ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaOpSaveConfig perform

Step 16 Log off:

ash:hostname:ONS15216 EDFA2> logoff

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

ActionOpGroup

AgentControlGroup

AlarmEntry

BootEntry

BootImageEntry

CfgGroup

FfsFileEntry

FfsOpGroup

LogEventControl

LogEventEntry

OpGroup

OverallControl

OverallStatusGroup

PumpCfgEntry

PumpStatusEntry

RtcDateAndTime

SromIpMgmtGroup

VersionGroup

5.4.1  ActionOpGroup

The cerent15216EdfaActionOpGroup table is used to perform operations on the agent. Table 5-8 lists the table variables.

Table 5-8 cerent15216EdfaActionOpGroup Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaActionOpStatus

idle(1), pending(2), inProgress(3), aborted(4)

Read-only

The status of the current operation.

cerent15216EdfaActionOpResult

Integer (-2147483647 to 2147483647)

Read-only

This value saves the error result (if any) of the last operation. 0 indicates success.

cerent15216EdfaActionOpReset

idle(1), perform(2), abort(3)

Read-write

This object resets the Management Module (not the Optical Module) when the "perform" value is written to it. The reset is delayed by approximately 2 seconds to allow SNMP response to be sent to the manager before the reset is performed.

cerent15216EdfaActionOpSaveConfig

Display String (1 to 20 characters)

Read-write

To save the configuration of the SNMP agent on the Management Module, write the destination file name to this object. The most recent version of the destination file is saved as <name>.bak.

Note: The agent automatically reads the configuration from `snmp.cfg' at startup. Saving to other file names does not change this.


5.4.2  AgentControlGroup

The cerent15216EdfaControlGroup table is used to control the agent. Table 5-9 lists the table variables.

Table 5-9 cerent15216EdfaControlGroup Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaAgentTrapEnable

enabled(1), disabled(2)

Read-write

Allows the generation of traps from the agent.

cerent15216EdfaAgentNotificationNumber

Integer (0 to 2147483647)

Read-only

The number of traps dispatched since the reboot.


5.4.3  AlarmEntry

The cerent15216EdfaAlarmEntry table is used to display and control alarms. The associated table command provides a summary of all alarms. Table 5-10 describes the table variables.

Table 5-10 cerent15216EdfaAlarmEntry Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaAlarmIndex

Integer
(1 to 2048)

Not Accessible

A unique value to identify this entry.

cerent15216EdfaAlarmID

unknownAlarm(1), lcrnt1(2), lcrnt2(3), ltmp1(4), ltmp2(5), lpout(6), lpin(7), gain(8), ctmp(9), powerBusA(10), powerBusB(11), dbBackup(12), dbRestore(13), swDownload(14)

Read-only

The alarm this entry refers to.

cerent15216EdfaAlarmPriority

noAlarm(1), info(2), minor(3), major(4), critical(5)

Read-only

The reporting priority of this alarm.

cerent15216EdfaAlarmState

active(1), disabled(2), cleared(3)

Read-only

The reporting state of this alarm.

cerent15216EdfaAlarmEnableStatus

enabled(1), disabled(2)

Read-write

If the alarm is enabled/disabled.

cerent15216EdfaAlarmDateAndTime

Cerent15216EdfaDateAndTimeString

Read-only

The local date and time when the alarm entered its current state.

cerent15216EdfaAlarmCfgPriority

noAlarm(1), info(2), minor(3), major(4), critical(5)

Read-write

The configured priority of this alarm.


5.4.4  BootEntry

The cerent15216EdfaBootEntry table is used to determine the boot source image for the bootable modules. The table contains up to four entries, and the module tries these sources in turn until an image is successfully loaded. Table 5-11 lists the table variables.

Table 5-11 cerent15216EdfaBootEntry Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaBootModuleIndex

Integer (1 to 63)

Not accessible

The index of this module within the chassis.

cerent15216EdfaBootEntryIndex

Integer (1 to 4)

Not accessible

The index of this boot entry for this module.

cerent15216EdfaBootType

tftp(1), flash(2), bootp(3), shell(4), noLoad(5)

Read-write

The boot record type.

cerent15216EdfaBootIpAddress

IpAddress

Read-write

IP address for boot server when using TFTP or bootp. It is 0.0.0.0 otherwise.

cerent15216EdfaBootFileName

Display String (1 to 33 characters)

Read-write

The file to be loaded. This may include a path component. For example if BootType is TFTP, this object represents the location of the file relative to the TFTP server's root directory and may have a form like images/image1.


5.4.5  BootImageEntry

The cerent15216EdfaBootImageEntry table contains the boot and running software image name and revision information for each bootable module. Table 5-12 lists the table variables.

Table 5-12 cerent15216EdfaBootImageEntry Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaBootImageModuleIndex

Integer (1 to 63)

Not accessible

The index of this module within the chassis.

cerent15216EdfaBootImageType

bootLoader(1), runTime(2)

Not accessible

The type of this image.

cerent15216EdfaBootImageName

Display String (0 to 10 characters)

Read-only

The name of the image.

cerent15216EdfaBootImageFileName

Display String (1 to 33 characters)

Read-only

The file name of the image with no path component.

cerent15216EdfaBootImageRevMajor

Integer (0 to 255)

Read-only

The major revision number of the image.

cerent15216EdfaBootImageRevMinor

Integer (0 to 255)

Read-only

The minor revision number of the image.

cerent15216EdfaBootImageRevInterim

Integer (0 to 255)

Read-only

The interim revision number of the image.


5.4.6  CfgGroup

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-13 for variable definitions. For more information on alarm thresholds, see the "Set Alarm Thresholds" section.

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

Table 5-13 cerent15216EdfaCfgGroup Variable Descriptions 

Variable
Syntax
Maximum
Access
Description

cerent15216EdfaCfgSaved

Truth Value
(true default)

Read-only

Indicates whether the current configuration has been saved. The object cerent15216EdfaOpSaveConfig can be used to save the current configuration.

cerent15216EdfaLpoutSetpoint

Integer
(0 to 1000,
0 default)

Read-only

Laser pump output power setpoint for the Lpout alarm, in units of 0.1 mW. This is set automatically when the pump mode for pump 2 is set to cerent15216EdfaPumpCfgConstPumpPower or cerent15216EdfaPumpCfgConstOutPower.

cerent15216EdfaLpoutDeviation

Integer
(0 to 1000,
200 default)

Read-write

Amount by which the output power must deviate from the setpoint to set the Lpout alarm, in units of 0.01 dB. For example, a value of 200 is actually 2.00 dB.

cerent15216EdfaLpoutHysteresis

Integer
(0 to 1000,
100 default)

Read-write

Amount the output power must move towards the setpoint before the Lpout alarm is cleared, in units of 0.01 dB. For example, a value of 100 is actually 1.00 dB.

cerent15216EdfaLOSThreshold

Integer
(-3100 to -1500, -3000 default)

Read-write

Loss of signal threshold, in units of 0.01 dBm. For example, a value of -3000 is actually -30.0 dBm.

cerent15216EdfaLOSHysteresis

Integer
(0 to 1000,
100 default)

Read-write

Amount above cerent15216EdfaLOSThreshold the input signal must rise before the Lpin alarm is cleared, in units of 0.01 dB. For example, a value of 100 is actually 1.0 dB.

cerent15216EdfaCtmpMin

Integer
(-10 to 10,
-5 default)

Read-write

Minimum allowable case temperature in degrees Celsius.

cerent15216EdfaCtmpMinHysteresis

Integer
(0 to 10,
1 default)

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,
70 default))

Read-write

Maximum allowable case temperature in degrees Celsius.

cerent15216EdfaCtmpMaxHysteresis

Integer
(0 to 10,
1 default)

Read-write

Amount below cerent15216EdfaCtmpMax that the case temperature must drop before the Ctmp alarm is cleared, in degrees Celsius.

cerent15216EdfaCLEI

Display String
(0 to 10 characters)

Read-only

Indicates the factory setting of the Common Language Equipment Identifier (CLEI) code (established by Telcordia) of the Cisco ONS 15216 EDFA2. This attribute can be accessed but not changed by the user.

cerent15216EdfaPowerBusMode

simplex(1), duplex(2)

Read-write

Simplex for one power source (Bus A) or duplex for redundant power source (Bus A and Bus B) Power Bus mode.

cerent15216EdfaPowerBusDCVoltageMin

Integer
(350 to 700,
420 default)

Read-write

Minimum allowable power bus DC voltage, in units of -0.1V. For example, a value of 420 is actually -42.0V.

The power bus threshold has a 1.5V tolerance and a 1.0V hysteresis. If the minimum threshold is configured at 420 (-42 VDC), the alarm may raise anywhere between -42 to -40.5V and will not clear until the voltage goes above -43 VDC.

cerent15216EdfaPowerBusDCVoltageMax

Integer
(350 to 700,
570 default)

Read-write

Maximum allowable power bus DC voltage, in units of -0.1V. For example, a value of 570 is actually -57.0V.

The power bus threshold has a 1.5V tolerance and a 1.0V hysteresis. If the maximum threshold is configured at 570 (-57 VDC), the alarm may raise anywhere between -57 to -58.5V and will not clear until the voltage goes below -56V.

cerent15216EdfaALSMode

enabled(1), disabled(2)

Read-write

Automatic Laser Shutdown. If enabled, then when LOS is detected, the amplifier is shut down to 0 mW output power, and when LOS is cleared, the amplifier mode is restored to the before shutdown state.


5.4.7  FfsFileEntry

The cerent15216EdfaFfsFileEntry table contains status information about the files within the file system. Table 5-14 lists the table variables.

Table 5-14 cerent15216EdfaFfsFileEntry Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaFfsFileName

Display String (1 to 20 characters)

Not Accessible

The name of this file.

cerent15216EdfaFfsFileType

directory(1), sequenced(2), record(3), unknown(4)

Read-only

The type of this file. "sequenced" is a normal text file.

cerent15216EdfaFfsFileStatus

deleted(65528), ok(65532), renameSource(65534), unInitialised(65535)

Read-only

The status of this file.

cerent15216EdfaFfsFileLength

Integer

Read-only

The length of this file (-1 for cerent15216EdfaFfsFileType = record).

cerent15216EdfaFfsFileAttributes

Unsigned32

Read-only

The attributes field for this file.


5.4.8  FfsOpGroup

The cerent15216EdfaFfsOpGroup table contains information on performing operations on the Flash File System. Table 5-15 lists the table variables.

Table 5-15 cerent15216EdfaFfsOpGroup Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaFfsOpAction

idle(1), perform(2), abort(3)

Read-write

Start or abort a file operation.

cerent15216EdfaFfsOpOperation

cerent15216EdfaFfsNoOperation(1), cerent15216EdfaFfsTftpGet(2), cerent15216EdfaFfsTftpPut(3), cerent15216EdfaFfsTftpGetRecord(4), cerent15216EdfaFfsTftpPutRecord(5), cerent15216EdfaFfsCopy(6), cerent15216EdfaFfsRename(7), cerent15216EdfaFfsCompress(8), cerent15216EdfaFfsDelete(9)

Read-write

Indicates the current (or last) action performed on the flash file system. Note that cerent15216EdfaFfsTftpGet and cerent15216EdfaFfsTftpPut transfer normal text or image files.

cerent15216EdfaFfsOpStatus

idle(1), pending(2), inProgress(3), aborted(4)

Read-only

The status of the operation.

cerent15216EdfaFfsOpStage

idle(1), flashDirOpen(2), flashDirClose(3), srcFileOpen(4), dstFileOpen(5), srcFileClose(6), dstFileClose(7), readData(8), writeData(9), rename(10), delete(11), findFile(12), compress(13), nextRecord(14)

Read-only

Indicates the current (or last) stage of the action performed on the flash file system.

cerent15216EdfaFfsOpCopyProgress

Integer

Read-only

This provides an indication of the progress of the copy operation. For normal files this shows bytes copied.

cerent15216EdfaFfsOpResult

Integer

Read-only

Indicates the result of the last operation. Success is indicated by a value of 0.

cerent15216EdfaFfsOpRequestId

Integer

Read-write

The request identifier for this operation. This is provided to allow managers to match actions and results.

cerent15216EdfaFfsOpSrcName

Display String
(0 to 127 characters)

Read-write

Source file name for the operation. Note that Flash File System names are limited to 20 bytes - the longer name supports long path names for TFTP operations from servers.

cerent15216EdfaFfsOpDstName

Display String
(0 to 127 characters)

Read-write

Destination file name for the operation. Note that Flash File System names are limited to 20 bytes - the longer name supports long path names for TFTP operations from servers.

cerent15216EdfaFfsOpTftpSrvAddr

IpAddress

Read-write

TFTP file server IP address.


5.4.9  LogEventControl

The cerent15216EdfaLogEventControl table controls the event log. Table 5-16 lists the table variables.

Table 5-16 cerent15216EdfaLogEventControl Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaLogEventClear

idle(1), perform(2), abort(3)

Read-write

Use this attribute to clear all logged events from the cerent15216EdfaLogEventTable.


5.4.10  LogEventEntry

The cerent15216EdfaLogEventEntry table contains the log information for each event. Table 5-17 lists the table variables.

Table 5-17 cerent15216EdfaLogEventEntry Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaLogEventIndex

Integer (1 to 2048)

Not Accessible

A unique value to identify this logged event.

cerent15216EdfaLogEventID

Autonomous Type

Read-only

he logged event this entry refers to.

cerent15216EdfaLogEventPriority

noAlarm(1), info(2), minor(3), major(4), critical(5)

Read-only

The priority of this logged event.

cerent15216EdfaLogEventType

active(1), cleared(2), trap(3)

Read-only

The type of logged event.

cerent15216EdfaLogEventSlot

Integer (-1 to 15)

Read-only

Index of the slot reporting the logged event. -1 implies no slot.

cerent15216EdfaLogEventPort

Integer (0 to 15)

Read-only

Index of the port reporting the logged event. 0 implies no port.

cerent15216EdfaLogEventTime

TimeStamp

Read-only

The value of sysUpTime when the logged event happened.

cerent15216EdfaLogEventDateAndTime

Cerent15216EdfaDateAndTimeString

Read-only

The local date and time when the logged event happened. If the node does not support a run-time clock the string is blank.

cerent15216EdfaLogEventFormsDateAndTime

Cerent15216EdfaDateAndTimeFormsString

Read-only

The local date and time when the logged event happened. If the node does not support a run-time clock the string is blank.


5.4.11  OpGroup

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-18 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-18 cerent15216EdfaOpGroup Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaOpStatus

idle(1), pending(2), inProgress(3), aborted(4)

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.

For DB backup and restore the following results are possible:

0: Success.

1: Restore or backup operation cannot obtain the db semaphore. This error should never occur because the cerent15216EdfaOpGroup MIB implementation does not allow more than one operation to be in progress at a time.

2: This will occur if there is a problem with opening cerent15216EdfaOpDbFileName. This could be because the file system is full, the file does not exist in the case of a restore, or the file already exists on the file system in the case of a backup.

3: This occurs if the backup procedure cannot obtain a configuration value.

4: This occurs during a restore if the CRC in file specified by cerent15216EdfaOpDbFileName is not correct. For example, a corrupted backup file.

5: This occurs during a restore if there is a parsing error. This could occur if the backup file was created by a version of software that is not compatible with the current software version.

-1: Unknown internal failure.

cerent15216EdfaOpRequestId

Integer

Read-write

The request identifier for this operation. This is provided to allow managers to match results with actions.

cerent15216EdfaOpSaveConfig

idle(1), perform(2), abort(3)

Read-write

To save the configuration of the management and optical modules, write "perform" to this object.

cerent15216EdfaOpCutover

idle(1), perform(2), abort(3)

Read-write

When "perform" is written to this object, a cutover occurs where the cerent15216EdfaAlternateVersion software image will be loaded after a Management Module reset.

The cutover operation is achieved automatically by swapping cerent15216EdfaBootEntry 1 & 2, then performing a Management Module reset. That is, the pre-reset cerent15216EdfaAlternateVersion becomes the post-reset cerent15216EdfaCurrentVersion and vice-versa.

cerent15216EdfaOpLoad

idle(1), perform(2), abort(3)

Read-write

When "perform" is written to this object, a new software image is downloaded via TFTP. Before setting this attribute, the source of the new software image should be specified by setting cerent15216EdfaOpSrcFileName and cerent15216EdfaOpTftpSrvAddr.

cerent15216EdfaOpSrcFileName

Display String (0 to 127 characters)

Read-write

Source file name for the Load operation. This must include the path of the file relative to the TFTP server's root directory, e.g. images/image1.

cerent15216EdfaOpTftpSrvAddr

IpAddress

Read-write

TFTP file server address for the Load operation.

cerent15216EdfaOpReset

idle(1), perform(2), abort(3)

Read-write

When "perform" is written to this object, a software reset is performed. The reset is delayed by approximately 10 seconds to allow SNMP response to be sent to the manager before the reset is performed.

cerent15216EdfaOpDbFileName

Display String (0 to 20 characters)

Read-write

Database file name for the Db Backup and Db Restore operations.

cerent15216EdfaOpDbBackup

idle(1), perform(2), abort(3)

Read-write

When "perform" is written to this object, the amplifier identification data and configuration are written to the specified Db backup file.

Before setting this attribute, the Db backup file name must specified by setting cerent15216EdfaDbFileName.

cerent15216EdfaOpDbRestore

idle(1), perform(2), abort(3)

Read-write

When "perform" is written to this object, the amplifier select configuration is restored from the specified DB backup file.

Before setting this attribute, the Db backup file name must specified by setting cerent15216EdfaDbFileName


5.4.12  OverallControl

The cerent15216EdfaOverallControl table allows the user to display and configure overall gain and pre-attenuation. Table 5-19 describes cerent15216EdfaOverallControl variables.

Table 5-19 cerent15216EdfaOverallControl Variable Descriptions

Variable
Syntax
Maximum Access
Description

cerent15216EdfaConstGainOverallGain

Integer
(130 to 220)

Read-write

The target overall gain that is used when the control mode in the PumpCfgEntry table is set to constGainTempComp, in units of 0.1 dB. For example, a value of 130 is actually 13.0 dB.

This variable is irrelevant in constOutputPower, constCurrent, and constPower modes.

cerent15216EdfaVariableGainPreAttenuation

Integer
(10 to 100)

Read-write

The target pre-attenuation that is used when the control mode in the PumpCfgEntry table is set to constOutputPower, constCurrent, or constPower, in units of 0.1 dB. For example a value of 10 is actually 1.0 dB.

This variable is irrelevant in constGainTempComp mode.


5.4.13  OverallStatusGroup

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

Table 5-20 cerent15216EdfaOverallStatusGroup Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaInPoweruW

Integer
(0 to 99999)

Read-only

EDFA input power in units of 0.1 microW. For example, a value of 1353 is actually 135.3 microW.

cerent15216EdfaInPowerdBm

Integer
(-999999 to 999999)

Read-only

EDFA input power in units of 0.01 dBm. For example, a value of -869 is actually -8.69 dBm.

cerent15216EdfaOutPowermW

Integer
(0 to 999999)

Read-only

EDFA output power in units of 0.01 mW. For example, a value of 2148 is actually 21.48 mW.

cerent15216EdfaOutPowerdBm

Integer
(-99999 to 99999)

Read-only

EDFA output power in units of 0.01 dBm. For example, a value of 1832 is actually 18.32 dBm.

cerent15216EdfaConstGainOverallGainMeasured

Integer
(0 to 230)

Read-only

The measured overall gain that is used when the control mode in the PumpCfg table is set to constGainTempComp, in units of 0.1 dB. For example, a value of 219 is actually 21.9 dB.

cerent15216EdfaVariableGainPreAttenuationMeasured

Integer
(0 to 110)

Read-only

The measured pre-attenuation that is used when the control mode in the PumpCfg table is not set to constGainTempComp, in units of 0.1 dB. For example, a value of 10 is actually 1.0 dB.



Note The values in mW and microW units are measured values. The dBm units are converted from mW or microW to dBm, so theses values could be slightly different. If you take the cerent15216EdfaInPoweruW, convert it to dBm (10log(cerent15216EdfaInPoweruW)) and compare the value to the attribute cerent15216EdfaInPowerdBm, you will see a small difference. The difference is because of rounding error. The value cerent15216EdfaInPoweruW that is displayed on the screen has been rounded, but the value used in the calculation has more significant digits.


5.4.14  PumpCfgEntry

The cerent15216EdfaPumpCfgEntry table is used to set or get laser pump control mode configuration. The associated table command displays a settings summary or allows you to set pumps. See Table 5-21 for variable definitions. The factory default pump control mode for the ONS 15216 EDFA2 is Constant Gain Temperature Compensated. Cisco recommends that users contact the Cisco TAC prior to changing this mode of operation.

Table 5-21 cerent15216EdfaPumpCfgEntry Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaPumpCfgPumpNum

Integer (1 or 2)

Not Accessible

Laser pump number (1 or 2).

cerent15216EdfaPumpCfgControlMode

constGainTempComp(2), constOutputPower(3), constCurrent(4), constPower(5), idle(6)

Read-write

Laser pump control mode. When the mode is set directly to constCurrent, constPower, or constOutputPower, the respective current value of ConstPumpCurrent, ConstPumpPower, or ConstOutPower is used as the constant parameter for the new mode.

Note: Pump 1 cannot be set to constOutputPower mode.

cerent15216EdfaPumpCfgConstPumpCurrent

Integer
(0 to 300)

Read-write

Constant pump current (mA).

The current that is used when the pump control mode is changed to constCurrent.

cerent15216EdfaPumpCfgConstPumpPower

Integer
(0 to 100)

Read-write

Constant pump power (mW). The power that is used when the control mode is changed to constPumpPower.

cerent15216EdfaPumpCfgConstOutPower

Integer
(0 to 650)

Read-write

Constant output power. The power that is used when the control mode is changed to constOutputPower. In units of 0.1 mW. For example, a value of 551 is actually 55.1 mW.


5.4.14.1  Changing the Pump Control Mode

For Constant Gain Temperature Compensated, Constant Pump Current, Constant Pump Power, or idle modes, the system automatically sets the second pump to the same mode when either pump is set.

Constant Output Power mode is only valid for pump 2. If pump 2 is set to Constant Output Power Mode, pump 1 is automatically set to Constant Pump Power mode with an internally calculated value.


Warning The pump control modes Constant Pump Current, Constant Pump Power, and Constant Output Power are to be used with very high precautions. They are service affecting and can reduce the life cycle of the lasers if used in extreme conditions. The factory default setting and recommended mode of operation is Constant Gain Temperature Compensated mode. Cisco recommends that users contact the Cisco TAC before changing from this mode of operation.


To set the ONS 15216 EDFA2 to Constant Pump Current mode, use the following steps:


Step 1 Set the pump value using cerent15216EdfaPumpCfgConstPumpCurrent attribute.

a. Select pump 1.

b. Set the value.

Step 2 Repeat Step 1 for pump 2.

Step 3 Set the pump mode of operation using cerent15216EdfaPumpCfgControlMode attribute.

a. Select pump 1 or 2.

b. Set the mode.

Example 5-6 shows how to set the ONS 15216 EDFA2 to Constant Pump Current mode and then set it back to Constant Gain Temperature Compensated mode. (Setting pump 1 or 2 to Constant Gain Temperature Compensated mode sets both pumps to that mode.)

Example 5-6 Setting Mode to Constant Pump Current and then Back to Constant Gain Temperature Compensated

ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgConstPumpCurrent 1 200
ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgConstPumpCurrent 2 200
ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgControlMode 1
constGainTempComp
constOutputPower
constCurrent
constPower
idle
ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgControlMode 1 constCurrent
ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgControlMode 1 constGainTempComp


5.4.14.2  Changing the Pump Control Value

To change the control value for Constant Gain Temperature Compensated mode, the user must set a new value of cerent15216EdfaConstGainOverallGain.

Constant Output Power mode is only valid for pump 2. To change the control value for pump 2, the user must set the new value of cerent15216EdfaPumpCfgConstOutPower for pump 2. When Constant Output Power mode is set for pump 2, pump 1 is automatically set to Constant Pump Power mode with a value that is internally calculated.

To change the control value for Constant Pump Current mode, the user must set new values of cerent15216EdfaPumpCfgConstPumpCurrent for both pumps.

To change the control value for Constant Pump Power mode, the user must set new values of cerent15216EdfaPumpCfgConstPumpPower for both pumps.

For example, to change the value for Constant Pump Current mode, use the following steps:


Step 1 Set the pump value using cerent15216EdfaPumpCfgConstPumpCurrent attribute.

a. Select pump 1.

b. Set the value.

Step 2 Repeat Step 1 for pump 2.

Step 3 If desired, set the pump mode of operation using cerent15216EdfaPumpCfgControlMode attribute.

a. Select pump 1 or 2.

b. Set the mode.

Example 5-7 shows how to set the value for Constant Pump Current mode to be 200 mA and then set the mode to Constant Pump Current mode again for the settings to take effect.

Example 5-7 Changing Value for Constant Pump Current Mode

ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgConstPumpCurrent 1 200
ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgConstPumpCurrent 2 200
ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPumpCfgControlMode 1 constCurrent


5.4.15  PumpStatusEntry

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

Table 5-22 cerent15216EdfaPumpStatusEntry Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaPumpStatusPumpNum

Integer (1 or 2)

Not Accessible

Laser pump number

cerent15216EdfaPumpStatusLaserChipTemp

Integer
(-9999 to 9999)

Read-only

Laser chip temperature in units of 0.1°C. For example, a value of 260 is actually 26.0°C.

cerent15216EdfaPumpStatusLaserChipTempSetpoint

Integer
(0 to 999)

Read-only

Laser chip temperature setpoint in units of 0.1°C. For example, a value of 260 is actually 26.0°C.

cerent15216EdfaPumpStatusLaserTECCurrent

Integer
(0 to 99999)

Read-only

Laser TEC current (mA).

cerent15216EdfaPumpStatusLaserPower

Integer
(0 to 99999)

Read-only

Laser power in units of 0.01 mW. For example, a value of 3230 is actually 32.30 mW.

cerent15216EdfaPumpStatusLaserCurrent

Integer
(0 to 999999)

Read-only

Laser current in units of 0.01 mA. For example, a value of 4024 is actually 40.24 mA.

cerent15216EdfaPumpStatusAmbientTemp

Integer
(-9999 to 9999)

Read-only

Ambient temperature in units of 0.01°C. For example, a value of 2454 is actually 24.54°C.

cerent15216EdfaPumpStatusDCVoltage

Integer
(0 to 9999)

Read-only

Pump DC voltage in units of 0.1V. For example, a value of 52 is actually 5.2V.

cerent15216EdfaPumpStatusInPoweruW

Integer
(0 to 99999)

Read-only

Optical input power to the pump, in units of 0.1 microW. For example, a value of 1764 is actually 176.4 microW.

cerent15216EdfaPumpStatusInPowerdBm

Integer
(-999999 to 999999)

Read-only

Optical input power to the pump, in units of 0.01 dBm. For example, a value of -753 is actually -7.53 dBm.

cerent15216EdfaPumpStatusOutPowermW

Integer
(0 to 999999)

Read-only

Optical output power of the pump, in units of 0.01 mW. For example, a value of 3497 is actually 34.97 mW.

cerent15216EdfaPumpStatusOutPowerdBm

Integer
(-99999 to 99999)

Read-only

Optical output power of the pump, in units of 0.01 dBm. For example, a value of 1542 is actually 15.42 dBm.

cerent15216EdfaPumpStatusGain1

Integer
(-9999 to 9999)

Read-only

The gain across the pump, in units of 0.1 dBm. For example, a value of 229 is actually 22.9 dBm.

cerent15216EdfaPumpStatusControlMode

constGainTempComp(2), constOutputPower(3), constCurrent(4), constPower(5), idle(6)

Read-only

Laser pump control mode.

cerent15216EdfaPumpStatusControlValue

Integer
(0 to 3000)

Read-only

Laser pump control value. The units depend on control mode:

constGainTempComp: 0.1 dB

ConstOutPower: 0.1 mW

constCurrent: 0.1 mA

constPower: 0.1 mW

For example, if the pump control mode is constGainTempComp, then a value of 229 is actually 22.9 dB.

1 In Constant Gain Temperature Compensated mode, 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. The cerent15216EdfaPumpStatusGain is the value of the gain of the amplification module only, it does not take into account the VOA (variable optical attenuator) attenuation. If you try to calculate the gain using the values of the PumpStatusOutPowerdBm - PumpStatusInPowerdBm you will not get the exact PumpStatusGain value. A more complex calculation is required to get the gain value. It needs to take ASE (amplified spontaneous emission) into account. This variable will be more dominant when the input power to the amplifier is low.


5.4.16  RtcDateAndTime

The cerent15216EdfaRtcDateAndTime table allows the user to set the date and time. When setting the local time of day, set the time zone first, set the DST offset second, and set the local time last. Entries must follow this format: "yyyy-m-d,h:m:s.s +h:m". Following the space, the time zone is set as +/- hours from Greenwich Mean Time (GMT) (also designated as universal coordinated time (UTC)) followed by a colon and minutes ahead for daylight savings. For example, Pacific Daylight Time would be -8:60 and Greenwich Mean Time would be +0:0.

Table 5-23 describes the variables.

Table 5-23 cerent15216EdfaRtcDateAndTime Variable Descriptions

Variable
Syntax
Maximum Access
Description

cerent15216EdfaRtcDateAndTimeLocal

DateAndTime

Read-write

The current local time. Setting this value changes the time according to the cerent15216EdfaRtcDateAndTimeTimezone and cerent15216EdfaRtcDateAndTimeSaving values.

In the format `07d3051e0c111a002d0800'H.

cerent15216EdfaRtcDateAndTimeGMT

DateAndTime

Read-only

The current GMT time in the format `07d3051e0c111a002d0800'H.

cerent15216EdfaRtcDateAndTimeLocalString

Cerent15216EdfaDateAndTimeString

Read-write

The current local time in the format "2003-5-30,12:17:26.0 -8.0".

cerent15216EdfaRtcDateAndTimeGMTString

Cerent15216EdfaDateAndTimeString

Read-only

The current GMT time in the format "2003-5-30,20:17:26.0 +0.0".

cerent15216EdfaRtcDateAndTimeTimezone

Integer
(-23 to 23)

Read-write

The time zone in hours from GMT, in the format "-8".

cerent15216EdfaRtcDateAndTimeSaving

Integer
(-60 to 60)

Read-write

The current daylight saving offset in minutes, in the format "0".

cerent15216EdfaRtcDateAndTimeFormsString

Cerent15216EdfaDateAndTimeFormsString

Read-write

The current local time, in the format "05/30/2003 12:17:26".


5.4.17  SromIpMgmtGroup

The cerent15216EdfaSromIpMgmtgroup table provides the IP setup information. Table 5-24 describes the variables.

Table 5-24 cerent15216EdfaSromIpMgmtGroup Variable Descriptions 

Variable
Syntax
Maximum Access
Description

cerent15216EdfaSromIpMgmtEnetAddress

IpAddress

Read-write

The IP address used by the system's Ethernet management port. If set to 0.0.0.0, then no IP
traffic is supported over the Ethernet interface.

cerent15216EdfaSromIpMgmtEnetSubNetMask

IpAddress

Read-write

The IP subnetwork mask for the
Ethernet management port.

cerent15216EdfaSromIpMgmtDefault
RouterAddress

IpAddress

Read-write

The IP address of the default router used by the system. The router's address must be on the Ethernet IP subnetwork.

cerent15216EdfaSromIpMgmtHostName

Display String (0 to 15 characters)

Read-write

The system's host name.

cerent15216EdfaSromIpMgmtMacAddress

MacAddress

Read-only

The system's MAC address.


5.4.18  VersionGroup

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

Table 5-25 cerent15216EdfaVersionGroup Variable Descriptions

Variable
Syntax
Maximum Access
Description

cerent15216EdfaCurrentVersion

Display String
(0 to 255 characters)

Read-only

The version of the currently loaded image.

cerent15216EdfaAlternateVersion

Display String
(0 to 255 characters)

Read-only

The version of the image to be loaded after a cutover is performed.

cerent15216EdfaHardwareVersion

Display String
(0 to 255 characters)

Read-only

The hardware version of the unit.

cerent15216EdfaHardwarePartNumber

Display String
(0 to 255 characters)

Read-only

The hardware part number of the unit.


5.5  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. See Table 5-28 and Table 5-29 for the alarms and events that initiate traps.

5.5.1  Display Trap Command

Command Types

snmp table display local cerent15216EdfaCommTrapEntry

Syntax Description

snmp table display local cerent15216EdfaCommTrapEntry #

Displays the communities for traps.

Example 5-8 cerent15216EdfaCommTrapEntry Display Command

ash:hostname:ONS15216 EDFA2> snmp table display local cerent15216EdfaCommTrapEntry 1

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCommTrapEntry ::=
{
cerent15216EdfaCommTrapIndex = 1;
cerent15216EdfaCommTrapCommunity = "private";
cerent15216EdfaCommTrapDestIPAddress = 172.22.87.50;
cerent15216EdfaCommTrapDestUDPPort = 162;
cerent15216EdfaCommTrapViewIndex = 1;
cerent15216EdfaCommTrapVersion = v2;
cerent15216EdfaCommTrapStatus = active;
};

5.5.2  Set Trap Command

Command Types

snmp row set local cerent15216EdfaCommTrapEntry

Syntax Description

snmp row set local cerent15216EdfaCommTrapEntry #

The command followed by a community number permits the user to set the parameters for the SNMP trap. Example 5-9 displays the prompts that appear after entering the 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-9 cerent15216EdfaCommTrapEntry Set Command

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaCommTrapEntry 1

cerent15216EdfaCommTrapCommunity "private"
cerent15216EdfaCommTrapDestIPAddress 172.22.87.50
cerent15216EdfaCommTrapDestUDPPort 162
cerent15216EdfaCommTrapViewIndex 1
cerent15216EdfaCommTrapVersion v2
cerent15216EdfaCommTrapStatus 4

5.5.3  Set Agent Trap Enable

Command Types

snmp attribute set local cerent15216EdfaAgentTrapEnable

Syntax Description

snmp attribute set local cerent15216EdfaAgentTrapEnable control

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

5.5.4  Get Agent Trap Enable

Command Types

snmp attribute get local cerent15216EdfaAgentTrapEnable

Syntax Description

snmp attribute get local cerent15216EdfaAgentTrapEnable

Gets the SNMP enable trap status. The system responds with either "enabled" or "disabled".

5.6  Retrieving Information

The following SNMP commands access ONS 15216 EDFA2 information.

5.6.1  IP Address

Command Types

snmp table display local cerent15216EdfaSromIpMgmtGroup

Syntax Description

snmp table display local cerent15216EdfaSromIpMgmtGroup

Displays the ONS 15216 EDFA2 IP address.

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

snmp row display local cerent15216EdfaSromIpMgmtGroup command ( Example 5-10)

Example 5-10 cerent15216EdfaSromIpMgmtGroup Display Command

ash: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-26 describes the other attributes displayed by these commands.

Table 5-26 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.

cerent15216EdfaSromIpMgmtDefaultRouterAddress

The default router (gateway) address for the network.

cerent15216EdfaSromIpMgmtEnetSubNetMask

The IP subnet mask for the Ethernet management port.

cerent15216EdfaSromIpMgmtHostName

The host name of the system.


5.6.2  Date and Time

Command Types

snmp attribute get local cerent15216EdfaRtcDateAndTime

Syntax Description

snmp attribute get local cerent15216EdfaRtcDateAndTime

Displays the date and time for the ONS 15216 EDFA2.

The following SNMP command displays the date and time for the ONS 15216 EDFA2 and other time data:

snmp row display local cerent15216EdfaRtcDateAndTime command

The following SNMP command sets the date and time for the ONS 15216 EDFA2 and other time data:

snmp attribute set local cerent15216EdfaRtcDateAndTimeLocalString command

When setting the local time of day, set the time zone first, set the DST offset second, and set the local time last. Entries must follow this format: "yyyy-m-d,h:m:s.s +h:m". Following the space, the time zone is set as +/- hours from Greenwich Mean Time (GMT) (also designated as universal coordinated time (UTC)) followed by a colon and minutes ahead for daylight savings. For example, Pacific Daylight Time would be -8:60 and Greenwich Mean Time would be +0:0.

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

Example 5-11 cerent15216EdfaRtcDateAndTime Display Command

ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaRtcDateAndTime

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaRtcDateAndTime ::=
{
cerent15216EdfaRtcDateAndTimeLocal = '07d20716070a2a042d083c'H;
cerent15216EdfaRtcDateAndTimeGMT = '07d207160e0a2a042b0000'H;
cerent15216EdfaRtcDateAndTimeLocalString = "2002-7-22,7:10:42.4 -8:60";
cerent15216EdfaRtcDateAndTimeGMTString = "2002-7-22,14:10:42.4 +0:0";
cerent15216EdfaRtcDateAndTimeTimezone = -8;
cerent15216EdfaRtcDateAndTimeSaving = 60;
cerent15216EdfaRtcDateAndTimeFormsString = "07/22/2002 07:10:42";
};

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

Table 5-27 cerent15216EdfaRtcDateAndTime Command Attributes

Attribute
Description

cerent15216EdfaRtcDateAndTimeLocal

The current local time.

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.


5.6.3  Power Gain

Command Types

snmp attribute get local cerentEdfa15216EdfaConstGainOverallGain

Syntax Description

snmp attribute get local cerentEdfa15216EdfaConstGainOverallGain #

Displays the overall power gain when the ONS 15216 EDFA2 is in Constant Gain Temperature Compensated mode.

The following commands access overall power gain when in the Constant Gain Temperature Compensated 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-12).

Example 5-12 cerent15216EdfaOverallControl Display Command

ash:hostname:ONS15216 EDFA2>snmp row display local cerent15216EdfaOverallControl

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaOverallControl ::=
{
cerent15216EdfaConstGainOverallGain = 220;
cerent15216EdfaVariableGainPreAttenuation = 10;
};

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

5.6.4  Case Temperature

5.6.4.1  Case Temperature Value

Command Types

snmp attribute get local cerent15216EdfaPumpStatusAmbientTemp

Syntax Description

snmp attribute get local cerent15216EdfaPumpStatusAmbientTemp pump#

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

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

snmp row display local cerent15216EdfaPumpStatusAmbientTemp pump# command

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

Example 5-13 cerent15216EdfaPumpStatusEntry Display Command

ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaPumpStatusEntry 1

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaPumpStatusEntry ::=
{
cerent15216EdfaPumpStatusPumpNum = 1;
cerent15216EdfaPumpStatusLaserChipTemp = 260;
cerent15216EdfaPumpStatusLaserChipTempSetpoint = 260;
cerent15216EdfaPumpStatusLaserTECCurrent = 20;
cerent15216EdfaPumpStatusLaserPower = 8503;
cerent15216EdfaPumpStatusLaserCurrent = 17010;
cerent15216EdfaPumpStatusAmbientTemp = 2272;
cerent15216EdfaPumpStatusDCVoltage = 52;
cerent15216EdfaPumpStatusInPoweruW = 250;
cerent15216EdfaPumpStatusInPowerdBm = -600;
cerent15216EdfaPumpStatusOutPowermW = 5000;
cerent15216EdfaPumpStatusOutPowerdBm = 1700;
cerent15216EdfaPumpStatusGain = 220;
    cerent15216EdfaPumpStatusControlMode= constGainTempComp;
cerent15216EdfaPumpStatusControlValue = 220;
};

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

5.6.4.2  Case Temperature Alarm Threshold

5.6.4.2.1  CtmpMin

Command Types

snmp attribute get local cerent15216EdfaCtmpMin

Syntax Description

snmp attribute get local cerent15216EdfaCtmpMin

This command displays minimum case temperature alarm threshold.

5.6.4.2.2  CtmpMax

snmp attribute get local cerent15216EdfaCtmpMax

Syntax Description

snmp attribute get local cerent15216EdfaCtmpMax

This command displays maximum case temperature alarm threshold.

The following command displays case temperature alarm threshold and other temperature data:

snmp row display local cerent15216EdfaCfgGroup command

This command is shown in Example 5-14.

Example 5-14 cerent15216EdfaCfgGroup Display Command

ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaCfgGroup

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCfgGroup ::=
{
cerent15216EdfaCfgSaved = true;
cerent15216EdfaLpoutSetpoint = 0;
cerent15216EdfaLpoutDeviation = 200;
cerent15216EdfaLpoutHysteresis = 100;
cerent15216EdfaLOSThreshold = -3102;
cerent15216EdfaLOSHysteresis = 100;
cerent15216EdfaCtmpMin = -5;
cerent15216EdfaCtmpMinHysteresis = 1;
cerent15216EdfaCtmpMax = 65;
cerent15216EdfaCtmpMaxHysteresis = 1;
cerent15216EdfaCLEI = "WMM4180BRA";
cerent15216EdfaPowerBusMode = duplex;
cerent15216EdfaPowerBusDCVoltageMin = 420;
cerent15216EdfaPowerBusDCVoltageMax = 700;
};

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

5.6.4.3  Case Temperature Alarm Hysteresis

5.6.4.3.1  CtmpMaxHysteresis

Command Types

snmp attribute get local cerent15216EdfaCtmpMaxHysteresis

Syntax Description

snmp attribute get local cerent15216EdfaCtmpMaxHysteresis

Displays maximum case temperature alarm hysteresis.

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

5.6.4.3.2  CtmpMinHysteresis

Command Types

snmp attribute get local cerent15216EdfaCtmpMinHysteresis

Syntax Description

snmp attribute get local cerent15216EdfaCtmpMinHysteresis

Displays the minimum case hysteresis temperature alarm threshold.

The following command displays case temperature alarm hysteresis and other data:

snmp row display local cerent15216EdfaCfgGroup command

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

5.6.5  Power Bus

5.6.5.1  Power Bus Mode

Command Types

snmp attribute get local cerent15216EdfaPowerBusMode

Syntax Description

snmp attribute get local cerent15216EdfaPowerBusMode

Displays the power bus mode (simplex or duplex).

The following command displays power bus voltage and other data:

snmp row display local cerent15216EdfaCfgGroup command

5.6.5.2  Power Bus Alarm Threshold

5.6.5.2.1  PowerBusDCVoltageMax

Command Types

snmp attribute get local cerent15216EdfaPowerBusDCVoltageMax

Syntax Description

snmp attribute get local cerent15216EdfaPowerBusDCVoltageMax

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

The following command displays power bus voltage and other data:

snmp row display local cerent15216EdfaCfgGroup command

5.6.5.2.2  PowerBusDCVoltageMin

Command Types

snmp attribute get local cerent15216EdfaPowerBusDCVoltageMin

Syntax Description

snmp attribute get local cerent15216EdfaPowerBusDCVoltageMin

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

The following command displays power bus voltage and other data:

snmp row display local cerent15216EdfaCfgGroup command

5.6.6  Input Power (Signal)

5.6.6.1  Input Power (Signal) Value

5.6.6.1.1  InPoweruW

Command Types

snmp attribute get local cerent15216EdfaInPoweruW

Syntax Description

snmp attribute get local cerent15216EdfaInPoweruW

Displays input power value in microwatts.

The following command displays the ONS 15216 EDFA2 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-20.

5.6.6.1.2  InPowerdBm

Command Types

snmp attribute get local cerent15216EdfaInPowerdBm

Syntax Description

snmp attribute get local cerent15216EdfaInPowerdBm

Displays the input power value in dBm. The dBm units are converted from µW to dBm, so theses values could be slightly different due to rounding error.

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

snmp row display local cerent15216EdfaOverallStatusGroup command

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

5.6.6.2  Loss of Signal (Input Power) Alarm Threshold

Command Types

snmp attribute get local cerent15216EdfaLOSThreshold

Syntax Description

snmp attribute get local cerent15216EdfaLOSThreshold

Displays the loss of signal (input power) alarm threshold.

The following command displays 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-14).

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

5.6.6.3  Loss of Signal (Input Power) Alarm Hysteresis

Command Types

snmp attribute get local cerent15216EdfaLOSHysteresis

Syntax Description

snmp attribute get local cerent15216EdfaLOSHysteresis

Displays the loss of signal (input power) alarm hysteresis value.

The following command displays 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-14). For information about all of the parameters in the cerent15216EdfaCfgGroup table, refer to Table 5-13.

5.6.7  Output Power

5.6.7.1  Output Power Value

5.6.7.1.1  OutPowermW

Command Types

snmp attribute get local cerent15216EdfaOutPowermW

Syntax Description

snmp attribute get local cerent15216EdfaOutPowermW

Displays output power value in milliwatts.

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

5.6.7.1.2  OutPowerdBm

Command Types

snmp attribute get local cerent15216EdfaOutPowerdBm

Syntax Description

snmp attribute get local cerent15216EdfaOutPowerdBm

Displays output power value in dBm. This command displays loss of output power value and additional pump status data. The dBm units are converted from mW to dBm, so theses values could be slightly different due to rounding error.

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

5.6.7.2  Loss of Output Power Alarm Setpoint

5.6.7.2.1  LpoutSetpoint

Command Types

snmp attribute get local cerent15216EdfaLpoutSetpoint

Syntax Description

snmp attribute get local cerent15216EdfaLpoutSetpoint

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 the Cisco TAC to determine threshold value for your application. As a guideline, Cisco recommends that loss of output power alarm threshold value be set at 1 dB below the current output power level of the amplifier.

When the ONS 15216 EDFA2 is set to Constant Gain Temperature Compensated mode (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-14). This command returns the current alarm threshold default values.

5.6.7.2.2  LpoutDeviation

Command Types

snmp attribute get local cerent15216EdfaLpoutDeviation

Syntax Description

snmp attribute get local cerent15216EdfaLpoutDeviation

This attribute is not required when operating in factory default Constant Gain Temperature Compensated mode. Setting of the loss of output power alarm deviation is only necessary when the amplifier is used in Constant Output Power mode.

This attribute is used to set the amount by which the output power must vary from the threshold set point 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 the Cisco TAC 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 dB. The module triggers an alarm if it detects a signal level of 2 dB below the current output power alarm level threshold value set for the amplifier.

When the ONS 15216 EDFA2 is set to Constant Gain Temperature Compensated mode (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-14. 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 mode, type snmp attribute set local cerent15216EdfaLpoutDeviation at the command prompt followed by a number (as shown in Example 5-15). Valid entries are between 0 and 1000 and are in dB times 100. For example, if the loss of output power deviation required were 0.2 dB, 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-15 cerent15216EdfaLpoutDeviation Set Command

ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaLpoutDeviation 200

ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaCfgGroup

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaCfgGroup ::=
{
cerent15216EdfaCfgSaved = false;
cerent15216EdfaLpoutSetpoint = 0;
cerent15216EdfaLpoutDeviation = 200;
cerent15216EdfaLpoutHysteresis = 100;
cerent15216EdfaLOSThreshold = -2694;
cerent15216EdfaLOSHysteresis = 100;
cerent15216EdfaCtmpMin = -5;
cerent15216EdfaCtmpMinHysteresis = 1;
cerent15216EdfaCtmpMax = 65;
cerent15216EdfaCtmpMaxHysteresis = 1;
cerent15216EdfaCLEI = "WMAW27VLAA";
cerent15216EdfaPowerBusMode = duplex;
cerent15216EdfaPowerBusDCVoltageMin = 420;
cerent15216EdfaPowerBusDCVoltageMax = 700;
};

Changes must be saved before terminating the session. See the "Save Changes" section.

5.6.7.3  Loss of Output Power Alarm Hysteresis

Command Types

snmp attribute get local cerent15216EdfaLpoutHysteresis

Syntax Description

snmp attribute get local cerent15216EdfaLpoutHysteresis

This attribute is not required when operating in factory default Constant Gain Temperature Compensated 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 the Cisco TAC 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 dB. The module clears the alarm if it detects a signal level of 0.2 dB above the current output power alarm level threshold value set for the amplifier.

When ONS 15216 EDFA2 is set to Constant Gain Temperature Compensated mode (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-14. This command returns the current alarm threshold default values.

To set the loss of output power alarm hysteresis when ONS 15216 EDFA2 is configured for operation in either Constant Output Power mode or Constant Pump Power 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 dB times 100. For example, if the loss of output power hysteresis required were 0.2 dB, 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.

5.6.8  Database Backup and Restore

The configuration information for the ONS 15216 EDFA2 can be saved in a file for later use or to configure other ONS 15216 EDFA2 units. This file contains manufacturing information about the unit that is being backed up (such as part number and serial number), setup information for the unit (such as IP address and host name), all configuration information (such as alarm thresholds and pump mode), and the user database.

The backup file is saved with cyclic redundancy code (CRC) to ensure data integrity, and the user names, passwords, and other system settings are encrypted for security. Only the configuration information and user database are copied back to the ONS 15216 EDFA2 during a restore.

5.6.8.1  Database Backup Procedure


Step 1 Back up the system configuration to a file (in this case, dbbkup) on the FFS:

a. Set cerent15216EdfaOpDbFileName = "dbbkup".

b. Set cerent15216EdfaOpRequestId = 1.

c. Set cerent15216EdfaOpDbBackup = 2.

d. Wait until cerent15216EdfaOpStatus goes from inprogress to idle.

e. Verify that cerent15216EdfaOpResult is 0.

Step 2 Verify that the backup file is on the FFS by getting the table cerent15216EdfaFfsFileEntry and checking for the file named "dbbkup".

Step 3 Copy the backup file to your TFTP server:

a. Set cerent15216EdfaFfsOpRequestId = 2.

b. Set cerent15216EdfaFfsOpSrcName = "dbbkup".

c. Set cerent15216EdfaFfsOpDstName = "dbbkup".

d. Set cerent15216EdfaFfsOpTftpSrvAddr = a.b.c.d (your TFTP server address).

e. Set cerent15216EdfaFfsOpOperation = 3 (put).

f. Set cerent15216EdfaFfsOpAction = 2 (perform).

Step 4 Wait for the TFTP put to complete and check that cerent15216EdfaFfsOpResult = 0 and that cerent15216EdfaFfsOpCopyProgress contains the number of bytes in the file "dbbkup".

Step 5 Copy file from your TFTP server to the FFS:

a. Set cerent15216EdfaFfsOpRequestId = 2.

b. Set cerent15216EdfaFfsOpSrcName = "dbbkup".

c. Set cerent15216EdfaFfsOpDstName = "dbbkup".

d. Set cerent15216EdfaFfsOpTftpSrvAddr = a.b.c.d (your TFTP server address).

e. Set cerent15216EdfaFfsOpOperation = 2 (get).

f. Set cerent15216EdfaFfsOpAction = 2 (perform).

Step 6 Verify that the file "dbbkup" is on the FFS by getting the table cerent15216EdfaFfsFileEntry.


5.6.8.2  Database Restore Procedure

The configuration information for the ONS 15216 EDFA2 can be restored form a file. During this process, all configuration information (such as alarm thresholds and pump mode) and the user database from the file are replaced in the ONS 15216 EDFA2 memory and FFS.

Before the restore begins, a cyclic redundancy code (CRC) check is performed to ensure data integrity.


Step 1 Restore from the backup database from a file (in this case, dbbkup) on the FFS:

a. Set cerent15216EdfaOpDbFileName = "dbbkup".

b. Set cerent15216EdfaOpRequestId = 1.

c. Set cerent15216EdfaOpDbRestore = 2.

d. Wait until cerent15216EdfaOpStatus goes from inprogress to idle.

e. Verify that cerent15216EdfaOpResult is 0.

Step 2 Save the changes by setting cerentEdfa15216OpSaveConfig = 2.

Step 3 Reboot the ONS 15216 EDFA2 by setting cerentEdfa15216OpReset = 2.

After the processor reboots, user names and passwords from the new user database must be used for access.


5.6.9  Alarm Entry

Command Types

snmp table display local cerent15216EdfaAlarmEntry

Syntax Description

snmp table display local cerent15216EdfaAlarmEntry

Accesses the alarm status. Example 5-16 shows the cerent15216EdfaAlarmEntry display command.

Example 5-16 cerent15216EdfaAlarmEntry Display Command

ash:hostname:ONS15216 EDFA2> snmp table display local cerent15216EdfaAlarmEntry

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaAlarmEntry ::=
{
cerent15216EdfaAlarmIndex = 1;
cerent15216EdfaAlarmID = lcrnt1;
cerent15216EdfaAlarmPriority = minor;
cerent15216EdfaAlarmState = cleared;
cerent15216EdfaAlarmEnable = enabled;
cerent15216EdfaAlarmDateAndTime = "2002-10-16,13:49:42.8 -8:60";
cerent15216EdfaAlarmCfgPriority = minor;
};

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaAlarmEntry ::=
{
cerent15216EdfaAlarmIndex = 2;
cerent15216EdfaAlarmID = lcrnt2;
cerent15216EdfaAlarmPriority = minor;
cerent15216EdfaAlarmState = cleared;
cerent15216EdfaAlarmEnable = enabled;
cerent15216EdfaAlarmDateAndTime = "2002-10-16,13:31:55.4 -8:60";
cerent15216EdfaAlarmCfgPriority = minor;
};

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaAlarmEntry ::=
{
cerent15216EdfaAlarmIndex = 3;
cerent15216EdfaAlarmID = ltmp1;
...

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

5.7  Summary of SNMP Alarms and Events

Alarm priorities can be configured (cerent15216EdfaAlarmCfgPriority), so the default values are provided in the tables below. Table 5-28 summarizes the ONS 15216 EDFA2 SNMP alarms.

Table 5-28 SNMP Alarms 

Alarm Index
Alarm ID
Description
Default Priority

1

lcrnt1

Excessive pump current for pump 1. Drive current greater than 95% of end of life value. Current must drop to 90% of end of life value for alarm to clear.

Minor

2

lcrnt2

Excessive pump current for pump 2. Drive current greater than 95% of end of life value. Current must drop to 90% of end of life value for alarm to clear.

Minor

3

ltmp1

Pump 1 laser temperature out of range. Chip temperature deviating more than 10 degrees C from the manufacturer-defined setpoint.

Minor

4

ltmp2

Pump 2 laser temp. out of range. Chip temperature deviating more than 10 degrees C from the manufacturer-defined setpoint.

Minor

5

lpout

Loss of output power. EDFA output power is deviating more than the value of cerent15216EdfaLpoutDeviation from the value of cerent15216EdfaLpoutSetpoint. This alarm is only valid for constOutputPower mode.

Major

6

lpin

Loss of input power (signal). EDFA input power is below the value of cerent15216EdfaLOSThreshold.

Major

7

gain

Gain out of range. Gain has deviated more than 1.25 dB from the setpoint in constGainTempComp mode. This alarm is also triggered if the input power goes outside the manufacturer-defined range by more than 0.15 dB.

Major

8

ctmp

The case temperature out of the threshold range.

Minor

9

powerBusA

The Power Bus A voltage is out of the threshold range. The power bus threshold has a 1.5V tolerance and a 1.0V hysteresis. There is a ±1.5V inaccuracy in the ONS 15216 EDFA2 voltage measurement.

Minor/Critical1

10

powerBusB

The Power Bus B voltage is out of the threshold range. The power bus threshold has a 1.5V tolerance and a 1.0V hysteresis. There is a ±1.5V inaccuracy in the ONS 15216 EDFA2 voltage measurement.

Minor/Critical1

11

dbBackup

A database backup is in progress.

Minor

12

dbRestore

A database restore is in progress.

Minor

13

swDownload

A TFTP software download is in progress.

Minor

1 If the power system is in simplex mode, a power bus alarm is Critical by default. If the power system is in duplex mode, a single power bus alarm is Minor by default, and if an alarm is raised on both power buses, the second alarm is Critical.


Table 5-29 summarizes the ONS 15216 EDFA2 SNMP event traps.

Table 5-29 SNMP Events 

Notification
Notification Trigger
Default Priority
Condition

cerent15216EdfaOpStarted

and

cerent15216EdfaOpFinished

cerent15216EdfaOpSaveConfig
cerent15216EdfaOpCutover
cerent15216EdfaOpLoad
cerent15216EdfaOpReset
cerent15216EdfaOpDbBackup
cerent15216EdfaOpDbRestore

NSA
NSA
NSA
NSA
NSA
NSA

Notification is generated when an operation from the affected attributes list starts and when it completes or terminates.

cerent15216EdfaFfsOpStarted

and

cerent15216EdfaFfsOpFinished

cerent15216EdfaFfsTftpPut
cerent15216EdfaFileTftpGet
cerent15216EdfaFfsCopy
cerent15216EdfaFfsRename
cerent15216EdfaFfsDelete
cerent15216EdfaFfsCompress

NSA
NSA
NSA
NSA
NSA
NSA

Notification is generated when an operation from the affected attributes list starts and when it completes or terminates.

cerent15216EdfaAlarmActivated

and

cerent15216EdfaAlarmCleared

lcrnt1
lcrnt2
ltmp1
ltmp2
lpout
lpin
gain
ctmp
powerBusA
powerBusB
dbBackup
dbRestore
swDownload

Minor
Minor
Minor
Minor
Major
Major
Major
Minor
Minor/Critical
Minor/Critical
Minor
Minor
Minor

Notification is generated when the fault condition is detected and when it is cleared.



hometocprevnextglossaryfeedbacksearchhelp

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