4.378 init-flash

Use this command to load the Board PROM to the inactive FLASH memory of a specified card or range of cards. When a card is reinitialized, it runs this version of the GPL in the card’s inactive FLASH memory.

Parameters

bits (optional)
This parameter must be specified for one E5-class card in conjunction with mode=rplcebl or mode=cnvrtbit. It indicates whether the bootloader or the flash image will be converted to a 32-bit or a 64-bit image. The E5-class card must be inhibited before the bootloader or the flash image can be changed through this mode.
Range:
32 - convert to a 32-bit bootloader or flash image
64 - convert to a 64-bit bootloader or flash image
boot (optional)
This parameter specifies whether the EPME5-class card should boot after the command successfully completes.

Multiple images can be flashed without having to boot after each flash. If multiple images are being flashed to the E5-class card, this parameter can be used to prevent the card from booting after each image is flashed. If multiple images are being flashed and the card is allowed to boot after each flash, an image that is not activated after the card boots will be lost on a subsequent reset of the card. This option does not apply to MUX cardsor IMT Switch cards.

Range:
yes
Reboot the card after the command completes successfully
no
Do not reboot the card after the command completes successfully.
Default:
yes

For E5-class cards, if the mode parameter is not specified or if mode=foregrnd, mode=imgselct or mode=pvjoy, then default value of boot parameter is yes. If the mode parameter is specified for E5-class card(s) as mode=backgrnd, then default value of boot parameter is no.

code (optional)
The version of the GPL being loaded onto the card.
Range:
appr
The approved GPL version
trial
The trial GPL version
The code parameter must be specified if the mode parameter is not specified as mode=imgselct; the code parameter must not be specified if the mode parameter is specified as mode=imgselct.
eloc (optional)
End location. The location of the last card of a range of cards to be initialized.
Range:
1101 - 1113, 1115, 1201 - 1218, 1301 - 1318, 2101 - 2118, 2201 - 2218, 2301 - 2318, 3101 - 3118, 3201 - 3218, 3301 - 3318, 4101 - 4118, 4201 - 4218, 4301 - 4318, 5101 - 5118, 5201 - 5218, 5301 - 5318, 6101 - 6118
force (optional)
This parameter is required to force the flash download on the in-service card(s).
Range:
yes
no
Default:
no
gpl (optional)
Generic program load. The flash GPL type that is running on the cards in the specified range of cards.
Range:
xyyyyyyy

1 alphabetic character followed by up to 7 alphanumeric characters.

Valid GPLs: bldc32, bldc64, blmcap, blslc32, blslc64, hipr2, and multiple.

Use " gpl=multiple " to simultaneously flash multiple E5-class cards running different GPLs, such as BLDC32, BLDC64, BLMCAP, BLSLC32, and BLSLC64. The command will then flash all E5-class cards in the specified range.
initclk (optional)
Initialize clock. If this parameter is specified, then the card location should be 1113 or 1115.
Range:
yes
no
Default:
no
loc (optional)
The location of a single card to be initialized.
Range:
1101 - 1113, 1115, 1201 - 1218, 1301 - 1318, 2101 - 2118, 2201 - 2218, 2301 - 2318, 3101 - 3118, 3201 - 3218, 3301 - 3318, 4101 - 4118, 4201 - 4218, 4301 - 4318, 5101 - 5118, 5201 - 5218, 5301 - 5318, 6101 - 6118
mode (optional)
If this parameter is specified for the E5-class cards, it indicates that the flashing of the E5-class card or range of cards will be performed in the specified mode. This parameter can be specified only for E5-class cards.
Range:
backgrnd
In this mode, the flash image will be copied into an inactive FLASH memory area of an E5-class card or range of cards. If the E5-class card in the specified location is provisioned, the E5-class card can be flashed without inhibiting it. The image uploaded with mode=backgrnd will run after the card boots upon receiving the command init-flash:mode=imgselct.
cnvrtbit
When used with this mode parameter value, init-flash will convert the E5-class card specified with the loc parameter to run on either a 32-bit or 64-bit flash image. The card will start running the target 32-bit or 64-bit flash image after it boots. The E5-class card must be inhibited before it can be flashed in this mode, and the sloc/eloc parameters may not be used.
foregrnd
In this mode, the flash image will be copied into an inactive FLASH memory area of an E5-class card or range of cards. After the E5-class card initializes, it runs this version of the GPL in the card's inactive FLASH memory. If the E5-class card in the specified location is provisioned, the E5-class card must be inhibited before it can be flashed in this mode.
imgselct
This mode will initialize the card(s), and load & run the image previously copied to the local FLASH memory with mode=backgrnd. Do not use this mode unless directed by Oracle's Customer Service.
pvjoy
In this mode, the flash image will be copied into inactive FLASH memory of an E5-class card or range of cards and the card(s) will initialize. After the E5-class card initializes, it will run the version of the GPL in the card's inactive FLASH memory. If the E5-class card in the specified location is provisioned, then the E5-class card can be flashed without inhibiting the E5-class card in the specified location. Debug must be enabled on the active OAM before this mode parameter value can be specified. Do not use this mode unless directed by Oracle's Customer Service.
rplcebl
In this mode, init-flash will replace the bootloader in the E5-class card specified with the loc parameter with either a 32-bit or 64-bit bootloader image and begin using it the next time the card boots. The E5-class card must be inhibited before the bootloader can be changed through this mode, and the sloc/eloc parameters may not be used.
Default:
foregrnd
sloc (optional)
Start location. Location of the first card of a range of cards to be initialized.
Range:
1101 - 1113, 1115, 1201 - 1218, 1301 - 1318, 2101 - 2118, 2201 - 2218, 2301 - 2318, 3101 - 3118, 3201 - 3218, 3301 - 3318, 4101 - 4118, 4201 - 4218, 4301 - 4318, 5101 - 5118, 5201 - 5218, 5301 - 5318, 6101 - 6118

Example

init-flash:loc=1105:code=trial

init-flash:loc=1113:code=appr:initclk=yes

init-flash:loc=1115:code=appr:initclk=yes:force=yes

init-flash:loc=1115:code=trial:initclk=no

init-flash:sloc=1302:eloc=1306:gpl=blisim:code=appr

init-flash:sloc=6305:eloc=6305:code=appr:gpl=blispm

init-flash:sloc=1105:eloc=1306:appr:gpl=blmcap:mode=foregrnd

init-flash:loc=1205:code=appr:mode=backgrnd

init-flash:sloc=1201:eloc=1311:code=trial:gpl=blmcap:mode=backgrnd

init-flash:sloc=1201:eloc=1311:code=trial:mode=imgselct

init-flash:loc=1301:mode=rplcebl:bits=64

init-flash:loc=1301:code=trial:mode=cnvrtbit:bits=64

init-flash:sloc=1103:eloc=1306:code=appr:gpl=blmcap

Dependencies

The specified card must be an E5-class card or Service Module card. A MUX card can be specified for locations xy09 and xy10 (x is the frame and y is the shelf).

Each specified card does not have to be defined in the database, but it does have to be aligned on the IMT bus.

If the card in the specified card location is provisioned, then the card must be inhibited before this command is entered (unless the card is a MUX card or E5-class card with mode set to backgrnd, imgselct or pvjoy).

If the target card is a MUX card, then both card locations specified in the sloc and eloc parameters must contain MUX cards on the same IMT bus. For these cards, the bus is implicit based on the specified location. Location xy09 specifies the MUX A Bus, and location xy10 specifies the MUX B Bus (x is the frame and y is the shelf). For example, sloc=1109:eloc=6109 specifies all MUX cards on the A Bus only; sloc=1110:eloc-6110 specifies all MUX cards on the B Bus only. MUX cards from both the A bus and B bus cannot be flash downloaded simultaneously.

The boot parameter can be specified only if the target is an E5-class card.

A card location that contains the active MASP cannot be specified for the loc, sloc, or eloc parameter.

The provisioning subsystem mode (simple, duplex) must be established prior to executing the command.

The loc parameter cannot be specified with the eloc and sloc parameters.

The loc parameter or the eloc and sloc parameters must be specified.

If the eloc and sloc parameters are specified, the gpl parameter must be specified. MUX cards in the locations specified in the sloc and eloc parameters must be running the specified general program load (gpl). If the GPL specified is not multiple, then other cards in the range of card locations can be running other GPLs, but will not be initialized and only the cards within the range that are running the specified GPL will be initialized.

The sloc parameter value must be less than the eloc parameter value, when the two parameters are specified.

The specified card cannot be running an inactive flash GPL when the command is executed. If the sloc and eloc parameters are specified, cards within the range running an inactive flash GPL will be skipped. If there are no cards in the list because all the cards are running an inactive flash GPL, then UIM 1119 (example in Notes section) will be raised and the command will be rejected.

If the initclk parameter is specified, the card location parameter value must be 1113 or 1115.

If TDM reload would cause a system clock outage, the initclk parameter cannot be specified unless force=yes is also specified.

Caution:

The resulting clock outage will probably cause loss of traffic on all links.

No other related command can be in progress when this command is entered.

A card location that is valid and defined in the database must be specified.

The eloc and sloc parameters must be specified together in the command.

MUX cards specified in the sloc and eloc location parameters must be running the specified GPL. For other GPLs including multiple, all cards within the range running the specified GPL will be flashed.

This command cannot be entered if an IMT Rate Change sequence is in progress.

This command cannot be entered during an Extended Bit Error Rate Test (BERT).

The boot parameter cannot be specified with the mode=backgrnd, mode=imgselct or mode=pvjoy for the E5-class card.

A card location that contains the MASP cannot be specified for the sloc or eloc parameter.

The mode parameter cannot be specified with the non E5-class card.

The gpl=multiple parameter can be specified only if the sloc and eloc parameters are specified.

The gpl=multiple parameter can be specified only if the card locations in the sloc and eloc parameters are E5-class cards.

The code parameter cannot be specified with mode=imgselct parameter for the E5-class card(s). If the mode=imgselct parameter is not specified, then the code parameter must be specified.

The GPL parameter cannot be specified when the mode=rplcebl or mode=cnvrtbit parameter is used with the E5-class card.

The mode=cnvrtbit parameter must be specified with the loc, code, and bits parameters. Any other parameters like force, boot, initclk, and sloc/eloc cannot be specified when the mode=cnvrtbit parameter is specified.

The mode=rplcebl parameter must be specified with the loc and bits parameters. Any other parameters like force, boot, initclk, code, and sloc/eloc cannot be specified when the mode=rplcebl parameter is specified.

The mode=cnvrtbit parameter can be specified only when the E5-class card is an SM8GB card type.

The mode=rplcebl parameter can be specified only when the E5-class card is either an SM8GB or a SLIC card type.

The mode=cnvrtbit parameter can be specified with the bits=64 parameter only when the E5-class card is running a 32-bit flash image (i.e., either BLMCAP or BLSLC32).

The mode=cnvrtbit parameter can be specified with the bits=32 parameter only when the E5-class card is running a 64-bit flash image (as in, BLDC64).

Notes

Card locations 1114, 1116, and 1117 are not valid and cannot be specified.

For the E5-class cards, multiple images can be flashed without having to boot the card after each flash. If multiple images are being flashed to the card the boot=no parameter can be used to prevent the card from booting after each image is flashed. After flashing any number of images, the card can be reset either by entering the init-flash command with the boot=yes parameter or by entering the init-card command. If multiple images are being flashed and the card is allowed to boot after each flash, any images that are not activated after the card boots will be lost on a subsequent reset of the card.

If E5-OAMs are being used, then the init-flash command can be accepted even when the cards specified in the sloc and eloc parameter range contains 1113 and/or 1115 locations in it. But the cards in 1113 and 1115 are never included in the list to flash the cards.

For example, if "sloc=1111:eloc=1215:gpl=blmcap", neither 1113 nor 1115 would be included in the list to flash the cards and the command will be accepted. The only way to flash an E5-OAM card is to specify loc=1113/1115 but the card location specified cannot be the active E5-MASP.

For mode=backgrnd or mode=imgselct to be accepted, the E5-class target card must already be running a 45.0.0=64.XX.YY release version or higher.

When the sloc and eloc parameters are specified for E5-class cards and one or more cards in the range are running an inactive Flash GPL, then UIM 1119 will be raised along with the flash results. UIM 1119 will capture the first 5 card locations along with the total number of cards that have been skipped because of running an inactive Flash GPL. Example:

XXXX.1119    CARD <Active OAM location>     INFO    Cards out of phase with flash procedure
                 Card List: 1101, 1102, 1103, 1105, 1111, ... (  1 others)

To use a 64-bit flash image, the EAGLE must be running Release 46.3 or higher. Steps for converting an E5-SM8G-B card running BLMCAP to BLDC64 GPL and vice-versa:

  • Flash BLMCAP --> BLDC64:
    1. Make sure the E5-SM8G-B card is running BLMCAP Release 46.3 or higher.
    2. Replace the bootloader with the new 64-bit version:
      init-flash:loc=xxxx:mode=rplcebl:bits=64
      • This command will not cause the card to boot.
      • If the card is already running the new bootloader, this command does nothing.
    3. Flash card to BLDC64:
      init-flash:loc=xxxx:code=yyyyy:mode=cnvrtbit:bits=64
    4. Activate flash.
    5. The card is now running the 64-bit flash image.
  • Flash BLDC64 --> BLMCAP:
    1. The card is running BLDC64.
    2. Flash card to BLMCAP (Release 46.3 or higher):
      init-flash:loc=xxxx:code=yyyyy:mode=cnvrtbit:bits=32
    3. Activate flash.
    4. The card is now running the 32-bit flash image.

SLIC cards run either the 32-bit BLSLC32 flash GPL or the 64-bit BLSLC64 flash GPL.

To convert a SLIC card from the 32-bit to the 64-bit flash image:

  1. Inhibit the card:
    inh-card:loc=xxxx:force=yes

    The card will boot and return to state OOS-MT-DSBLD.

  2. Flash the card:
    init-flash:loc=xxxx:code=appr:64gpl=blslc64

    The card will boot and return to state OOS-MT-DSBLD.

  3. Activate the 64-bit BLSLC64 flash GPL:
    act-flash:loc=xxxx

    The card will now accept 64-bit application GPLs from the OAM.

To convert a SLIC card from the 64-bit to the 32-bit flash image:

  1. Inhibit the card:
    inh-card:loc=xxxx:force=yes

    The card will boot and return to state OOS-MT-DSBLD.

  2. Flash the card:
    init-flash:loc=xxxx:code=appr:gpl=blslc32

    The card will boot and return to state OOS-MT-DSBLD.

  3. Activate the 32-bit BLSLC32 flash GPL:
    act-flash:loc=xxxx

    The card will now accept 32-bit application GPLs from the OAM.

Output

init-flash:loc=1105:code=trial

    rlghncxa03w 04-01-05 13:05:05 EST  EAGLE 31.3.0
    FLASH Memory Downloading for card 1105 Started.

    rlghncxa03w 04-01-05 13:05:05 EST  EAGLE 31.3.0
    BPHCAP Downloading for card 1105 Complete.

    rlghncxa03w 04-01-05 13:05:05 EST  EAGLE 31.3.0
    Command Completed. 
;
init-flash:loc=1113:code=appr:initclk=yes

    rlghncxa03w 04-03-08 10:02:04 EST  EAGLE 31.6.0
    FLASH Memory Download for card 1113 Started. 
;

    rlghncxa03w 04-03-08 10:02:23 EST  EAGLE 31.6.0
    FLASH Memory Download for card 1113 Completed. 
;
init-flash:sloc=1101:eloc=1112:gpl=blmcap:code=appr
tekelecstp 18-01-15 02:28:23 EST  EAGLE 46.6.0.0.0-71.5.0
    FLASH Memory Download for cards 1101 - 1112 Started. 
    LOC 1101 : PASSED
    LOC 1102 : PASSED
    LOC 1112 : PASSED
 
    ALL CARD RESULTS PASSED 
;
    Command Completed.