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:

: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

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

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

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