4.61 chg-gpl
Use this command to copy a generic program load from the system removable drive to the destination active and standby system disks as a "trial" version. The system release identification file is uploaded from the system removable drive to the active and standby fixed drives along with each GPL. This command also provides a parameter to turn GPL auditing “on” and “off”.
Parameters
- audit (optional)
- This parameter specifies whether the active MASP
system release running version is to be audited every 90 seconds. The audit
state is preserved through a system restart or power up.
Note:
When audit is turned off, the system release audit process is stopped. The detection, marking, and reporting of corrupt GPLs is continuous and not affected by turning audit off.
- gpl (optional)
- Generic program load. The name of the GPL
identifier to be
copied from
the system removable drive to the
active and standby
system
disks.
- Range:
- xyyyyyyy
1 alphabetic character followed by up to 7 alphanumeric characters. Valid GPLs are:
atmhc—Used by E5-ATM-B cards to allow the card to support up to 3 signaling links
bldc32—Flash GPL containing a tar image with all code required on E5-MCAP cards to support VxWorks6.9 32-bit application, as in OAMHC69.
bldc64—Flash GPL containing a tar image with all code required on E5-SM8G-B cards for SCCP64, ENUM64, SIP64 and DEIR64 applications.
blmcap—Flash GPL containing a tar image with all code required on E5-MCAP, E5-E1T1-B, E5-MCPM-B, E5-ATM-B, E5-ENET-B, and E5-SM8G-B cards
blslc32—Flash GPL containing a tar image with all code required on SLIC cards for 32-bit application i.e. MCPHC, IPSHC etc.
blslc64—Flash GPL containing a tar image with all code required on SLIC cards for 64-bit application i.e. SCCP64, ENUM64, SIP64 and DEIR64.
blsl932—Flash GPL containing a tar image with all code required on SLIC cards for 32-bit application on VxWorks6.9, as in IPSHC69 and MCPHC69.
deirhc— Used by E5-SM8G-B cards to support the S13/S13' EIR feature
enumhc—Used by E5-SM8G-B cards to support the ENUM Mobile Number Portability and Tier One Address Resolution application
erthc—Used by E5-ENET-B cards for EAGLE 5 Integrated Monitoring Support functions
hipr2—Communication software used on the High Speed IMT Packet Router (HIPR2) card
ipsg—Used by E5-ENET-B cards to support the combined functionality of IPLIMx M2PA and IPGWx M3UA
ipsg32—Used by SLIC cards to support IPSG application with 64-bit addressing either with GTT functionality or without it.
ipshc—Used by E5-ENET-B and SLIC cards to support the IPS application
ipshc69—Used by E5-ENET-B and SLIC cards to support the IPS application when running on VxWorks69.
mcphc— Used by E5-MCPM-B cards for the Measurements Platform feature
mcphc69—Used by E5-MCPM-B and SLIC cards for the Measurements Platform feature when running on VxWorks69.
oamhc—Used by E5-MCAP cards for enhanced OAM functions
oamhc69—Used by E5-MCAP cards for enhanced OAM functions, when running on VxWorks 69.
sccphc—Used by E5-SM8G-B cards to support EPAP-based features and the LNP ELAP Configuration feature. If no EPAP-based or LNP ELAP Configuration feature is turned on, and an E5-SM8G-B card is present, then the GPL processes normal GTT traffic.
sfapp—Used by SLIC cards to support the Stateful Firewall Application.
siphc— Used by E5-SM8G-B Cards to support the SIP application.
ss7hc—Application GPL used by E5-E1T1-B and SLIC cards to support E1 and T1 signaling links.
Example
chg-gpl:audit=on
chg-gpl:gpl=atmhc:ver=138-19-0
chg-gpl:gpl=siphc:ver=134-35-0
chg-gpl:gpl=enumhc:ver=135-20-0
chg-gpl:gpl=ipsg32:ver=140-20-0
chg-gpl:gpl=sfapp:ver=141-012-1
Dependencies
No other activate, change, copy, or retrieve GPL command can be in progress when this command is entered.
If the ver or gpl parameter is specified, then both parameters must be specified.
The audit parameter, the ver and gpl parameters, or the audit and ver and gpl parameters must be specified.
A system removable drive must be inserted in the Active OAM.
A valid value must be specified for the gpl parameter.
Notes
If there is a failure changing the active system, the operation is stopped. If there is a failure changing the standby system, the active system is still updated.
A system removable drive must be inserted into the latched USB port, initialized, and formatted as a system disk.
Use the
rtrv-gpl command to determine the
version number and audit state of a GPL.
The ver and gpl parameters are mandatory if a generic program load is being uploaded from a system removable drive.
The audit parameter is required only when turning GPL auditing on or off and the ver and gpl parameters are optional.
When the audit=off parameter is specified, the system release audit process is stopped. The detection, marking, and reporting of corrupt GPLs is continuous and not affected by turning audit off.
Output
This example shows the output for a successful command execution:
chg-gpl:gpl=ss7hc:ver=125-1-0
rlghncxa03w 09-03-01 11:43:04 EST EAGLE 40.1.0
SS7HC upload to 1114 completed
SS7HC upload to 1116 completed
System Release ID table upload to 1116 completed
System Release ID table upload to 1114 completed
;
chg-gpl:gpl=siphc:ver=134-35-0
tekelecstp 12-07-09 19:08:39 EST EAGLE 45.0.0
SIPHC upload to 1114 completed
SIPHC upload to 1116 completed
System Release ID table upload to 1116 completed
System Release ID table upload to 1114 completed
;
chg-gpl:gpl=enumhc:ver=135-20-0
tekelecstp 14-05-20 15:19:30 EST EAGLE 46.1.0
ENUMHC upload to 1114 completed
ENUMHC upload to 1116 completed
System Release ID table upload to 1116 completed
System Release ID table upload to 1114 completed
;
chg-gpl:gpl=ipsg32:ver=140-20-0
tekelecstp 14-05-20 15:19:30 EST EAGLE 46.1.0
IPSG32 upload to 1114 completed
IPSG32 upload to 1116 completed
System Release ID table upload to 1116 completed
System Release ID table upload to 1114 completed
;
chg-gpl:gpl=sfapp:ver= 141-012-1
tekelecstp 17-11-29 16:18:04 MST EAGLE 46.5.1.5.0-73.2.0
SFAPP activate to 1114 completed
SFAPP activate to 1116 completed
;