How to Upgrade Microcode in SL8500 Library:ATR:383:2

Asset ID:	1-71-1306003.1
Update Date:	2017-11-27
Keywords:

Solution Type Technical Instruction Sure

Solution 1306003.1 : How to Upgrade Microcode in SL8500 Library:ATR:383:2

Applies to:

Sun StorageTek SL8500 Modular Library System - Version All Versions and later
Information in this document applies to any platform.

Goal

How to Upgrade Microcode in SL8500 Library:ATR:383:2 (Doc ID 1306003.1)

Solution

DISPATCH INSTRUCTIONS

TASK COMPLEXITY: 2

TIME ESTIMATE: 120 minutes

Note: If this is a 5 module with 8 bots, and coming from a lower level of code, ie; 3.98b or 4.x, this process could take up to 240 minutes. Furthermore, each library firmware upgrade will take 2 hours (120 minutes) per library i.e. 1 library = 120 minutes, 2 libraries = 240 minutes, etc.

WHAT SKILLS DOES THE ENGINEER NEED:(IS A SITE ENGINEER AVAILABLE?)
Oracle/Storagetek SL8500 Product Knowledge

DELIVERY REQUIREMENT: Scheduled with customer

FIELD ENGINEER INSTRUCTIONS

PROBLEM OVERVIEW: Firmware upgrade needed on SL8500 library

CONFIRM THE FAULT BY CHECKING:
- Check firmware level using SL Console or
- Verify firmware level with CLI

WHAT STATE SHOULD THE SYSTEM BE IN TO BE READY TO PERFORM THE RESOLUTION ACTIVITY? :

Read code instructions and determine if code upgrade is disruptive or non-disruptive:

If code upgrade is disruptive, then customer needs to shutdown or quiesce backup applications, offline the libraries and drives.

If code upgrade is non-disruptive, no action is required by customer.

WHAT ACTION DOES THE ENGINEER NEED TO TAKE:
-Acquire current level of firmware from the System Assurance Center.
https://sac.us.oracle.com/download/index.html

Loading code to the SL8500 is done using the StreamLine Library Console (SLC; remote and web launch versions only).
There are four sets of code download instructions:
A. Upgrading from code levels prior to FRS_3.98 (Instruction A).
B. Upgrading to a Non-Redundant Electronics library (Instruction B).
C. Upgrading to a Redundant Electronics library (Instruction C).
D. Upgrading from FRS_6.0x to FRS_7.01 (Instruction D).

E. Upgrading from non-RE pre-6.01+ (3.98b or 4.xx) code level to a non-RE library with code level 8.31+ (Instruction E).

F. Upgrading from a non-RE pre-6.01+ (3.98b or 4.xx) code level to an RE code level 8.31+ and installing cards (Instruction F).

Please go to the correct set of instructions for your particular situation.

---------------------------------------------------------------------------------------------------------------------------------

Note: Nov. 2, 2015

Run a logsnap after the code upgrade and upload to SPLAT to get configuration information updated on back end.

----------------------------------------------------------------------------------------------------------------------------------
A. Instructions for upgrading from code levels prior to FRS_3.98b
Any code levels prior to FRS_3.98b running on the SL8500 need to use FRS_3.98b as a bridge to FRS_7.01. Upgrading from code from a level prior to 3.98 to 7.01 will fail.
1. Vary the Library Offline.
2. A Reboot must be done before proceeding with this code load.
3. Do NOT use the ERS button!!!!
4. Load and Unpack the 3.98b Code
- There are 2 steps to code load – load code and unpack code:
- Loads firmware archive file (*.jar) into flash memory on the HBC card.
- Unpacks (similar to unzip) the archive file into individual files in flash memory on HBC
- Approximate time – 10 minutes, +/- 5 minutes
5. Activate Code
- Code activation pushes code from flash memory on the HBC to other SL8500 cards (i.e. HBC, HBT, HBB).
Caution!!!! The wait LED will be on: do not open the door or power-cycle the SL8500 or Robots during this phase, or potential damage can be done to the PCB/PWAs (i.e. HBC, HBT, HBB).
Note: detailed status of which file is being updated, which device is being updated, and status (i.e. successful, failed, skipped) is provided on SLC during entire activation process. Please observe!
- Approximate time – 45 minutes, +/- 15 minutes.
6. Reboot
- Reboot is the final step of loading new code. New code is now in flash memory on all SL8500 cards, but is not running until after the reboot.
- Approximate time – 10 minutes, (IF the front access doors have not been opened. Otherwise, a full audit is automatically triggered, which can take 20 to 60 minutes, depending on the number of tape cartridges in the SL8500).
7. Re-login to SLC
- Go to the instructions pertaining to the situation for this library, either B, upgrading to a non-Redundant Electronics library or C, upgrading to a Redundant Electronics library.

B. Instructions for upgrading from non-Redundant Electronics pre-6.01+ (3.98b or 4.xx) code levels to a non-Redundant Electronics library with code level 7.01+
NOTE: The loading, unpacking, and activation phases of the code load can be performed non-disruptively. However, to avoid possible mount cleanup and recovery actions after the reboot phase, it is highly recommended to vary “Offline” all drives in the library, before the library reboot. The drives have been reported as being affected by the HBT card reboot and this is particularly true for all RTD drives connected to VSM. Additionally, it is highly recommended that the ACS be varied “Offline” from all SCSI hosts, ACSLS and/or HSC for the duration of the reboot.
1. IMPORTANT FIRST STEP BEFORE UPGRADE:
- Prior to updating the code, using the CLI network print command to determine if the netmask is set. If not, you MUST set the netmask BEFORE upgrading to 7.01+. (Note CLI must be used, not SLConsole to determine if the netmask is set.)
Contact your network administrator for the correct netmask.
2. Vary the Library Offline.
3. Load and Unpack the Code
- Loading code is non-disruptive and can be done while host jobs are in progress.
- There are 2 steps to code load – load code and unpack code:
- Loads firmware archive file (*.jar) into flash memory on the HBC card.
- Unpacks (similar to unzip) the archive file into individual files in flash memory on HBC
- Approximate time – 10 minutes, +/- 5 minutes
4. Activate Code
- Code activation pushes code from flash memory on the HBC to other SL8500 cards (i.e. HBC, HBT, HBB).
Caution!!!! The wait LED will be on: do not open the door or power-cycle the SL8500 or Robots during this phase, or potential damage can be done to the PCB/PWAs (i.e. HBC, HBT, HBB).
Note: Detailed status of which file is being updated, which device is being updated, and status (i.e. successful, failed, skipped) is provided on SLC during entire activation process. Please observe!
- Approximate time – 45 minutes, +/- 15 minutes.
5. Reboot
- The library and drives should be taken “Offline” via the control path before pressing the reboot button. Please see the note above at the start of the Code Download section of this document for more details.
- Reboot is the final step of loading new code. New code is now in flash memory on all SL8500 cards, but is not running until after the reboot.
- Approximate time – 10 minutes, (A full audit is automatically triggered, which can take 20 to 60 minutes, depending on the number of tape cartridges in the SL8500. The following steps can proceed while the audit is in progress.).
6. Re-login to SLC
- Robots may show not installed at this time. Continue on, as the second reboot (step 7 below) will correct the issue.
7. Load and Unpack the 7.01 Code again
- This is necessary to extract missing manifest signature files.
8. Activate the 7.01 code again
- In this second pass, you will verify that all files are skipped.
9. Reboot again
- This is necessary because another load/unpack will not be allowed unless the system has been rebooted.
Note: After this procedure is complete, only one level of code, 7.01, will be left on the machine.
WARNING: To return to a pre-6.XX code level, the CSE must load and unpack that level of code.

C. Instructions for upgrading from non-Redundant Electronics pre-6.01+ (3.98b or 4.XX) code levels to a Redundant Electronic (RE) code level 7.01+ and add cards.
NOTE: Upgrade to a Redundant Electronic library is DISRUPTIVE. Thus, Host jobs should be quiesced prior to upgrading the library.
1. Ensure the B slot HBC/HBT cards are NOT present in the library.
- If they are present, they should be removed before starting this procedure.
2. Power off the robotic devices by opening the door.
3. IMPORTANT FIRST STEP BEFORE UPGRADE:
- Prior to updating the code, using the CLI network print command to determine if the netmask is set. If not, you MUST set the netmask BEFORE upgrading to 7.01+. (Note CLI must be used, not SLConsole to determine if the netmask is set.)
Contact your network administrator for the correct netmask.
4. Load and Unpack the Code
- Loading code is non-disruptive and can be done while host jobs are in progress.
- There are 2 steps to code load – load code and unpack code:
- Loads firmware archive file (*.jar) into flash memory on the HBC card.
- Unpacks (similar to unzip) the archive file into individual files in flash memory on HBC
- Approximate time – 10 minutes, +/- 5 minutes
5. Activate Code
- Code activation pushes code from flash memory on the HBC to other SL8500 cards (i.e. HBC, HBT).
Note: detailed status of which file is being updated, which device is being updated, and status (i.e. successful, failed, skipped) is provided on SLC during entire activation process. Please observe!
- Approximate time – 45 minutes, +/- 15 minutes.
6. Reboot
- Reboot is the final step of loading new code. New code is now in flash memory on all SL8500 cards, but is not running until after the reboot.
- Approximate time – 10 minutes. (Leave library door open at this time.)
7. Re-login to SLC
- Robots will show not installed at this time because the door is open. This is normal, continue on to step 6.
8. Load and Unpack the 7.01 Code again
a. This is necessary to extract missing manifest signature files.
9. Activate the 7.01 code again
- In this second pass, you will verify that all files are skipped.
10. Reboot again
- This is necessary because another load/unpack will not be allowed unless the system has been rebooted.
9. Remove the original HBC and HBT cards from the A slots.
10. Insert the second set of HBC and HBT cards from the RE install kit into the A slot and repeat steps 3-8.
11. Power on the robotic devices by closing the door.
NOTE: The robotic devices will then be auto-loaded to the RE release level at this time.
Also, note that a complete audit will be performed after the robot initialization is complete. The full audit can take 20 to 60 minutes, depending on the number of tape cartridges in the SL8500.
Note: After this procedure is complete, only one level of code, 7.01, will be left on the machine.
Additional Notes: To return to the pre-6.XX code level, the CSE must load and unpack that level of code.
12. To add the second set of cards in the B slots, follow the instructions included with the RE installation kit to finish the installation and configuration.

D. Upgrading from 6.0x to 7.01 (with or without Redundant Electronics).
1. IMPORTANT FIRST STEP BEFORE UPGRADE:
- Prior to updating the code, using the CLI network print command to determine if the netmask is set. If not, you MUST set the netmask BEFORE upgrading to 7.01+. (Note CLI must be used, not SLConsole to determine if the netmask is set.)
Contact your network administrator for the correct netmask.
2. Vary the Library Offline.
3. Load and Unpack the Code
- Loading code is non-disruptive and can be done while host jobs are in progress.
- There are 2 steps to code load – load code and unpack code:
- Loads firmware archive file (*.jar) into flash memory on the HBC card.
- Unpacks (similar to unzip) the archive file into individual files in flash memory on HBC
- Approximate time – 10 minutes, +/- 5 minutes
4. Activate Code
- Code activation is also non-disruptive and can be done while host jobs are in progress.
- Code activation pushes code from flash memory on the HBC to other SL8500 cards (i.e. HBC, HBT, HBB).
Caution!!!! The wait LED will be on: do not open the door or power-cycle the SL8500 or Robots during this phase, or potential damage can be done to the PCB/PWAs (i.e. HBC, HBT, HBB).
Note: detailed status of which file is being updated, which device is being updated, and status (i.e. successful, failed, skipped) is provided on SLC during entire activation process. Please observe!
- Approximate time – 45 minutes, +/- 15 minutes.
5. Reboot
- The library and drives should be taken “Offline” via the control path before pressing the reboot button. Please see the note above at the start of the Code Download section of this document for more details.
- Reboot is the final step of loading new code. New code is now in flash memory on all SL8500 cards, but is not running until after the reboot.
- Host jobs should be quiesced prior to rebooting the library.
- Approximate time – 10 minutes, (IF the front access doors have not been opened. Otherwise, a full audit is automatically triggered, which can take 20 to 60 minutes, depending on the number of tape cartridges in the SL8500).
6. Re-login to SLC
- The library should now successfully be running FRS_7.01.

E. Upgrading from non-RE pre-6.01+ (3.98b or 4.xx) code level to a non-RE library with code level 8.31+
NOTE: Code load and unpack can be performed non-disruptively.
However, it is highly recommended to vary ‘Offline’ all drives in the library before the code activation and library reboot for the activation phase of the code load.
- This avoids possible mount cleanup and recovery actions after the reboot phase
- The drives have been reported as being affected by the HBT card reboot and this is particularly true for all RTD drives connected to VSM.
NOTE: After this procedure is complete, only one level of code, 8.31+, will be left on the machine.
WARNING: to return to a pre-6.xx code level, the CSE must load and unpack that level of code.
1. Vary the Library Offline.
2. Load and Unpack the Code
There are two steps to code load:
- Load: loads firmware archive file (*.jar) into flash memory on the HBC card.
- Unpack: Unpacks (similar to unzip) the archive file into individual files in flash memory on HBC
- When loading code in a complex, the code will be loaded on all libraries at the same time with SLC 5.25+ Approximate time – 10 minutes, +/- 5 minutes
3. Activate Code:
- Before pressing the activate button, the library and drives should be taken off-line through the control path.
- Code activation pushes code from flash memory on the HBC to other SL8500 cards (i.e. HBC, HBT, HBB).
- When activating code in a complex, the code will be activated on all libraries at the same time with SLC 5.25+.
- Caution!!!! The wait LED will be on: do not open the door or power-cycle the SL8500 or Robots during this phase, or potential damage can be done to the PCB/PWAs (i.e. HBC, HBT, HBB).

NOTE: detailed status of which file is being updated, which device is being updated, and status (i.e. successful, failed, skipped) is provided on SLC during entire activation process. Please observe!
Approximate time – 45 minutes, +/- 15 minutes.
4. Reboot:
- Before pressing the reboot button, the library drives should be taken off-line through the control path.
- Reboot is the final step of loading new code. New code is now in flash memory on all SL8500 cards, but is not running until after the reboot.
- With SLC 5.25+, when asked to reboot in a complex, all libraries in the complex will be rebooted.
- Approximate time – 10 minutes, (IF the front access doors have not been opened. Otherwise, a full audit is automatically triggered, which can take 20 to 60 minutes, depending on the number of tape cartridges in the SL8500).
5. Re-login to SLC
- Robots may show not installed at this time. Continue on to Step 6; the second reboot will correct the issue.
6. Load and Unpack the 8.31+ code again
- This is necessary to extract missing manifest signature files.
7. Activate the 8.31+ code again
- In this second pass, you will verify that all files are skipped.
8. Reboot again
- This is necessary since another load/unpack will not be allowed unless the system has been rebooted.

F. Upgrading from a non-RE pre-6.01+ (3.98b or 4.xx) code level to an RE code level 8.31+ and installing cards
NOTE: Upgrading to a Redundant Electronics library is DISRUPTIVE. Host jobs should be quiesced (paused) prior to upgrading the library.
1. Ensure the B slot HBC/HBT cards are NOT present in the library.
- If these cards are present, remove them before starting this procedure.
2. Power off the robotic devices by opening the door.
3. Load the 8.31+ Code:
- There are two steps to code load:
- Load code: loads firmware archive file (*.jar) into flash memory on the HBC card.
- Unpack code: Unpacks (similar to unzip) the archive file into individual files in flash memory on HBC
- When loading code in a complex, the code will be loaded on all libraries at the same time with SLC 5.25+
- Approximate time – 10 minutes, +/- 5 minutes
4. Activate Code:
- Code activation pushes code from flash memory on the HBC to other SL8500 cards (i.e. HBC, HBT, HBB).
- When activating code in a complex, the code will be activated on all libraries at the same time with SLC 5.25+.
- Caution!!!! The wait LED will be on: do not open the door or power-cycle the SL8500 or Robots during this phase, or potential damage can be done to the PCB/PWAs (i.e. HBC, HBT, HBB).
NOTE: detailed status of which file is being updated, which device is being updated, and status (i.e. successful, failed, skipped) is provided on SLC during entire activation process. Please observe!
- Approximate time – 45 minutes, +/- 15 minutes.
5. Reboot:
- Reboot is the final step of loading new code. New code is now in flash memory on all SL8500 cards, but is not running until after the reboot.
- When asked to reboot in a complex, all libraries in the complex will be rebooted with SLC 5.25+.
- Approximate time – 10 minutes, (leave library door open at this time).
6. Re-login to SLC.
- Robots may show not installed at this time. Continue on to Step 7; the second reboot will correct the issue.
7. Load and Unpack the 8.31+ code again.
- This is necessary to extract missing manifest signature files.
8. Activate the 8.31+ code again.
- In this second pass, you will verify that all files are skipped.
9. Reboot again.
- This is necessary since another load/unpack will not be allowed unless the system has been rebooted.
10. Remove the original HBC and HBT cards from the A slots.
11. Insert the second set of HBC and HBT cards from the RE install kit into the A slot and repeat Steps 3-8.
12. Power on the robotic devices by closing the door.
NOTE:
- The robotic devices are auto-loaded to the RE release level at this time
- A complete audit is performed after the robot initialization is complete. The full audit can take 20-120 minutes, depending on the number of tape cartridges in the SL8500.
- After this procedure is complete, only one level of code, 8.31+, will be left on the machine.
- To return to the pre-6.xx code level, the CSE must load and unpack that level of code.
13. To add the second set of cards to the B slots (the ones removed above), follow the instructions included with the RE installation kit to finish the installation and configuration.
- This involves enabling the RE hardware activation file, as well as the installation of the second set of cards.
- See Appendix G: Redundant Electronics (page 28) for more information on RE card installation and replacement.

CONFIRM THE FIX BY:
Check firmware level using SL Console

OBTAIN CUSTOMER ACCEPTANCE

WHAT ACTION DOES THE CUSTOMER NEED TO TAKE TO RETURN THE SYSTEM TO AN OPERATIONAL STATE: Application should have library and drives in an online state. Customer should perform a backup to confirm proper operation.

PARTS NOTE: N/A

ADDITIONAL COMMENTS:
SL8500 - Procedure to Upgrade Code from Version 1.42a or Higher to Version 3.02 or Higher (Doc ID 1014203.1)
SL8500 - Problems Upgrading SL8500 Code Direct Attached (Doc ID 1005619.1)

Attachments

This solution has no attachment