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

Table Of Contents

Provisioning in the ASH Shell

4.1 Log In via EIA/TIA-232 Port Using HyperTerminal

4.2 Set IP Address

4.3 Log In via LAN Port Using Telnet (Optional)

4.4 Set Date and Time

4.5 Set Power Bus Mode (Simplex or Duplex)

4.6 Verify Amplifier Operational Status

4.7 Set Gain

4.8 Set Alarm Thresholds

4.9 Set Password

4.10 Add Users

4.11 Save Changes

4.12 Log Off

4.13 Recover Default Password


Provisioning in the ASH Shell


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 in the TL1 Shell" 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. Log In via EIA/TIA-232 Port Using HyperTerminal

2. Set IP Address

3. Log In via LAN Port Using Telnet (Optional)

4. Set Date and Time

5. Set Power Bus Mode (Simplex or Duplex)

6. Verify Amplifier Operational Status

7. Set Gain

8. Set Alarm Thresholds

9. Set Password

10. Add Users

11. Save Changes

12. Log Off

13. Recover Default Password

The following sections describe these steps in detail.

4.1 Log In via EIA/TIA-232 Port Using HyperTerminal

Logging in through the EIA/TIA-232 port is required to set the ONS 15216 EDFA2 IP address before there can be access via the LAN port. (See "Log In via LAN Port Using Telnet (Optional)" section.)


Step 1 Connect to the EIA/TIA-232 port on the front panel. See "EIA/TIA-232 Connection Procedure" section on page 3-7 for line connection and HyperTerminal setup instructions.

Step 2 Open HyperTerminal. (HyperTerminal can be found in the Microsoft Windows Accessories menu.)

Step 3 If you see the login window shown in Example 4-1, skip to Step 4.

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 (sidtidname:ONS15216 EDFA2>). To change to ASH shell, log in using the procedure in "Log In via EIA/TIA-232 Port Using HyperTerminal" section on page 8-1, and then enter the following command at the hostname prompt:

Welcome to ONS15216 EDFA2 Console (v2.1.0)

sidtidname:ONS15216 EDFA2> ED-NE-GEN:::123:::CLI=ASH;

Then enter the following command at the hostname prompt:

sidtidname:ONS15216 EDFA2> INIT-SYS::ALL:1234::1;

The ONS 15216 EDFA2 should log you off and then bring up the ASH shell login window.

Step 4 Check that the ONS 15216 EDFA2 login window appears as shown in Example 4-1.

Example 4-1 ASH Shell Login Window

-- LOGIN ---------------------------------------------------- sysname

ONS15216 EDFA2 Optical Amplifier

--------------------------------


Software Version 2.1.0

Copyright (c) 2000-2001 Cisco Systems, Inc.



Username: { }
Password: { }

[Login]

Step 5 Enter both a user name and password.

The default user name and password is CISCO15 with no password (press Enter).


Note For security reasons, it is recommended to change the password from its default value. See Set Password or Set Password, page 8-10.


Step 6 Press Enter when [Login] becomes highlighted. Example 4-2 displays the login response.

Example 4-2 ASH Shell Login Response

Welcome to ONS15216 EDFA2 Console (v2.1.0)

ash:hostname:ONS15216 EDFA2>

An EIA/TIA-232 link to the ONS 15216 EDFA2 is established. The user can now provision the ONS 15216 EDFA2.


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

Step 2 At the command prompt, enter the snmp row set local cerent15216EdfaSromIpMgmtGroup command (displayed in Example 4-3) and press Enter.

Example 4-3 Setting IP Address, Subnet Mask, Gateway Address, and Host Name

ash:hostname:ONS15216 EDFA2> snmp row set local cerent15216EdfaSromIpMgmtGroup

cerent15216EdfaSromIpMgmtEnetAddress 0.0.0.0
cerent15216EdfaSromIpMgmtEnetSubNetMask 0.0.0.0
cerent15216EdfaSromIpMgmtDefaultRouterAddress 0.0.0.0
cerent15216EdfaSromIpMgmtHostName ""

Because row set is being used in this command, the user is prompted row by row to enter the IP address, the subnet mask, the gateway address, and the host name (community ID).

Step 3 The changes must be saved prior to terminating the session. See "Save Changes" section.

Step 4 The system must be rebooted to make the IP address active. Use the processor reset command. (See "processor reset Command" section on page 6-11.)


4.3 Log In via LAN Port Using Telnet (Optional)

Provisioning of the ONS 15216 EDFA2 can be accomplished entirely through the EIA/TIA-232 port using CLI commands. After an IP address is assigned, it may be easier to provision the ONS 15216 EDFA2 using Telnet or an SNMP manager. A Telnet client is needed for CLI commands over IP. A generic SNMP manager is required for SNMP management over IP. After connecting the ONS 15216 EDFA2 to the network through its RJ-45 LAN port (see "LAN Interface (Ethernet)" section on page 3-14), the user can configure the module to accept SNMP and CLI commands via Telnet using the following procedure:


Step 1 Connect to the LAN port on the front panel. See "LAN Connection Procedure" section on page 3-14.

Step 2 Click the Microsoft Windows Start menu and select Run.

Step 3 In the text field, type the following:

telnet <ONS 15216 EDFA2 IP address> 8023

Specifying port 8023 ensures login through the ASH shell. If no port is specified, the ONS 15216 EDFA2 responds in the shell that the ONS 15216 EDFA2 is set to. (TL1 is the default shell.)

Step 4 Log in again using Step 4 through Step 6 in "Log In via EIA/TIA-232 Port Using HyperTerminal" section.

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". Following the space, the time zone is set as +/- hours from Greenwich Mean Time (GMT) (also designated as universal coordinated time (UTC)) followed by a colon and minutes ahead for daylight savings. For example, Pacific Daylight Time would be -8:60 and Greenwich Mean Time would be +0:0. See Example 4-4.

Example 4-4 Setting the Date and Time

ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaRtcDateAndTimeLocalString "2002-6-30,14:8:30.0 -8:60"

4.5 Set Power Bus Mode (Simplex or Duplex)

The ONS 15216 EDFA2 allows users to set a simplex (one power source-Bus A) or duplex (redundant power source-Bus A and Bus B) Power Bus mode. Use the snmp attribute set local cerent15216EdfaPowerBusMode command to set the desired Power Bus mode. The default mode is duplex. See Example 4-5.

Example 4-5 Setting the Power Bus Mode

ash:hostname:ONS15216 EDFA2> snmp attribute set local cerent15216EdfaPowerBusMode simplex

4.6 Verify Amplifier Operational Status

To ensure that the amplifier is working correctly on the optical level, you must verify the amplifier operational status. Use the snmp table display local cerent15216EdfaOverallStatusGroup command to verify amplifier operational status. Example 4-6 displays the output of this command.

Example 4-6 Verifying the Amplifier Operations Status

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

CLASS CERENT-15216-EDFA-MIB.cerent15216EdfaOverallStatusGroup ::=
{
cerent15216EdfaInPoweruW = 279;
cerent15216EdfaInPowerdBm = -1555;
cerent15216EdfaOutPowermW = 476;
cerent15216EdfaOutPowerdBm = 678;
cerent15216EdfaConstGainOverallGainMeasured = 219;
cerent15216EdfaVariableGainPreAttenuationMeasured = 10;
};

The input power (signal) should be consistent with the input power measured during the optical connection procedure. See the "Optical Connection Procedure" section on page 3-3 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. For more information, refer to Table 2-2.


4.7 Set Gain

To ensure that the ONS 15216 EDFA2 output signal is received by the transceiver in the network element, it is important that the gain is set correctly.

The desired output power per channel is dependent on the number of channels traversed in the amplifier. The user sets the gain of the amplifier depending on the input power (signal) level, the network application, and the required receiver specifications necessary for error-free operation. Gain range is provided in Table 3-1.

To set the amplifier gain, enter the snmp attribute set local cerent15216EdfaConstGainOverallGain gainvalue command, where gainvalue is the desired gain multiplied by ten. For example, if the desired gain is 20 dB, the gainvalue would be set to 200. Example 4-7 shows the command used to set the gain.

Example 4-7 Setting the Gain

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


Note Prior to changing or implementing gain changes, consult with the Cisco TAC to ensure proper network operation.


4.8 Set Alarm Thresholds

Alarm thresholds are set so that the network operator can be notified when valid alarms occur via the RJ-45 ALARM OUT and RJ-45 LAN ports on the front panel of the ONS 15216 EDFA2. (See Figure 4-1.)

Figure 4-1 ONS 15216 EDFA2 Front Panel

Alarms are reported for the following conditions:

Loss or degradation of electrical power

Pump laser overheating, excessive pump current

Loss or degradation of optical input

Alarms can be connected to a network operations center (NOC) network management system (NMS) via a network element miscellaneous discrete input and/or office alarm panel/system.

For a full description of alarm threshold command attributes, refer to Chapter 5, "SNMP MIB Installation and Configuration" or Chapter 6, "ASH Commands."

To display the alarm thresholds, use the snmp table display local cerent15216EdfaCfgGroup command ( Example 4-8). This command returns the current alarm threshold default values.

Example 4-8 Displaying the Alarm Thresholds

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

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

To set the alarm thresholds, use the snmp row set local cerent15216EdfaCfgGroup command. After this command is entered, the user is prompted to modify each attribute, row by row, until all attributes are set. Alarm threshold attributes are described in Table 4-1.

Table 4-1 Alarm Threshold Attribute Definitions  

Attribute
Variable Definition
Syntax
Maximum Access
Description

cerent15216EdfaCfgSaved

Configuration saved status

True Value

Read-only

Indicates whether the current configuration has been saved. The value can be true or false. If false, the configuration is not saved.

cerent15216EdfaLpoutSetpoint

Loss of output power setpoint

Integer
(0 to 1000)

Read-only

Can be disregarded when operating amplifier in Constant Gain Temperature Compensated mode (manufacturer default) and Constant Pump Current mode. Setpoint object is only valid when amplifier is used in Constant Output Power and Constant Pump Power modes.

cerent15216EdfaLpoutDeviation

Loss of output power deviation

Integer
(0 to 1000)

Read-write

Can be disregarded when operating amplifier in manufacturer default Constant Gain Temperature Compensated mode. Deviation object is only valid when amplifier is used in Constant Output Power and Constant Pump Power modes.

cerent15216EdfaLpoutHysteresis

Loss of output power hysteresis

Integer
(0 to 1000)

Read-write

Can be disregarded when operating amplifier in manufacturer default Constant Gain Temperature Compensated mode. Hysteresis object is only valid when amplifier is used in Constant Output Power and Constant Pump Power modes.

cerent15216EdfaLOSThreshold

Loss of signal (input power) threshold

Integer
(-3100 to -1500)

Read-write

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. Consult with the Cisco TAC to determine the threshold value for your application. As a guideline, Cisco recommends setting the threshold value at 3 dBm below the current input power level of the amplifier. Valid entries are between -3100 and -1500 in dBm times 100. For example, if the total input power of the amplifier is -24 dBm and the loss of input power threshold required is -27 dBm, the loss of input power alarm threshold is -2700.

cerent15216EdfaLOSHysteresis

Loss of signal (input power) hysteresis

Integer
(0 to 1000)

Read-write

Used to set the amount the input signal must increase above the LOS Threshold level before the alarm is cleared. This attribute, in conjunction with the loss of input signal alarm threshold, enables efficient clearing of alarms. Set this attribute at a value that is appropriate for the application so that the alarm condition will clear when input is stable. Consult with the Cisco TAC to determine the correct value for your application. As a guideline, Cisco recommends setting the value 1 dBm above the LOS Threshold value. With this setting, the module will clear the alarm if it detects a signal level of 1 dBm above the current LOS Threshold value. Valid entries are between 0 and 1000 and are in dBm times 100. For example, if the hysteresis required is 1 dBm, the power alarm hysteresis is 100.

cerent15216EdfaCtmpMin

Minimum case temperature

Integer
(-10 to 10)

Read-write

Notifies operations personnel notification if the case temperature of the ONS 15216 EDFA2 drops below a level that impacts proper operation of the optical network. The minimum case temperature should be set at a value that is appropriate for the intended application and within product specifications. Users should consult with the Cisco TAC to determine the threshold value for their application. As a guideline, Cisco recommends that minimum case temperature be set at 1°C. Valid entries are between -10 and 10°C.

cerent15216EdfaCtmpMinHysteresis

Minimum case temperature hysteresis

Integer
(0 to 10)

Read-write

Used to set the amount the case temperature of the module must rise above the minimum case temperature alarm level before the alarm is cleared. This attribute, in conjunction with the case temperature minimum, enables efficient clearing of alarms. Set the hysteresis at a value that is appropriate for the application so that the alarm condition will clear when the input is stable. The user should consult with the Cisco TAC in order to determine the value for their application. As a guideline, Cisco recommends that the hysteresis value be set at 1°C. Valid entries are between 0 and 10°C.

cerent15216EdfaCtmpMax

Maximum case temperature

Integer
(20 to 70)

Read-write

Notifies operations personnel if the case temperature of the ONS 15216 EDFA2 is at a level that may impact proper operation of the optical network. Set the maximum case temperature at a value that is appropriate for intended application and within product specifications. Consult with the Cisco TAC to determine the threshold value for your application. As a guideline, Cisco recommends that minimum case temperature value be set at 50°C. Valid entries are between 20 and 70°C.

cerent15216EdfaCtmpMaxHysteresis

Maximum case temperature hysteresis

Integer
(0 to 10)

Read-write

Used to set the amount the case temperature of module must drop below the maximum case temperature alarm level before the alarm is cleared. This attribute, in conjunction with the case temperature minimum, enables efficient clearing of alarms. Set the hysteresis at a value that is appropriate for the application. If an alarm occurs, the case temperature must return to 1oC below the set value to clear the alarm. Consult with the Cisco TAC to determine the value for your application. As a guideline, Cisco recommends setting the value at 1°C. Valid entries are between 0 and 10°C. Setting this value to 0 disables this option.

cerent15216EdfaPowerBusDCVoltageMin

Power bus minimum voltage

Integer
(350 to 700)

Read-write

Minimum allowable power bus DC voltage. The default minimum power bus voltage is set at -40 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.

The power bus measurement has a 1.0V tolerance. If the minimum threshold is configured at 400 (-40 VDC), the alarm may not raise until the voltage drops below -39 VDC.

cerent15216EdfaPowerBusDCVoltageMax

Power bus maximum voltage

Integer
(350 to 700)

Read-write

Maximum allowable power bus DC voltage. The default maximum power bus voltage is set at -57 VDC. Valid entries are between 350 and 700 and are in negative volts times 10. For example, if the voltage required is -57 VDC, the power bus setting is 570.

The power bus measurement has a 1.0V tolerance. If the maximum threshold is configured at 570 (-57 VDC), the alarm may not raise until the voltage goes above -58 VDC.


4.9 Set Password

To restrict access to the ONS 15216 EDFA2, use the user passwd set command to change the default user password. The password must be a string of up to 10 characters, where at least 2 are non-alphabetic characters and at least 1 is a special character. With the exception of the administrator access level (read_write_admin), users can only modify their own passwords. For additional information on user levels, refer to Table 6-1. Example 4-9 displays the command.

Example 4-9 Changing Current User's Password

ash:hostname:ONS15216 EDFA2> user passwd set
Password =
****
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. The ONS 15216 EDFA2 responds with a request for the password.

Passwords must be an ASCII string of up to 10 characters, where at least 2 are non-alphabetic characters with at least one special character. Special characters are +, #, and % (defined in Telcordia GR-831-CORE).

Example 4-10 Adding a New User

ash:hostname:ONS15216 EDFA2> user entry create janedoe read_write
New Password =
*********
Confirm New Password =
*********

4.11 Save Changes

To ensure that the provisioning changes are set, you must save your changes prior to terminating the session. To save changes, use the snmp attribute set local cerent15216EdfaOpSaveConfig perform command ( Example 4-11).

Example 4-11 Saving Changes

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

Most SNMP configuration attributes require the above save command before terminating the session (does not apply to TL1 shell). The exceptions to this save requirement (the attributes that are automatically saved) are shown below:

cerent15216EdfaPowerBusMode

cerent15216EdfaPowerBusDCVoltageMin

cerent15216EdfaPowerBusDCVoltageMax

cerent15216EdfaConstGainOverallGain

cerent15216EdfaVariableGainPreAttenuation

SromIpMgmtGroup attributes:

cerent15216EdfaSromIpMgmtEnetAddress

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.

Example 4-12 Logging Off

ash:hostname:ONS15216 EDFA2> logoff

4.13 Recover Default 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. The user must be connected to the ONS 15216 EDFA2 by serial communication, perform a hard power reset, and then performs a series of commands within 60 seconds of rebooting, according to the following procedure.


Warning The ONS 15216 EDFA2 ceases its optical amplification function when power is off during this process. Traffic should be rerouted before this procedure begins.



Note If the ONS 15216 EDFA2 firmware is not version 2.1.0 or greater, the CISCO15 user resets to read_write access level, not read_write_admin, which has full administrative control. Contact Cisco TAC for assistance.



Step 1 Connect to the EIA/TIA-232 port.

Step 2 Open HyperTerminal. (HyperTerminal can be found in the Microsoft Windows Accessories menu.)

Step 3 Perform hard power reset of the ONS 15216 EDFA2 (disconnect and reconnect power).

Step 4 While the dots are present in the HyperTerminal window during the reboot process, enter Ctrl C on the keyboard.

The ONS 15216 EDFA2 should boot from the firmware image. The prompt is %.

Step 5 At the hostname prompt, enter the following command (must be done within 60 seconds of rebooting):

hostname:edfaboot%user passwd set CISCO15 default

Step 6 At the hostname prompt, enter the following command:

hostname:edfaboot%login CISCO15

Step 7 At the hostname prompt, enter the following command:

hostname:edfaboot%processor reset

After the processor reset, the default CISCO15 login password will be the default (the Enter key).



hometocprevnextglossaryfeedbacksearchhelp

Posted: Sun Apr 2 12:13:20 PDT 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.