1. EAGLE Database Administration - System Management User's Guide
  2. Controlled Feature Activation Procedures

A Controlled Feature Activation Procedures

Appendix A, Controlled Feature Activation Procedures, describes the procedures necessary to activate and deactivate features (features that require a feature access key to be activated) contained in this manual.

A.1 Introduction

Note:

As of Release 46.3, the fak parameter is no longer required. This parameter is only used for backward compatibility.

Controlled features are features that are activated using a feature access key. These features can either be on or off, or features that operate at a particular performance level. Only the controlled features that are used in this manual are covered in this appendix.

The feature access key allows the user to enable and activate a controlled feature in the EAGLE by entering either a permanent feature access key or a temporary feature access key. By requiring a feature access key to enable and activate a controlled feature, unauthorized enabling and activation of a controlled feature can be prevented. The feature access key is supplied by Oracle.

Features enabled with a permanent feature access key remain enabled for as long as the EAGLE remains in service. Once features are permanently enabled, they cannot be disabled.

Features enabled with a temporary feature access key are enabled for only 30 days. On the twenty-third day, seven days before the temporary key expires, a major alarm (UAM 0367) is generated to inform the user that the one or more temporary feature access keys will expire soon. 


0367.0181  ** SYSTEM      Temp Key(s) expiring soon.

If a temporary feature access key expires, the controlled feature is disabled and a critical alarm (UAM 0368) is generated. 


0368.0181  *C SYSTEM      Temp Key(s) have expired.

Any attempts to enable the controlled feature with the temporary feature access key are rejected. The controlled feature can be enabled only by entering the permanent feature access key for the controlled feature.

To clear the critical alarm (UAM 0368), the user can either enter the chg-ctrl-feat command with the alarm=clearparameter, or permanently enable the controlled feature by entering the permanent feature access key for the controlled feature.

If the critical alarm is cleared with the chg-ctrl-feat command, the controlled feature is disabled and cannot be enabled with the temporary feature access key. The feature can be enabled only by entering the permanent feature access key for the controlled feature.

A.2 Activating Controlled Features

This procedure is used to enable and activate these controlled features, Command Class Management, IP User Interface, and Network Security Enhancements, using the feature’s part number and a feature access key for each feature.

The feature access key is based on the feature’s part number and the serial number of the EAGLE, making the feature access key site-specific.

The enable-ctrl-feat command enables the controlled feature by inputting the controlled feature’s access key and the controlled feature’s part number with these parameters:

:fak – The feature access key generated by the feature access key generator. The feature access key contains 13 alphanumeric characters and is not case sensitive.

:partnum – The Oracle-issued part number associated with the controlled feature. The part number is a 9-digit number, not including dashes. The first three digits must be 893 (that is, 893xxxxxx, where x is a numeric value).

If the controlled feature is being enabled with a temporary feature access key, the feature must not be in the in-use, expired, or unavailable state.

The enable-ctrl-feat command requires that the database contain a valid serial number for the EAGLE, and that this serial number is locked. This can be verified with the rtrv-serial-num command. The EAGLE is shipped with a serial number in the database, but the serial number is not locked. The serial number can be changed, if necessary, and locked once the EAGLE is on-site, with the ent-serial-num command. The ent-serial-num command uses these parameters.

:serial – The serial number assigned to the EAGLE. The serial number is not case sensitive.

:lock – Specifies whether or not the serial number is locked. This parameter has only one value, yes, which locks the serial number. Once the serial number is locked, it cannot be changed.

Note:

To enter and lock the EAGLE’s serial number, the ent-serial-num command must be entered twice, once to add the correct serial number to the database with the serial parameter, then again with the serial and the lock=yes parameters to lock the serial number. You should verify that the serial number in the database is correct before locking the serial number. The serial number can be found on a label affixed to the control shelf (shelf 1100).

Once the controlled feature has been enabled, the controlled feature must be activated with the chg-ctrl-feat command. The chg-ctrl-feat command uses these parameters:

:partnum – The Oracle-issued part number associated with the controlled feature. The part number is a 9-digit number, not including dashes. The first three digits must be 893 (that is, 893xxxxxx, where x is a numeric value).

:status=on – used to activate the controlled features that customer has purchased and enabled.

The status of the controlled features in the EAGLE is shown with the rtrv-ctrl-feat command.

The part numbers for the Command Class Management, IP User Interface, and Network Security Enhancements features are:

  • Command Class Management – 893005801

  • Telnet (IP User Interface) – 893005701

  • Network Security Enhancements – 893009101

  1. Display the status of the controlled features by entering the rtrv-ctrl-feat command.

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  off     ----
LNP Short Message Service 893006601  on      ----
Intermed GTT Load Sharing 893006901  off     ----
XGTT Table Expansion      893006101  off     ----
XMAP Table Expansion      893007710  on      3000
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the rtrv-ctrl-feat output shows that the controlled feature is permanently enabled, and its status is on, no further action is necessary.

    If the controlled feature is permanently enabled, and its status is off, skip steps 2 through 4, and go to step 5.

    If the controlled feature is temporarily enabled, and you wish to permanently enable this feature, or the temporary feature access key for that feature has expired, skip steps 2 and 3, and go to step 4.

    If the controlled feature is to remain temporarily enabled, and its status is off, skip steps 2 through 4, and go to step 5. If the feature’s status is on, no further action is necessary.

    If the controlled feature is to remain temporarily enabled, and its status is on, no further action is necessary.

    Note:

    If the rtrv-ctrl-feat output in step 1 shows any controlled features, skip steps 2 and 3, and go to step 4. If the rtrv-ctrl-feat output shows only the HC-MIMSLK Capacity feature with a quantity of 64, steps 2 and 3 must be performed.
  2. Display the serial number in the database with the rtrv-serial-num command.

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = ntxxxxxxxxxxxxx

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed

    Note:

    If the serial number is correct and locked, skip steps 3, 4, and 5, and go to step 6. If the serial number is correct but not locked, skip steps 3 and 4, and go to step 5. If the serial number is not correct, but is locked, this feature cannot be enabled and the remainder of this procedure cannot be performed. Contact the Customer Care Center to get an incorrect and locked serial number changed. Refer to My Oracle Support (MOS) for the contact information. The serial number can be found on a label affixed to the control shelf (shelf 1100).
  3. Enter the correct serial number into the database using the ent-serial-num command with the serial parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s correct serial number>

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  4. Verify that the serial number entered into step 3 was entered correctly using the rtrv-serial-num command.

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed

    If the serial number was not entered correctly, repeat steps 3 and 4 and re-enter the correct serial number.

  5. Lock the serial number in the database by entering the ent-serial-num command with the serial number shown in step 2, if the serial number shown in step 2 is correct, or with the serial number shown in step 4, if the serial number was changed in step 3, and with the lock=yes parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s serial number>:lock=yes

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  6. Enable the controlled feature with either a permanent key or temporary key by entering the enable-ctrl-feat command.

    For this example, enter these commands.

    enable-ctrl-feat:partnum=893005801:fak=xxxxxxxxxxxxx

    enable-ctrl-feat:partnum=893005701:fak=xxxxxxxxxxxxx

    enable-ctrl-feat:partnum=893009101:fak=xxxxxxxxxxxxx

    Note:

    The values for the feature access key (the fak parameter) are provided by Oracle. The feature access key determines if the controlled feature is permanently or temporarily enabled. If you do not have the controlled feature part number or the feature access key for the feature you wish to enable, contact your Oracle Sales Representative or Account Representative.

    When the enable-ctrl-feat command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENABLE-CTRL-FEAT: MASP B - COMPLTD

    Note:

    If a temporarily enabled feature was permanently enabled in step 4, and the status of the temporarily enabled feature was on, skip step 5 and go to step 6.
  7. The controlled features enabled in step 4 must be activated using the chg-ctrl-feat command, specifying the controlled feature part number used in step 4 and the status=on parameter.
    For this example, enter these commands.

    chg-ctrl-feat:partnum=893005801:status=on

    chg-ctrl-feat:partnum=893005701:status=on

    chg-ctrl-feat:partnum=893009101:status=on

    When the chg-ctrl-feat command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CHG-CTRL-FEAT: MASP B - COMPLTD
  8. Verify the changes by entering the rtrv-ctrl-featcommand with the part number specified in step 5.

    rtrv-ctrl-feat:partnum=893005801

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:
Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  on      ----

    rtrv-ctrl-feat:partnum=893005701

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:
Feature Name              Partnum    Status  Quantity
Telnet                    893005701  on      ----

    rtrv-ctrl-feat:partnum=893009101

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:
Feature Name              Partnum    Status  Quantity
Network Security Enhance  893009101  on      ----
  9. Backup the new changes using the chg-db:action=backup:dest=fixed command.

    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 

    
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure A-1 Activating Controlled Features



Sheet 1 of 4



Sheet 2 of 4



Sheet 3 of 4



Sheet 4 of 4

A.3 Activating the EAGLE OA&M IP Security Enhancement Controlled Feature

This procedure is used to enable and activate the EAGLE OAM IP Security Enhancement Controlled Feature, using the feature’s part number and a feature access key.

For Release 46.5 and later. the EAGLE OA&M IP Security feature is enabled by default and the feature entry is used to control only the alarming if the SSH for terminals or Security of FTP Server entries is OFF. SSH for terminals and Security of FTP Server entries are controlled via the SECU-DFLT: SSH parameter and SECUIRTY parameter against the FTP servers entries, respectively. The following is expected after upgrade to release 46.5 or later from release 46.4 or earlier:

  1. If the OA&M IP Security feature is currently (R46.4 or earlier) OFF, then it will remain OFF after the upgrade to R46.5.
  2. If the OA&M IP Security feature is currently (R46.4 or earlier) ON, and all the FTP Servers have Security ON and the Telnet terminals are using SSH, then it will remain ON after the upgrade to R46.5.
  3. If the OA&M IP Security feature is currently (R46.4 or earlier) ON, and there was 1 or more FTP Servers or Telnet terminals not using SSH, then it will be turned OFF after upgrade to R46.5, so that no new alarms will be generated after the upgrade.
  4. If the OA&M IP Security feature is currently (R46.4 or earlier) OFF and SECU-DFLT-SSH parameter is ON, then the SECU-DFLT-SSH parameter will be turned OFF after the upgrade to R46.5, so that the access protocol used will not be changed after the upgrade.
  5. If the OA&M IP Security feature is currently (R46.4 or earlier) OFF and the SECURITY parameter is ON for the FTP server entry in the FTP server table, then the SECURITY parameter for the FTP server entry (except for the SFLOG FTP server entry) will be turned OFF after the upgrade to R46.5, so that the file transfer protocol used will not be changed after the upgrade.

With SSH for terminals ON, a secure shell connection is established between the EAGLE and the telnet terminals allowing passwords to be sent over the connection. This allows the EAGLE administrator to add new users to the EAGLE (with the ent-user command) and to change the passwords of existing users (with the pid parameter of the chg-user command) from a telnet terminal.

If the SSH for terminals is ON, the FTRA must be configured to support secure connections to the EAGLE. Go to FTP Table Base Retrieval User's Guide, for more information on using secure connections with the FTRA.

If Security of meas FTP Server entry is ON, the Measurements Platform must support secure FTP servers. Go to the Adding an FTP Server procedure for more information on configuring secure FTP servers for the Measurements Platform.

Similarly, if Security of FTP Server entry for any specific application (dist, db, user) is ON, the designated FTP server for the application must support secure FTP protocol.

Caution:

If EAGLE OA&M IP Security Enhancements feature is activated with a temporary feature access key and that key expires, secure shell connections will become non-secure. Passwords can be transmitted on a non-secure connection, but cannot be assigned or changed. The ent-user command and pid parameter of the chg-user command cannot be used. File transfers using secure FTP cannot be performed unless non-secure FTP servers are available. It is recommended that the FTRA and the Measurements Platform is configured with secure and non-secure FTP servers.

To enable and activate this feature, the enable-ctrl-feat, ent-serial-num, and chg-ctrl-feat commands are used. For more information on these commands, go to the Activating Controlled Features procedure, or Commands User's Guide.

  1. Display the status of the controlled features by entering the rtrv-ctrl-feat command.

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  off     ----
LNP Short Message Service 893006601  on      ----
Intermed GTT Load Sharing 893006901  off     ----
XGTT Table Expansion      893006101  off     ----
XMAP Table Expansion      893007710  on      3000
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the rtrv-ctrl-feat output shows that the controlled feature is permanently enabled, and its status is on, no further action is necessary.

    If the controlled feature is permanently enabled, and its status is off, skip steps 2 through 6, and go to step 7.

    If the controlled feature is temporarily enabled, and you wish to permanently enable this feature, or the temporary feature access key for that feature has expired, skip steps 2 through 5, and go to step 6.

    If the controlled feature is to remain temporarily enabled, and its status is off, skip steps 2 through 6, and go to step 7. If the feature’s status is on, no further action is necessary. If the controlled feature is to remain temporarily enabled, and its status is on, no further action is necessary.

    Note:

    If the rtrv-ctrl-feat output in step 1 shows any controlled features, skip steps 2 through 5, and go to step 6. If the rtrv-ctrl-feat output shows only the HC-MIMSLK Capacity feature with a quantity of 64, steps 2 through 5 must be performed.
  2. Display the serial number in the database with the rtrv-serial-num command.

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = ntxxxxxxxxxxxxx

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed

    Note:

    If the serial number is correct and locked, skip steps 3, 4, and 5, and go to step 6. If the serial number is correct but not locked, skip steps 3 and 4, and go to step 5. If the serial number is not correct, but is locked, this feature cannot be enabled and the remainder of this procedure cannot be performed. Contact the Customer Care Center to get an incorrect and locked serial number changed. Refer to My Oracle Support (MOS) for the contact information. The serial number can be found on a label affixed to the control shelf (shelf 1100).

  3. Enter the correct serial number into the database using the ent-serial-num command with the serial parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s correct serial number>

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  4. Verify that the serial number entered into step 3 was entered correctly using the rtrv-serial-num command.

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed

    If the serial number was not entered correctly, repeat steps 3 and 4 and re-enter the correct serial number.

  5. Lock the serial number in the database by entering the ent-serial-num command with the serial number shown in step 2, if the serial number shown in step 2 is correct, or with the serial number shown in step 4, if the serial number was changed in step 3, and with the lock=yes parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s serial number>:lock=yes

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  6. Enable the controlled feature with either a permanent key or temporary key by entering the enable-ctrl-feat command.
    For this example, enter this command.

    enable-ctrl-feat:partnum=893400001:fak=<feature access key>

    Note:

    The values for the feature access key (the fak parameter) are provided by Oracle. If you do not have the feature access key for the SEAS over IP feature, contact your Oracle Sales Representative or Account Representative.

    When the enable-ctrl-feat command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENABLE-CTRL-FEAT: MASP B - COMPLTD

    Note:

    If the feature was temporarily enabled before being permanently enabled in step 6, and the status of the temporarily enabled feature was on, skip steps 7 through 12, and go to step 13.
  7. Before the status of the EAGLE OAMIP Security Enhancements controlled feature can be changed to on, all ISPMs, if present, must be taken out of service.

    Before the ISPMs can be taken out of service, all telnet terminals associated with the IPSMs must be taken out of service. Enter the rtrv-trm command to display the terminals in the database. The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 16:02:08 GMT EAGLE5 39.0.0
TRM  TYPE     COMM        FC    TMOUT MXINV DURAL
1    VT320    9600-7-E-1  SW    30    5     99:59:59
2    KSR      9600-7-E-1  HW    30    5     INDEF
3    PRINTER  4800-7-E-1  HW    30    0     00:00:00
4    VT320    2400-7-E-1  BOTH  30    5     00:30:00
5    VT320    9600-7-O-1  NONE  30    5     00:00:30
6    VT320    9600-7-E-2  SW    30    9     INDEF
7    PRINTER  9600-7-N-2  HW    30    5     00:30:00
8    KSR     19200-7-E-2  BOTH  30    5     00:30:00
9    VT320    9600-7-E-1  SW    30    7     00:30:00
10   VT320    9600-7-E-1  HW    30    5     00:30:00
11   VT320    4800-7-E-1  HW    30    5     00:30:00
12   PRINTER  9600-7-E-1  HW    30    4     00:30:00
13   VT320    9600-7-O-1  NONE  30    5     00:30:00
14   VT320    9600-7-E-2  SW    30    8     00:30:00
15   VT320    9600-7-N-2  HW    30    5     00:30:00
16   VT320    9600-7-E-2  BOTH  30    3     00:30:00

TRM  TYPE      LOC              TMOUT MXINV DURAL      SECURE
17   TELNET    2107             60    5     00:30:00
18   TELNET    2107             60    5     00:30:00
19   TELNET    2107             60    5     00:30:00
20   TELNET    2107             60    5     00:30:00
21   TELNET    2107             60    5     00:30:00
22   TELNET    2107             60    5     00:30:00
23   TELNET    2107             60    5     00:30:00
24   TELNET    2107             60    5     00:30:00
25   TELNET    2108             60    5     00:30:00
26   TELNET    2108             60    5     00:30:00
27   TELNET    2108             60    5     00:30:00
28   TELNET    2108             60    5     00:30:00
29   TELNET    2108             60    5     00:30:00
30   TELNET    2108             60    5     00:30:00
31   TELNET    2108             60    5     00:30:00
32   TELNET    2108             60    5     00:30:00
33   TELNET    2111             60    5     00:30:00
34   TELNET    2111             60    5     00:30:00
35   TELNET    2111             60    5     00:30:00
36   TELNET    2111             60    5     00:30:00
37   TELNET    2111             60    5     00:30:00
38   TELNET    2111             60    5     00:30:00
39   TELNET    2111             60    5     00:30:00
40   TELNET    2111             60    5     00:30:00

TRM  LOGINTMR LOGOUTTMR PNGTIMEINT PNGFAILCNT
     (sec)    (sec)     (msec)
17   none     none      none       1
18   none     none      none       1
19   none     none      none       1
20   none     none      none       1
21   none     none      none       1
22   none     none      none       1
23   none     none      none       1
24   none     none      none       1
25   none     none      none       1
26   none     none      none       1
27   none     none      none       1
28   none     none      none       1
28   none     none      none       1
30   none     none      none       1
31   none     none      none       1
32   none     none      none       1
33   none     none      none       1
34   none     none      none       1
35   none     none      none       1
36   none     none      none       1
37   none     none      none       1
38   none     none      none       1
39   none     none      none       1
40   none     none      none       1

TRM  TRAF LINK SA  SYS PU  DB  UIMRD
1    NO   YES  NO  YES NO  YES YES
2    NO   NO   NO  NO  NO  NO  NO
.
.
.
39   NO   NO   NO  NO  NO  NO  NO
40   NO   NO   NO  NO  NO  NO  NO

     APP  APP
TRM  SERV SS  CARD CLK DBG GTT GWS MEAS MON MPS SEAS 
1    YES  YES YES  YES YES YES YES YES  YES YES NO   
2    YES  YES YES  YES YES YES YES YES  YES YES NO   
.
.
.
39   NO   NO  NO   NO  NO  NO  NO  NO   NO  NO  NO   
40   NO   NO  NO   NO  NO  NO  NO  NO   NO  NO  NO

    Note:

    If the rtrv-trm output in step 7 shows no telnet terminals, skip steps 8 through 11, and go to step 12.
  8. Display the status of the IPSMs by entering the rept-stat-card command with the card location of each IPSM shown in the output of step 7.

    rept-stat-card:loc=2107

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 16:43:42 GMT  EAGLE5 36.0.0
CARD   VERSION      TYPE      GPL        PST            SST        AST
2107   114-001-000  IPSM      IPS        IS-NR          Active     -----

  ALARM STATUS       = No Alarms.
  BPDCM GPL          = 002-122-000
  IMT BUS A          = Conn
  IMT BUS B          = Conn
Command Completed.

    rept-stat-card:loc=2108

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 16:43:42 GMT  EAGLE5 36.0.0
CARD   VERSION      TYPE      GPL        PST            SST        AST
2108   114-001-000  IPSM      IPS        IS-NR          Active     -----

  ALARM STATUS       = No Alarms.
  BPDCM GPL          = 002-122-000
  IMT BUS A          = Conn
  IMT BUS B          = Conn
Command Completed.

    rept-stat-card:loc=2111

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 16:43:42 GMT  EAGLE5 36.0.0
CARD   VERSION      TYPE      GPL        PST            SST        AST
2111   114-001-000  IPSM      IPS        IS-NR          Active     -----

  ALARM STATUS       = No Alarms.
  BPDCM GPL          = 002-122-000
  IMT BUS A          = Conn
  IMT BUS B          = Conn
Command Completed.

    If all the IPSMs are out of service, shown by the entry OOS-MT-DSBLD in the PST column, skip steps 9 and 10, and go to step 11.

  9. Display the status of the terminals by entering the rept-stat-trm command.

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 15:08:45 GMT EAGLE5 36.0.0
TRM   PST           SST           AST
1     IS-NR         Active        -----
2     IS-NR         Active        -----
3     IS-NR         Active        -----
4     IS-NR         Active        -----
5     IS-NR         Active        -----
6     IS-NR         Active        -----
7     IS-NR         Active        -----
8     IS-NR         Active        -----
9     IS-NR         Active        -----
10    IS-NR         Active        -----
11    IS-NR         Active        -----
12    IS-NR         Active        -----
13    IS-NR         Active        -----
14    IS-NR         Active        -----
15    IS-NR         Active        -----
16    IS-NR         Active        -----
17    IS-NR         Active        -----
18    IS-NR         Active        -----
19    IS-NR         Active        -----
20    IS-NR         Active        -----
21    IS-NR         Active        -----
22    IS-NR         Active        -----
23    IS-NR         Active        -----
24    IS-NR         Active        -----
25    IS-NR         Active        -----
26    IS-NR         Active        -----
27    IS-NR         Active        -----
28    IS-NR         Active        -----
29    IS-NR         Active        -----
30    IS-NR         Active        -----
31    IS-NR         Active        -----
32    IS-NR         Active        -----
33    IS-NR         Active        -----
34    IS-NR         Active        -----
35    IS-NR         Active        -----
36    IS-NR         Active        -----
37    IS-NR         Active        -----
38    IS-NR         Active        -----
39    IS-NR         Active        -----
40    IS-NR         Active        -----

Command Completed.

    Note:

    If all the terminals associated with the IPSMs being taken out of service are out of service, shown by the entry OOS-MT-DSBLD in the PST column, skip step 10 and go to step 11.

  10. Place the terminals associated with the IPSMs being taken out of service using the rmv-trm command with the terminal number shown in step 7.

    For this example, enter these commands.

    rmv-trm:trm=17

    rmv-trm:trm=18

    rmv-trm:trm=19

    rmv-trm:trm=20

    rmv-trm:trm=21

    rmv-trm:trm=22

    rmv-trm:trm=23

    rmv-trm:trm=24

    rmv-trm:trm=25

    rmv-trm:trm=26

    rmv-trm:trm=27

    rmv-trm:trm=28

    rmv-trm:trm=29

    rmv-trm:trm=30

    rmv-trm:trm=31

    rmv-trm:trm=32

    rmv-trm:trm=33

    rmv-trm:trm=34

    rmv-trm:trm=35

    rmv-trm:trm=36

    rmv-trm:trm=37

    rmv-trm:trm=38

    rmv-trm:trm=39

    rmv-trm:trm=40

    Caution:

    Placing these terminals out of service will disable any Telnet sessions running on these terminals.

    If the status of any terminals associated with the IPSM being removed shown in the PST field in step 9 is OOS-MT-DSBLD (out-of-service maintenance disabled), the terminal is already out of service and the rmv-trm command does not need to be executed for that terminal.

    When these commands have successfully completed, this message should appear. 

    
rlghncxa03w 06-10-01 15:08:45 GMT EAGLE5 36.0.0
Inhibit message sent to terminal

rlghncxa03w 06-10-01 15:08:45 GMT EAGLE5 36.0.0
Command Completed.
  11. Place the IPSMs out of service using the rmv-card command, specifying the card location of the IPSM.

    For this example, enter this command.

    rmv-card:loc=2107

    rmv-card:loc=2108

    rmv-card:loc=2111

    When this command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-01 09:12:36 GMT  EAGLE5 36.0.0
Card has been inhibited.
  12. The controlled feature enabled in step 6 must be activated using the chg-ctrl-feat command, specifying the controlled feature part number used in step 6 and the status=on parameter.

    For this example, enter this command.

    chg-ctrl-feat:partnum=893400001:status=on

    When the chg-ctrl-feat command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CHG-CTRL-FEAT: MASP B - COMPLTD
  13. Verify the changes by entering the rtrv-ctrl-featcommand with the part number specified in step 12.

    rtrv-ctrl-feat:partnum=893400001

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:
Feature Name              Partnum    Status  Quantity
EAGLE OAM IP Security     893400001  on      ----

    Note:

    If steps 7 through 11 were not performed, skip steps 14 and 15, and go to step 16.

  14. Place the terminals that were taken out of service in step 10 back into service by entering the rst-trm command with the terminal numbers specified in step 10.

    For this example, enter these commands.

    rst-trm:trm=17

    rst-trm:trm=18

    rst-trm:trm=19

    rst-trm:trm=20

    rst-trm:trm=21

    rst-trm:trm=22

    rst-trm:trm=23

    rst-trm:trm=24

    rst-trm:trm=25

    rst-trm:trm=26

    rst-trm:trm=27

    rst-trm:trm=28

    rst-trm:trm=29

    rst-trm:trm=30

    rst-trm:trm=31

    rst-trm:trm=32

    rst-trm:trm=33

    rst-trm:trm=34

    rst-trm:trm=35

    rst-trm:trm=36

    rst-trm:trm=37

    rst-trm:trm=38

    rst-trm:trm=39

    rst-trm:trm=40

  15. Place the ISPMs back into service by entering the rst-card command with the card locations specified in step 11.

    For this example, enter this command.

    rst-card:loc=2107

    rst-card:loc=2108

    rst-card:loc=2111

    When this command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-01 09:12:36 GMT  EAGLE5 36.0.0
Card has been allowed.

    When the IPSMs are placed into service with the rst-card command, UIM 1494, SSH Host Keys Loaded, is displayed. UIM 1494 contains the public host key fingerprint which is used to establish a secure connection with an SSH client. If the secure connection is to be made with the FTRA, the public host key fingerprint displayed in UIM 1494 must be added to the hosts.xml file in the FTRA. Record the public host key fingerprint information displayed in UIM 1494 if a secure connection to the FTRA will be made. For more information about editing the hosts.xml file on the FTRA, see FTP Table Base Retrieval User 's Guide.

  16. Backup the new changes using the chg-db:action=backup:dest=fixedcommand.

    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first

    . 
    
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure A-2 Activating the EAGLE OA&M IP Security Enhancement Controlled Feature



Sheet 1 of 4



Sheet 2 of 4



Sheet 3 of 4



Sheet 4 of 4

A.4 Unmate IP Security for Terminal and Measurements

EAGLE Release 45.0 provides the capability to unmate the IP Security for Telnet and FTP. The Terminal security (SSH) will be controlled by an option 'ssh' in the Security Default table. This option can be set to ON to enable SSH or set to OFF to disable SSH. The chg-secu-dflt command is modified to support the parameter 'ssh' that turns SSH ON/OFF. The parameter is optional, and defaults to ON. Example command:

chg-secu-dflt:ssh=on

Security for the FTP interfaces will be controlled by an option Security in the FTP Server table. Each option in the table defines the parameters for a specific FTP interface. The parameter Security can be turned ON/OFF for each server entry independently. When the OAM IP Security feature is ON and the FTP interface Security parameter is ON, the interface will be protected by data encryption.

The Security Parameter can be set when an interface is initially created with the ent-ftp-serv command, or changed for an existing interface with the chg-ftp-serv command. The parameter is optional, and defaults to ON. Example commands:

ent-ft-serv-:ipaddr=x.x.x.x:login=user:app=dist:prio=1=login=eagle:path="/path":security=on and

chg-ftp-serv:ipaddr=x.x.x.x:app=dist:security=on.

A.5 Activating the 15 Minute Measurements Controlled Feature

This procedure is used to enable and turn on the 15 Minute Measurements controlled feature, using the feature’s part number and a feature access key. This feature allows EAGLE measurements to be collected every 15 minutes.

To enable and turn on the 15 Minute Measurements controlled feature, the following requirements must be met:

  • The Measurements Platform feature must be on, or the Integrated Measurements feature must be enabled and turned on.
  • The EAGLE must be configured to use the Measurements Platform, or the Integrated Measurements feature.
  • If the Measurements Platform is being used, MCPMs must be provisioned in the database, and the state of all these MCPMs must be IS-NR.

The enable-ctrl-feat, ent-serial-num, and chg-ctrl-feat commands are used to enable and turn on the 15 Minute Measurements controlled feature using the feature’s part number and a feature access key.

The feature access key for the 15 Minute Measurements controlled feature is based on the feature’s part number and the serial number of the EAGLE, making the feature access key site-specific.

The enable-ctrl-feat command enables the feature by inputting the feature’s access key and the feature’s part number with these parameters:

:fak – The feature access key provided by Oracle. The feature access key contains 13 alphanumeric characters and is not case sensitive.

:partnum – The Oracle-issued part number of the 15 Minute Measurements controlled feature, 893012101.

The enable-ctrl-feat command requires that the database contain a valid serial number for the EAGLE, and that this serial number is locked. This can be verified with the rtrv-serial-num command. The EAGLE is shipped with a serial number in the database, but the serial number is not locked. The serial number can be changed, if necessary, and locked once the EAGLE is on-site, with the ent-serial-num command. The ent-serial-num command uses these parameters.

:serial – The serial number assigned to the EAGLE. The serial number is not case sensitive.

:lock – Specifies whether or not the serial number is locked. This parameter has only one value, yes, which locks the serial number. Once the serial number is locked, it cannot be changed.

Note:

To enter and lock the EAGLE’s serial number, the ent-serial-num command must be entered twice, once to add the correct serial number to the database with the serial parameter, then again with the serial and the lock=yes parameters to lock the serial number. You should verify that the serial number in the database is correct before locking the serial number. The serial number can be found on a label affixed to the control shelf (shelf 1100).

This feature cannot be temporarily enabled (with the temporary feature access key).

Once this feature has been enabled, the feature must be turned on with the chg-ctrl-feat command. The chg-ctrl-feat command uses these parameters:

:partnum – The Oracle-issued part number of the 15 Minute Measurements controlled feature, 893027701.

:status=on – used to turn the 15 Minute Measurements controlled feature on.

Once the 15 Minute Measurements controlled feature has been turned on, it be cannot be turned off.

The status of the features in the EAGLE is shown with the rtrv-ctrl-feat command.

After the 15 Minute Measurements controlled feature is enabled and turned on, the 15 minute measurement collection option in the measurement options table must be turned on.

  1. Display the status of the 15 Minute Measurements controlled features by entering the rtrv-ctrl-feat command.

    The following is an example of the possible output.

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  off     ----
LNP Short Message Service 893006601  on      ----
Intermed GTT Load Sharing 893006901  off     ----
XGTT Table Expansion      893006101  off     ----
XMAP Table Expansion      893007710  on      3000
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000
15 Minute Measurements    893012101  off     ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the rtrv-ctrl-feat output shows that the 15 Minute Measurements controlled feature is enabled, and its status is on, no further action is necessary.

    If the 15 Minute Measurements controlled feature is enabled, and its status is off, continue the procedure with 7.

    Note:

    If the rtrv-ctrl-feat output in 1 shows any controlled features, continue the procedure with 6. If the rtrv-ctrl-feat output shows only the HC-MIM SLK Capacity feature with a quantity of 64, 2 through 5 must be performed.
  2. Display the serial number in the database with the rtrv-serial-num command.

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = ntxxxxxxxxxxxxx

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed

    Note:

    If the serial number is correct and locked, continue the procedure with 6. If the serial number is correct but not locked, continue the procedure with 5. If the serial number is not correct, but is locked, this feature cannot be enabled and the remainder of this procedure cannot be performed. Contact the Customer Care Center to get an incorrect and locked serial number changed. Refer to My Oracle Support (MOS) for the contact information. The serial number can be found on a label affixed to the control shelf (shelf 1100).
  3. Enter the correct serial number into the database using the ent-serial-num command with the serial parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s correct serial number>

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  4. Verify that the serial number entered into 3 was entered correctly using the rtrv-serial-num command.

    This is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed

    If the serial number was not entered correctly, repeat 3 and 4 and re-enter the correct serial number.

  5. Lock the serial number in the database by entering the ent-serial-num command with the serial number shown in 2 , if the serial number shown in 2 is correct, or with the serial number shown in 4 , if the serial number was changed in 3 , and with the lock=yes parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s serial number>:lock=yes

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  6. Enable the 15 Minute Measurements controlled feature by entering the enable-ctrl-feat command.

    For this example, enter this command.

    enable-ctrl-feat:partnum=893012101:fak=<feature access key>

    This feature cannot be enabled with a temporary feature access key.

    Note:

    The values for the feature access key (the fak parameter) are provided by Oracle. If you do not have the controlled feature part number or the feature access key for the feature you wish to enable, contact your Oracle Sales Representative or Account Representative.

    When the enable-ctrl-feat command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENABLE-CTRL-FEAT: MASP B - COMPLTD
  7. Display the quantity of signaling links that are provisioned in the EAGLE by entering the rtrv-tbl-capacity command.

    This is an example of the possible output.

    
rlghncxa03w 10-04-19 21:16:37 GMT EAGLE5 42.0.0
SLK      table is (        7 of      1200)   1% full

    Note:

    The rtrv-tbl-capacity command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-tbl-capacity command, refer to the rtrv-tbl-capacity command description in Commands User's Guide.
  8. To enable the 15 Minute Measurements controlled feature, either the Measurements Platform feature must be on and the Measurements Platform option (PLATFORMENABLE) must be on, or the Integrated Measurements feature must be enabled and turned on and the measurement collection option for the E5-MCAP card (OAMHCMEAS) must be on. If the EAGLE contains more than 1200 signaling links, shown in 7, the Measurements Platform feature must be used. If the EAGLE contains 1200 signaling links or less, either the Measurements Platform feature or the Integrated Measurements feature can be used. Verify whether or nor the Measurements Platform option is enabled (PLATFORMENABLE = on), or the measurement collection option for the E5-MCAP card (OAMHCMEAS) must be on using the rtrv-measopts command.

    The following is an example of the possible output.

    
rlghncxa03w 10-04-01 16:02:05 GMT  EAGLE5 42.0.0

PLATFORMENABLE = on
COLLECT15MIN   = off
CLLIBASEDNAME  = on
OAMHCMEAS      = off
-------------------------------------
SYSTOTSTP     =on

    Note:

    The rtrv-measopts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-measopts command, see the rtrv-measopts command description in Commands User's Guide.

    If the Measurements Platform option is enabled, continue the procedure with 11.

    If the Measurements Platform option is not enabled and the Measurements Platform is required, or you wish to use the Measurements Platform, continue the procedure with 9.

    If the Integrated Measurements feature will be used, continue the procedure by performing one of these steps.
    • If the measurement collection option for the E5-MCAP card (OAMHCMEAS) is on, continue the procedure with 11.
    • If the measurement collection option for the E5-MCAP card (OAMHCMEAS) is off, continue the procedure by performing one of these steps.
      • If the Integrated Measurements feature is not enabled or turned on, shown in the rtrv-ctrl-feat output in 1, perform the Configuring the Integrated Measurements Feature procedure to configure the Integrated Measurements feature. Continue the procedure with 11.
      • If the Integrated Measurements feature is enabled and turned on, continue the procedure with 10.
  9. Verify whether or not the Measurements Platform feature is on by entering the rtrv-feat command.

    If the Measurements Platform feature is on, the entry MEASPLAT = on is shown in the rtrv-feat command output:

    Note:

    The rtrv-feat command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-feat command, see the rtrv-feat command description in Commands User's Guide.

    If the Measurements Platform feature is not on, perform the Adding a Measurement Collection and Polling Module (MCPM) procedure to add the required MCPMs and to turn the Measurements Platform feature on. After the Measurements Platform is turned on, perform the Configuring the Measurements Platform Feature procedure to configure the Measurements Platform feature. Continue the procedure with 11.

    If the Measurements Platform is on, perform the Configuring the Measurements Platform Feature procedure to configure Measurements Platform feature and to enable the Measurements Platform option, if required. Continue the procedure with 11..

  10. Turn the measurement collection option for the E5-MCAP card (OAMHCMEAS) on by entering this command.

    chg-measopts:oamhcmeas=on

    When the chg-measopts command has successfully completed, the following message should appear. 

    
rlghncxa03w 10-04-01 21:16:37 GMT EAGLE5 42.0.0
CHG-MEASOPTS: MASP A - COMPLTD
  11. Turn the 15 Minute Measurements controlled feature on using the chg-ctrl-feat command, specifying the 15 Minute Measurements controlled feature part number and the status=on parameter.

    Note:

    If a 30-minute measurement collection is in progress, the chg-ctrl-feat command will be rejected. Wait until the 30-minute measurement collection has finished before executing the chg-ctrl-feat command.

    For this example, enter this command.

    chg-ctrl-feat:partnum=893012101:status=on

    Note:

    Once the 15 Minute Measurements feature is turned on, it cannot be turned off.

    When the chg-ctrl-feat command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CHG-CTRL-FEAT: MASP B - COMPLTD
  12. Verify the changes by entering the rtrv-ctrl-feat command with the part number specified in 11 .

    rtrv-ctrl-feat:partnum=893012101

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:
Feature Name              Partnum    Status  Quantity
15 Minute Measurements    893012101  on      ----
  13. Turn the 15 Minute Measurement collection option on by entering this command.

    chg-measopts:collect15min=on

    When the chg-measopts command has successfully completed, the following message should appear. 

    
rlghncxa03w 10-04-01 21:16:37 GMT EAGLE5 42.0.0
CHG-MEASOPTS: MASP A - COMPLTD
  14. Verify that the 15 Minute Measurement collection option is on by entering the rtrv-measopts command.

    The following is an example of the possible output. 

    
rlghncxa03w 10-04-01 16:02:05 GMT  EAGLE5 42.0.0

PLATFORMENABLE = on
COLLECT15MIN   = on
CLLIBASEDNAME  = on
OAMHCMEAS      = off
-------------------------------------
SYSTOTSTP     =on

    Note:

    The rtrv-measopts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-measopts command, see the rtrv-measopts command description in Commands User's Guide.
  15. Backup the new changes using the chg-db:action=backup:dest=fixed command.

    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 

    
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure A-3 Activating the 15 Minute Measurements Controlled Feature



Sheet 1 of 4



Sheet 2 of 4



Sheet 3 of 4



Sheet 4 of 4

A.6 Clearing a Temporary FAK Alarm

This procedure is used to clear the critical alarm, UAM 0368, generated when a a temporary feature access key has expired, using the chg-ctrl-feat command.

The chg-ctrl-feat command uses the following parameters:

:partnum - The part number of the controlled feature that was temporarily enabled and is causing the alarm.

:alarm=clear - Clears UAM 0368, Temp Key(s) have expired.

The controlled feature must have been temporarily enabled and is now in danger of expiration or in an expired state.

  1. Display the controlled feature that has the expired feature access key by entering the rtrv-ctrl-feat:expired=yes command.

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:17:37 GMT EAGLE5 36.0.0
The following features have expired temporary keys:
Feature Name              Part Num
Command Class Management  893005801
  2. Clear the EAGLE alarm in the database by entering the chg-ctrl-feat command.

    For example, enter this command.

    chg-ctrl-feat:partnum=893005801:alarm=clear

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
CHG-CTRL-FEAT: MASP A - COMPLTD
  3. Verify that the alarm has cleared in the database by using the rtrv-ctrl-feat:expired=yes command.

    The following is an example of the possible output.

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
0367.0181  *  SYSTEM      Temp Key(s) expiration alarm cleared.
  4. Backup the new changes using the chg-db:action=backup:dest=fixedcommand.

    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first

    . 
    
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure A-4 Clearing a Temporary FAK Alarm



A.7 Deactivating Controlled Features

This procedure is used to deactivate these controlled features, Command Class Management, IP User Interface, and Network Security Enhancements using the chg-ctrl-feat command.

The chg-ctrl-feat command uses the following parameters:

:partnum - The part number of the controlled feature being deactivated.

  • Command Class Management – 893005801
  • Telnet (IP User Interface) – 893005701
  • Network Security Enhancements – 893009101

:status=off – used to deactivate the controlled feature.

The status of the controlled feature being deactivated must be on and is shown with the rtrv-ctrl-feat command.

Caution:

If the SEAS over IP feature is turned off, all SEAS terminal traffic stops.

Caution:

If the IP User Interface (TELNET) controlled feature is deactivated, all Telnet sessions supported by this feature will be disabled. No changes can be made to the configuration of the Telnet terminals (terminals 17 through 40). Deactivating this feature will also deactivate FTP Retrieve and Replace feature. If the SEAS over IP feature is turned on, the TELNET feature cannot be turned off.
  1. Display the controlled features whose status is on by entering the rtrv-ctrl-feat:status=on command.

    The following is an example of the possible output.

    
rlghncxa03w 06-10-01 21:17:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  on      ----
LNP Short Message Service 893006601  on      ----
Intermed GTT Load Sharing 893006901  on      ----
XMAP Table Expansion      893007710  on      3000
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000
Telnet                    893005701  on      ----
Network Security Enhance  893009101  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum   Status Quantity   Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    The TELNET feature cannot be turned off if the SEAS over IP feature is turned on. If the TELNET (IP User Interface) is not being turned off, go to step 2.

    If the TELNET feature is being turned off, and the SEAS over IP feature is not turned on (shown in the rtrv-ctrl-feat output in this step by the entry SEAS over IP), go to step 2.

    If the TELNET feature is being turned off, and the SEAS over IP feature is turned on, perform the Turning Off the SEAS Over IP Feature procedure to turn the SEAS over IP feature off. After the SEAS over IP feature has been turned off, go to step 2.

  2. Deactivate the controlled feature by entering the chg-ctrl-feat command with the status=off parameter.

    For example, enter this command.

    chg-ctrl-feat:partnum=893005801:status=off

    chg-ctrl-feat:partnum=893005701:status=off

    chg-ctrl-feat:partnum=893009101:status=off

    When each of these commands has successfully completed, the following message should appear. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
CHG-CTRL-FEAT: MASP A - COMPLTD
  3. Verify that the controlled feature has been deactivated by using the rtrv-ctrl-feat:partnum=<controlled feature part number> command.

    For this example, enter these commands.

    rtrv-ctrl-feat:partnum=893005801

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  off     ----

The following features have been temporarily enabled:

Feature Name              Partnum   Status Quantity   Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    rtrv-ctrl-feat:partnum=893005701

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Telnet                    893005701  off     ----

The following features have been temporarily enabled:

Feature Name              Partnum   Status Quantity   Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    rtrv-ctrl-feat:partnum=893009101

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Network Security Enhance  893009101  off     ----

The following features have been temporarily enabled:

Feature Name              Partnum   Status Quantity   Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.
  4. Backup the new changes using the chg-db:action=backup:dest=fixedcommand.

    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 

    
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure A-5 Deactivating Controlled Features



A.8 Activating the HIPR2 High Rate Mode Feature

This procedure is used to enable and turn on the HIPR2 High Rate Mode feature using the feature’s part number and a feature access key.

The feature access key for the HIPR2 High Rate Mode feature is based on the feature’s part number and the serial number of the EAGLE, making the feature access key site-specific.

The enable-ctrl-feat command enables the feature by inputting the feature’s access key and the feature’s part number with these parameters:

:fak – The feature access key provided by Oracle. The feature access key contains 13 alphanumeric characters and is not case sensitive.

:partnum – The Oracle-issued part number of the HIPR2 High Rate Mode feature, 893020101.

The enable-ctrl-feat command requires that the database contain a valid serial number for the EAGLE, and that this serial number is locked. This can be verified with the rtrv-serial-num command. The EAGLE is shipped with a serial number in the database, but the serial number is not locked. The serial number can be changed, if necessary, and locked once the EAGLE is on-site, with the ent-serial-num command. The ent-serial-num command uses these parameters.

:serial – The serial number assigned to the EAGLE. The serial number is not case sensitive.

:lock – Specifies whether or not the serial number is locked. This parameter has only one value, yes, which locks the serial number. Once the serial number is locked, it cannot be changed.

Note:

To enter and lock the EAGLE’s serial number, the ent-serial-num command must be entered twice, once to add the correct serial number to the database with the serial parameter, then again with the serial and the lock=yes parameters to lock the serial number. You should verify that the serial number in the database is correct before locking the serial number. The serial number can be found on a label affixed to the control shelf (shelf 1100).

This feature cannot be temporarily enabled (with the temporary feature access key).

Once this feature is enabled, the feature must be turned on with the chg-ctrl-feat command. The chg-ctrl-feat command uses these parameters.

:partnum – The Oracle-issued part number of the HIPR2 High Rate Mode feature, 893020101.

:status=on – used to turn the HIPR2 High Rate Mode feature on.

Caution:

The HIPR2 High Rate Mode feature cannot be turned off if any of these conditions are present.
  • The IMT Rate Change sequence is being performed.
  • The Extended Bit Rate Test (BERT) is being performed.
  • Any of the cards in card locations 9 and 10 in each shelf are being flashed with the init-flash command.

Once the HIPR2 High Rate Mode feature has been turned on, it be can be turned off. For more information on turning the HIPR2 High Rate Mode feature off, perform Turning Off the HIPR2 High Rate Mode Feature.

The status of the features in the EAGLE is shown with the rtrv-ctrl-feat command.

When the HIPR2 High Rate Mode feature is turned on, the throughput of the IMT bus is increased to 2.5 Gbps. If the HIPR2 High Rate Mode feature is not turned on, the throughput of the IMT bus is limited to 1 Gbps. To turn the the HIPR2 High Rate Mode feature on, all the cards in card locations 9 and 10 in each shelf must be HIPR2 cards.

  1. Display the status of the controlled features by entering the rtrv-ctrl-feat command. The following is an example of the possible output. 
    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  on      ----
LNP Short Message Service 893006601  on      ----
Intermed GTT Load Sharing 893006901  on      ----
XGTT Table Expansion      893006101  on      400000
XMAP Table Expansion      893007710  off     ----
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000
HC-MIM SLK Capacity       893012707  on      64

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the HIPR2 High Rate Mode feature is enabled and turned on, no further action is necessary. This procedure does not need to be performed.

    If the HIPR2 High Rate Mode feature is enabled and but not turned on, continue the procedure with 7.

    If the HIPR2 High Rate Mode feature is not enabled, continue the procedure by performing one of these steps.
    • If the rtrv-ctrl-feat output shows the HC-MIM SLK Capacity feature with a quantity of 64 and other features, continue the procedure with 6.
    • If the rtrv-ctrl-feat output shows only the HC-MIMSLK Capacity feature with a quantity of 64, continue the procedure with 2.
  2. Display the serial number in the database with the rtrv-serial-num command. This is an example of the possible output. 
    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
Command Completed

    Note:

    If the serial number is correct and locked, continue the procedure with 6. If the serial number is correct but not locked, continue the procedure with 5. If the serial number is not correct, but is locked, this feature cannot be enabled and the remainder of this procedure cannot be performed. Contact the Customer Care Center to get an incorrect and locked serial number changed. Refer to My Oracle Support (MOS) for the contact information. The serial number can be found on a label affixed to the control shelf (shelf 1100).
  3. Enter the correct serial number into the database using the ent-serial-num command with the serial parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s correct serial number>

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  4. Verify that the serial number entered into 3 was entered correctly using the rtrv-serial-num command. This is an example of the possible output. 
    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
Command Completed

    If the serial number was not entered correctly, repeat 3 and 4 and re-enter the correct serial number.

  5. Lock the serial number in the database by entering the ent-serial-num command with the serial number shown in 2, if the serial number shown in 2 is correct, or with the serial number shown in 4, if the serial number was changed in 3, and with the lock=yes parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s serial number>:lock=yes

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  6. Enable the HIPR2 High Rate Mode feature with the enable-ctrl-feat command specifying the part number for the HIPR2 High Rate Mode feature and the feature access key. Enter this command.

    enable-ctrl-feat:partnum=893020101:fak=<HIPR2 High Rate Mode feature access key>

    The HIPR2 High Rate Mode feature cannot be enabled with a temporary feature access key.

    The values for the feature access key (the fak parameter) are provided by Oracle. If you do not have the feature access key for the HIPR2 High Rate Mode feature, contact your Oracle Sales Representative or Account Representative.

    When the enable-crtl-feat command has successfully completed, this message should appear. 

    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
ENABLE-CTRL-FEAT: MASP B - COMPLTD

    If you do not wish to turn the HIPR2 High Rate Mode feature on at this time, continue the procedure with 9.

    If you wish to turn the HIPR2 High Rate Mode feature, continue the procedure with 7.

  7. To turn the HIPR2 High Rate Mode feature on, all the cards in card locations 9 and 10 in each shelf must be HIPR2 cards. Enter these commands to verify that cards that are in card locations 9 and 10 in each shelf.
    1. To verify if HIPR2 cards are in card locations 9 and 10, enter this command.

      rept-stat-gpl:gpl=hipr2

      This is an example of the possible output.

      
rlghncxa03w 09-07-01 11:40:26 GMT  EAGLE5 41.1.0

GPL      CARD   RUNNING           APPROVED      TRIAL
HIPR2    1309   132-003-000       132-003-000   132-002-000
HIPR2    1310   132-003-000       132-003-000   132-002-000
HIPR2    2109   132-003-000       132-003-000   132-002-000
HIPR2    2100   132-003-000       132-003-000   132-002-000
Command Completed

    If no cards running the specified GPL are installed, the rept-stat-gpl output shows no entries, as shown in this example. 

    
rlghncxa03w 09-07-01 11:40:26 GMT  EAGLE5 41.1.0

GPL      CARD   RUNNING           APPROVED      TRIAL

Command Completed

    If card locations 9 and 10 in all shelves contain HIPR2 cards, continue the procedure with 8.

    If card locations 9 and 10 in any shelves contain HMUX or HIPR cards, perform the procedures in Installation Guide to replace the HMUX or HIPR cards with HIPR2 cards. After the HIPR2 cards have been installed, continue the procedure with 8.

  8. Turn the HIPR2 High Rate Mode feature on with the chg-ctrl-feat command specifying the part number for the HIPR2 High Rate Mode feature and the status=on parameter. Enter this command.

    Caution:

    The HIPR2 High Rate Mode feature cannot be turned off if any of these conditions are present.
    • The IMT Rate Change sequence is being performed.
    • The Extended Bit Rate Test (BERT) is being performed.
    • Any of the cards in card locations 9 and 10 in each shelf are being flashed with the init-flash command.

    chg-ctrl-feat:partnum=893020101:status=on

    When the chg-crtl-feat command has successfully completed, this message should appear. 

    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
CHG-CTRL-FEAT: MASP B - COMPLTD
  9. Verify the changes by entering the rtrv-ctrl-featcommand with the HIPR2 High Rate Mode feature part number. Enter this command.

    rtrv-ctrl-feat:partnum=893020101

    The following is an example of the possible output. 

    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
HIPR2 High Rate Mode      893020101  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.
  10. Backup the new changes using the chg-db:action=backup:dest=fixed command. These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first.
    
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure A-6 Activating the HIPR2 High Rate Mode Feature



Sheet 1 of 5



Sheet 2 of 5



Sheet 3 of 5



Sheet 4 of 5



Sheet 5 of 5

A.9 Turning Off the HIPR2 High Rate Mode Feature

This procedure is used to turn off the HIPR2 High Rate Mode feature, using the chg-ctrl-feat command.

Caution:

The HIPR2 High Rate Mode feature cannot be turned off if any of these conditions are present.
  • The IMT Rate Change sequence is being performed.
  • The Extended Bit Rate Test (BERT) is being performed.
  • The total provisioned system TPS value is greater than 500,000.
  • Any of the cards in card locations 9 and 10 in each shelf are being flashed with the init-flash command.

The chg-ctrl-feat command uses the following parameters:

:partnum - The part number of the HIPR2 High Rate Mode feature, 893020101.

:status=off – used to turn off the HIPR2 High Rate Mode feature.

The status of the HIPR2 High Rate Mode feature must be on and is shown with the rtrv-ctrl-feat command.

Caution:

If the HIPR2 High Rate Mode feature is turned off, the throughput rate for the IMT bus is limited to 1 Gbps.
  1. Display the status of the HIPR2 High Rate Mode feature by entering the rtrv-ctrl-feat:partnum=893020101 command.

    The following is an example of the possible output. 

    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
HIPR2 High Rate Mode      893020101  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the status of the HIPR2 High Rate Mode feature is off, or if the HIPR2 High Rate Mode feature is not enabled, this procedure cannot be performed.

  2. Display the maximum system IP TPS value by entering the rtrv-tps command.

    The following is an example of the possible output. 

    
rlghncxa03w 10-07-28 21:15:37 GMT EAGLE5 42.0.0

    CARD     NUM    NUM      RSVD       MAX
    TYPE   CARDS  LINKS       TPS       TPS
    -----  -----  -----  --------  --------
    IPGW       9      8     32000     40000
    IPSG     100     16     80000     80000
    IPLIM      1      0         0         0
    ATM        0      0         0         0

    Total provisioned System TPS (120000 of 500000) 24%

    Command Completed.

    If the maximum system IP TPS value is greater than 500,000, this procedure cannot be performed.

  3. Turn off the HIPR2 High Rate Mode feature by entering the chg-ctrl-feat command with the status=off parameter.

    For example, enter this command.

    chg-ctrl-feat:partnum=893020101:status=off

    When this command has successfully completed, the following message should appear. 

    
rlghncxa03w 09-07-28 21:16:37 GMT EAGLE5 41.1.0
CHG-CTRL-FEAT: MASP A - COMPLTD
  4. Verify that the HIPR2 High Rate Mode feature has been turned off by using the rtrv-ctrl-feat:partnum=893020101 command. The following is an example of the possible output. 
    
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
HIPR2 High Rate Mode      893020101  off     ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.
  5. Backup the new changes using the chg-db:action=backup:dest=fixed command.
    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 
    
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure A-7 Turning Off the HIPR2 High Rate Mode Feature