Cisco ONS 15216 EDFA2 Operations Guide
Corporate Headquarters
Cisco ONS 15216 EDFA2 Operations Guide
N T E N T S
Rack Installation and Power Supply Connection Procedures
Srom cfg ip modify Command
Snmp mib get Command Snmp mib list Command
Provisioning Using TL1
Introduction
Status Information Needed by Cisco TAC
Cisco ONS 15216 EDFA2 Temperature Requirement A-25
Eye Damage Warning
Xii
G U R E S
Xiv
Gain Range
TL1 Commands and Messages Security Permissions Access Levels
Table A-1
Xviii
Optical Networking Product Documentation CD-ROM
Obtaining Documentation
Cisco.com
Ordering Documentation
Obtaining Technical Assistance
Documentation Feedback
Technical Assistance Center
Cisco TAC Website
Cisco TAC Escalation Center
Obtaining Additional Publications and Information
Wavelength Protection Switching
Bandwidth On Demand
Key Features
Wavelength Protection Switching
Constant Gain
Gain Flattening
Snmp MIBs
Transient Suppression
Low Noise
6 TL1
There is no input power, the ONS 15216 EDFA2 has
Optical Specifications
Requirement Specification
DBm of output power. For additional safety
Maximum Input Power
Maximum Channel Power
Channel Loading
Electrical Specifications
ONS 15216 EDFA2 Electrical Specifications
4lists the ONS 15216 EDFA2 mechanical specifications
Mechanical Specifications
External Features
TR-NWT-000332, Issue 4, Method
ONS 15216 EDFA2 Dimensions
Front Panel
Information
Feature Description
ONS 15216 EDFA2 Front Panel Features
LAN
Introduction
Standard Precautions
Placement and Power Connection
General Rack Considerations
Rack Installation and Power Supply Connection Procedures
Safety Requirements
Optical Connection Procedure
SC/UPC Optical Ports
Optical Amplification Operation Verification Procedure
Gain Total Input Power dBm Total Output Power dBm
Gain Range
Communications
Alarm Out Relay Interface RJ-45
Alarm Relay Connection Procedure
Relay Pinout Description
Power Fail LOS
Alarm LEDs
Power LED Green
Fail LED Red
LOS LED Yellow
Serial Connection Procedure
Serial Interface EIA/TIA-232 Communication
Ethernet Socket LEDs
HyperTerminal Connect To Dialog Box
Click Settings -5 on page 3-10 and click Ascii Setup
Optical Amplifier Properties Dialog Box Settings Tab
Component
Serial Interface Remote Communication via Modem
Remote Communication Component Requirements
Communication Component List
Modem Configuration Settings
Modem Signals
Modem Power Up
Up U or Down D Description
Setting and Saving Modem Settings
Modem Setting Description
LAN Interface Ethernet
PC Connection via Modem
LAN Connection Procedure
N a L D R a F T C I S C O C O N F I D E N T I a L
Provisioning Using ASH and Snmp
Following sections describe these steps in detail
Example 4-2 ASH Shell Login Response
Then enter the following command at the hostname prompt
Example 4-1 ASH Shell Login Window
SidtidnameONS15216 EDFA2 ED-NE-GEN123CLI=ASH
Log In via LAN Port Using Telnet Optional
Set IP Address
Verify Amplifier Operational Status
Set Power Bus Mode Simplex or Duplex
Set Date and Time
You are now connected to the ONS 15216 EDFA2 via Telnet
Set Alarm Thresholds
Example 4-7 Setting the Gain
Set Gain
Example 4-8 Displaying the Alarm Thresholds
Class CERENT-15216-EDFA-MIB.cerent15216EdfaCfgGroup =
Alarm Threshold Attribute Definitions
N a L D R a F T C I S C O C O N F I D E N T I a L
N a L D R a F T C I S C O C O N F I D E N T I a L
Set Password
Example 4-9 Changing Current User’s Password
Example 4-10 Adding a New User
Add Users
Save Changes
Example 4-11 Saving Changes
System responds with progress information
Back Up System Configuration
Log Off
Example 4-12 Logging Off
Restore System Configuration
Reboot the ONS 15216 EDFA2
Save the changes
Recover Default Password
At the hostname prompt, enter the following command
Snmp Overview
Snmp Components
Snmp MIB
ONS 15216 EDFA2 Snmp Elements
Snmp Agent
Snmp manager Snmp elements are shown in Figure
Snmp MIBs and Message Types
Snmp MIB
Snmp Manager
Operation Description
Command Syntax Using the Snmp Agent
Example 5-1 snmp Command Followed by the Tab Key
Snmp Operation Types
Community String Default Privileges
Example 5-2 snmp table display Command
Default Community Strings
Set View Entry
Command
Creating a View
Snmp row set local cerent15216EdfaViewEntry
Set CommunityEntry
Data Prompt Command Description
Creating a Community Entry
Snmp row set local cerent15216EdfaCommunityEntry
4displays the definitions for the community entry values
Data Prompt Description
Creating a Community Entry
Snmp row display local cerent15216EdfaCommunityEntry
Example 5-5 cerent15216EdfaCommunityEntry Display Command
Display CommunityEntry
Snmp Operation Decimal Values
Setup for CTM Access
Tables and Groups
Maximum Variable Syntax Access Description
CfgGroup Table
Cerent15216EdfaCfgGroup Variable Descriptions
N a L D R a F T C I S C O C O N F I D E N T I a L
Changing the Pump Control Mode
PumpCfgEntry Table
Cerent15216EdfaPumpCfgEntry Variable Descriptions
Changing the Pump Control Value
200
Example 5-7 Changing Value for Constant Pump Current Mode
OverallStatusGroup Table
Cerent15216EdfaOverallStatusGroup Variable Descriptions
Cerent15216EdfaOverallControl Variable Descriptions
OverallControl Table
PumpStatusEntry Table
10 cerent15216EdfaPumpStatusEntry Variable Descriptions
AlarmEntry Table
11 cerent15216EdfaAlarmEntry Variable Descriptions
OpGroup Table
12 cerent15216EdfaOpGroup Variable Descriptions
Setting Up Traps
VersionGroup Table
13 cerent15216EdfaVersionGroup Variable Descriptions
Snmp table display local cerent15216EdfaCommTrapEntry
Display Trap Command
Notification MIB Items Description
Displays the communities for traps. See Example
Snmp attribute set local cerent15216EdfaAgentTrapEnable
Set Trap Command
Set Agent Trap Enable
Example 5-9 cerent15216EdfaCommTrapEntry Set Command
Retrieving Information
Get Agent Trap Enable
Snmp attribute get local cerent15216EdfaAgentTrapEnable
IP Address
Attribute Description
16describes the attributes displayed by these commands
Date and Time
Snmp attribute get local cerent15216EdfaRtcDateAndTime
Power Gain
16 cerent15216EdfaRtcDateAndTime Command Attributes
Example 5-12 cerent15216EdfaOverallControl Display Command
Case Temperature Alarm Threshold
Case Temperature
Case Temperature Value
Example 5-13 cerent15216EdfaPumpStatusEntry Display Command
Snmp attribute get local cerent15216EdfaCtmpMax
Case Temperature Alarm Hysteresis
Example 5-14 cerent15216EdfaCfgGroup Display Command
Snmp attribute get local cerent15216EdfaCtmpMaxHysteresis
Power Bus
Power Bus Mode
Power Bus Alarm Threshold
Snmp attribute get local cerent15216EdfaInPoweruW
Input Power Signal
Input Power Signal Value
Snmp attribute get local cerent15216EdfaInPowerdBm
Loss of Signal Input Power Alarm Hysteresis
Output Power
Loss of Signal Input Power Alarm Threshold
Output Power Value
Snmp attribute get local cerent15216EdfaOutPowerdBm
Loss of Output Power Alarm Setpoint
Displays output power value in milliwatts
Snmp attribute get local cerent15216EdfaLpoutSetpoint
Example 5-15 cerent15216EdfaLpoutDeviation Set Command
Snmp attribute get local cerent15216EdfaLpoutDeviation
Database Backup and Restore
Loss of Output Power Alarm Hysteresis
Snmp attribute get local cerent15216EdfaLpoutHysteresis
Database Backup Procedure
Database Restore Procedure
Alarm Entry
Snmp table display local cerent15216EdfaAlarmEntry
Example 5-16 cerent15216EdfaAlarmEntry Display Command
Alarm Index Alarm ID Description Priority
Summary of Snmp Alarms
17summarizes the ONS 15216 EDFA2 Snmp alarms
17 Snmp Alarms
N a L D R a F T C I S C O C O N F I D E N T I a L
ASH Commands Security Permissions Access Levels
User Access Levels
Command Description
Clear Clears the shell screen Yes
Login Allows the user to log into shell Yes
Gain gain modify Modifies gain setting Yes
Help Gives help about commands Yes
History Displays the history list Yes
Shell more enable Enables more Yes
Restore system Restores configuration from backup file Yes
Shell more disable Disables more Yes
Network host ftp FTPs to remote host Yes
Snmp mib list Lists a MIB Yes
Snmp attribute set Sets an attribute Yes
Snmp mib get Gets a MIB Yes
Snmp row get Gets a row Yes
User entry delete Deletes the user Yes
Srom cfg ip modify Modifies the serial ROM IP contents Yes
User entry create Creates a new user Yes
User entry edit Edits an existing user entry Yes
Srom cfg boot display
Configuration Commands
Srom cfg boot display Command
Syntax Description srom cfg boot display
Srom cfg boot modify
Srom cfg boot modify Command
Srom cfg ip display Command
Syntax Description srom cfg boot modify
Srom cfg ip modify
Srom cfg ip modify Command
Pdm busmode display Command
Pdm busmode display
Pdm cfg threshold bus modify Command
Pdm busmode modify Command
Pdm cfg threshold bus display Command
Gain gain display Command
Voa power input display Command
Administrative Commands
Gain gain modify Command
Syntax Description
Help Command
Clear Command
Exit Command
History Command
Shell Commands
Login and logoff Commands
Processor reset Command
Shell status display Command
Shell lines set Command
Shell more enable and disable Commands
Shell type modify Command
Example 6-12 ffs file list Command
Flash File System Commands
Ffs file list Command
Syntax Description shell type modify tl1 ash
Accesses and displays a specific MIB attribute. See Example
Snmp Commands
Snmp attribute get Command
Example 6-13 snmp attribute get Command
Example 6-15 snmp attribute list Command
Snmp attribute list Command
Example 6-14 snmp attribute get Command List
Snmp attribute list
Snmp attribute set
Snmp attribute set Command
Snmp mib display Command
Snmp mib display
Snmp mib get
Snmp mib get Command
Snmp mib list Command
Syntax Description snmp mib get IPaddress local
Example 6-19 snmp row display Command
Snmp row display
Snmp row get
Snmp row get Command
Snmp row set Command
Snmp row set
Snmp subtree display Command
Snmp subtree get Command
Snmp subtree list
Snmp subtree list Command
Example 6-24 snmp subtree list Command
Syntax Description snmp subtree list IPaddress local
Snmp table display
Snmp table display Command
Example 6-25 snmp table display Command
Snmp table display IPaddress local
Snmp table get
Snmp table get Command
Snmp table list Command
Syntax Description snmp table get IPaddress local table
Example 6-28 snmp tree attribute list Command
User Commands
Snmp tree attribute list Command
Snmp tree attribute list
Syntax Description user entry create name usermode
User entry create Command
User entry edit Command
Syntax Description user entry edit username
User entry delete
User entry delete Command
User file display and user name display Commands
Syntax Description user entry delete username
Command to display the current inactivity values
User inactivity modify and user inactivity display Commands
User passwd set Command
User inactivity modify or user inactivity display
User active list Command
User active message send Command
Snmp table display local entPhysicalEntry
Manufacturing Information Access Commands
Snmp table display local entPhysicalEntry Command
Displays the entity information. See Example
Restore system Command
Restore Commands
Backup system Command
Syntax Description backup system filename
Manufacturer Mode
Manufacturer restore defaults passwords Command
Manufacturer restore defaults all Command
When prompted, enter the FTP user password as shown
FTP Command Line
To start an FTP session, use the following command
Example of FTP from a Remote Server
At the ftp prompt, enter the following command
Example of FTP to a Remote Server
Ftp type
FTP Commands
Example 7-1 FTP Help Command
N a L D R a F T C I S C O C O N F I D E N T I a L
Provisioning Using TL1
Example 8-2 TL1 Shell Login Response
Then enter the following command at the ASH hostname prompt
Example 8-1 TL1 Shell Login Prompt
SidtidnameONS15216 EDFA2 ACT-USERCISCO15100
255.0,DEFRTR=192.167.3.20
SidtidnameONS15216 EDFA2 INIT-SYSALL1021
Example 8-5 Setting the Power Bus Mode Using TL1
Example 8-6displays sample output of this command
Example 8-4 Setting the Date and Time Using TL1
Pwrbusmode value can be Simplex or DUPLEX. See Example
Example 8-7 Setting the Gain Using TL1
SidtidnameONS15216 EDFA2 ED-DWDMALL123OVERALLGAIN=200
SidtidnameONS15216 EDFA2 RTRV-TH-DWDMALL124
Example 8-8shows sample command outputs
Example 8-8 Displaying the Alarm Thresholds Using TL1
SidtidnameONS15216 EDFA2 RTRV-TH-EQPTALL125
Losth
Lpouthyst
Loshyst
Lpoutdev
Lpoutsetpt
Maxctmp
Maxctmphyst
Minctmp
Example 8-9 Changing Current User’s Password Using TL1
Minctmphyst
SidtidnameONS15216 EDFA2 ED-PIDCISCO15130OLDPW,NEWPW
SidtidnameONS15216 EDFA2 ENT-USER-SECUjsmith140jspasswd,,RW
Example 8-10 Adding a New User Using TL1
Example 8-11 Logging Off Using TL1
SidtidnameONS15216 EDFA2 CANC-USERCISCO15150
SidtidnameONS15216 EDFA2 INIT-SYSALL1241
Explanation of Command Parameters
Connection to the ONS 15216 EDFA2
Source Identifier sid and Target Identifier tid
Notation
Command Code Modifier ccm
Access Identifier aid
Correlation Tag ctag
Summary of Autonomous Alarms and Messages
Symbol Meaning Description
Rept EVT Dwdm CTRLMODE2
Rept EVT Eqpt Cutoverreset
Rept EVT Dwdm CTRLMODE1
Rept EVT Dwdm Gainchgd
New Software Load
Software Reset
On page 9-5summarizes the ONS 15216 EDFA2 clear alarms
File Transfer
Apply
ACT-USER
ALW-MSG-ALL
CANC-USER
Rept EVT Dwdm
Rept ALM Dwdm
Rept ALM ENV
Rept EVT ENV
RTRV-INV
RTRV-ENV
RTRV-HDR
RTRV-NE-GEN
ACT-USER
TL1 Commands and Autonomous Messages
CommandACT-USER
ALW-MSG-ALL
Powerbusa
Powerbusb
Apply
Softwarereset
CommandAPPLY
Softwareload
CANC-USER
CommandCANC-USER
CommandCOPY-RFILE
COPY-RFILE
File//localhost/urlpath
Ftp//useridpassword@ftphostport/urlp
Ath
Cwd1/cwd2/…/cwdn/filename
CFG
CommandCPY-MEM
CPY-MEM
LOG
Dbcfg
CommandDLT-RFILE
DLT-RFILE
MEM
DLT-USER-SECU
CommandDLT-USER-SECU
CommandED-DAT
ED-DAT
CommandED-DWDM
ED-DWDM
Aid
CommandED-ENV
ED-ENV
PWR-A, PWR-B, and ALL have same input effect
CommandED-NE-GEN
ED-NE-GEN
TL1
CommandED-PID
ED-PID
ASH
ED-USER-SECU
CommandED-USER-SECU
CommandENT-USER-SECU
ENT-USER-SECU
CommandINH-MSG-ALL
INH-MSG-ALL
Permissions
LOS
Gainchgd
Rept ALM Dwdm
CommandINIT-SYS
INIT-SYS
Eqpt ALL
Non-service affecting
Gain Out of Range alarm cerent15216EdfaAlarmGain
Loss of Output Power alarm cerent15216EdfaAlarmLpout
25 Rept ALM Dwdm Syntax Description
Example 9-21 Rept ALM ENV Message
Rept ALM ENV
Date Yyyy-mm-dd Date of origination of TL1 message
26 Rept ALM ENV Syntax Description
Rept ALM Eqpt
Example 9-22 Rept ALM Eqpt Message
Affecting optical signal or power bus
General parameters of the ONS 15216 EDFA2 not directly
27 Rept ALM Eqpt Syntax Description
Time Hhmmss Time of origination of TL1 message
Reports autonomous events. Reports when an event is logged
Rept EVT Dwdm / Rept EVT ENV / Rept EVT Eqpt
Rept EVT Dwdm or Rept EVT ENV or Rept EVT Eqpt
EVN
Eqpt Softwarereset
Rept EVT Fxfr
CommandRTRV-ALM-ALL
RTRV-ALM-ALL
Dwdm Ctmp
Example 9-25 RTRV-ALM-ALL Command and Response
Dwdm Lpout
30 RTRV-ALM-ALL Syntax Description
Example 9-26 RTRV-ALM-DWDM Command and Response
CommandRTRV-ALM-DWDM
Generates a report on active Dwdm alarms
RTRV-ALM-DWDM
31 RTRV-ALM-DWDM Syntax Description
RTRV-ALM-ENV
CommandRTRV-ALM-ENV
Example 9-27 RTRV-ALM-ENV Command and Response
32 RTRV-ALM-ENV Syntax Description
RTRV-ALM-EQPT
CommandRTRV-ALM-EQPT
Example 9-28 RTRV-ALM-EQPT Command and Response
Aid Eqpt and ALL have same input effect
Ctmp
ALM
CommandRTRV-AO
RTRV-AO
EVT
RTRV-COND-ALL
CommandRTRV-COND-ALL
Example 9-30 RTRV-COND-ALL Command and Response
35 RTRV-COND-ALL Syntax Description
LOS
Example 9-31 RTRV-COND-DWDM Command and Response
CommandRTRV-COND-DWDM
Generates a report on the condition state of Dwdm alarms
RTRV-COND-DWDM
RTRV-COND-ENV
CommandRTRV-COND-ENV
Example 9-32 RTRV-COND-ENV Command and Response
Amp01ONS15216 EDFA2 RTRV-COND-ENVAmp01ALL229PWRBUSA
37 RTRV-COND-ENV Syntax Description
Example 9-33 RTRV-COND-EQPT Command and Response
CommandRTRV-COND-EQPT
Generates a report on the condition state of general alarms
RTRV-COND-EQPT
Example 9-34 RTRV-DFLT-SECU Command and Response
CommandRTRV-DFLT-SECU
Retrieves the timeout values for user access levels
RTRV-DFLT-SECU
Retrieves the ONS 15216 EDFA2 optical control configuration
Timeout Integer Timeout in minutes
CommandRTRV-DWDM
RTRV-DWDM
ConstOutputPower. a valid mode only for pump
Idle
40 RTRV-DWDM Syntax Description
CommandRTRV-ENV
RTRV-ENV
Overallgain
RTRV-HDR
CommandRTRV-HDR
CommandRTRV-INV
RTRV-INV
CommandRTRV-NE-GEN
RTRV-NE-GEN
43 RTRV-INV Syntax Description
44 RTRV-NE-GEN Syntax Description
Example 9-39 RTRV-NE-GEN Command and Response
Aid Always Eqpt
Amp01ONS15216 EDFA2 RTRV-NE-GENAmp01123
RTRV-RFILE
CommandRTRV-RFILE
Example 9-40 RTRV-RFILE Command and Response List all Files
45 RTRV-RFILE Syntax Description
RTRV-TH-DWDM
CommandRTRV-TH-DWDM
Example 9-42 RTRV-TH-DWDM Command and Response
46 RTRV-TH-DWDM Syntax Description
CommandRTRV-TH-ENV
RTRV-TH-ENV
Pwrbusmin
CommandRTRV-TH-EQPT
RTRV-TH-EQPT
Pwrbusmax
Maximum case temperature hysteresis
Maximum case temperature cerent15216EdfaCtmpMax
Thresholdvalue can be between 20 and 70, with default of 65
Thresholdvalue can be between 0 and 10, with default of 1,
CommandRTRV-TOD
RTRV-TOD
RTRV-USER-SECU
CommandRTRV-USER-SECU
CommandSET-ATTR-SECUDFLT
SET-ATTR-SECUDFLT
SET-TH-DWDM
9-6 for access level permissions
CommandSET-TH-DWDM
Sets optical threshold values for the ONS 15216 EDFA2
CommandSET-TH-ENV
SET-TH-ENV
CommandSET-TH-EQPT
SET-TH-EQPT
Example 9-51 STA-LOCL-RST Command
Thresholdvalue can be between 20 and 70, with default
CommandSTA-LOCL-RST
STA-LOCL-RST
Troubleshooting
Alarm Indicators
LEDs and Office Alarms
Front panel of the ONS 15216 EDFA2 has five LEDs
10-3
Gain Gain Out of Range Alarm
Optical Alarms
LOS Loss of Signal Alarm
LOS Gain Lpout
Lpout Loss of Output Power Alarm
LCRNT1 and LCRNT2 Excessive Pump Current Alarms
Equipment Alarms
Ctmp Case Temperature Out of Range Alarm
LTMP1 and LTMP2 Excessive Pump Temperature Alarms
No Output Power after Adjusting Gain Settings
Troubleshooting Typical Scenarios
Environmental Alarms
Pwrbusa and Pwrbusb Power Bus Alarms
10.2.2 2.0.1 to 2.2.1 Upgrade Attempt
Boot Up Failure
Image File Download Incomplete
No Response from RS-232 Port
Hostnameedfaboot% ffs file list
Hostnameedfaboot% srom cfg boot display
No Response from LAN Port
Lost Password
Status Information Needed by Cisco TAC
10-12
EMC
Regulatory Compliance
Discipline Standard Description
ACA AS/NZS3548
Translated Safety Warnings
Safety warnings contained in this document are
N a L D R a F T C I S C O C O N F I D E N T I a L
N a L D R a F T C I S C O C O N F I D E N T I a L
DC Power Supply Warning
Installation Warning
Power Cord Warning
No On/Off Switch Warning
Selv Circuit Warning
Laser Radiation Warning
Power Cabling Warning
Laser Beam Warning
Grounded Equipment Warning
Ground Connection Warning
Jewelry Removal Warning
Qualified Personnel Warning
Supply Circuit Warning
Power Supply Wiring Warning
Invisible Laser Radiation Warning
Incorrect Connection Warning
Ground Conductor Warning
Voltages on DC-input Power Supply Terminals
More Than One Power Supply
Cisco ONS 15216 EDFA2 Rack Installation
Exposed DC Power Wire Warning
VDC Power System
Chassis Power Connection
Cisco ONS 15216 EDFA2 Temperature Requirement
N a L D R a F T C I S C O C O N F I D E N T I a L
Cisco ONS 15216 EDFA2 Power Circuit Overload Warning
Product Disposal Warning
Energy Hazard
Unit Grounding Protection Warning
DC Power Disconnection Warning
Ground Wire Warning
N a L D R a F T C I S C O C O N F I D E N T I a L
N a L D R a F T C I S C O C O N F I D E N T I a L
Class B EMC Warning Safety Requirements Warning
Laser Radiation Warning
Fiber Disconnect Sequence Warning
Optical Connector Warning
Optical Connector Disconnect Warning
Eye Damage Warning
Static Electricity Warning
Connector Cleaning Warning
Cable Connection Sequence Warning
Module Removal Warning
DC Power Selv Requirement Warning
Reinforced Insulation Warning
Power Supply Voltage Warning
DC Power Supply Connection Warning
N a L D R a F T C I S C O C O N F I D E N T I a L
N a L D R a F T C I S C O C O N F I D E N T I a L
ASH TL1 ACT-USER
Snmp
Front panel LEDs FTP commands
Electrical specifications EntPhysicalEntry
Flash file system commands
Ctag
Maxctmp Maxctmphyst mechanical specifications 2-4MIBs
Default recovery Pdm busmode display Pdm busmode modify
Remote communications
Rept ALM Dwdm Rept ALM ENV Rept ALM Eqpt Rept EVT Dwdm
SET-TH-ENV SET-TH-EQPT
MIB
User active list User active message send 6-29user commands
STA-LOCL-RST
IN-7
IN-8