Configuring the Integrated Measurements Feature

This procedure is used to configure IP communications links between the EAGLE and the customer’s network and enable the Integrated Measurements feature on the EAGLE using these commands.

ent-ip-host – Configuring the IP host of the E5-MCAP.
chg-ip-card – Configuring the IP address of the E5-MCAP.
chg-ip-lnk – Configuring the IP link assigned to the E5-MCAP.
chg-measopts – Enabling the measurement collection option for the E5-MCAP card option.
enable-ctrl-feat – Enabling the Integrated Measurements feature.
chg-ctrl-feat – Turning the Integrated Measurements feature on.

Some of these commands contain parameters that are not used in this procedure. Commands User's Guide contains a full description of these commands.

The Integrated Measurements feature requires measurements FTP servers. A maximum of three measurements FTP servers can be configured with one of these procedures.

This procedure can be performed only on EAGLEs that contain E5-based control cards. Refer to Maintenance and Administration Subsystem for more information about the control cards.

The Integrated Measurements feature is enabled using the enable-ctrl-feat command with these parameters.

:fak – The feature access key provided by Oracle.

:partnum – The Oracle-issued part number of the Integrated Measurements feature, 893037301.

Once this feature is enabled, it is permanently enabled. This feature cannot be enabled with a temporary feature access key.

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 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. 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 Integrated Measurements feature has been enabled, the Integrated Measurements 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 Integrated Measurements feature, 893037301.

:status=on – used to turn the Integrated Measurements feature on.

Once the Integrated Measurements feature has been turned on, it be cannot be turned off.

The status of the Integrated Measurements feature is shown with the rtrv-ctrl-feat command.

If a Class B IP address is specified for the ipaddr parameter of the chg-ip-lnk command, the subnet address that results from the ipaddr and submask parameter values cannot be the same as the subnet address that results from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command. The pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values can be verified by entering the rtrv-netopts command. Choose ipaddr and submask parameter values for the IP address assigned to the E5-MCAP card whose resulting subnet address is not be the same as the subnet address that resulting from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command.

The Integrated Measurements feature supports the collection and reporting of all measurement entities for EAGLEs configured with a maximum of 2400 signaling links (or 1200 links if the 15-minute measurements feature is turned on) using the E5-MCAP cards instead of the MCPM. The enhanced reporting capabilities provided by the Integrated Measurements feature support the generation of text file measurements reports in the CSV format. The reports can be sent to a customer-provided FTP server on-demand or on a scheduled basis. EAGLEs with more than 2400/1200 signaling links require the Measurements Platform for full measurements support.

Display the status of the controlled features by entering the rtrv-ctrl-feat command. The following is an example of the possible output.

rlghncxa03w 10-04-28 21:15:37 GMT EAGLE5 42.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      ----
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 Integrated Measurements feature is enabled and turned on, continue the procedure with 21.

If the Integrated Measurements feature is enabled but not turned on, continue the procedure with 19.

If the Integrated Measurements feature is not enabled, continue the procedure with 2.

Display the control cards in the EAGLE by entering this command.
rtrv-stp:gpl=oamhc

This is an example of the possible output.
```
rlghncxa03w 10-04-01 16:07:48 GMT  EAGLE5 42.0.0

Card  Part Number  Rev Serial Number  Type     DB     APPL     GPL Version
----  -----------  --- -------------  ----     --     ----     -----------
1113  870-2903-01  C   10206255064    E5MCAP   4096M  OAMHC    132-018-000
1115  870-2903-01  C   10206255165    E5MCAP   4096M  OAMHC    132-018-000

Command Completed.
```
To enable the Integrated Measurements feature, E5-MCAP cards must be installed in card locations 1113 and 1115. If E5-MCAP cards are not shown in either card location 1113 or 1115, install the E5-MCAP cards in card locations 1113 or 1115 as required. Contact the Customer Care Center before installing the E5-MCAP cards. Refer to the My Oracle Support (MOS) section for the contact information.
After the E5-MCAP cards have been installed, or if E5-MCAP cards are shown in card locations 1113 and 1115 in the rtrv-stp output, 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 7.
- If the rtrv-ctrl-feat output shows only the HC-MIMSLK Capacity feature with a quantity of 64, continue the procedure with 3.
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 not correct and not locked, continue the procedure with 4If the serial number is correct and locked, continue the procedure with 7. If the serial number is correct but not locked, continue the procedure with 6. 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 10-04-28 21:15:37 GMT EAGLE5 42.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
```
Verify that the serial number entered into 4 was entered correctly using the rtrv-serial-num command. This is an example of the possible output.
```
rlghncxa03w 10-04-28 21:15:37 GMT EAGLE5 42.0.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 10-04-28 21:15:37 GMT EAGLE5 42.0.0
Command Completed
```
If the serial number was not entered correctly, repeat 4 and 5 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 3, if the serial number shown in 3 is correct, or with the serial number shown in 5, if the serial number was changed in 4, 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 10-04-28 21:15:37 GMT EAGLE5 42.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
```
If the IP address for the E5-MCAP cards will be either a Class A or Class C IP address, continue the procedure with 8.

If the IP address for either E5-MCAP card will be a Class B IP address, continue the procedure with 7.
The subnet address that results from the ipaddr and submask parameter values of the chg-ip-lnk command cannot be the same as the subnet address that results from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command.
Display the pvn, pvnmask, fcna, fcnamask, fcnb, and fcnbmask parameter values of the chg-netopts command by entering the rtrv-netoptscommand.

If error message E3967 Cmd Rej: E5IS must be on is displayed after the rtrv-netopts command is executed, the pvn, pvnmask, fcna, fcnamask, fcnb, and fcnbmask parameters are not configured. Continue the procedure with 8.

This is an example of the possible output if the E5IS feature is on.
```
rlghncxa03w 10-04-28 21:17:37 GMT EAGLE5 42.0.0
NETWORK OPTIONS
------------------
PVN        = 128.20.30.40
PVNMASK    = 255.255.192.0
FCNA       = 170.120.50.0
FCNAMASK   = 255.255.240.0
FCNB       = 170.121.50.0
FCNBMASK   = 255.255.254.0
```
Choose ipaddr and submask parameter values for the IP link to the MCPM whose resulting subnet address is not be the same as the subnet address that resulting from the pvn and pvnmask, fcna and fcnamask, or fcnb and fcnbmask parameter values of the chg-netopts command. Continue the procedure with 8.

Display the IP link information for both E5-MCAP cards by entering these commands.

rtrv-ip-lnk:loc=1113