Table Of Contents

Provisioning in the TL1 Shell

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

8.2 Set IP Address

8.3 Log In via LAN Port Using Telnet (Optional)

8.4 Set Date and Time

8.5 Set Power Bus Mode (Simplex or Duplex)

8.6 Verify Amplifier Operational Status

8.7 Set Gain

8.8 Set Alarm Thresholds

8.9 Set Password

8.10 Add Users

8.11 Log Off

Provisioning in the TL1 Shell

---

This chapter discusses the provisioning procedures for the Cisco ONS 15216 EDFA2 using TL1 commands in the TL1 shell. See Chapter 4, "Provisioning in the ASH Shell" 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. 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. Log Off

The following sections describe these steps in detail.

8.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 ONS 15216 EDFA2. See "LAN Connection Procedure" section on page 3-14 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 8-1, skip to Step 4.

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 "Log In via EIA/TIA-232 Port Using HyperTerminal" section on page 4-1, and then enter the following command at the ASH hostname prompt:

ash:hostname:ONS15216 EDFA2> shell type modify tl1




Then enter the following command at the ASH hostname prompt:

ash:hostname:ONS15216 EDFA2> processor reset




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

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

Example 8-1 TL1 Shell Login Prompt

Welcome to ONS15216 EDFA2 Console (v2.1.0)




sidtidname:ONS15216 EDFA2> 




Step 5 Log in using the ACT-USER command (see "ACT-USER" section on page 9-9) with the following syntax:

ACT-USER:[<tid>]:<uid>:<ctag>::<pid>;




The tid is the same as the sidtidname in the command line prompt (use is optional), uid is the user name, ctag is an arbitrary number to associate with the command, and pid is the user password. The default uid is CISCO15 with no pid (nothing between the last colon and semicolon).

---

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

---

Step 6 After the semicolon is entered, the ONS 15216 EDFA2 displays the login response, as shown in Example 8-2.

Example 8-2 TL1 Shell Login Response

sidtidname:ONS15216 EDFA2> ACT-USER::CISCO15:100::;




sidtidname 2002-07-11 10:09:19

M 100 COMPLD

/* ACT-USER */

;

sidtidname:ONS15216 EDFA2> 




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 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 sid/tid name, contact your network administrator.

Step 2 At the command prompt, enter the ED-NE-GEN command (see "ED-NE-GEN" section on page 9-18) according to the following syntax:

ED-NE-GEN:[<tid>]::<ctag>:::[NAME=<name>],[IPADDR=<ipaddr>],[IPMASK=<ipmask>],[DEFRTR=<def rtr>];




The name is the sid/tid name in the command line prompt. See Example 8-3.

Example 8-3 Setting IP Address, Subnet Mask, Gateway Address, and sid/tid Name Using TL1

sidtidname:ONS15216 EDFA2> ED-NE-GEN:::101:::NAME=Amp01,IPADDR=192.167.3.4,IPMASK=255.255. 255.0,DEFRTR=192.167.3.20;




Step 3 The system must be rebooted to make the IP address active. Use the INIT-SYS command (see "INIT-SYS" section on page 9-23), as follows:

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




---

8.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, so this step is optional. After an IP address is assigned, it may be easier to provision the ONS 15216 EDFA2 using Telnet. A Telnet client is needed for TL1 commands 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 TL1 commands via Telnet using the following procedure:

---

Step 1 Connect to the LAN port on the ONS 15216 EDFA2. 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> 3083




Specifying port 3083 ensures login through the TL1 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.

---

8.4 Set Date and Time

Use the ED-DAT command (see "ED-DAT" section on page 9-16) to set the date and time. A time zone cannot be set using TL1. The time setting is restricted to universal coordinated time (UTC) according to the following syntax:

ED-DAT:[<tid>]::<ctag>::<utcdate>,<utctime>;




The utcdate and utctime entries must follow this format: yyyy-mm-dd,hh-mm-ss. See Example 8-4.

Example 8-4 Setting the Date and Time Using TL1

sidtidname:ONS15216 EDFA2> ED-DAT:::120::2002-04-18,02-24-55;

8.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. The default mode is duplex. Use the ED-ENV command (see "ED-ENV" section on page 9-17) to set the desired power bus mode according to the following syntax:

ED-ENV:[<tid>]:<aid>:<ctag>:::PWRBUSMODE=<pwrbusmode>;




The pwrbusmode value can be SIMPLEX or DUPLEX. See Example 8-5.

Example 8-5 Setting the Power Bus Mode Using TL1

sidtidname:ONS15216 EDFA2> ED-ENV::ALL:121:::PWRBUSMODE=SIMPLEX;

8.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 RTRV-DWDM command (see "RTRV-DWDM" section on page 9-45) to verify amplifier operational status according to the following syntax:

RTRV-DWDM:[<tid>]:<aid>:<ctag>;

<sid> <date> <time>

M <ctag> COMPLD

    "<aid>:INPWRMICROW=<inputpoweruw>,INPWRDBM=<inputpowerdbm>,OUTPWRMILLIW=<outputpowermw >,OUTPWRDBM=<outputpowerdbm>,PUMP1CTRLMODE=<pump1ctrlmode>,PUMP1CTRLVALUE=<pump1ctrlvalue> ,PUMP2CTRLMODE=<pump2ctrlmode>,PUMP2CTRLVALUE=<pump1ctrlvalue>,OVERALLGAIN=<gain>,PREATT=< preatt>"




Example 8-6 displays sample output of this command.

Example 8-6 Verifying the Amplifier Operations Status Using TL1

sidtidname:ONS15216 EDFA2> RTRV-DWDM::ALL:122;




sidtidname 2002-07-11 10:20:05

M 122 COMPLD

   "1:INPWRMICROW=264,INPWRDBM=-1578,OUTPWRMILLIW=172,OUTPWRDBM=237,PUMP1CTRLMODE=GAINTEMP ,PUMP1CTRLVALUE=169,PUMP2CTRLMODE=GAINTEMP,PUMP2CTRLVALUE=169,OVERALLGAIN=169,PREATT=60"

;




The input power 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.

---

8.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 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, use the ED-DWDM command (see "ED-DWDM" section on page 9-16), according to the following syntax:

ED-DWDM:[<tid>]:<aid>:<ctag>:::[GAIN=<gain>];




The gain is the desired gain multiplied by ten. For example, if the desired gain is 20 dB, the gain value would be set to 200.

Example 8-7 Setting the Gain Using TL1

sidtidname:ONS15216 EDFA2> ED-DWDM::ALL:123:::GAIN=200;




---

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

---

8.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 8-1.)

Figure 8-1 ONS 15216 EDFA2 Front Panel

Alarms are reported for the following conditions:

•Degradation of electrical power source

•Pump laser overheating or excessive pump current

•Loss or degradation of optical input (signal)

•Loss of output power or gain out of range

•Case temperature out of range

Alarms can be connected to a NOC 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 9, "TL1 Commands."

To display the alarm thresholds, use the RTRV-TH-DWDM and RTRV-TH-EQPT commands (see "RTRV-TH-DWDM" section on page 9-51 and "RTRV-TH-EQPT" section on page 9-53) according to the following syntax:

RTRV-TH-DWDM:[<tid>]:<aid>:<ctag>::[<thresholdtype>][,][,];

<sid> <date> <time>

M <ctag> COMPLD

"<aid>,DWDM:<thresholdtype>,,,<thresholdvalue>"




RTRV-TH-EQPT:[<tid>]:<aid>:<ctag>::[<thresholdtype>][,][,];

   <sid> <date> <time>

M <ctag> COMPLD

   "<aid>:<thresholdtype>,,,<thresholdvalue>"




Example 8-8 shows sample command outputs.

Example 8-8 Displaying the Alarm Thresholds Using TL1

sidtidname:ONS15216 EDFA2> RTRV-TH-DWDM::ALL:124::;




sidtidname 2002-07-11 11:15:19

M 124 COMPLD

"1,DWDM:LOSTH,,,-3000"

"1,DWDM:LOSHYST,,,5"

"1,DWDM:LPOUTDEV,,,1000"

"1,DWDM:LPOUTHYST,,,5"

"1,DWDM:LPOUTSETPT,,,0"

;

sidtidname:ONS15216 EDFA2> RTRV-TH-EQPT::ALL:125::;




   sidtidname 2002-07-11 11:16:10

M 125 COMPLD

"EQPT:MAXCTMP,,,65"

"EQPT:MAXCTMPHYST,,,5"

"EQPT:MINCTMP,,,10"

"EQPT:MINCTMPHYST,,,2"

;




To set the alarm thresholds, use the SET-TH-DWDM and SET-TH-EQPT commands (see "SET-TH-DWDM" section on page 9-57 and "SET-TH-EQPT" section on page 9-58). Alarm threshold attributes are described in Table 8-1.

Table 8-1 Alarm Threshold Attribute Definitions  

Attribute	Variable Definition	Syntax	Maximum Access	Description
LOSTH	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 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.
LOSHYST	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.
LPOUTDEV	Loss of output power deviation	Integer (0 to 1000)	Read-write	Can be disregarded when operating amplifier in factory default Constant Gain Temperature Compensated mode. Deviation object is only valid when amplifier is used in Constant Output Power and Constant Pump Power modes.
LPOUTHYST	Loss of output power hysteresis	Integer (0 to 1000)	Read-write	Can be disregarded when operating amplifier in factory default Constant Gain Temperature Compensated mode. Hysteresis object is only valid when amplifier is used in Constant Output Power and Constant Pump Power modes.
LPOUTSETPT	Loss of output power setpoint	Integer (0 to 1000)	Read-only	Can be disregarded when operating amplifier in factory default Constant Gain Temperature Compensated mode. Setpoint object is only valid when amplifier is used in Constant Output Power and Constant Pump Power modes.
MAXCTMP	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.
MAXCTMPHYST	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.
MINCTMP	Minimum case temperature	Integer (-10 to 10)	Read-write	Notifies operations personnel 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.
MINCTMPHYST	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.

8.9 Set Password

To restrict access to the ONS 15216 EDFA2, use the ED-PID command (see "ED-PID" section on page 9-19) to change the default user password according to the following syntax:

ED-PID:[<tid>]:<uid>:<ctag>::<oldpid>,<newpid>;

Note that 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. See Example 8-9.

Example 8-9 Changing Current User's Password Using TL1

sidtidname:ONS15216 EDFA2> ED-PID::CISCO15:130::OLDPW,NEWPW;

---

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 "ED-USER-SECU" section on page 9-20) to add new users to the ONS 15216 EDFA2 according to the following syntax:

ENT-USER-SECU:[<tid>]:<uid>:<ctag>::<pid>,,<al>[:];

The uid is the user name, pid is the password, and al is the access level (R, RW, RWA). 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). The access levels are presented in "Summary of Security Permissions for TL1 Commands" section on page 9-6. See Example 8-10.

Example 8-10 Adding a New User Using TL1

sidtidname:ONS15216 EDFA2> ENT-USER-SECU::jsmith:140::jspasswd,,RW;




8.11 Log Off

At the end of a session, the user must log off of the ONS 15216 EDFA2. To log off, use the CANC-USER command (see "CANC-USER" section on page 9-12) according to the following syntax:

CANC-USER:[<tid>]:<uid>:<ctag>;




See Example 8-11.

Example 8-11 Logging Off Using TL1

sidtidname:ONS15216 EDFA2> CANC-USER::CISCO15:150;

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