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 BLMCAP and OAMHC GPLs

This procedure updates the BLMCAP and OAMHC GPLs on the E5-MCAP cards in card locations 1113 and 1115 as a trial version from the removable media, then making the trial version of these GPLs the approved version of these GPLs. The E5-MCAP card in card locations 1113 and 1115 is used in combination with the TDM to form the Maintenance and Administration Subsystem Processor (MASP).

The BLMCAP GPL is updated using the chg-gpl, act-gpl, and flash-card commands.

Caution:

The flash-card command cannot be entered if the IMT Rate Change sequence or the Extended Bit Error Rate Test (BERT) is being performed.

The OAMHC GPL is updated using the chg-gpl command.

Caution:

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.

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.

Removable media containing the BLMCAP and OAMHC GPLs that are being updated is required.

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

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

    If E5-based control cards are installed in the EAGLE, continue the procedure with 2.

  2. Check the E5-MASPs for removable media.

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

    If removable media is not installed in either 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.

    eagle1 16-09-09 17:51:57 MST  EAGLE 46.4.0.0.0-69.6.0
        DATABASE STATUS: >> OK <<
                TDM 1114 ( STDBY)                 TDM 1116 ( ACTV )
                C   LEVEL    TIME LAST BACKUP     C   LEVEL    TIME LAST BACKUP
                - -------- ---------------------- - -------- ----------------------
        FD BKUP Y        1     -        -         Y        1     -        -
        FD CRNT Y       93                        Y       93
                MCAP 1113                         MCAP 1115
                - --------                        - --------
        RD BKUP -    -         -        -         Y        1     -        -
        USB BKP -    -         -        -         -    -         -        -
    

    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 BLMCAP and OAM HC GPLs on the fixed disk and on the removable media using the rtrv-gpl command with the gpl parameter value equal to the GPL being updated. Perform these substeps.
    1. Display the BLMCAP GPL by entering this command.

      rtrv-gpl:gpl=blmcap

      This is an example of the possible output.

      eagle1 16-09-09 18:28:48 MST  EAGLE 46.4.0.0.0-69.6.0
          GPL Auditing  ON
      
          GPL       CARD  RELEASE      APPROVED         TRIAL        REMOVE TRIAL
          BLMCAP    1114  139-005-000  139-005-000      139-005-000  -----------
          BLMCAP    1116  139-005-000  139-005-000      139-005-000  139-008-000
          BLMCAP    1115  -----------  -----------      -----------  -----------
      
    2. Display the OAMHC GPL by entering this command.

      rtrv-gpl:gpl=oamhc

      This is an example of the possible output.

      eagle1 16-09-09 18:30:03 MST  EAGLE 46.4.0.0.0-69.6.0
          GPL Auditing  ON
      
          GPL       CARD  RELEASE      APPROVED         TRIAL        REMOVE TRIAL
          OAMHC     1114  139-006-000  139-006-000      -----------  -----------
          OAMHC     1116  139-006-000  139-006-000      139-008-000  139-008-000
          OAMHC     1115  -----------  -----------      -----------  -----------
      

    If the version of either 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 GPLs that are being updated into the removable media drive in the active MASP. If 3 was performed, repeat this step. If 3 was not performed, repeat this procedure from 3.

    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 versions of the GPLs shown in the REMOVE TRIAL column of the rtrv-gpl output are the versions that are to be loaded onto the cards, continue the procedure with 5.

  5. Change the BLMCAP and OAMHC GPLs using the chg-gpl command and specifying the value for the trial BLMCAP and OAMHC GPLs shown in the REMOVE TRIAL column in the output of the rtrv-gpl command (in 4). Perform these substeps.
    1. For the BLMCAP GPL in this example, enter this command.

      chg-gpl:gpl=blmcap:ver=139-008-000

      These messages should appear.

          eagle1 16-09-09 18:47:55 MST  EAGLE 46.4.0.0.0-69.6.0
          BLMCAP upload to 1116 completed
          BLMCAP upload to 1114 completed
          System Release ID table upload to 1116 completed
          System Release ID table upload to 1114 completed
      
      
    2. For the OAMHC GPL in this example, enter this command.

      chg-gpl:gpl=oamhc:ver=139-008-000

      These messages should appear.

          eagle1 16-09-09 18:48:30 MST  EAGLE 46.4.0.0.0-69.6.0
          OAMHC upload to 1116 completed
          OAMHC upload to 1114 completed
          System Release ID table upload to 1116 completed
          System Release ID table upload to 1114 completed
      
      
  6. Activate the trial BLMCAP GPL, using the act-gpl command and specifying the name and version of the trial BLMCAP GPL specified in Substep a in 5. Enter this command.

    act-gpl:gpl=blmcap:ver=139-008-000

    These messages should appear.

        eagle1 16-09-09 18:48:53 MST  EAGLE 46.4.0.0.0-69.8.0
        BLMCAP activate on 1116 completed
        BLMCAP activate on 1114 completed
    
    
  7. Verify that the trial BLMCAP and OAM HC GPLs have been made the approved GPLs using the rtrv-gpl command. Perform these substeps.
    1. For the BLMCAP GPL, enter the rtrv-gpl:gpl=blmcap command.

      This is an example of the possible output.

          eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
          GPL Auditing  ON
      
          GPL       CARD  RELEASE      APPROVED         TRIAL        REMOVE TRIAL
          BLMCAP    1114  139-008-000  139-008-000      139-005-000  -----------
          BLMCAP    1116  139-008-000  139-008-000      139-005-000  139-008-000
          BLMCAP    1115  -----------  -----------      -----------  -----------
      
      
    2. For the OAMHC GPL, enter the rtrv-gpl:gpl=oamhc command.

      This is an example of the possible output.

      eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
      GPL Auditing  ON
      
      GPL       CARD  RELEASE      APPROVED         TRIAL        REMOVE TRIAL
      OAMHC     1114  139-008-000  139-008-000      139-005-000  139-008-000
      OAMHC     1116  139-008-000  139-008-000      139-005-000  139-008-000
      OAMHC     1115  -----------  -----------      -----------  -----------
      
  8. Verify the GPLs that are running on the E5-MCAP cards by performing these substeps.
    1. For the BLMCAP GPL, enter the rept-stat-gpl:gpl=blmcap command.

      This is an example of the possible output.

      eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
      GPL Auditing  ON
      
      GPL     CARD   RUNNING           APPROVED      TRIAL
      BLMCAP  1113   139-005-000 ALM   139-008-000   139-005-000
      BLMCAP  1115   139-005-000 ALM   139-008-000   139-005-000
      
      Command Completed
      

      The flash-card command will load only the BLMCAP GPLs whose approved versions are different from the versions that the card is running. The version of the BLMCAP GPL that the card is running is shown in the RUNNING column in the rept-stat-gpl output. The approved version of the BLMCAP GPL is shown in the APPROVED column of the rept-stat-gpl output. If the running and approved versions of a BLMCAP GPL are the same, the flash-card command will not load that BLMCAP GPL.

    2. For the OAMHC GPL, enter the rept-stat-gpl:gpl=oamhc command.

      This is an example of the possible output.

      eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
      GPL      CARD   RUNNING           APPROVED      TRIAL
      OAMHC    1113   139-005-000 ALM   139-008-000   139-005-000
      OAMHC    1115   139-005-000 ALM   139-008-000   139-005-000
      Command Completed
      
  9. Display the terminal configuration in the database with the rtrv-trm command.

    All the SEAS terminals must be placed out of service in order to load the BLMCAP and OAMHC GPLs onto the E5-MCAP cards. The SEAS terminals are shown in the output with the entry SEAS in the TYPE field. This is an example of the possible output. In this example, the SEAS terminals are terminals 18 and 27.

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.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    1303             60    5     00:30:00
    18   SEAS      1201             60    5     00:30:00
    19   TELNET    1303             60    5     00:30:00
    20   TELNET    1303             60    5     00:30:00
    21   TELNET    1303             60    5     00:30:00
    22   TELNET    1303             60    5     00:30:00
    23   TELNET    1303             60    5     00:30:00
    24   TELNET    1303             60    5     00:30:00
    25   TELNET    1203             60    5     00:30:00
    26   TELNET    1203             60    5     00:30:00
    27   SEAS      1203             60    5     00:30:00
    28   TELNET    1203             60    5     00:30:00
    39   TELNET    1203             60    5     00:30:00
    30   TELNET    1203             60    5     00:30:00
    31   TELNET    1203             60    5     00:30:00
    32   TELNET    1203             60    5     00:30:00
    33   TELNET    1208             60    5     00:30:00
    34   TELNET    1208             60    5     00:30:00
    35   TELNET    1208             60    5     00:30:00
    36   TELNET    1208             60    5     00:30:00
    37   TELNET    1208             60    5     00:30:00
    38   TELNET    1208             60    5     00:30:00
    39   TELNET    1208             60    5     00:30:00
    40   TELNET    1208             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.

    If SEAS terminals are shown in the rtrv-trm command output, continue the procedure with 10.

    If no SEAS terminals are shown in the rtrv-trm command output, perform one of these steps to continue the procedure.
    • If the rept-stat-db command in 3 was not performed, continue the procedure with 13.
    • If the rept-stat-db command in 3 was performed, continue the procedure with 14.
  10. Display the status of the terminals with the rept-stat-trm command with the terminal number of the SEAS terminals.

    For this example, enter these commands.

    rept-stat-trm:trm=18

    This is an example of the possible output.

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    TRM   PST           SST           AST
    18     IS-NR         Active        -----
    Command Completed.
    

    rept-stat-trm:trm=27

    This is an example of the possible output.

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    TRM   PST           SST           AST
    27     IS-NR         Active        -----
    Command Completed.
    
  11. Place the SEAS terminals out of service using the rmv-trm command with the number of the terminal displayed in 10 whose state is not OOS-MT-DSBLD.

    The force=yes parameter must be used when placing the last SEAS terminal out of service. For this example, enter these commands.

    For this example, enter these commands.

    rmv-trm:trm=18

    rmv-trm:trm=27:force=yes

    If the status of the SEAS terminals shown in the PST field in 10 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.

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

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    Inhibit message sent to terminal
    
    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    Command Completed.
    
  12. Change the terminal type of the SEAS terminals to NONE with the chg-trm command, the type=none parameter, and with the values of the SEAS terminals used in 11.

    For this example, enter these commands.

    chg-trm:trm=18:type=none

    chg-trm:trm=27:type=none

    This message should appear when these commands have successfully completed.

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    CHG-TRM: MASP B - COMPLTD
    
    Continue the procedure with by performing one of these steps.
    • If the rept-stat-db command in 3 was not performed, continue the procedure with 13.
    • If the rept-stat-db command in 3 was performed, continue the procedure with 14.
  13. To load the BLMCAP and OAMHC GPLs, they must be loaded on the standby MASP (E5-MCAP) first.

    To determine which MASP is active, enter the rept-stat-db command. This is an example of the possible output.

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.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
    

    The output of the rept-stat-db command shows which MASP is active with the indicator ( ACTV ) following the TDM card location. The indicator ( STDBY) following the TDM card location shows which MASP is standby.

    For this example, the MASP associated with TDM 1116 is active and the MASP associated with TDM 1114 is standby.

  14. Using the outputs of 8 and either 3 or 13 as a guide, place the E5-MCAP card making up the standby MASP card out of service using the rmv-card command.

    For this example, enter this command.

    rmv-card:loc=1113

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

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    Card has been inhibited.
    
  15. Load the approved version of the BLMCAP GPLs onto the card inhibited in 14 using the flash-card command with the code=appr parameter.

    Caution:

    The flash-card command cannot be entered if the IMT Rate Change sequence or the Extended Bit Error Rate Test (BERT) is being performed.

    The flash-card command will load only those BLMCAP GPLs whose approved versions are different from the versions that the card is running. The version of the BLMCAP GPL that the card is running is shown in the RUNNING column in the rept-stat-gpl output. The approved version of the BLMCAP GPL is shown in the APPROVED column of the rept-stat-gpl output. If the running and approved versions of an BLMCAP GPL are the same, the flash-card command will not load that BLMCAP GPL.

    For this example, enter this command.

    flash-card:code=appr:loc=1113

    When this command has successfully completed, these messages should appear.

        eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
        Flash Card: FLASH GPL(s) required to be downloaded on card 1113
          BLMCAP   : Running version 134-015-000  Expected version 134-016-000
    
    ;
    
        eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
        Flash Card: Downloading BLMCAP on card 1113
        Flash Card: Card(s) will reset after the flash GPL download.
    
    ;
    
        eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
        Flash Card: Card 1113 download BLMCAP complete.
    
    ;
    
        eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
        Flash Card: FLASH GPL(s) required to be activated on card 1113
          BLMCAP   : Running inactive version 134-016-000
    
    ;
    
        eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
        Flash Card: Activating BLMCAP on card 1113
    
    ;
    
        eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
        Flash Card: Card 1113 activation BLMCAP complete.
    
    ;
    
        eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
        Command Completed.
    ;
    

    The E5-MCAP card specified in the flash-card command will be re-initialized when the BLMCAP GPL download is complete.

  16. Put the card that was taken out of service in 14 back into service using the rst-card command.

    The rst-card command also loads the approved version of the BLMCAP and OAMHC GPLs onto the card.

    For this example, enter this command.

    rst-card:loc=1113

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

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    Card has been allowed.
    
  17. Verify that the BLMCAP and OAMHC GPLs from 15 have been loaded and that the card has returned to its in-service normal (IS-NR) state using the rept-stat-card command.

    For this example, enter this command.

    rept-stat-card:loc=1113

    This is an example of the possible output.

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    
    CARD   VERSION      TYPE      GPL        PST            SST        AST
    1113   139-008-000  E5MCAP    OAMHC      IS-NR          Active     -----
      ALARM STATUS       = No Alarms.
      BLMCAP  GPL version = 139-008-000
      IMT BUS A           = Conn
      IMT BUS B           = Conn
      CURRENT TEMPERATURE   =  30C ( 86F)
      PEAK TEMPERATURE:     =  33C ( 92F)     [02-01-05 07:18]
    Command Completed.
    

    Note:

    If the versions of the BLMCAP or OAMHC GPLs shown in the rept-stat-card command output are not the versions specified in 6, contact the Customer Care Center. Refer to My Oracle Support (MOS) for the contact information. The reminder of this procedure should not be performed.
  18. To load the new BLMCAP and OAMHC GPLs onto the E5-MCAP card making up the active MASP, enter the init-card command specifying the location of the E5-MCAP card making up active MASP. For this example, enter the init-card:loc=1115 command. This message should appear.
    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    Init Card command issued to card 1115
    

    After this step has been performed, repeat steps 14, 15, 16, and 17 using the card location specified in this step as the loc parameter value in these steps. After these steps have been performed, continue the procedure with either 19 or 21 based on the following conditions:

    • If SEAS terminals were not shown in the rtrv-trm command output in 9, continue the procedure with 21.
    • If SEAS terminals were shown in the rtrv-trm command output in 9, continue the procedure with 19.
  19. Change the terminal type of the terminals that were changed to NONE in 12 to the terminal type SEAS with the chg-trm command and the type=seas parameter.

    The terminal type is shown in the TYPE field in the rtrv-trm command output in 9.

    For this example, enter these commands.

    chg-trm:trm=18:type=seas

    chg-trm:trm=27:type=seas

    This message should appear when these commands have successfully completed.

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    CHG-TRM: MASP B - COMPLTD
    
  20. Put the SEAS terminals back into service using the rst-trm command with the number of the terminals specified in 19.
    rst-trm:trm=18
    rst-trm:trm=27

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

    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    Allow message sent to terminal
    
    eagle1 16-09-09 18:49:10 MST  EAGLE 46.4.0.0.0-69.8.0
    Command Completed.
  21. This procedure is finished.

Figure 3-1 Updating the BLMCAP and OAMHC GPLs



Sheet 1 of 3



Sheet 2 of 3



Sheet 3 of 3