Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide Product and Software Release 2.4 July 2004 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
C ON T E N T S About this Guide xix Document Objectives Audience xix xix Document Organization xix Document Conventions xx Where to Find Safety and Warning Information xxi Obtaining Documentation xxi Cisco.
Contents 2.2 Electrical Specifications 2-4 2.3 Mechanical Specifications 2.4 External Features 2.5 Front Panel CHAPTER 3 Installation 2-4 2-5 2-6 3-1 3.1 Standard Precautions 3-1 3.2 Placement and Power Connection 3-1 3.2.1 General Rack Considerations 3-1 3.2.2 Rack Installation and Power Supply Connection Procedures 3.3 SC/UPC Optical Ports 3-3 3.3.1 Safety Requirements 3-3 3.3.2 Optical Connection Procedure 3-4 3.3.3 Optical Amplification Operation Verification Procedure 3-2 3-4 3.
Contents 4.3 Log In via LAN Port Using Telnet (Optional) 4.4 Set Date and Time 4-4 4.5 Set Power Bus Mode (Simplex or Duplex) 4.6 Verify Amplifier Operational Status 4.7 Set Gain 4.9 Set Password CHAPTER 5 4-4 4-5 4-10 4-11 4.11 Save Changes 4.12 Log Off 4-4 4-5 4.8 Set Alarm Thresholds 4.10 Add Users 4-3 4-11 4-12 4.13 Back Up System Configuration 4-12 4.14 Restore System Configuration 4-13 SNMP MIB Configuration 5-1 5.1 SNMP Overview 5-1 5.1.1 SNMP Components 5-1 5.1.
Contents 5.4.9 LogEventControl 5-19 5.4.10 LogEventEntry 5-19 5.4.11 OpGroup 5-20 5.4.12 OverallControl 5-23 5.4.13 OverallStatusGroup 5-23 5.4.14 PumpCfgEntry 5-24 5.4.14.1 Changing the Pump Control Mode 5.4.14.2 Changing the Pump Control Value 5.4.15 PumpStatusEntry 5-27 5.4.16 RtcDateAndTime 5-28 5.4.17 SromIpMgmtGroup 5-29 5.4.18 VersionGroup 5-30 5-25 5-26 5.5 Setting Up Traps 5-30 5.5.1 Display Trap Command 5-30 5.5.2 Set Trap Command 5-31 5.5.3 Set Agent Trap Enable 5-32 5.5.
Contents 5.7 Summary of SNMP Alarms and Events CHAPTER 6 ASH Commands 5-45 6-1 6.1 Summary of Security Permissions for ASH Commands 6-1 6.2 Configuration Commands 6-7 6.2.1 srom cfg boot display Command 6-7 6.2.2 srom cfg boot modify Command 6-7 6.2.3 srom cfg ip display Command 6-8 6.2.4 srom cfg ip modify Command 6-8 6.2.5 pdm busmode display Command 6-9 6.2.6 pdm cfg threshold bus display Command 6-9 6.2.7 gain gain display Command 6-9 6.2.8 voa power input display Command 6-10 6.
Contents 6.6.12 6.6.13 6.6.14 6.6.15 6.6.16 snmp subtree list Command 6-21 snmp table display Command 6-22 snmp table get Command 6-23 snmp table list Command 6-23 snmp tree attribute list Command 6-24 6.7 User Commands 6-24 6.7.1 user entry create Command 6-25 6.7.2 user entry edit Command 6-25 6.7.3 user entry delete Command 6-26 6.7.4 user file display and user name display Commands 6-26 6.7.5 user inactivity modify and user inactivity display Commands 6.7.6 user passwd set Command 6-27 6.7.
Contents 8.5 Set Power Bus Mode (Simplex or Duplex) 8.6 Verify Amplifier Operational Status 8.7 Set Gain 8.9 Set Password 8.10 Add Users CHAPTER 9 8-4 8-5 8.8 Set Alarm Thresholds 8.11 Log Off 8-5 8-11 8-12 8-12 8.12 Back Up System Configuration 8-12 8.13 Restore System Configuration 8-13 TL1 Commands 8-4 9-1 9.1 Connection to the ONS 15216 EDFA2 9-1 9.2 Explanation of Command Parameters 9-1 9.2.1 Source Identifier (sid) and Target Identifier (tid) 9.2.
Contents 9.6.18 9.6.19 9.6.20 9.6.21 9.6.22 9.6.23 9.6.24 9.6.25 9.6.26 9.6.27 9.6.28 9.6.29 9.6.30 9.6.31 9.6.32 9.6.33 9.6.34 9.6.35 9.6.36 9.6.37 9.6.38 9.6.39 9.6.40 9.6.41 9.6.42 9.6.43 9.6.44 9.6.45 9.6.46 9.6.47 9.6.
Contents 10.1.2.1 LOS (Loss of Signal) Alarm 10-4 10.1.2.2 GAIN (Gain Out of Range) Alarm 10-5 10.1.2.3 LPOUT (Loss of Output Power) Alarm 10-6 10.1.3 Troubleshooting Equipment Alarms 10-6 10.1.3.1 CTMP (Case Temperature Out of Range) Alarm 10-6 10.1.3.2 LCRNT1 and LCRNT2 (Excessive Pump Current) Alarms 10-7 10.1.3.3 LTMP1 and LTMP2 (Excessive Pump Temperature) Alarms 10-7 10.1.3.4 PWRBUSA and PWRBUSB (Power Bus) Alarms 10-7 10.2 Typical Troubleshooting Scenarios 10-8 10.2.
Contents Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
F I G U R E S Figure 1-1 Wavelength Protection Switching Figure 1-2 Gain Flattening Filter Figure 2-1 ONS 15216 EDFA2 Dimensions 2-6 Figure 2-2 ONS 15216 EDFA2 Front Panel 2-6 Figure 3-1 ONS 15216 EDFA2 Optical Connections Figure 3-2 HyperTerminal Connect To Dialog Box Figure 3-3 HyperTerminal COM1 Properties Dialog Box Figure 3-4 Optical Amplifier Properties Dialog Box (Connect To Tab) Figure 3-5 Optical Amplifier Properties Dialog Box (Settings Tab) Figure 3-6 HyperTerminal ASCII Set
Figures Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
T A B L E S Table 2-1 ONS 15216 EDFA2 Optical Specifications Table 2-2 Noise Figure Specification - ONS 15216 EDFA2-A Only Table 2-3 Maximum Channel Power Table 2-4 ONS 15216 EDFA2 Electrical Specifications Table 2-5 ONS 15216 EDFA2 Mechanical Specifications Table 2-6 ONS 15216 EDFA2 Front Panel Features Table 3-1 Gain Range Table 3-2 Alarm Pinout and Definitions (RJ-45) Table 3-3 Equipment Checklist Table 3-4 Communication Component List Table 3-5 Modem DIP Switch Setting Table 3-6
Tables Table 5-19 cerent15216EdfaOverallControl Variable Descriptions Table 5-20 cerent15216EdfaOverallStatusGroup Variable Descriptions Table 5-21 cerent15216EdfaPumpCfgEntry Variable Descriptions Table 5-22 cerent15216EdfaPumpStatusEntry Variable Descriptions 5-27 Table 5-23 cerent15216EdfaRtcDateAndTime Variable Descriptions 5-29 Table 5-24 cerent15216EdfaSromIpMgmtGroup Variable Descriptions Table 5-25 cerent15216EdfaVersionGroup Variable Descriptions Table 5-26 cerent15216EdfaSromIpMg
Tables Table 9-23 INIT-SYS Syntax Description Table 9-24 REPT ALM DWDM Syntax Description Table 9-25 REPT ALM EQPT Syntax Description Table 9-26 REPT EVT DWDM / REPT EVT EQPT Syntax Description Table 9-27 REPT EVT FXFR Syntax Description 9-37 Table 9-28 RTRV-ALM-ALL Syntax Description 9-38 Table 9-29 RTRV-ALM-DWDM Syntax Description Table 9-30 RTRV-ALM-EQPT Syntax Description Table 9-31 RTRV-AO Syntax Description Table 9-32 RTRV-ATTR-ALL Syntax Description Table 9-33 RTRV-ATTR-DWDM S
Tables Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
About this Guide This section explains the objectives, intended audience, and organization of this publication and describes the conventions that convey instructions and other information.
About this Guide Document Conventions • Chapter 2, “Technical Specifications” provides technical specifications for the Cisco ONS 15216 EDFA2/EDFA2-A. • Chapter 3, “Installation” provides installation procedures for the Cisco ONS 15216 EDFA2/EDFA2-A. • Chapter 4, “Provisioning with ASH and SNMP” provides provisioning procedures for the Cisco ONS 15216 EDFA2/EDFA2-A using SNMP and the ASH shell.
About this Guide Where to Find Safety and Warning Information Caution Warning Means reader be careful. In this situation, the user might do something that could result in equipment damage or loss of data. IMPORTANT SAFETY INSTRUCTIONS This warning symbol means danger. You are in a situation that could cause bodily injury. Before you work on any equipment, be aware of the hazards involved with electrical circuitry and be familiar with standard practices for preventing accidents.
About this Guide Documentation Feedback Ordering Documentation You can find instructions for ordering documentation at this URL: http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm You can order Cisco documentation in these ways: • Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool: http://www.cisco.com/en/US/partner/ordering/index.shtml • Nonregistered Cisco.
About this Guide Obtaining Technical Assistance Cisco Technical Support Website The Cisco Technical Support Website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, 365 days a year at this URL: http://www.cisco.com/techsupport Access to all tools on the Cisco Technical Support Website requires a Cisco.com user ID and password.
About this Guide Obtaining Additional Publications and Information Obtaining Additional Publications and Information Information about Cisco products, technologies, and network solutions is available from various online and printed sources. • Cisco Marketplace provides a variety of Cisco books, reference guides, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL: http://www.cisco.
C H A P T E R 1 Applications This manual describes how to install and operate the Cisco Optical Network System (ONS) 15216 Erbium-Doped Fiber Amplifier 2 (EDFA2). The ONS 15216 EDFA2 is an optical amplifier that enables the migration to next-generation all-optical networks. It features bandwidth-on-demand and wavelength protection switching that extend dense wavelength division multiplexing (DWDM) links by hundreds of kilometers.
Chapter 1 Applications 1.3 Key Features Figure 1-1 Wavelength Protection Switching Wavelength is rerouted C D B D B A Before Fiber Cut A After 61990 C After a protection switch occurs, the number of wavelengths on each fiber changes. In the example, the number of clockwise wavelengths increases to three, while the number of counter-clockwise wavelengths decreases to one. 1.
Chapter 1 Applications 1.3.2 Gain Flattening • Constant Pump Current mode • Constant Pump Power mode 1.3.2 Gain Flattening Figure 1-2 illustrates the effect of the gain flattening filter in the ONS 15216 EDFA2. Fiber (a) in the figure shows a set of channels with equal powers being input to a cascaded network of amplifiers that produce vastly different power levels and optical signal-to-noise ratios (OSNR) at the output.
Chapter 1 Applications 1.3.6 SNMP MIBs 1.3.6 SNMP MIBs The ONS 15216 EDFA2 SNMP MIBs contain definitions of management information that allows network systems to be remotely monitored, configured, and controlled. 1.3.7 TL1 The ONS 15216 EDFA2 has a TL1 interface available to the network operator and craftsperson. Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
C H A P T E R 2 Technical Specifications This chapter discusses the technical specifications for the Cisco ONS 15216 EDFA2. 2.1 Optical Specifications ONS 15216 EDFA2 optical specifications are listed and described in Table 2-1. Table 2-1 ONS 15216 EDFA2 Optical Specifications Requirement Specification Input signal wavelength 1530 nm to 1563 nm Input power (channel total)1 –27 dBm to 4 dBm (total all channels) See the “2.1.1 Maximum Input Power” section on page 2-2 and the “2.1.
Chapter 2 Technical Specifications 2.1.1 Maximum Input Power Table 2-1 ONS 15216 EDFA2 Optical Specifications (continued) Requirement Specification Polarization sensitivity < 0.5 dB Automatic gain control (AGC) The ONS 15216 EDFA2 contains an active gain block with an automatic gain control loop to minimize the effects of output power variations per wavelength upon adding or deleting wavelengths on the same DWDM ring. 1.
Chapter 2 Technical Specifications 2.1.2 Channel Loading Table 2-3 Maximum Channel Power Composite Input Power (dBm) 4 3 2 1 0 –1 –2 –3 –4 –5 Corresponding Max. Gain (dB) 13 14 15 16 17 18 19 20 21 22 Number of Channels at Full Loading Maximum per Channel Input Power at Maximum Gain Setting (dBm) 1 4.0 3.0 2.0 1.0 0.0 –1.0 –2.0 –3.0 –4.0 –5.0 2 1.0 0.0 –1.0 –2.0 –3.0 –4.0 –5.0 –6.0 –7.0 –8.0 3 –0.8 –1.8 –2.8 –3.8 –4.8 –5.8 –6.8 –7.8 –8.8 –9.
Chapter 2 Technical Specifications 2.2 Electrical Specifications Table 2-3 Maximum Channel Power (continued) Composite Input Power (dBm) 4 3 2 1 0 –1 –2 –3 –4 –5 Corresponding Max. Gain (dB) 13 14 15 16 17 18 19 20 21 22 Number of Channels at Full Loading Maximum per Channel Input Power at Maximum Gain Setting (dBm) 31 –10.9 –11.9 –12.9 –13.9 –14.9 –15.9 –16.9 –17.9 –18.9 –19.9 32 –11.1 –12.1 –13.1 –14.1 –15.1 –16.1 –17.1 –18.1 –19.1 –20.1 2.
Chapter 2 Technical Specifications 2.4 External Features Table 2-5 ONS 15216 EDFA2 Mechanical Specifications (continued) Requirement Specification Connector types SC/UPC Bulkhead connectors Mean time between failures (MTBF) 12.7 years as per calculation procedure outlined in TR-NWT-000332, Issue 4, Method 1 2.
Chapter 2 Technical Specifications 2.5 Front Panel Figure 2-1 ONS 15216 EDFA2 Dimensions 17 3/16 in. Width 1 3/4 in. Height 71177 11 in. Dimension 2.5 Front Panel Figure 2-2 shows the ONS 15216 EDFA2 front panel in detail. The front panel provides an all-front access (fibers, power, alarm contact, and management interface) that complies with international standards.
Chapter 2 Technical Specifications 2.5 Front Panel Table 2-6 ONS 15216 EDFA2 Front Panel Features Feature Description Terminal strip Terminal strip for supplying power to the ONS 15216 EDFA2. Attach AWG 18 stranded power wires to appropriate terminals. Threaded grounding holes Threaded grounding holes (#10-32) to ground the ONS 15216 EDFA2. Alarm Out RJ-45 connector used for alarm system connection. (See the “3.4.1 Alarm Out Relay Interface (RJ-45)” section on page 3-5 for additional information.
Chapter 2 Technical Specifications 2.5 Front Panel Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
C H A P T E R 3 Installation This chapter contains the installation procedures for the Cisco ONS 15216 EDFA2. The chapter is divided into the following sections: • Power (–48V A, RET A, –48V B, RET B, and chassis ground) • Optical (fiber input and output ports) • Communications (Alarm Out, LEDs, RS-232 (EIA/TIA-232), and LAN) 3.
Chapter 3 Installation 3.2.2 Rack Installation and Power Supply Connection Procedures Warning • Circuit Overloading—Consideration should be given to the connection of the equipment to the supply circuit and the effect that overloading of circuits might have on overcurrent protection and supply wiring. Appropriate consideration of equipment nameplate ratings should be used. • Reliable Earthing—Reliable grounding of rack mounted equipment should be maintained.
Chapter 3 Installation 3.3 SC/UPC Optical Ports e. The POWER (green) LED remains on if the Power Bus mode is duplex and both power supplies are connected to valid power sources or if the Power Bus mode is simplex and the Power A terminal is connected to a valid power source. Note that the POWER LED could flash for a few seconds while the software determines the validity of the power sources. A continuously flashing POWER LED indicates a Power Bus alarm. f.
Chapter 3 Installation 3.3.2 Optical Connection Procedure 3.3.2 Optical Connection Procedure Warning Follow all directions and warning labels when working with optical fibers. To prevent eye damage, never look directly into a fiber or connector. Connect the customer-supplied fiber optic patchcords to the SC/UPC optical ports of the ONS 15216 EDFA2 using the following procedure. Refer to Figure 3-1 while performing this procedure: Step 1 Clean both ends of the two fiber optic patchcords.
Chapter 3 Installation 3.4 Communications For example, if the total input power is between –27 dBm and –5 dBm, expect an output power between –5 dBm and 17 dBm. Table 3-1 Note Gain Range Gain Total Input Power (dBm) Total Output Power (dBm) (dB) Min Max Min Max 22 –27 –5 –5 17 Unless overridden by the user, the gain per channel is by default set to 22 dB by the ONS 15216 EDFA2. Gain is fixed at 22 dB as long as total input power is less than or equal to –5 dBm.
Chapter 3 Installation 3.4.2 Alarm LEDs Table 3-2 Alarm Pinout and Definitions (RJ-45) (continued) Relay Pinout Description 1 3 (1+) 4 (1–) Laser pump temperature or bias is out of range; input power is out of tolerance for gain settings (Major) 5 (2+) Loss of optical input signal or input signal is below threshold (Minor) 2 6 (2–) 3 7 (3+) 8 (3–) Loss of electrical power or out of range for Bus A or Bus B while in duplex mode 3.4.1.
Chapter 3 Installation 3.4.3 Serial Interface (EIA/TIA-232) Communication • Flashing: Power Bus A or B (in duplex mode) has failed or is out of tolerance, or Power Bus A (in simplex mode) is out of tolerance. In the off condition, the first pair of alarm relay contacts in the RJ-45 connector changes from a normally open condition to a closed condition. The LED and alarm automatically reset when the condition clears. (For additional alarm contact closure information, see the “3.4.
Chapter 3 Installation 3.4.3 Serial Interface (EIA/TIA-232) Communication Table 3-3 Equipment Checklist Hardware Comments Laptop or computer running a Terminal application. User-provided. HyperTerminal can be found in the Microsoft Windows Accessories menu. EIA/TIA-232 cable with DB-9F/DB-9M Provides EIA/TIA-232 link to ONS 15216 EDFA2. connectors wired as shown in Figure 3-8 on page 3-14. 3.4.3.
Chapter 3 Installation 3.4.3 Serial Interface (EIA/TIA-232) Communication Click OK when done. Figure 3-3 HyperTerminal COM1 Properties Dialog Box Step 7 In the HyperTerminal main window, click File > Properties. Step 8 Click Connect To tab in the Optical Amplifier Properties dialog box as shown in Figure 3-4. Figure 3-4 Optical Amplifier Properties Dialog Box (Connect To Tab) Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
Chapter 3 Installation 3.4.3 Serial Interface (EIA/TIA-232) Communication Step 9 Ensure that Direct to Com1 is selected in the Connect using field. Step 10 Click Settings (Figure 3-5) and click ASCII Setup. Figure 3-5 Step 11 Configure the ASCII Setup window as shown in Figure 3-6. Click OK when done. Figure 3-6 Step 12 Optical Amplifier Properties Dialog Box (Settings Tab) HyperTerminal ASCII Setup Dialog Box Click OK to return to the main HyperTerminal window.
Chapter 3 Installation 3.4.4 Serial Interface Remote Communication via Modem The ONS 15216 EDFA2 login screen appears. The appearance depends on the shell the ONS 15216 EDFA2 is set to (TL1 is the default shell). See the “4.1 Log In via RS-232 (EIA/TIA-232) Port Using HyperTerminal” section on page 4-1 for the login procedure in ASH shell and the “8.1 Log In via RS-232 (EIA/TIA-232) Port Using HyperTerminal” section on page 8-1 for the login procedure in TL1 shell. 3.4.
Chapter 3 Installation 3.4.4 Serial Interface Remote Communication via Modem Table 3-4 Communication Component List (continued) Component Notes Local Site 1 PC running HyperTerminal US Robotics 56K Fax modem V.90 The modem to ONS 15216 EDFA2 connection must be set for 19200 baud. The modem to modem connection must be set for 14400 baud. 1 10-ft DB-25M to DB-9F For connection between PC COM port and modem.
Chapter 3 Installation 3.4.4 Serial Interface Remote Communication via Modem Set the terminal communication parameters as follows: • 19,200 baud • No parity • 8 bits per character • 1 stop bit, and no flow control Table 3-6 gives a brief description of the modem settings that are stored in NVRAM. These settings survive power supply interruptions. Use these settings to configure each modem.
Chapter 3 Installation 3.4.5 LAN Interface (Ethernet) 3.4.4.5 Setting and Saving Modem Settings To set and save modem settings, enter the following command to the terminal program and to each modem: atb0e0f1m1q1v1x1y0 at&a3&b1&c1&d0&g0&h0&i0&k0s0=1 at&m5&n8&7p1&r1&s1&t5&u8&y1s2=128 at&w0 Note Modem communication is not necessary unless dial-up remote communication is desired. 3.4.4.
Chapter 3 Installation 3.4.5 LAN Interface (Ethernet) • ASH CLI commands (Chapter 6, “ASH Commands”) • TL1 commands (Chapter 9, “TL1 Commands”) 3.4.5.1 LAN Connection Procedure Use the following procedure to configure the module to accept SNMP, CLI, and TL1 commands via its RJ-45 LAN port: Step 1 The ONS 15216 EDFA2 IP address is factory set at 0.0.0.0. The IP address must be set before the ONS 15216 EDFA2 can be accessed via the Ethernet port. See the “4.2 Set IP Address” section on page 4-3.
Chapter 3 Installation 3.4.5 LAN Interface (Ethernet) Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
C H A P T E R 4 Provisioning with ASH and SNMP This chapter discusses the provisioning procedures for the Cisco ONS 15216 EDFA2 using SNMP and a proprietary command line interface named the ASH shell. See Chapter 8, “Provisioning with TL1” for provisioning information using TL1 commands in the TL1 shell. The provisioning procedure for the ONS 15216 EDFA2 in the ASH shell is as follows: 1. 4.1 Log In via RS-232 (EIA/TIA-232) Port Using HyperTerminal, page 4-1 2. 4.2 Set IP Address, page 4-3 3. 4.
Chapter 4 Provisioning with ASH and SNMP 4.1 Log In via RS-232 (EIA/TIA-232) Port Using HyperTerminal By default the ONS 15216 EDFA2 is in TL1 shell, so this step may be required to proceed in ASH shell. When in TL1 shell, the screen opens to a simple prompt (>). To change to ASH shell, log in using the procedure in the“8.
Chapter 4 Provisioning with ASH and SNMP 4.2 Set IP Address 4.2 Set IP Address Before connecting the ONS 15216 EDFA2 to a LAN, it is mandatory to set the ONS 15216 EDFA2 IP address through a local serial communication interface using the RS-232 (EIA/TIA-232) port on the front of the module. Step 1 If you do not know the ONS 15216 EDFA2’s IP address, subnet mask, gateway address, or host name, contact your network administrator.
Chapter 4 Provisioning with ASH and SNMP 4.4 Set Date and Time You are now connected to the ONS 15216 EDFA2 via Telnet. 4.4 Set Date and Time Use the snmp attribute set local cerent15216EdfaRtcDateAndTimeLocalString command to set the date, time, and time zone. Entries must follow this format: “yyyy-m-d,h:m:s.s +h:m”.
Chapter 4 Provisioning with ASH and SNMP 4.7 Set Gain The input power (signal) should be consistent with the input power measured during the optical connection procedure. See the “3.3.2 Optical Connection Procedure” section on page 3-4 for more information. The output power value should be 22 dB greater than the input, assuming that the default gain setting is 22 dB. Note An input power higher than –5 dBm will return a Gain Out of Range alarm that can be cleared by correctly setting the gain value.
Chapter 4 Provisioning with ASH and SNMP 4.
Chapter 4 Provisioning with ASH and SNMP 4.8 Set Alarm Thresholds Table 4-1 Alarm Threshold Attribute Definitions Attribute Variable Definition Syntax Maximum Access Description cerent15216Edfa CfgSaved Configurati True Value Read-only on saved status Indicates whether the current configuration has been saved. The value can be true or false. If false, the configuration is not saved.
Chapter 4 Provisioning with ASH and SNMP 4.8 Set Alarm Thresholds Table 4-1 Alarm Threshold Attribute Definitions (continued) Attribute Variable Definition Syntax Maximum Access Description Read-write Used to set the amount the input signal Integer must increase above the LOS Threshold (0 to 1000, level before the alarm is cleared. This 100 attribute, in conjunction with the loss of default) input signal alarm threshold, enables efficient clearing of alarms.
Chapter 4 Provisioning with ASH and SNMP 4.8 Set Alarm Thresholds Table 4-1 Alarm Threshold Attribute Definitions (continued) Attribute cerent15216Edfa CtmpMax Variable Definition Syntax Maximum Access Description Maximum Integer Read-write Alarm notifies operations personnel if the case (20 to 70, case temperature of the ONS 15216 temperature 70 default) EDFA2 is at a level that may impact proper operation of the optical network.
Chapter 4 Provisioning with ASH and SNMP 4.9 Set Password Table 4-1 Alarm Threshold Attribute Definitions (continued) Attribute Variable Definition cerent15216Edfa Power bus PowerBusDCVolt minimum ageMin voltage Syntax Integer (350 to 700, 420 default) Maximum Access Description Read-write Minimum allowable power bus DC voltage. The default minimum power bus voltage is set at –42 VDC. Valid entries are between 350 and 700 and are in negative volts times 10.
Chapter 4 Provisioning with ASH and SNMP 4.10 Add Users New Password = ****** Confirm New Password = ****** Note The default user name for the administrator level is CISCO15 with no default password. To start a session for this user name, press Enter. 4.10 Add Users Use the user entry create command to add new users to the ONS 15216 EDFA2. The syntax is to enter the command followed by the user name and then the access level (read, read_write, read_write_admin) as shown in Example 4-10.
Chapter 4 Provisioning with ASH and SNMP 4.12 Log Off – cerent15216EdfaSromIpMgmtEnetSubNetMask – cerent15216EdfaSromIpMgmtDefaultRouterAddress – cerent15216EdfaSromIpMgmtHostName • BootTable attributes: – cerent15216EdfaBootModuleIndex – cerent15216EdfaBootEntryIndex – cerent15216EdfaBootType – cerent15216EdfaBootIpAddress – cerent15216EdfaBootFileName 4.12 Log Off At the end of a session, the user must log off of the ONS 15216 EDFA2. To log off, use the logoff command. This is shown in Example 4-12.
Chapter 4 Provisioning with ASH and SNMP 4.14 Restore System Configuration Step 2 If desired, use FTP to copy the file to a remote server. See “7.1.2 Example of FTP to a Remote Server” section on page 7-2. 4.14 Restore System Configuration 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.
Chapter 4 Provisioning with ASH and SNMP 4.14 Restore System Configuration Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
C H A P T E R 5 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 Chapter 4, “Provisioning with ASH and SNMP.” 5.
Chapter 5 SNMP MIB Configuration 5.1.2 ONS 15216 EDFA2 SNMP Elements 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 Management Entity Agent Agent Agent Management Database Management Database Management Database Managed Devices 33930 NMS 5.1.2.
Chapter 5 SNMP MIB Configuration 5.1.2 ONS 15216 EDFA2 SNMP Elements Figure 5-2 SNMP Agent and MIB Network device NMS SNMP Manager get-response, traps MIB SNMP Agent 32632 get, get-next, get-bulk 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.
Chapter 5 SNMP MIB Configuration 5.1.3 SNMP MIBs and Message Types 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.
Chapter 5 SNMP MIB Configuration 5.1.4 Command Syntax Using the SNMP Agent 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.
Chapter 5 SNMP MIB Configuration 5.2 Enabling SNMP Remote Management Community Strings Use these commands to set up community strings and traps (see the “5.2 Enabling SNMP Remote Management Community Strings” section on page 5-6 and the “5.5 Setting Up Traps” section on page 5-30). 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.
Chapter 5 SNMP MIB Configuration 5.2.1 Creating a View 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.
Chapter 5 SNMP MIB Configuration 5.2.2 Creating a Community Entry 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.
Chapter 5 SNMP MIB Configuration 5.2.2 Creating a Community Entry Table 5-6 Note 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 on page 5-8, it is “3”. cerent15216EdfaCommName Community Name: The community string.
Chapter 5 SNMP MIB Configuration 5.3 Setting Up for CTM Access }; Table 5-7 displays the decimal values for the following SNMP operations.
Chapter 5 SNMP MIB Configuration 5.3 Setting Up for CTM Access 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.
Chapter 5 SNMP MIB Configuration 5.4 Tables and Groups 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: • 5.4.1 ActionOpGroup, page 5-12 • 5.4.
Chapter 5 SNMP MIB Configuration 5.4.2 AgentControlGroup Table 5-8 cerent15216EdfaActionOpGroup Variable Descriptions Maximum Access Description idle(1), pending(2), inProgress(3), aborted(4) Read-only The status of the current operation. cerent15216Edfa ActionOpResult Integer (-2147483647 to 2147483647) Read-only This value saves the error result (if any) of the last operation. 0 indicates success.
Chapter 5 SNMP MIB Configuration 5.4.4 BootEntry Table 5-10 cerent15216EdfaAlarmEntry Variable Descriptions Variable Syntax Maximum Access cerent15216Edfa AlarmIndex Integer (1 to 2048) Not A unique value to identify this entry. Accessible cerent15216Edfa AlarmID 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.
Chapter 5 SNMP MIB Configuration 5.4.5 BootImageEntry Table 5-11 cerent15216EdfaBootEntry Variable Descriptions (continued) Maximum Access Variable Syntax Description cerent15216Edfa BootIpAddress IpAddress Read-write IP address for boot server when using TFTP or bootp. It is 0.0.0.0 otherwise. cerent15216Edfa BootFileName Display String (1 to 33 characters) Read-write The file to be loaded. This may include a path component.
Chapter 5 SNMP MIB Configuration 5.4.6 CfgGroup Table 5-13 cerent15216EdfaCfgGroup Variable Descriptions Maximum Access Variable Syntax Description cerent15216Edfa CfgSaved 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. cerent15216Edfa LpoutSetpoint Integer (0 to 1000, 0 default) Read-only Laser pump output power setpoint for the Lpout alarm, in units of 0.
Chapter 5 SNMP MIB Configuration 5.4.7 FfsFileEntry Table 5-13 cerent15216EdfaCfgGroup Variable Descriptions (continued) Variable Syntax cerent15216Edfa Integer PowerBusDCVolt (350 to 700, ageMin 420 default) Maximum Access Description 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.
Chapter 5 SNMP MIB Configuration 5.4.8 FfsOpGroup 5.4.8 FfsOpGroup The cerent15216EdfaFfsOpGroup table contains information on performing operations on the Flash File System. Table 5-15 lists the table variables.
Chapter 5 SNMP MIB Configuration 5.4.9 LogEventControl Table 5-15 cerent15216EdfaFfsOpGroup Variable Descriptions (continued) Maximum Access Variable Syntax Description cerent15216Edfa FfsOpDstName 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.
Chapter 5 SNMP MIB Configuration 5.4.11 OpGroup Table 5-17 cerent15216EdfaLogEventEntry Variable Descriptions (continued) Maximum Access Variable Syntax Description cerent15216Edfa LogEventSlot Integer (-1 to 15) Read-only Index of the slot reporting the logged event. -1 implies no slot. cerent15216Edfa LogEventPort Integer (0 to 15) Read-only Index of the port reporting the logged event. 0 implies no port.
Chapter 5 SNMP MIB Configuration 5.4.11 OpGroup Table 5-18 cerent15216EdfaOpGroup Variable Descriptions Maximum Access Description idle(1), pending(2), inProgress(3), aborted(4) Read-only The status of the current operation. 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. Variable Syntax cerent15216Edfa OpStatus cerent15216Edfa OpResult For DB backup and restore the following results are possible: 0: Success.
Chapter 5 SNMP MIB Configuration 5.4.11 OpGroup Table 5-18 cerent15216EdfaOpGroup Variable Descriptions (continued) Variable Syntax cerent15216Edfa OpCutover idle(1), perform(2), abort(3) Maximum Access Description 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.
Chapter 5 SNMP MIB Configuration 5.4.12 OverallControl 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.
Chapter 5 SNMP MIB Configuration 5.4.14 PumpCfgEntry Table 5-20 cerent15216EdfaOverallStatusGroup Variable Descriptions (continued) Variable Note Syntax Maximum Access Description cerent15216EdfaConstGainOver Integer allGainMeasured (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.
Chapter 5 SNMP MIB Configuration 5.4.14 PumpCfgEntry Table 5-21 cerent15216EdfaPumpCfgEntry Variable Descriptions Variable Maximum Access Syntax cerent15216EdfaPumpCfgP Integer (1 or 2) umpNum Not Accessible cerent15216EdfaPumpCfgC constGainTempC Read-write ontrolMode omp(2), constOutputPowe r(3), constCurrent(4), constPower(5), idle(6) Description Laser pump number (1 or 2). Laser pump control mode.
Chapter 5 SNMP MIB Configuration 5.4.14 PumpCfgEntry 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.
Chapter 5 SNMP MIB Configuration 5.4.15 PumpStatusEntry 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.
Chapter 5 SNMP MIB Configuration 5.4.16 RtcDateAndTime Table 5-22 cerent15216EdfaPumpStatusEntry Variable Descriptions (continued) Maximum Access Variable Syntax cerent15216EdfaPumpStatus InPowerdBm 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. cerent15216EdfaPumpStatus OutPowermW Integer (0 to 999999) Read-only Optical output power of the pump, in units of 0.01 mW.
Chapter 5 SNMP MIB Configuration 5.4.17 SromIpMgmtGroup Table 5-23 describes the variables. Table 5-23 cerent15216EdfaRtcDateAndTime Variable Descriptions Variable Syntax cerent15216Edfa DateAndTime RtcDateAndTime Local Maximum Access Read-write Description The current local time. Setting this value changes the time according to the cerent15216EdfaRtcDateAndTimeTimezone and cerent15216EdfaRtcDateAndTimeSaving values. In the format ‘07d3051e0c111a002d0800’H.
Chapter 5 SNMP MIB Configuration 5.4.18 VersionGroup Table 5-24 cerent15216EdfaSromIpMgmtGroup Variable Descriptions (continued) Variable Syntax Maximum Access Description cerent15216EdfaSromIpMgmtDefault IpAddress RouterAddress Read-write The IP address of the default router used by the system. The router’s address must be on the Ethernet IP subnetwork. cerent15216EdfaSromIpMgmtHostNa Display String me (0 to 15 characters) Read-write The system’s host name.
Chapter 5 SNMP MIB Configuration 5.5.2 Set Trap Command 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.
Chapter 5 SNMP MIB Configuration 5.5.3 Set Agent Trap Enable 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.
Chapter 5 SNMP MIB Configuration 5.6.2 Date and Time }; Table 5-26 describes the other attributes displayed by these commands. Table 5-26 cerent15216EdfaSromIpMgmtGroup Command Attributes Attribute Description cerent15216EdfaSromIpMgmt The IP address used by the system Ethernet management port. If set to EnetAddress 0.0.0.0, IP traffic is not supported over the Ethernet interface. cerent15216EdfaSromIpMgmt The default router (gateway) address for the network.
Chapter 5 SNMP MIB Configuration 5.6.3 Power Gain 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.
Chapter 5 SNMP MIB Configuration 5.6.4 Case Temperature 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).
Chapter 5 SNMP MIB Configuration 5.6.4 Case Temperature 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.
Chapter 5 SNMP MIB Configuration 5.6.5 Power Bus 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 on page 5-36).
Chapter 5 SNMP MIB Configuration 5.6.6 Input Power (Signal) 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.
Chapter 5 SNMP MIB Configuration 5.6.6 Input Power (Signal) 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.
Chapter 5 SNMP MIB Configuration 5.6.7 Output Power The cerent15216EdfaLOSHysterisis attribute in the cerent15216EdfaCfgGroup display command shows the loss of input power alarm threshold (Example 5-14 on page 5-36). For information about all of the parameters in the cerent15216EdfaCfgGroup table, refer to Table 5-13 on page 5-16. 5.6.7 Output Power 5.6.7.1 Output Power Value 5.6.7.1.
Chapter 5 SNMP MIB Configuration 5.6.7 Output Power 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.
Chapter 5 SNMP MIB Configuration 5.6.7 Output Power ash:hostname:ONS15216 EDFA2> snmp row display local cerent15216EdfaCfgGroup CLASS CERENT-15216-EDFA-MIB.
Chapter 5 SNMP MIB Configuration 5.6.8 Database Backup and Restore 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 “4.11 Save Changes” section on page 4-11. 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.
Chapter 5 SNMP MIB Configuration 5.6.9 Alarm Entry f. Step 6 Set cerent15216EdfaFfsOpAction = 2 (perform). 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.
Chapter 5 SNMP MIB Configuration 5.7 Summary of SNMP Alarms and Events 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.
Chapter 5 SNMP MIB Configuration 5.7 Summary of SNMP Alarms and Events Table 5-28 SNMP Alarms (continued) Alarm Index Alarm ID Description Default Priority 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.
Chapter 5 SNMP MIB Configuration 5.7 Summary of SNMP Alarms and Events Table 5-29 SNMP Events (continued) Notification Notification Trigger Default Priority Condition cerent15216Edfa FfsOpStarted 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.
Chapter 5 SNMP MIB Configuration 5.7 Summary of SNMP Alarms and Events Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
6 C H A P T E R ASH Commands ASH commands are available in the ASH shell command line interface. ASH commands consist of proprietary commands and command-line SNMP instructions. This chapter is a reference of ASH commands that are used in advanced setup and troubleshooting. For provisioning the Cisco ONS 15216 EDFA2 using ASH commands, see Chapter 4, “Provisioning with ASH and SNMP.
Chapter 6 ASH Commands 6.1 Summary of Security Permissions for ASH Commands Table 6-1 ASH Commands Security Permissions (Access Levels) (continued) User Access Levels Command Description ffs file list R RW RWA Displays the files in flash memory. No See the “6.5.1 ffs file list Command” section on page 6-14. Yes Yes ffs file rename Renames flash file. No Yes Yes ffs format Formats flash file system. No Yes Yes ffs status display Displays current flash file system status.
Chapter 6 ASH Commands 6.1 Summary of Security Permissions for ASH Commands Table 6-1 ASH Commands Security Permissions (Access Levels) (continued) User Access Levels Command Description R RW RWA network host ftp FTPs to remote host. See the “7.1 FTP Command Line” section on page 7-1 No Yes Yes network host ping Pings remote host. No Yes Yes network host telnet Telnets to remote host No Yes Yes pdm busmode display Displays the bus mode (simplex or duplex). See the “6.2.
Chapter 6 ASH Commands 6.1 Summary of Security Permissions for ASH Commands Table 6-1 ASH Commands Security Permissions (Access Levels) (continued) User Access Levels Command Description R RW RWA snmp attribute set Sets an attribute. See the “6.6.3 snmp attribute set Command” section on page 6-16. No Yes Yes snmp host ip get Gets the IP address from host name. No Yes Yes snmp host name get Gets the host name from IP address. No Yes Yes snmp mib display Displays a MIB. See the “6.6.
Chapter 6 ASH Commands 6.1 Summary of Security Permissions for ASH Commands Table 6-1 ASH Commands Security Permissions (Access Levels) (continued) User Access Levels Command Description snmp table display R RW RWA No Displays a table. See the “6.6.13 snmp table display Command” section on page 6-22. See also “5.5.1 Display Trap Command” section on page 5-30, the “5.6.1 IP Address” section on page 5-32, and the “5.6.9 Alarm Entry” section on page 5-44. Yes Yes snmp table get Gets a table.
Chapter 6 ASH Commands 6.1 Summary of Security Permissions for ASH Commands Table 6-1 ASH Commands Security Permissions (Access Levels) (continued) User Access Levels Command Description R RW RWA user active list Lists the active users. See the “6.7.7 user active list Command” section on page 6-28. No Yes Yes user active message send Sends the message to all active users. See the “6.7.8 user active message send Command” section on page 6-28.
Chapter 6 ASH Commands 6.2 Configuration Commands 6.2 Configuration Commands The following commands are useful in configuring the ONS 15216 EDFA2: • 6.2.1 srom cfg boot display Command, page 6-7 • 6.2.2 srom cfg boot modify Command, page 6-7 • 6.2.3 srom cfg ip display Command, page 6-8 • 6.2.4 srom cfg ip modify Command, page 6-8 • 6.2.5 pdm busmode display Command, page 6-9 • 6.2.6 pdm cfg threshold bus display Command, page 6-9 • 6.2.7 gain gain display Command, page 6-9 • 6.2.
Chapter 6 ASH Commands 6.2.3 srom cfg ip display Command Example 6-2 srom cfg boot modify Command ash:hostname:ONS15216 EDFA2> srom cfg boot modify Boot Count = 2 Boot Record 0 type 1 TFTP 2 Filename = users/name/15216EdfaSw_x.x.x 15216EdfaSw_x.x.x Boot Record 1 type 2 Flash 2 Filename = orion427 15216EdfaSw_y.y.y Note Boot type 1 = TFTP and boot type 2 = Flash. 6.2.
Chapter 6 ASH Commands 6.2.5 pdm busmode display Command Example 6-4 srom cfg ip modify Command ash:hostname:ONS15216 EDFA2> srom cfg ip modify Shelf ID = 1 IP Address = 192.168.60.168 Subnet Mask = 255.255.255.0 Default Router IP Address = 192.168.60.254 Hostname = hostname SW Config = 0x00000000 6.2.5 pdm busmode display Command Command Types pdm busmode display Syntax Description pdm busmode display Displays power bus mode (simplex or duplex). 6.2.
Chapter 6 ASH Commands 6.2.8 voa power input display Command Example 6-6 gain gain display Command ash:hostname:ONS15216 EDFA2> gain gain display Target = 22000(mdB), Actual = 21985(mdB) 6.2.8 voa power input display Command Command Types voa power input display Syntax Description voa power input display Displays variable optical attenuator (VOA) power input. 6.3 Administrative Commands The following commands are useful in administering the ONS 15216 EDFA2: • 6.3.
Chapter 6 ASH Commands 6.3.3 help Command 6.3.3 help Command Command Types help Syntax Description help Displays a list of all CLI commands for current user security level. 6.3.4 history Command Command Types history Syntax Description history Displays a list of commands issued by the user during that specific session. See Example 6-7.
Chapter 6 ASH Commands 6.3.6 processor reset Command Parameters user_name (string[0..10]) name of user 6.3.6 processor reset Command Command Types processor reset Syntax Description processor reset Resets the processor on the ONS 15216 EDFA2. Although the performance of the amplifier is not affected, the user must log in again. 6.4 Shell Commands The following commands are useful in working with the shell within the ONS 15216 EDFA2 SNMP manager: • 6.4.1 shell lines set Command, page 6-12 • 6.
Chapter 6 ASH Commands 6.4.3 shell status display Command 6.4.3 shell status display Command Command Types shell status display Syntax Description shell status display Displays the current shell settings, including the number of shell lines, the number of shell rows, and whether the more setting is enabled or disabled. See Example 6-9. Example 6-9 shell status display Command ash:hostname:ONS15216 EDFA2> shell status display Shell Lines: 22 Shell Rows : 80 More : On 6.4.
Chapter 6 ASH Commands 6.5.1 ffs file list Command 6.5.1 ffs file list Command Command Types ffs file list Syntax Description ffs file list List the files on the ONS 15216 EDFA2 Flash memory. See Example 6-10. Example 6-10 ffs file list Command ash:hostname:ONS15216 EDFA2> ffs file list --------name-------15216EdfaSw_2.3.0 snmp.bak passwd snmp.cfg 15216EdfaSw_2.1.
Chapter 6 ASH Commands 6.6.1 snmp attribute get Command 6.6.1 snmp attribute get Command Command Types snmp attribute get Syntax Description snmp attribute get {IP_address | local} attribute_name index Accesses and displays a specific MIB attribute. See Example 6-11. Example 6-11 snmp attribute get Command ash:hostname:ONS15216 EDFA2> snmp attribute get local sysDescr attributes sysDescr "hostname, Hardware Rev B0, ONS15216 EDFA2, v2.1.
Chapter 6 ASH Commands 6.6.3 snmp attribute set Command Example 6-13 snmp attribute list Command ash:hostname:ONS15216 EDFA2> snmp attribute list local cerent15216EdfaAlarmID cerent15216EdfaAlarmID.1 = cerent15216EdfaAlarmID.2 = cerent15216EdfaAlarmID.3 = cerent15216EdfaAlarmID.4 = cerent15216EdfaAlarmID.5 = cerent15216EdfaAlarmID.6 = cerent15216EdfaAlarmID.7 = cerent15216EdfaAlarmID.8 = cerent15216EdfaAlarmID.9 = cerent15216EdfaAlarmID.
Chapter 6 ASH Commands 6.6.5 snmp mib get Command Syntax Description snmp mib display {IP_address | local} -all Displays all writable MIB attributes (or all accessible attributes if the -all option is used). 6.6.5 snmp mib get Command Command Types snmp mib get Syntax Description snmp mib get {IP_address | local} Displays all MIB attributes. The data is output in two columns. The first column lists the attributes and indices and the second column lists the data. See Example 6-15.
Chapter 6 ASH Commands 6.6.7 snmp row display Command sysName.0 = "sysname"; sysLocation.0 = ""; sysServices.0 = 0; sysORLastChange.0 = 135; sysORID.1 = { snmpBasicCompliance }; sysORID.2 = { rs232Compliance }; sysORDescr.1 = ""; sysORDescr.2 = ""; sysORUpTime.1 = 355925; sysORUpTime.2 = 355925; ifNumber.0 = 3; ifIndex.300 = 300; ifIndex.302 = 302; ifIndex.350 = 350; ifDescr.300 = "Intra-machine interface"; ifDescr.302 = "Ethernet Interface"; ifDescr.350 = "RS232 Interface"; ifType.
Chapter 6 ASH Commands 6.6.8 snmp row get Command cerent15216EdfaLOSThreshold = -2400; cerent15216EdfaLOSHysteresis = 100; cerent15216EdfaCtmpMin = 5; cerent15216EdfaCtmpMinHysteresis = 1; cerent15216EdfaCtmpMax = 65; cerent15216EdfaCtmpMaxHysteresis = 1; cerent15216EdfaCLEI = "CLEI"; cerent15216EdfaPowerBusMode = duplex; cerent15216EdfaPowerBusDCVoltageMin = 480; cerent15216EdfaPowerBusDCVoltageMax = 570; cerent15216EdfaALSMode = enabled; 6.6.
Chapter 6 ASH Commands 6.6.10 snmp subtree display Command 6.6.10 snmp subtree display Command Command Types snmp subtree display Syntax Description snmp subtree display {IP_address | local} subtree Displays the attributes below a node in a SNMP tree. See Example 6-20. Example 6-20 snmp subtree display Command ash:hostname:ONS15216 EDFA2> snmp subtree display local cerent15216EdfaCommunityEntry BEGIN-HOST "testhost" 0.0.0.0 "private" CLASS CERENT-15216-EDFA-MIB.
Chapter 6 ASH Commands 6.6.12 snmp subtree list Command sysORUpTime index sysORIndex attributes sysORID sysORDescr sysORUpTime 391985 2 rs232Compliance "" 391990 3 index ifIndex attributes ifDescr ifType ifMtu ... 300 "Intra-machine interface" softwareLoopback 0 6.6.12 snmp subtree list Command Command Types snmp subtree list Syntax Description snmp subtree list {IP_address | local} Lists the attributes below a node in a SNMP tree. See Example 6-22.
Chapter 6 ASH Commands 6.6.13 snmp table display Command sysObjectID.0 = { cerent15216EdfaNode }; sysUpTime.0 = 35913255; sysContact.0 = ""; sysName.0 = "sysname"; sysLocation.0 = ""; sysServices.0 = 0; sysORLastChange.0 = 120; sysORID.1 = { snmpBasicCompliance }; ... 6.6.13 snmp table display Command Command Types snmp table display Syntax Description snmp table display {IP_address | local} Displays table data for the ONS 15216 EDFA2. Example 6-23 displays the command entered without a table.
Chapter 6 ASH Commands 6.6.14 snmp table get Command sysORLastChange = 120; }; 6.6.14 snmp table get Command Command Types snmp table get Syntax Description snmp table get {IP_address | local} table Accesses table data. See Example 6-24. Example 6-24 snmp table get Command ash:hostname:ONS15216 EDFA2> snmp table get local system attributes sysDescr "hostname, Hardware Rev A1, ONS15216 EDFA2, v2.3.
Chapter 6 ASH Commands 6.6.16 snmp tree attribute list Command 6.6.16 snmp tree attribute list Command Command Types snmp tree attribute list Syntax Description snmp tree attribute list Lists all the attributes implemented by the SNMP agent. See Example 6-26.
Chapter 6 ASH Commands 6.7.1 user entry create Command 6.7.1 user entry create Command Command Types user entry create Syntax Description user entry create name user_mode Creates a new user. The parameters required to create a new user are user name, access level, and password. The user_mode (access privilege level) is set by entering either read, read_write, or read_write_admin. See Table 6-1 on page 6-1 for the command privileges of each user level.
Chapter 6 ASH Commands 6.7.3 user entry delete Command New Password = Confirm New Password = 6.7.3 user entry delete Command Command Types user entry delete Syntax Description user entry delete username Delete users. See Example 6-30. Example 6-30 user entry delete Command ash:hostname:ONS15216 EDFA2> user entry delete jdoe 6.7.
Chapter 6 ASH Commands 6.7.6 user passwd set Command Inactivity is the length of time of user inactivity before the user is automatically logged off. Type the user inactivity modify command to change the inactivity values. Type the user inactivity display command to display the current inactivity values. The default inactivity values for the read, read_write, and read_write_admin user access levels are 60, 30, and 15 minutes, respectively. Possible values are 0 to 99 (in minutes).
Chapter 6 ASH Commands 6.7.7 user active list Command 6.7.7 user active list Command Command Types user active list Syntax Description user active list Displays a list of the active users. See Example 6-36. Example 6-36 user active list Command ash:hostname:ONS15216 EDFA2> user active list Users CISCO15 6.7.8 user active message send Command Command Types user active message send Syntax Description user active message send ["message"] Sends a message to all current users on the system.
Chapter 6 ASH Commands 6.8.2 snmp table display local cerent15216EdfaCommTrapEntry Command Example 6-38 snmp table display local entPhysicalEntry Command ash:hostname:ONS15216 EDFA2> snmp table display local entPhysicalEntry CLASS ENTITY-MIB.
Chapter 6 ASH Commands 6.9 Restore Commands }; 6.9 Restore Commands 6.9.1 backup system Command Command Types backup system Syntax Description backup system filename Creates a backup file on the FFS with the configuration information of the ONS 15216 EDFA2.
Chapter 6 ASH Commands 6.10.2 manufacturer restore defaults all Command Syntax Description manufacturer restore defaults passwords Restores the manufacturing factory default passwords to the ONS 15216 EDFA2. Note If the password for the CISCO15 user is lost and there are not other users with read_write_admin access level in the system, the password for CISCO15 can be reset by following the procedure in “10.2.9 Lost Password” section on page 10-12. 6.10.
Chapter 6 ASH Commands 6.10.2 manufacturer restore defaults all Command Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
C H A P T E R 7 File Transfers This chapter discusses how to get and send image and configuration files between an FTP or TFTP server and the ONS 15216 EDFA2. 7.1 FTP Command Line To start an FTP session, use the following command: ash:hostname:ONS15216 EDFA2> network host ftp FTP_server_IP_address To log off, type quit at the FTP command line. This command disconnects the user from the remote server and exits the FTP shell. 7.1.
Chapter 7 File Transfers 7.1.2 Example of FTP to a Remote Server Step 5 At the ftp prompt, change directories to where the remote file is located using the following command: ftp> cd /Directory_of_FTP_site Step 6 At the ftp prompt, enter the following command: ftp> type i The ONS 15216 EDFA2 should respond as follows: type set to BINARY Step 7 At the ftp prompt, get the file from the remote server using the following command: ftp> get 15216EdfaSw_2.x.
Chapter 7 File Transfers 7.1.3 FTP Commands The ONS 15216 EDFA2 should respond as follows: 230 User FTP_username logged in.
Chapter 7 File Transfers 7.2 TFTP File Transfer type t Set type to t, either I image/binary or A ascii. 7.2 TFTP File Transfer TFTP can also be used to transfer files to and from an external server. See the sections below for examples of transferring a database backup file from and to and external server. 7.2.1 Example of TFTP from a Remote Server To transfer a file from a TFTP server, see Example 7-2, which shows a database backup file transfer.
C H A P T E R 8 Provisioning with TL1 This chapter discusses the provisioning procedures for the Cisco ONS 15216 EDFA2 using TL1 commands in the TL1 shell. See Chapter 4, “Provisioning with ASH and SNMP” for provisioning information using command-line SNMP and proprietary commands in the ASH shell. The provisioning procedure for the ONS 15216 EDFA2 in the TL1 shell is as follows: 1. 8.1 Log In via RS-232 (EIA/TIA-232) Port Using HyperTerminal, page 8-1 2. 8.2 Set IP Address, page 8-3 3. 8.
Chapter 8 Provisioning with TL1 8.1 Log In via RS-232 (EIA/TIA-232) Port Using HyperTerminal If the ONS 15216 EDFA2 has been set to ASH shell, this step may is be required to proceed in TL1 shell. When in ASH shell, the screens opens to a multi-line login screen beginning with -- LOGIN--- and with the cursor positioned in the Username line. To change to the TL1 shell, log in using the procedure in the “4.
Chapter 8 Provisioning with TL1 8.2 Set IP Address An EIA/TIA-232 link to the ONS 15216 EDFA2 is established. The user can now provision the ONS 15216 EDFA2. 8.2 Set IP Address Before connecting the ONS 15216 EDFA2 to a LAN, it is mandatory to set the ONS 15216 EDFA2 IP address through a local serial communication interface using the RS-232 (EIA/TIA-232) port on the front of the module.
Chapter 8 Provisioning with TL1 8.4 Set Date and Time Step 4 Log in again using Step 4 through Step 6 in the “8.1 Log In via RS-232 (EIA/TIA-232) Port Using HyperTerminal” section on page 8-1. You are now connected to the ONS 15216 EDFA2 via Telnet. 8.4 Set Date and Time Use the ED-DAT command (see the “9.6.9 ED-DAT” section on page 9-19) to set the date and time. A time zone cannot be set using TL1.
Chapter 8 Provisioning with TL1 8.7 Set Gain Example 8-6 Verifying the Amplifier Operations Status Using TL1 sidtidname:ONS15216 EDFA2> RTRV-DWDM::ALL:122; sidtidname 2002-07-11 10:20:05 122 COMPLD "1:INPWRMICROW=264,INPWRDBM=-1578,OUTPWRMILLIW=172,OUTPWRDBM=237,PUMP1CTRLMODE=GAINTEMP ,PUMP1CTRLVALUE=169,PUMP2CTRLMODE=GAINTEMP,PUMP2CTRLVALUE=169,OVERALLGAIN=169,PREATT=60" ; M The input power should be consistent with the input power measured during the optical connection procedure. See the “3.3.
Chapter 8 Provisioning with TL1 8.
Chapter 8 Provisioning with TL1 8.8 Set Alarm Thresholds M sidtidname 2002-07-11 11:16:10 125 COMPLD "EQPT:MAXCTMP,,,65" "EQPT:MAXCTMPHYST,,,5" "EQPT:MINCTMP,,,10" "EQPT:MINCTMPHYST,,,2" "PWR-A:PWRBUSMIN,,,420" "PWR-A:PWRBUSMAX,,,570" "PWR-B:PWRBUSMIN,,,420" "PWR-B:PWRBUSMAX,,,570" ; To set the alarm thresholds, use the SET-TH-DWDM and SET-TH-EQPT commands (see the “9.6.46 SET-TH-DWDM” section on page 9-71 and the “9.6.47 SET-TH-EQPT” section on page 9-72).
Chapter 8 Provisioning with TL1 8.8 Set Alarm Thresholds Table 8-1 Attribute Alarm Threshold Attribute Definitions Variable Definition Syntax Maximum Access Description Read-write Alarm notifies operations personnel if the optical input signal of the ONS 15216 EDFA2 drops below a level that impacts proper operation of optical network. Set this attribute at a value that is appropriate for the intended application so that the alarm condition is meaningful.
Chapter 8 Provisioning with TL1 8.8 Set Alarm Thresholds Table 8-1 Alarm Threshold Attribute Definitions (continued) Attribute Variable Definition Maximum Access Syntax Description LPOUTDEV Read-write Can be disregarded when operating Loss of output Integer amplifier in factory default Constant power (0 to 1000, Gain Temperature Compensated mode. deviation 200 Deviation object is only valid when default) amplifier is used in Constant Output Power and Idle modes.
Chapter 8 Provisioning with TL1 8.8 Set Alarm Thresholds Table 8-1 Alarm Threshold Attribute Definitions (continued) Attribute Variable Definition Syntax Maximum Access Description MINCTMP Minimum case temperature Integer Read-write Alarm notifies operations personnel if (–10 to 10, the case temperature of the ONS 15216 –5 default) EDFA2 drops below a level that impacts proper operation of the optical network.
Chapter 8 Provisioning with TL1 8.9 Set Password Table 8-1 Alarm Threshold Attribute Definitions (continued) Attribute PWRBUSMIN Variable Definition Power bus minimum voltage Maximum Access Syntax Integer (350 to 700, 420 default) Description Read-write Minimum allowable power bus DC voltage. The default minimum power bus voltage is set at –42 VDC. Valid entries are between 350 and 700 and are in negative volts times 10. For example, if the voltage required is –40 VDC, the power bus setting is 400.
Chapter 8 Provisioning with TL1 8.10 Add Users Example 8-9 Changing Current User’s Password Using TL1 sidtidname:ONS15216 EDFA2> ED-PID::CISCO15:130::OLDPW,*****; Note The default user name for the administrator level is CISCO15 with no default password. 8.10 Add Users Use the ENT-USER-SECU command (see the “9.6.
Chapter 8 Provisioning with TL1 8.13 Restore System Configuration Amp01 2004-03-01 17:22:43 * þ12 REPT ALM EQPT þ"EQPT:MN,DBBACKUP,NSA,3-1,17-22-43,,:\"Database Backup In Progress\"" ; Amp01 2004-03-01 17:22:45 M þ123 COMPLD þ/* CPY-MEM */ ; Amp01 2004-03-01 17:22:46 A þ13 REPT ALM EQPT þ"EQPT:CL,DBBACKUP,NSA,3-1,17-22-46,,:\"Database Backup In Progress\"" ; Step 2 If desired, use the COPY-RFILE command to copy the file to a remote server. See the “9.6.5 COPY-RFILE” section on page 9-15. 8.
Chapter 8 Provisioning with TL1 8.13 Restore System Configuration Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.
C H A P T E R 9 TL1 Commands This chapter provides the details of TL1 commands supported by the Cisco ONS 15216 EDFA2. This chapter also maps various TL1 command parameters to their SNMP counterpart attributes in the ONS 15216 EDFA2 MIB (CERENT-15216-EDFA-MIB.mib). 9.1 Connection to the ONS 15216 EDFA2 The ONS 15216 EDFA2 system supports up to ten simultaneous Telnet connections via the Ethernet LAN port. TL1 sessions are available on TCP/IP port 3082 for raw TL1 and/or port 3083 for TL1 over Telnet.
Chapter 9 TL1 Commands 9.2.2 Command Code Modifier (ccm) 9.2.2 Command Code Modifier (ccm) The command code modifier (ccm) identifies the object of the action being applied by the verb of the TL1 command. Some command code modifiers for the ONS 15216 EDFA2 are described in Table 9-1. Table 9-1 Command Code Modifiers ccm Description DWDM Optical parameters. EQPT General parameters of the ONS 15216 EDFA2. FXFR File transfer parameters. 9.2.
Chapter 9 TL1 Commands 9.4 Summary of Autonomous Alarms and Messages Table 9-3 TL1 Notation Symbols Symbol Meaning Description [] Optional expression Square brackets indicate the parameters are optional. An optional parameter means that if a user inputs an empty field for an optional parameter, then a default value (or a default action) will be substituted automatically in the transmitted input field. The default value, or null value, is defined in the parameter descriptions of the messages.
Chapter 9 TL1 Commands 9.
Chapter 9 TL1 Commands 9.
Chapter 9 TL1 Commands 9.
Chapter 9 TL1 Commands 9.5 Summary of Security Permissions for TL1 Commands Table 9-7 TL1 Commands and Messages Security Permissions (Access Levels) User Access Levels Command or Message Description R RW RWA ACT-USER Activates user session (login). See the “9.6.1 ACT-USER” section on page 9-10. Yes Yes Yes ALW-MSG-ALL Allows automatic (REPT) messages. See the “9.6.2 ALW-MSG-ALL” section on page 9-11. Yes Yes Yes APPLY Applies software cutover. See the “9.6.3 APPLY” section on page 9-14.
Chapter 9 TL1 Commands 9.5 Summary of Security Permissions for TL1 Commands Table 9-7 TL1 Commands and Messages Security Permissions (Access Levels) (continued) User Access Levels Command or Message Description R RW RWA ENT-USER-SECU Enters new user. See the “9.6.15 ENT-USER-SECU” section on page 9-24. No No Yes INH-MSG-ALL Inhibits some automatic messages. See the “9.6.16 INH-MSG-ALL” section on page 9-25. Yes Yes Yes INIT-SYS Initializes (reboots) system. No See the “9.6.
Chapter 9 TL1 Commands 9.5 Summary of Security Permissions for TL1 Commands Table 9-7 TL1 Commands and Messages Security Permissions (Access Levels) (continued) User Access Levels Command or Message Description R RW RWA RTRV-ATTR-DWDM Retrieves alarm severity of optical alarms. See the “9.6.27 RTRV-ATTR-DWDM” section on page 9-46. Yes Yes Yes RTRV-ATTR-EQPT Yes Retrieves alarm severity of general alarms. See the “9.6.28 RTRV-ATTR-EQPT” section on page 9-48.
Chapter 9 TL1 Commands 9.6 TL1 Commands and Autonomous Messages Table 9-7 TL1 Commands and Messages Security Permissions (Access Levels) (continued) User Access Levels Command or Message Description R RW RWA RTRV-TH-DWDM Retrieves optical thresholds. See the “9.6.39 RTRV-TH-DWDM” section on page 9-63. Yes Yes Yes RTRV-TH-EQPT Retrieves general thresholds. See the “9.6.40 RTRV-TH-EQPT” section on page 9-64. Yes Yes Yes RTRV-TOD Retrieves date and time. See the “9.6.
Chapter 9 TL1 Commands 9.6.2 ALW-MSG-ALL Syntax Description ACT-USER:[]::::; Example 9-1 ACT-USER Command Amp01:ONS15216 EDFA2> ACT-USER:Amp01:JOE:123::***; Table 9-8 ACT-USER Syntax Description Parameter Syntax Description uid string The user’s identifier (user name). Can be any combination of up to 10 alphanumeric characters. pid string The user’s private identifier (password).
Chapter 9 TL1 Commands 9.6.2 ALW-MSG-ALL Table 9-9 Parameter ALW-MSG-ALL Syntax Description (continued) Syntax condtype Description Condition type of the alarm or event that is to be allowed. (Maps to cerent15216EdfaLogEventID.) ALL maps to all types. A null maps to none of the types, i.e., with a null, all existing condtype inhibitions are kept unchanged. Possible condtype and corresponding conddescr (in quotes) are: LOS “Loss of Signal” (input power) alarm (cerent15216EdfaAlarmLpin).
Chapter 9 TL1 Commands 9.6.2 ALW-MSG-ALL Table 9-9 Parameter ALW-MSG-ALL Syntax Description (continued) Syntax Description ALSCHGD “ALS (automatic laser shutdown) Changed” (cerent15216EdfaALSModeEnable). CONFIGSAVED “Config Saved”. CTRLMODE1 “Pump1 Control Mode Changed” (cerent15216EdfaControlMode for cerent15216EdfaPumpCfgPumpNumber=1). CTRLMODE2 “Pump2 Control Mode Changed” (cerent15216EdfaControlMode for cerent15216EdfaPumpCfgPumpNumber=2).
Chapter 9 TL1 Commands 9.6.3 APPLY Table 9-9 ALW-MSG-ALL Syntax Description (continued) Parameter Syntax Description MINCTMPHYSTCHGD “Min Ctmp (case temperature) Hysteresis Changed” (cerent15216EdfaCtmpMinHysteresis). PREATTCHGD “Pre-attenuation Changed” (cerent15216EdfaVariableGainPreAttenuation). PWRBUSMAXCHGD “Power Bus Max (voltage) Changed” (cerent15216EdfaPowerBusDCVoltageMax). PWRBUSMINCHGD “Power Bus Min (voltage) Changed” (cerent15216EdfaPowerBusDCVoltageMin).
Chapter 9 TL1 Commands 9.6.5 COPY-RFILE Syntax Description CANC-USER:[]::; Example 9-4 CANC-USER Command Amp01:ONS15216 EDFA2> CANC-USER:Amp01:JOE:100; Table 9-10 CANC-USER Syntax Description Parameter Syntax Description uid string The user’s identifier (user name). 9.6.5 COPY-RFILE Command Types COPY-RFILE Copies a local or remote file to the persistent memory (flash file system) on the ONS 15216 EDFA2.
Chapter 9 TL1 Commands 9.6.6 CPY-MEM Table 9-11 COPY-RFILE Syntax Description Parameter Syntax type src, dest Description Specifies the type and direction of transfer. Possible values are: RFR Restore a file from remote server to the ONS 15216 EDFA2’s flash file system. RFBU Backup a file from the ONS 15216 EDFA2’s flash file system to the remote server (overwrite is always YES for this type).
Chapter 9 TL1 Commands 9.6.6 CPY-MEM Example 9-6 CPY-MEM Command and Response (Copy LOG File from RAM as aolog.txt on FFS) Amp01:ONS15216 EDFA2> CPY-MEM:Amp01::123::LOG,MEM,; Amp01 2002-07-16 09:49:01 M 123 COMPLD /* CPY-MEM */ ; Example 9-7 CPY-MEM Command and Response (Copy LOG File from RAM as aolog.txt on FFS using Null) Amp01:ONS15216 EDFA2> CPY-MEM:Amp01::123::,,; Amp01 2002-07-16 09:46:01 M 123 COMPLD /* CPY-MEM */ ; Example 9-8 CPY-MEM Command and Response (Copy aolog.
Chapter 9 TL1 Commands 9.6.7 DLT-RFILE Table 9-12 CPY-MEM Syntax Description (continued) Parameter Syntax Description tofile CFG ONS 15216 EDFA2 system configuration in memory. The system must be rebooted using INI-SYS for changes to the system configuration to take effect. any other string The name string of the destination file. A null value is valid only when fromfile is LOG or null and fromdev is MEM or null. When null is valid, the system log file (LOG) is saved as aolog.txt.
Chapter 9 TL1 Commands 9.6.9 ED-DAT Example 9-10 DLT-USER-SECU Command Amp01:ONS15216 EDFA2> DLT-USER-SECU:Amp01:jsmith:123; Table 9-14 DLT-USER-SECU Syntax Description Parameter Syntax Description uid string The user identifier (user name) of the existing user to be removed. 9.6.9 ED-DAT Command Types ED-DAT Edits the date and/or time of the ONS 15216 EDFA2.
Chapter 9 TL1 Commands 9.6.10 ED-DWDM Example 9-12 ED-DWDM Command Amp01:ONS15216 EDFA2> ED-DWDM:Amp01:ALL:123:::PUMP1CTRLMODE=GAINTEMP; Table 9-16 ED-DWDM Syntax Description Parameter Syntax aid 1 and ALL have same input effect. 1 Directly affecting the optical signal. ALL Any or all of the preceding (command input only). pump1ctrlmode, pump2ctrlmode Pump 1 or pump 2 control mode (maps to cerent15216EdfaPumpCfgControlMode for the corresponding pump).
Chapter 9 TL1 Commands 9.6.11 ED-EQPT Table 9-16 ED-DWDM Syntax Description (continued) Parameter Syntax Description preatt 10 - 100 Gain pre-attenuation value in units of 10 dB when mode is other than GAINTEMP (sets cerent15216EdfaVariableGainPreAttenuation). als Automatic Laser Shutdown (sets cerent15216EdfaALSModeEnable). ENABLED When input power (signal) goes below the LOSTH value, the laser pumps are shut down until the input signal is restored beyond the value of LOSHYST.
Chapter 9 TL1 Commands 9.6.12 ED-NE-GEN Edit general parameters of the ONS 15216 EDFA2. Edits ONS 15216 EDFA2’s sid (source identifier)/tid (target identifier), IP address, IP mask, and IP address of the default router. The ONS 15216 EDFA2 needs to be manually rebooted for the changes to take effect. (Use the INIT-SYS command to manually reboot after changing parameters.) Also edits the boot table content: to return to the TL1 shell from the ASH shell, use the ASH command shell type modify tl1 (step 3.
Chapter 9 TL1 Commands 9.6.13 ED-PID Table 9-18 ED-NE-GEN Syntax Description (continued) Parameter Syntax cli Description Default type of command line interface for all EIA/TIA-232 and default telnet port user sessions with the ONS 15216 EDFA2. Possible values are: TL1 TL1shell interface (manufacturer default). ASH ASH shell interface – ONS 15216 EDFA2’s native interface. 9.6.13 ED-PID Command Types ED-PID Edits password.
Chapter 9 TL1 Commands 9.6.15 ENT-USER-SECU Example 9-16 ED-USER-SECU Command Amp01:ONS15216 EDFA2> ED-USER-SECU:Amp01:jsmith:123::johnsmith,****,,RW; Table 9-20 ED-USER-SECU Syntax Description Parameter Syntax Description uid string The user identifier (user name) of the existing user whose parameters are being modified. newuid string New user identifier (user name) for the existing user. Can be any combination of up to 10 alphanumeric characters.
Chapter 9 TL1 Commands 9.6.16 INH-MSG-ALL Table 9-21 ENT-USER-SECU Syntax Description (continued) Parameter Syntax al Description Access level of the user. See “9.5 Summary of Security Permissions for TL1 Commands” section on page 9-6 for access level permissions. R Read only privileges. RW Read and write privileges. RWA Read, write, and administrative privileges. 9.6.
Chapter 9 TL1 Commands 9.6.16 INH-MSG-ALL Table 9-22 INH-MSG-ALL Syntax Description (continued) Parameter Syntax condtype Description Condition type of the alarm or event that is to be inhibited (maps to cerent15216EdfaLogEventID). ALL maps to all types. A null maps to none of the types, i.e., with a null, all existing condtype allowances are kept unchanged. Possible condtype and corresponding conddescr (in quotes) are: LOS “Loss of Signal” (input power) alarm (cerent15216EdfaAlarmLpin).
Chapter 9 TL1 Commands 9.6.16 INH-MSG-ALL Table 9-22 INH-MSG-ALL Syntax Description (continued) Parameter Syntax Description LCRNT2 “Excessive Pump2 Current” alarm (cerent15216EdfaAlarmLcrnt2). LTMP1 “Excessive Pump1 Temperature” alarm (cerent15216EdfaAlarmLtmp1). LTMP2 “Excessive Pump2 Temperature” alarm (cerent15216EdfaAlarmLtmp2). POWERBUSA “Power Bus A (voltage) Alarm” (cerent15216EdfaAlarmPowerBusA). POWERBUSB “Power Bus B (voltage) Alarm” (cerent15216EdfaAlarmPowerBusB).
Chapter 9 TL1 Commands 9.6.17 INIT-SYS Table 9-22 INH-MSG-ALL Syntax Description (continued) Parameter Syntax Description LPOUTCHGD “Loss of Output Power Setpoint Changed” (cerent15216EdfaLpoutSetpoint). LPOUTDEVCHGD “Lpout (loss of output power) Deviation Changed” (cerent15216EdfaLpoutDeviation). LPOUTHYSTCHGD “Lpout (loss of output power) Hysteresis Changed” (cerent15216EdfaLpoutHysteresis). MAXCTMPCHGD “Max Case Temperature Changed” (cerent15216EdfaCtmpMax).
Chapter 9 TL1 Commands 9.6.18 REPT ALM DWDM Example 9-19 INIT-SYS Command Amp01:ONS15216 EDFA2> INIT-SYS:Amp01:ALL:1234::1; Table 9-23 INIT-SYS Syntax Description Parameter aid ph Syntax string EQPT ALL integer 1 Description EQPT and ALL have same input effect. Level of initialization. Always 1. 9.6.18 REPT ALM DWDM Command Types REPT ALM DWDM Reports when a DWDM alarm is logged or cleared (derived from cerent15216EdfaAlarmState).
Chapter 9 TL1 Commands 9.6.18 REPT ALM DWDM Table 9-24 REPT ALM DWDM Syntax Description (continued) Parameter Syntax almcde atag Description The alarm severity code for the TL1 message. Possible values are: *C Critical alarm. ** Major alarm. * Minor alarm. A No alarm. Occurs only when ntfncde is NA. 0 - 999 An integer between 0 and 999 used as a sequence number in autonomous messages. Always 1. 1 Directly affecting the optical signal.
Chapter 9 TL1 Commands 9.6.19 REPT ALM EQPT 9.6.19 REPT ALM EQPT Command Types REPT ALM EQPT Reports when a general alarm (not directly affecting optical signal) is logged or cleared (derived from cerent15216EdfaAlarmState).
Chapter 9 TL1 Commands 9.6.19 REPT ALM EQPT Table 9-25 REPT ALM EQPT Syntax Description (continued) Parameter Syntax condtype date Description Condition type identifies the type of alarm (maps to cerent15216EdfaLogEventID). Possible condtype and corresponding conddescr (in quotes) are: CTMP “Case Temperature Out of Range” alarm (cerent15216EdfaAlarmCtmp). DBBACKUP “Database Backup In Progress” (cerent15216EdfaOpDbBackup). DBRESTORE “Database Restore In Progress” (cerent15216EdfaOpDbRestore).
Chapter 9 TL1 Commands 9.6.20 REPT EVT DWDM / REPT EVT EQPT 9.6.20 REPT EVT DWDM / REPT EVT EQPT Command Types REPT EVT DWDM or REPT EVT EQPT Reports autonomous events. Reports when an event is logged.
Chapter 9 TL1 Commands 9.6.20 REPT EVT DWDM / REPT EVT EQPT Table 9-26 REPT EVT DWDM / REPT EVT EQPT Syntax Description (continued) Parameter Syntax Description conddescr Detailed text description of the event. The conddescr is 1 to 64 characters of ASCII text. See condtype below. condtype (ccm) Condition type identifies the type of event (maps to cerent15216EdfaLogEventID).
Chapter 9 TL1 Commands 9.6.20 REPT EVT DWDM / REPT EVT EQPT Table 9-26 REPT EVT DWDM / REPT EVT EQPT Syntax Description (continued) Parameter Syntax Description DBBACKUP (EQPT) “Database Backup In Progress” alarm (cerent15216EdfaOpDbBackup). DBBKRTCRCERR (EQPT) “Database Backup/Restore CRC Error” (cerent15216EdfaActionOpResult). DBBKRTERR (EQPT) “Database Backup/Restore Error” (cerent15216EdfaActionOpResult).
Chapter 9 TL1 Commands 9.6.21 REPT EVT FXFR Table 9-26 REPT EVT DWDM / REPT EVT EQPT Syntax Description (continued) Parameter Syntax Description PWRBUSMODE (EQPT) “Power Bus Mode Changed” (cerent15216EdfaPowerBusMode). SEVERITYCHGD (EQPT) “Severity Changed from CR|MJ|MN|NA|NR to CR|MJ|MN|NA|NR”. SFTWDOWN (EQPT) “Software Download In Progress” alarm (cerent15216EdfaOpLoad). SFTWDOWNERR (EQPT) “Software Load Error”. SOFTWARERESET (EQPT) “Software Reset” (cerent15216EdfaOpReset).
Chapter 9 TL1 Commands 9.6.22 RTRV-ALM-ALL Example 9-25 REPT EVT FXFR Message A Amp01 2001-06-18 14:48:44 141 REPT EVT FXFR "EQPT:VMRLS20.EXE,COMPLD,SUCCESS,8051" ; Table 9-27 REPT EVT FXFR Syntax Description Parameter Syntax Description atag 0 - 999 An integer between 0 and 999 used as a sequence number in autonomous messages. aid Always EQPT. EQPT General parameters of the ONS 15216 EDFA2. bytes_xfrd Total number of bytes transferred when fxfr_status is COMPLD. See fxfr_status below.
Chapter 9 TL1 Commands 9.6.
Chapter 9 TL1 Commands 9.6.22 RTRV-ALM-ALL Table 9-28 RTRV-ALM-ALL Syntax Description (continued) Parameter Syntax condtype (ccm) date Description Condition type identifies the type of alarm (maps to cerent15216EdfaLogEventID). Possible condtype and corresponding conddescr (in quotes) are: LOS (DWDM) “Loss of Signal” (input power) alarm (cerent15216EdfaAlarmLpin). GAIN (DWDM) “Gain Out of Range” alarm (cerent15216EdfaAlarmGain).
Chapter 9 TL1 Commands 9.6.23 RTRV-ALM-DWDM Table 9-28 RTRV-ALM-ALL Syntax Description (continued) Parameter Syntax Description sid string Source identifier uniquely identifies the source of a TL1 autonomous command. srveff time Effect on service. Possible values are: SA Service affecting. NSA Non-service affecting. hh:mm:ss Time of origination of TL1 message. 9.6.23 RTRV-ALM-DWDM Command Types RTRV-ALM-DWDM Generates a report on active DWDM alarms.
Chapter 9 TL1 Commands 9.6.24 RTRV-ALM-EQPT Table 9-29 RTRV-ALM-DWDM Syntax Description (continued) Parameter Syntax condtype date Description Condition type identifies the type of alarm (maps to cerent15216EdfaLogEventID). Possible condtype and corresponding conddescr (in quotes) are: LOS “Loss of Signal” (input power) alarm (cerent15216EdfaAlarmLpin). GAIN “Gain Out of Range” alarm (cerent15216EdfaAlarmGain). LPOUT “Loss of Output Power” alarm (cerent15216EdfaAlarmLpout).
Chapter 9 TL1 Commands 9.6.24 RTRV-ALM-EQPT Example 9-28 RTRV-ALM-EQPT Command and Response Amp01:ONS15216 EDFA2> RTRV-ALM-EQPT:Amp01:ALL:229::MN,LCRNT1,NSA,,; Amp01 2002-06-20 14:30:00 M 229 COMPLD "EQPT:MN,LCRNT1,NSA,6-20,14-25-30,,:\"Excessive Pump1 Current\"" ; Table 9-30 RTRV-ALM-EQPT Syntax Description Parameter Syntax aid Description Possible valies are: EQPT General parameters of the ONS 15216 EDFA2. PWR-A Affecting Power Bus A. PWR-B Affecting Power Bus B.
Chapter 9 TL1 Commands 9.6.25 RTRV-AO Table 9-30 RTRV-ALM-EQPT Syntax Description (continued) Parameter Syntax ntfncde Description Notification code (maps to cerent15216EdfaAlarmPriority). Possible values are: CR Critical alarm. MJ Major alarm. MN Minor alarm. NULL Defaults to ALL. ocrdat m-d Date (month-day) of the event occurrence (derived from cerent15216EdfaDateAndTimeString).
Chapter 9 TL1 Commands 9.6.26 RTRV-ATTR-ALL Table 9-31 RTRV-AO Syntax Description Parameter Syntax Description atagseq atag is an integer between 0 and 999 used by the ONS 15216 EDFA2 to sequentially number in autonomous messages. atagseq can be a single atag number or a range of numbers in the form AA&&BB, where AA and BB are integers. If null, the 20 latest messages will be retrieved. msgtype Type of message. A null value means both ALM and EVT. ALM Alarm message. EVT Event message. 9.6.
Chapter 9 TL1 Commands 9.6.26 RTRV-ATTR-ALL Table 9-32 RTRV-ATTR-ALL Syntax Description Parameter Syntax aid Description Possible values are: 1 Directly affecting the optical signal. EQPT General parameters of the ONS 15216 EDFA2. PWR-A Affecting Power Bus A. PWR-B Affecting Power Bus B. ALL Any or all of the preceding (command input only). NULL Defaults to ALL. ntfncde Notification code (maps to cerent15216EdfaAlarmPriority). Possible values are: CR Critical alarm. MJ Major alarm.
Chapter 9 TL1 Commands 9.6.27 RTRV-ATTR-DWDM Table 9-32 RTRV-ATTR-ALL Syntax Description (continued) Parameter Syntax condtype Description Condition type identifies the type of alarm (maps to cerent15216EdfaLogEventID). Possible condtype and corresponding conddescr (in quotes) are: LOS (DWDM) “Loss of Signal” (input power) alarm (cerent15216EdfaAlarmLpin). GAIN (DWDM) “Gain Out of Range” alarm (cerent15216EdfaAlarmGain). LPOUT (DWDM) “Loss of Output Power” alarm (cerent15216EdfaAlarmLpout).
Chapter 9 TL1 Commands 9.6.27 RTRV-ATTR-DWDM ",:,,,," ; Example 9-31 RTRV-ATTR-DWDM Command and Response Amp01:ONS15216 EDFA2> RTRV-ATTR-DWDM:Amp01:1:229::MJ,,,,; Amp01 2002-06-20 14:30:00 M 229 COMPLD "1,DWDM:MJ,LOS,,," "1,DWDM:MJ,GAIN,," "1,DWDM:MJ,LPOUT,," ; Table 9-33 RTRV-ATTR-DWDM Syntax Description Parameter Syntax aid Description 1 and ALL have same input effecct. 1 Directly affecting the optical signal. ALL Any or all of the preceding (command input only).
Chapter 9 TL1 Commands 9.6.28 RTRV-ATTR-EQPT 9.6.28 RTRV-ATTR-EQPT Command Types RTRV-ATTR-EQPT Retrieves the notification codes for the eqiupment attributes.
Chapter 9 TL1 Commands 9.6.29 RTRV-COND-ALL Table 9-34 RTRV-ATTR-EQPT Syntax Description (continued) Parameter Syntax condtype Description Condition type identifies the type of alarm (maps to cerent15216EdfaLogEventID). Possible condtype and corresponding conddescr (in quotes) are: CTMP “Case Temperature Out of Range” alarm (cerent15216EdfaAlarmCtmp). DBBACKUP “Database Backup In Progress” (cerent15216EdfaOpDbBackup). DBRESTORE “Database Restore In Progress” (cerent15216EdfaOpDbRestore).
Chapter 9 TL1 Commands 9.6.
Chapter 9 TL1 Commands 9.6.29 RTRV-COND-ALL Table 9-35 RTRV-COND-ALL Syntax Description (continued) Parameter Syntax condtype (ccm) date Description Condition type identifies the type of alarm (maps to cerent15216EdfaLogEventID). Possible condtype and corresponding conddescr (in quotes) are: LOS (DWDM) “Loss of Signal” (input power) alarm (cerent15216EdfaAlarmLpin). GAIN (DWDM) “Gain Out of Range” alarm (cerent15216EdfaAlarmGain).
Chapter 9 TL1 Commands 9.6.30 RTRV-COND-DWDM Table 9-35 RTRV-COND-ALL Syntax Description (continued) Parameter Syntax Description sid string Source identifier uniquely identifies the source of a TL1 autonomous command. srveff time Effect on service. Possible values are: SA Service affecting. NSA Non-service affecting. hh:mm:ss Time of origination of TL1 message. 9.6.
Chapter 9 TL1 Commands 9.6.31 RTRV-COND-EQPT Table 9-36 RTRV-COND-DWDM Syntax Description (continued) Parameter Syntax condtype date Description Condition type identifies the type of alarm (maps to cerent15216EdfaLogEventID). Possible condtype and corresponding conddescr (in quotes) are: LOS “Loss of Signal” (input power) alarm (cerent15216EdfaAlarmLpin). GAIN “Gain Out of Range” alarm (cerent15216EdfaAlarmGain). LPOUT “Loss of Output Power” alarm (cerent15216EdfaAlarmLpout).
Chapter 9 TL1 Commands 9.6.31 RTRV-COND-EQPT Example 9-35 RTRV-COND-EQPT Command and Response Amp01:ONS15216 EDFA2> RTRV-COND-EQPT:Amp01:ALL:229::LCRNT1; Amp01 2002-06-20 14:30:00 M 229 COMPLD "EQPT:MN,LCRNT1,NSA,6-20,14-25-30,,,\"Excessive Pump1 Current\"" ; Table 9-37 RTRV-COND-EQPT Syntax Description Parameter Syntax aid Description EQPT and ALL have same input effect. EQPT General parameters of the ONS 15216 EDFA2. PWR-A Affecting Power Bus A. PWR-B Affecting Power Bus B.
Chapter 9 TL1 Commands 9.6.32 RTRV-DFLT-SECU Table 9-37 RTRV-COND-EQPT Syntax Description (continued) Parameter Syntax ntfncde Description Notification code (maps to cerent15216EdfaAlarmPriority). Possible values are: CR Critical alarm. MJ Major alarm. MN Minor alarm. NA Not alarmed. NR Not reported. ocrdat m-d Date (month-day) of the event occurrence (derived from cerent15216EdfaDateAndTimeString).
Chapter 9 TL1 Commands 9.6.33 RTRV-DWDM Table 9-38 RTRV-DFLT-SECU Syntax Description Parameter Syntax Description date yyyy-mm-dd Date of origination of TL1 message. time hh:mm:ss Time of origination of TL1 message. aid EQPT and ALL have same input effect. EQPT General parameters of the ONS 15216 EDFA2. ALL Any or all of the preceding (command input only). al timeout Access level of the user. See “9.
Chapter 9 TL1 Commands 9.6.33 RTRV-DWDM Table 9-39 RTRV-DWDM Syntax Description Parameter Syntax Description date yyyy-mm-dd Date of origination of TL1 message. time hh:mm:ss Time of origination of TL1 message. aid 1 and ALL have same input effect. 1 Directly affecting the optical signal. ALL Any or all of the preceding (command input only). inputpoweruw 0 - 99999 Input power (signal) in units of 10 microW (cerent15216EdfaInPoweruW).
Chapter 9 TL1 Commands 9.6.34 RTRV-EQPT Table 9-39 RTRV-DWDM Syntax Description (continued) Parameter Syntax Description Pump 1 or pump 2 measured control value. Possible values are same as pump1ctrlvalue and pump2ctrlvalue, as shown above. pump1ctrlvaluem easured, pump2ctrlvaluem easured gainmeasured 0 - 230 Value of gain in units of 10 dB when mode is GAINTEMP (gets cerent15216EdfaConstGainOverallGainMeasured).
Chapter 9 TL1 Commands 9.6.35 RTRV-HDR Table 9-40 RTRV-EQPT Syntax Description Parameter Syntax Description date yyyy-mm-dd Date of origination of TL1 message. time hh:mm:ss Time of origination of TL1 message. aid PWR-A, PWR-B, and ALL have same input effect. PWR-A Affecting Power Bus A. PWR-B Affecting Power Bus B. ALL Any or all of the preceding (command input only). pwrbusmode Power bus mode setting (cerent15216EdfaPowerBusMode). Possible values are: SIMPLEX Simplex mode.
Chapter 9 TL1 Commands 9.6.36 RTRV-INV 9.6.36 RTRV-INV Command Types RTRV-INV Retrieves the inventory information of the ONS 15216 EDFA2.
Chapter 9 TL1 Commands 9.6.37 RTRV-NE-GEN 9.6.37 RTRV-NE-GEN Command Types RTRV-NE-GEN Retrieves general parameters of the ONS 15216 EDFA2. Retrieves sid/tid name, IP address and mask, and default router information. Also retrieves the boot table content.
Chapter 9 TL1 Commands 9.6.38 RTRV-RFILE Table 9-43 RTRV-NE-GEN Syntax Description (continued) Parameter Syntax Description bootipaddr1 string IP address to boot from if bootrectype1 is set to TFTP (cerent15216EdfaBootIpAddress for first entry). bootrectype2 Boot record type (cerent15216EdfaBootType for second entry). Possible values are: FLASH Boot from flash. TFTP Boot through TFTP. bootfilename2 string Boot file name (cerent15216EdfaBootFileName for second entry).
Chapter 9 TL1 Commands 9.6.39 RTRV-TH-DWDM Table 9-44 RTRV-RFILE Syntax Description Parameter Syntax aid Description Always EQPT. localfilename EQPT General parameters of the ONS 15216 EDFA2. string Name of the file on the flash file system of the ONS 15216 EDFA2 that is to be listed. A null value in the request means all files are to be listed. A null value in the response means the file specified does not exist. File names are case sensitive. 9.6.
Chapter 9 TL1 Commands 9.6.40 RTRV-TH-EQPT Table 9-45 RTRV-TH-DWDM Syntax Description (continued) Parameter threshholdtype and thresholdvalue pairs Syntax Description Type of threshold or set point that is to be retrieved. A null value is equivalent to ALL. Possible to specify values for one or more of the following: LOSHYST Loss of signal (input power) hysteresis (cerent15216EdfaLOSHysteresis). thresholdvalue can be between 0 and 1000, with default of 100, in units of 100 dB.
Chapter 9 TL1 Commands 9.6.40 RTRV-TH-EQPT Example 9-45 RTRV-TH-EQPT Command and Response Amp01:ONS15216 EDFA2> RTRV-TH-EQPT:Amp01:ALL:123::; Amp01 2001-06-08 09:00:05 M 123 COMPLD "EQPT:MAXCTMP,,,65" "EQPT:MAXCTMPHYST,,,1" "EQPT:MINCTMP,,,-5" "EQPT:MINCTMPHYST,,,1" "PWR-A:PWRBUSMIN,,,420" "PWR-A:PWRBUSMAX,,,570" "PWR-B:PWRBUSMIN,,,420" "PWR-B:PWRBUSMAX,,,570" ; Table 9-46 RTRV-TH-EQPT Syntax Description Parameter Syntax Description date yyyy-mm-dd Date of origination of TL1 message.
Chapter 9 TL1 Commands 9.6.41 RTRV-TOD Table 9-46 RTRV-TH-EQPT Syntax Description (continued) Parameter threshholdtype and thresholdvalue pairs Syntax Description Type of threshold or set point that is to be retrieved. A null value is equivalent to ALL. Possible to specify values for one or more of the following: MAXCTMP Maximum case temperature (cerent15216EdfaCtmpMax). thresholdvalue can be between 20 and 70, with default of 70 in units of °C.
Chapter 9 TL1 Commands 9.6.42 RTRV-USER-SECU M 123 COMPLD "2002,06,20,14,30,00,000,UTC,GPS,IS-ACT" ; Table 9-47 RTRV-TOD Syntax Description Parameter Syntax Description date yyyy-mm-dd Date of origination of TL1 message. time hh:mm:ss Time of origination of TL1 message. Time of day of the format: YYYY,MM,DD,HH,MM,SS,sss tmody format: Current calendar year Month Day Hour Minutes Seconds Sub-seconds, currently fixed at 000.
Chapter 9 TL1 Commands 9.6.43 SET-ATTR-DWDM Table 9-48 RTRV-USER-SECU Syntax Description Parameter Syntax Description sid string Source identifier uniquely identifies the source of a TL1 autonomous command. al uid Access level of the user. See “9.5 Summary of Security Permissions for TL1 Commands” section on page 9-6 for access level permissions. R Read only privileges. RW Read and write privileges. RWA Read, write, and administrative privileges.
Chapter 9 TL1 Commands 9.6.44 SET-ATTR-EQPT Table 9-49 SET-ATTR-DWDM Syntax Description Parameter Syntax aid Description 1 and ALL have same input effect. 1 Directly affecting the optical signal. ALL Any or all of the preceding (command input only). ntfncde Notification code (maps to cerent15216EdfaAlarmPriority). Possible values are: CR Critical alarm. MJ Major alarm. MN Minor alarm. NA Not alarmed. NR Not reported. NULL Deafults to NA.
Chapter 9 TL1 Commands 9.6.44 SET-ATTR-EQPT Table 9-50 SET-ATTR-EQPT Syntax Description Parameter Syntax aid Description Possible values are: EQPT General parameters of the ONS 15216 EDFA2. PWR-A Affecting Power Bus A. PWR-B Affecting Power Bus B. ALL Any or all of the preceding (command input only). ntfncde Notification code (maps to cerent15216EdfaAlarmPriority). Possible values are: CR Critical alarm. MJ Major alarm. MN Minor alarm. NA Not alarmed. NR Not reported.
Chapter 9 TL1 Commands 9.6.45 SET-ATTR-SECUDFLT 9.6.45 SET-ATTR-SECUDFLT Command Types SET-ATTR-SECUDFLT Sets the timeout value of user sessions for users with a specific access level. If no communication occurs for this time, the user session is closed by the ONS 15216 EDFA2 TL1 agent. Users affected by changes to the timeout must log out and log in again for the change to take effect.
Chapter 9 TL1 Commands 9.6.47 SET-TH-EQPT Table 9-52 SET-TH-DWDM Syntax Description Parameter Syntax aid threshholdtype and thresholdvalue pairs Description 1 and ALL have same input effect. 1 Directly affecting the optical signal. ALL Any or all of the preceding (command input only). string Type of threshold that is to be set. The threshold is set to the thresholdvalue that follows the comma.
Chapter 9 TL1 Commands 9.6.47 SET-TH-EQPT Table 9-53 SET-TH-EQPT Syntax Description Parameter Syntax aid threshholdtype and thresholdvalue pairs Description Possible values are: EQPT General parameters of the ONS 15216 EDFA2. PWR-A Sets Power Bus A and Power Bus B. PWR-B Sets Power Bus A and Power Bus B. ALL Any or all of the preceding (command input only). string Type of threshold that is to be set. The threshold is set to the thresholdvalue that follows the comma.
Chapter 9 TL1 Commands 9.6.48 STA-LOCL-RST 9.6.48 STA-LOCL-RST Command Types STA-LOCL-RST Instructs the ONS 15216 EDFA2 to restore all the manufacturing default settings and reset the unit. The files on the flash file system (FFS), the date and time, and the values of manufacturing calibration are not affected. When this command is entered the unit resets itself.
C H A P T E R 10 Troubleshooting This chapter presents basic fault information and diagnosis (troubleshooting) procedures for the 2.1.0, 2.2.1, 2.3.0, and 2.4.0 product releases of the Cisco ONS 15216 EDFA2. Only TL1 information about the alarm notifications and commands is provided. This chapter describes the behavior of the ONS 15216 EDFA2 in the most expected troubleshooting situations. It does not address all possible causes of a particular situation or all possible solutions.
Chapter 10 Troubleshooting 10.1 Alarm Indicators 10.1 Alarm Indicators This section provides alarm indications, including LEDs and alarms. 10.1.1 LEDs and Office Alarms The front panel of the ONS 15216 EDFA2 has five LEDs: • POWER • FAIL • LOS • Ethernet socket (2) On the left side of the front panel of the ONS 15216 EDFA2 are the POWER, FAIL, and LOS alarm LEDs. The Ethernet LEDs are located at the top left and right sides of the Ethernet LAN port.
Chapter 10 Troubleshooting 10.1.1 LEDs and Office Alarms • Off: The gain, output power, case temperature, laser pump current, and laser pump temperature are all within their specified ranges (or –48 VDC power has failed). • On: GAIN, LPOUT, CTMP, LCRNT1, LCRNT2, LTMP1, and/or LTMP2 alarm. The gain, output power, case temperature, laser pump current, and/or laser pump temperature are out of tolerance. (A major internal failure has occurred.
Chapter 10 Troubleshooting 10.1.2 Troubleshooting Optical Alarms 10.1.2 Troubleshooting Optical Alarms The ONS 15216 EDFA2 amplifier has two main categories of alarms: optical (DWDM) and equipment (EQPT). The optical alarms are directly related to the signal amplification and are usually service affecting. The ONS 15216 EDFA2 has three Optical alarms: Warning • LOS • GAIN • LPOUT Follow all directions and warning labels when working with optical fibers.
Chapter 10 Troubleshooting 10.1.2 Troubleshooting Optical Alarms Warning Follow all directions and warning labels when working with optical fibers. To prevent eye damage, never look directly into a fiber or connector. 10.1.2.2 GAIN (Gain Out of Range) Alarm This alarm is only valid when the ONS 15216 EDFA2 is in GAINTEMP mode. It occurs when the value of OVERALLGAINMEASURED has deviated more than 1.25 dB from the manufacturer-defined set point’s allowable range. This condition has a 0.25 dB hysteresis.
Chapter 10 Troubleshooting 10.1.3 Troubleshooting Equipment Alarms 10.1.2.3 LPOUT (Loss of Output Power) Alarm This alarm is valid only when the ONS 15216 EDFA2 is in OPWR mode, which is rare because this mode applies to few applications and is generally not recommended. This alarm occurs if the unit is in OPWR mode and the output power is deviating more than the value of LPOUTDEV from the value of LPOUTSETPT. The value of LPOUTHYST is used to clear the alarm.
Chapter 10 Troubleshooting 10.1.3 Troubleshooting Equipment Alarms 10.1.3.2 LCRNT1 and LCRNT2 (Excessive Pump Current) Alarms These alarms occur when the input power exceeds input range and the ONS 15216 EDFA2 is overdriving the pump laser to try to get the target Gain value. The manufacturer defines this condition as the drive current at greater than 95% of end of life value. The current must drop to 90% of the end-of-life value for the alarm to clear.
Chapter 10 Troubleshooting 10.2 Typical Troubleshooting Scenarios ; Amp01:ONS15216 EDFA2> ED-EQPT:SID:PWR-B:125:Amp01::PWRBUSMODE=SIMPLEX; þAmp01 2004-03-17 00:23:07 A þ1 REPT EVT EQPT þ"PWR-B:PWRBUSMODE,TC,3-17,0-23-7,,,,:\"Power Bus Mode Changed\"" ; þAmp01 2004-03-17 00:23:08 A þ2 REPT ALM EQPT þ"PWR-B:CL,PWRBUSB,NSA,3-17,0-23-8,,:\"Power Bus B Alarm\"" ; þAmp01 2004-03-17 00:23:08 M þ125 COMPLD þ/* ED-EQPT */ ; 10.
Chapter 10 Troubleshooting 10.2.2 2.0.1 to 2.2.1 Upgrade Attempt 10.2.2 2.0.1 to 2.2.1 Upgrade Attempt To achieve a smooth software upgrade, the ONS 15216 EDFA2 must first get upgraded from software version v2.0.1 to v2.1.0 before being upgraded from v2.1.0 to v2.2.1. If a unit has been upgraded directly from v2.0.1 to v2.2.1, some features of v2.2.1 may not operate properly. In addition, the CISCO15 user has only read write access and cannot perform administrative commands.
Chapter 10 Troubleshooting 10.2.5 Complete Boot Up Failure "EQPT:CLEI=IPI01AA0AAA,DESCR=ONS15216 EDFA2,NAME=Amp01,HARDWAREREV=74-2256-05-A0-B4,FIR MWAREREV=v2.3.15,SOFTWAREREV=v2.3.0,SERIALNUM=DIT0533000P,MFGNAME=Cisco Systems,MODELNAME= ONS216EDFA" ; Amp01:ONS15216 EDFA2> RTRV-NE-GEN:Amp01::124; Amp01 2002-01-12 08:01:25 M 124 COMPLD "EQPT:NAME=Amp01,IPADDR=172.22.87.100,IPMASK=255.255.255.0,DEFRTR=172.22.87.2,MACADDRES S=000D56727245,BOOTRECORDTYPE1=FLASH,BOOTFILENAME1=15216EdfaSw_2.4.0,BOOTIPADDR1=0.
Chapter 10 Troubleshooting 10.2.6 No Response from RS-232 Port Step 6 At the hostname prompt, enter the following command: hostname:edfaboot% srom cfg boot display Check that the entries are complete and accurately reflect the image file names. Use the srom cfg boot modify command to correct the boot entries as needed.
Chapter 10 Troubleshooting 10.2.9 Lost Password Explanation When powered up without an Ethernet cable, the activity light remains on. Recommended Action The Ethernet activity light works correctly when connected to the network. 10.2.9 Lost Password If the root password for CISCO15 is lost, there is a procedure to reset it to regain full administrative control of the ONS 15216 EDFA2.
Chapter 10 Troubleshooting 10.3 Status Information Needed by Cisco TAC • RTRV-INV::ALL:101; • RTRV-NE-GEN:::102; • RTRV-ALM-ALL:::103::; • RTRV-DWDM::ALL:104; • RTRV-EQPT::ALL:105; • RTRV-TH-DWDM::ALL:106::; • RTRV-TH-EQPT::ALL:107::; If the TL1 shell is not active or working, the following ASH commands should be issued, and pasted into a text file.
Chapter 10 Troubleshooting 10.3 Status Information Needed by Cisco TAC Cisco ONS 15216 EDFA2/EDFA2-A Operations Guide, R2.