Go to primary content
Oracle® Communications EAGLE Database Administration - System Management User's Guide
Release 46.6
E93319 Revision 1
Go To Table Of Contents
Contents

Previous
Previous
Next
Next

Updating the Service GPLs

This procedure is used to update these GPLs: GLS, SCCPHC, and IPSHC. These names are used as the value of the gpl parameter of the chg-gpl, act-gpl, rept-stat-gpl, and rtrv-gpl commands.

These GPLs are assigned to the card types shown in Table 3-3.

Table 3-3 Service GPL Card Types

GPL Card Type
sccphc dsm (these cards must be E5-SM4G/E5-SM8G cards)
iphsc ipsm (these cards must be E5-ENET-B or SLIC cards)
glshc tsm (these cards must be E5-TSM cards)

The card types shown in Table 3-3 are the values used for the type parameter of the ent-card command.

If the GPL is being updated to a new version, a removable cartridge containing the GPL being updated is required.

If any card is not running the version of the GPL shown in the RELEASE column of the rtrv-gpl output, the indicator ALM is displayed next to the GPL version in the RUNNING column of the rept-stat-gpl output, and next to the GPL version in the APPROVED column in the rtrv-gpl output.

  1. Verify the control cards that are installed in the EAGLE.

    Refer to Maintenance and Administration Subsystem for information about the control cards.

  2. Check the E5-MASPs for removable media.

    If removable media is installed in both E5-MASPs, continue the procedure with 4.

    If removable media is not installed in both E5-MASPs, continue the procedure with 3.

  3. Verify the active MASP by entering the rept-stat-db command.

    This is an example of the possible output.

    rlghncxa03w 09-03-01 15:25:40 GMT  EAGLE5 40.1.0
    DATABASE STATUS: >> OK <<
            E5TDM 1114 ( STDBY)                 E5TDM 1116 ( ACTV )
            C   LEVEL    TIME LAST BACKUP     C   LEVEL    TIME LAST BACKUP
            - -------- ---------------------- - -------- ----------------------
    FD BKUP Y       36 09-02-19 09:38:25 GMT  Y       36 09-02-19 09:38:25 GMT
    FD CRNT Y       39                        Y       39
            E5MCAP 1113                         E5MCAP 1115
            - --------                        - --------
    RD BKUP -    -         -        -         Y       36 09-02-19 09:27:17 GMT
    USB BKP -    -         -        -         Y        3 09-02-07 01:11:22 GMT
    

    If removable media is installed in the active MASP, continue the procedure with 4.

    If removable media is not installed in the active MASP, insert the removable media in the removable media drive in the active MASP. For more information about inserting removable media in the removable media drive, refer to Removable USB Drive. After the removable media has been inserted in the removable media drive in the active MASP, continue the procedure with 4.

  4. Display the GPLs on the fixed disk and on the removable cartridge using the rtrv-gpl command with the gpl parameter value equal to the GPL being updated. These are examples of the possible output.

    rtrv-gpl:gpl=vsccp

    rlghncxa03w 09-03-01 11:34:04 GMT  EAGLE5 40.1.0
    GPL Auditing  ON
    
    GPL       CARD  RELEASE      APPROVED         TRIAL        REMOVE TRIAL
    VSCCP     1114  132-002-000  132-002-000      132-001-000  132-003-000
    VSCCP     1116  132-002-000  132-002-000      132-001-000  132-003-000
    VSCCP     1115  -----------  -----------      -----------  -----------
    

    If the version of the GPL shown in the REMOVE TRIAL column of the rtrv-gpl output is not the version that is to be loaded onto the cards, remove the removable media from the active MASP.

    Insert the removable media that contains the GPL that is being updated into the removable media drive in the active MASP and repeat this step.

    For more information about inserting removable media in the removable media drive, or removing removable media from the removable media drive, refer to Removable USB Drive.

    If the version of the GPL shown in the REMOVE TRIAL column of the rtrv-gpl output is the version that is to be loaded onto the cards, continue the procedure with 5.

  5. Change the GPLs, using the chg-gpl command and specifying the value for the trial GPL shown in the REMOVE TRIAL column in the output of the rtrv-gpl command.

    For this example, enter this command.

    chg-gpl:gpl=vsccp:ver=132-003-000

    These messages should appear.

    rlghncxa03w 09-03-01  11:43:04  GMT  EAGLE5 40.1.0
    GPL Auditing  ON
    
    VSCCP upload on 1114 completed
    VSCCP upload on 1116 completed
    System Release ID table upload 1114 completed
    System Release ID table upload 1116 completed
    
  6. Activate the trial GPL, using the act-gpl command and specifying the value for the trial GPL shown in 5.

    For this example, enter this command.

    act-gpl:gpl=vsccp:ver=132-003-000

    These messages should appear.

    rlghncxa03w 09-03-01 06:54:39 GMT EAGLE5 40.1.0
    VSCCP activate on 1114 completed
    VSCCP activate on 1116 completed
    
  7. Verify that the trial GPL has been made the approved GPL using the rtrv-gpl command with the gpl parameter value specified in 5 and 6.

    For this example, enter this command.

    rtrv-gpl:gpl=vsccp

    This is an example of the possible output.
    rlghncxa03w 09-03-01 11:34:04 GMT EAGLE5 40.1.0
    GPL Auditing  ON
    
    GPL       CARD  RELEASE      APPROVED         TRIAL        REMOVE TRIAL
    VSCCP     1114  132-003-000  132-003-000      132-002-000  132-003-000
    VSCCP     1116  132-003-000  132-003-000      132-002-000  -----------
    

    If E5-based control cards are installed in the EAGLE, this is an example of the possible output.

    rlghncxa03w 09-03-01 11:34:04 GMT  EAGLE5 40.1.0
    GPL Auditing  ON
    
    GPL       CARD  RELEASE      APPROVED         TRIAL        REMOVE TRIAL
    VSCCP     1114  132-003-000  132-003-000      132-002-000  132-003-000
    VSCCP     1116  132-003-000  132-003-000      132-002-000  132-003-000
    VSCCP     1115  -----------  -----------      -----------  -----------
    
  8. Verify which cards are running the GPL using the rept-stat-gpl command with the gpl parameter value specified in 7.

    For this example, enter this command.

    rept-stat-gpl:gpl=vsccp

    This is an example of the possible output.

    rlghncxa03w 09-03-01 11:40:26 GMT  EAGLE5 40.1.0
    GPL      CARD   RUNNING           APPROVED      TRIAL
    VSCCP    1101   132-002-000 ALM   132-003-000   132-002-000
    VSCCP    1102   132-002-000 ALM   132-003-000   132-002-000
    VSCCP    1103   132-002-000 ALM   132-003-000   132-002-000
    Command Completed
    

    If the GLSHC GPL is being loaded onto the cards, continue the procedure with 16.

    If the GPL that is being loaded onto the card is not GLSHC, continue the procedure with 9.

  9. 10 through 15 are performed based on the GPL being updated (shown in the rept-stat-gpl output in 8).

    The following list shows the steps that are performed for the GPL being updated.

    • SCCPHC – Perform 10, then continue the procedure with 16.
    • MCP – Perform 11, then continue the procedure with 16.
    • IPSHC – Continue the procedure with 12.
  10. Display the status of the service modules by entering the rept-stat-sccp command.

    This is an example of the possible output.

    rlghncxa03w 09-03-01 09:57:31 GMT  EAGLE5 40.1.0
    
    CARD  VERSION      PST             SST        AST       MSU USAGE  CPU USAGE
    -----------------------------------------------------------------------------
    1101  132-002-001  IS-NR           Active     -----       47%         81%
    1102  132-002-001  IS-NR           Active     -----       34%         50%
    1103  132-002-001  IS-NR           Active     -----       21%         29%
    -----------------------------------------------------------------------------
    SCCP Service Average MSU Capacity = 36%       Average CPU Capacity = 56%
    Command Completed.
    

    Continue the procedure with 16.

    Note:

    The rept-stat-sccp command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rept-stat-sccp command, see the rept-stat-sccp command description in Commands User's Guide.
  11. Display the status of the MCPMs in the database by entering the rept-stat-meas command.

    This is an example of the possible output.

    rlghncxa03w 09-03-01 16:43:42 GMT  EAGLE5 40.1.0
    
                          PST            SST       AST
    MEAS SS               IS-NR          Active    -----
            ALARM STATUS =   No Alarms
    
        CARD   VERSION         TYPE    PST           SST        AST
        2107 P 132-002-000     EDSM    IS-NR         Active     -----
           IP Link A                   IS-NR         Active     Available
        2108   132-200-000     EDSM    IS-NR         Active     -----
           IP Link A                   IS-NR         Active     Available
        2111   132-002-000     EDSM    IS-NR         Active     -----
           IP Link A                   IS-NR         Active     Available
      
        CARD 2107 ALARM STATUS = No Alarms
        CARD 2108 ALARM STATUS = No Alarms
        CARD 2111 ALARM STATUS = No Alarms
    

    Continue the procedure with 16.

  12. Display the status of the IPSMs (if the IPSHCGPL is being updated) using the rept-stat-card command and specifying the location of the card shown in the rept-stat-gpl output in 8.

    For this example, enter this command.

    rept-stat-card:loc=2301

    This is an example of the possible output.

    rlghncxa03w 09-03-01 09:12:36 GMT  EAGLE5 40.1.0
    CARD   VERSION      TYPE      GPL        PST            SST        AST
    2301   132-001-000  IPSM      IPS        IS-NR          Active     -----
    
      ALARM STATUS       = No Alarms.
      BPDCM GPL          = 132-002-000
      IMT BUS A          = Conn
      IMT BUS B          = Conn
    Command Completed.
    
  13. Display the terminal configuration in the database with the rtrv-trm command.

    The IP terminals are shown by the terminal numbers 17 through 40. The rtrv-trm output shows the location of the IPSM associated with the IP terminals. This is an example of the possible output.

    rlghncxa03w 10-07-01 16:02:08 GMT EAGLE5 42.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-O-1 NONE   30    5     00:00:30
    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-O-1 NONE   30    5     00:00:30
    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
    17   TELNET    3101             60    5     00:30:00
    18   TELNET    3101             60    5     00:30:00
    19   TELNET    3101             60    5     00:30:00
    20   TELNET    3101             60    5     00:30:00
    21   TELNET    3101             60    5     00:30:00
    22   TELNET    3101             60    5     00:30:00
    23   TELNET    3101             60    5     00:30:00
    24   TELNET    3101             60    5     00:30:00
    25   TELNET    3105             60    5     00:30:00
    26   TELNET    3105             60    5     00:30:00
    27   TELNET    3105             60    5     00:30:00
    28   TELNET    3105             60    5     00:30:00
    39   TELNET    3105             60    5     00:30:00
    30   TELNET    3105             60    5     00:30:00
    31   TELNET    3105             60    5     00:30:00
    32   TELNET    3105             60    5     00:30:00
    33   TELNET    3111             60    5     00:30:00
    34   TELNET    3111             60    5     00:30:00
    35   TELNET    3111             60    5     00:30:00
    36   TELNET    3111             60    5     00:30:00
    37   TELNET    3111             60    5     00:30:00
    38   TELNET    3111             60    5     00:30:00
    39   TELNET    3111             60    5     00:30:00
    40   TELNET    3111             60    5     00:30:00
    
    

    Note:

    The rtrv-trm command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-trm command, see the rtrv-trm command description in Commands User's Guide.
  14. Display the status of the terminals with the rept-stat-trm command.

    This is an example of the possible output.

    rlghncxa03w 09-03-01 15:08:45 GMT EAGLE5 40.1.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.
    
  15. Place the terminals associated with the IPSM that will be updated with the new IPSHCGPL out of service using the rmv-trm command.

    If the last in service SEAS terminal is assigned to the card containing the terminals that are being inhibited in this step, the force=yes parameter must be specified for that terminal.

    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

    Caution:

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

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

    This message should appear when each of these commands have successfully completed.

    rlghncxa03w 09-03-01 15:08:45 GMT EAGLE5 40.1.0
    Inhibit message sent to terminal
    
    rlghncxa03w 09-03-01 15:08:45 GMT EAGLE5 40.1.0
    Command Completed.
    
  16. The card that the new version of the GPL will be loaded onto must be out of service.

    Place the card, selected from the outputs of 8, 10, 11, or 12, out of service using the rmv-card command. If there is only one of these cards running these GPLs in service (GLSHC), the force=yes parameter must be specified with the rmv-card command.

    For this example, enter this command.

    rmv-card:loc=1101

    Caution:

    Do not place all the cards running the same GPL in the EAGLE out of service at the same time. Doing so will cause all traffic carried by these cards to be lost and disable the feature associated with these cards.

    Caution:

    If there is only one in service card running the GPL being updated in the EAGLE, placing the card out of service will cause the traffic carried by this card to be lost and disable the feature associated with this card.

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

    rlghncxa03w 09-03-01  11:11:28 GMT  EAGLE5 40.1.0
    Card has been inhibited.
    
  17. Put the card that was inhibited in 16 back into service using the rst-card command.

    The rst-card command also loads the approved version of the GPL onto the card.

    For this example, enter this command.

    rst-card:loc=1101

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

    rlghncxa03w 09-03-01  11:11:28 GMT  EAGLE5 40.1.0
    Card has been allowed.
    
  18. Verify the GPLs on the cards using the rept-stat-gpl command with the gpl parameter value equal to the gpl parameter value specified in 8.

    If any card is not running the release version of the GPL, shown in the RELEASE column of the rtrv-gpl output in 7, the indicator ALM is displayed next to the GPL version in the RUNNING column of the rept-stat-gpl output. For this example, enter these commands.

    rept-stat-gpl:gpl=vsccp

    This is an example of the possible output.

    rlghncxa03w 09-03-01 11:40:26 GMT  EAGLE5 40.1.0
    GPL      CARD   RUNNING           APPROVED      TRIAL
    VSCCP    1101   132-003-000       132-003-000   132-002-000
    VSCCP    1102   132-002-000 ALM   132-003-000   132-002-000
    VSCCP    1103   132-002-000 ALM   132-003-000   132-002-000
    Command Completed
    

    Note:

    If the IPSHC GPL is not being updated in this procedure, continue the procedure with 21.
  19. Put the terminals that were placed out of service in 15 back into service using the rst-trm command.

    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

    This message should appear when each of these commands have successfully completed.

    rlghncxa03w 09-03-01 15:08:45 GMT EAGLE5 40.1.0
    Allow message sent to terminal
    
    rlghncxa03w 09-03-01 15:08:45 GMT EAGLE5 40.1.0
    Command Completed.
    
  20. Verify that the terminals are in service with the rept-stat-trm command.

    This is an example of the possible output.

    rlghncxa03w 09-03-01 15:08:45 GMT EAGLE5 40.1.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.
    
  21. Continue the procedure by performing these actions.
    When the E5-based control cards are installed in the EAGLE, continue the procedure by performing one of these actions.
    • If you wish to load the new GPL onto the other cards shown in 8, repeat this procedure from 9 for each card shown in 8.
    • If the new GPL will not be loaded onto other cards but other GPLs will be updated, repeat this procedure from 1.
    • If the new GPL will not be loaded onto other cards and no other GPLs are being updated, then this procedure is finished.

Figure 3-3 Updating the Service GPLs





Sheet 1 of 7





Sheet 2 of 7





Sheet 3 of 7



Sheet 4 of 7



Sheet 5 of 7



Sheet 6 of 7



Sheet 7 of 7