Patch-ID# 116620-01 Keywords: lto, lto-2, lto2, gen 2, ultrium, ultrium 2, hp, autoloader, firmware, l8, adic, faststor 2 Synopsis: Hardware, StorEdge L8 LTO2 Autoloader, Firmware Download Program G12r Date: Jan/29/2004 Install Requirements: Additional instructions may be listed below Solaris Release: SunOS Release: Unbundled Product: Sun StorEdge L8 Tape Library Unbundled Release: N/A Xref: Topic: Relevant Architectures: BugId's fixed with this patch: Changes incorporated in this version: Patches accumulated and obsoleted by this patch: Patches which conflict with this patch: Patches required with this patch: Obsoleted by: Files included with this patch: OR2S_R_1_20_L8LTO2_G12r_SCSI_Controller.fbi OR2_R_1_00_L8LTO2_G12r_Robot.fbi README.116620-01 sgen.conf.example tload Problem Description: NOTE: This firmware release is intended to allow Sun to maintain synchronicity with the supplier partner of this device, ADIC. There are some changes to the code which are anticipated to make an insignificant improvement in AFR and reliability. Patch Installation Instructions: ------------------------------- None. Special Install Instructions: ---------------------------- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Contents -------- A.0 Firmware File Names, Configuration & Utility Descriptions B.O Precautionary Statements C.O Patch Installation and Utility Usage Instructions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A.0 Firmware File Names & Utility Descriptions ----------------------------------------------- A.1 sgen.conf.example (2,899 bytes) --> Sample /kernel/drv/sgen.conf file modified for use of the uscsi compliant sgen target driver to attach to a SCSI tape library (SCSI changer/SCSI device type 0x08) A.2 OR2S_R_1_20_L8LTO2_G12r_SCSI_Controller.fbi (60,928 bytes) --> L8 autoloader SCSI Controller Firmware Image G12r A.3 OR2_R_1_00_L8LTO2_G12r_Robot.fbi (65,280 bytes) --> L8 autoloader Robotics Controller Firmware Image G12r A.4 tload (57,556 bytes) --> Firmware Download Utility A.5 README.116620-01 --> This file ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ B.0 Precautionary Statements ----------------------------- **WARNING:****WARNING:****WARNING:****WARNING:****WARNING:****WARNING:** B.1 The system MUST BE IDLE during the firmware download process! No other programs should be running while this utility is being used. Failure to do so may cause the devices being upgraded to fail or the system to crash. Any other computers sharing the same I/O bus as the host system must be either disconnected or offline. B.2 If any upgrade failures occur, do not continue upgrading devices. For example, loss of power during download will result in damaged peripherals and require replacement. If any failures occur, please collect the following log file: "/var/adm/messages", and an explorer dump. Please forward these files to your service provider for analysis. B.3 This package will only function on StorEdge L8 Autoloaders which use an HP Ultrium-2 LTO Tape Drive. B.4 Please READ instructions below completely BEFORE starting download procedure. Follow the procedures carefully. You may program multiple autoloaders at the same time, however, you may not exit the utility until all autoloaders have completed the download process. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C.O Patch Installation and Utility Usage Intructions ----------------------------------------------------- C.1 General guidelines for upgrading: EJECT MEDIA FROM DEVICE TO BE UPGRADED. Download utility will eject media from the device if it is found to be loaded. Do NOT attempt to force media back into the drive. STOP ALL APPLICATIONS. The system must be idle during the firmware upgrade process. DISCONNECT or take OFFLINE any other computers sharing the same I/O bus as the host. The StorEdge L8 Autoloader requires two firmware images to be downloaded: * One to the SCSI Controller * One to the Robotics Controller The images must be loaded sequentially one immediately after the other. You will not receive a valid Product Revision unless both images are present. Follow the procedure section below. In case of any disruption or unforeseen events happening on the relevant bus during the firmware download process, it may be that the upgraded device becomes non-functional. In this event, it will be necessary to replace the device. This would happen as a result of an incomplete or corrupted firmware file being downloaded. Loss of power during the upgrade process would also damage the device. **NOTE** If you cannot upgrade devices due to software application interference, try booting off of the Solaris release CD. **NOTE** After the firmware download is completed, it may be necessary to power cycle the device to ensure fully resetting the device. In turn, this may also require a successive reboot of the host system to ensure all functionality is restored. C.2 Procedure for L8 Tape Autoloader Firmware Download: The procedure to be used for upgrading the device's firmware is explained below. Total upgrade time will be approximately 4-5 minutes for each device. You must have root/super-user privileges in order to perform this operation. a). Ensure you are logged in as root on the machine attached to the L8 tape autoloaders you wish to upgrade. b). Unpack the patch (through tar) into any directory, e.g. /var/spool/patch (Note, if the patch ends in a ".Z" suffix, you will need to first uncompress it.) Example: # uncompress # tar xvf c). Modify the /kernel/drv/sgen.conf file so that the sgen target driver will have a device link allowing access to the L8 tape autoloader via a /dev/scsi/changer device link. SUGGESTED METHOD: ---------------- The sgen.conf.example file included with this patch may be utilized by first moving /kernel/drv/sgen.conf to /kernel/drv/sgen.conf.bak. Secondly, copy the included sgen.conf.example file to /kernel/drv/sgen.conf which supports tape library target (changer) devices operating on a parallel SCSI bus (SCSI target ID's 0-15 are supported). After completing this task, run: /usr/sbin/devfsadm -i sgen to create the /dev/scsi/changer/c#t#d# device link. MANUAL METHOD: ------------- Note: If you have used the SUGGESTED METHOD, skip to step C.2.d below in this section, else for manual sgen modifications: Refer to /kernel/drv/sgen.conf and/or the sgen man page for instructions on how to configure the sgen driver (included in Solaris 8 and later) to support tape library target (changer) devices operating on a parallel SCSI bus. First, copy /kernel/drv/sgen.conf to /kernel/drv/sgen.conf.bak to ensure preservation of the original sgen.conf file. Modify /kernel/drv/sgen.conf to enable sgen attach to tape library target (changer) devices operating on a parallel SCSI bus and enable the appropriate SCSI target ID(s) for your L8 tape autoloader(s). The following lines must exist in /kernel/drv/sgen.conf after modification: device-type-config-list="changer"; name="sgen" class="scsi" target=0 lun=0; where target= (target is set to SCSI ID 0 above). Uncomment the appropriate "name=..." lines to support your L8 tape autoloader SCSI target IDs. Do not modify the lun address as all L8 autoloaders use lun=0 in all cases. After completing this task, run: /usr/sbin/devfsadm -i sgen to create the /dev/scsi/changer/c#t#d# device link. d). In the patch directory, type the "tload" command to load the SCSI Controller firmware: # ./tload OR2S_R_1_20_L8LTO2_G12r_SCSI_Controller.fbi **NOTE** Do not rename the firmware filename or change it to lowercase characters. e). Select the device to be upgraded (see example below--the L8 tape autoloader corresponds to a Vendor ID of ADIC and Product ID of FastStor 2). f). Ensure that the revision level of the selected ADIC FastStor 2 device begins with the letter "G". If it does not, you have the incorrect patch for this L8 autoloader type. Please consult http://sunsolve.sun.com/ or your local service provider for additional assistance. If the revision level does begin with the letter "G", answer the question: Do you want to download firmware to this tape device [N]? with a 'y' for yes or anything else for no. Default answer is no. **NOTE** While the SCSI Controller firmware is downloading, the LCD on the autoloader will display "Controller SW/Update busy..." and the Ready/Activity LED will be in slow blink mode. The download will take approximately 1 minute. The autoloader will automatically reboot when completed. g). After the first code image has been downloaded to the L8 tape autoloader, the displayed tape device list will be refreshed. A "----" should appear in the "Rev" field. The "----" indicates an intermediate status until the second firmware image is downloaded. The autoloader will not function in this configuration (see example below). h). If there is an additional device to be upgraded (same device type and desire to upgrade to the latest firmware), select that device as previously done in C.2.e). & C.2.f). above. Continue in this fashion until all desired devices have been upgraded. i). Quit the "tload" program by typing '0' (see example below). j). In the patch directory, as root, type the "tload" command to load the Robotics firmware: # ./tload OR2_R_1_00_L8LTO2_G12r_Robot.fbi **NOTE** Do not rename the firmware filename or change to lowercase characters. k). Select the device to be upgraded (see example below). l). Ensure that the device to be upgraded is the correct one (must have previously had a revision level starting with the letter "G" prior to the SCSI controller firmware upgrade) and answer the question: Do you want to download firmware to this tape device [N]? with a 'y' for yes or anything else for no. Default answer is no. **NOTE** While the Robotics Controller firmware is downloading, the LCD on the autoloader will display "Robot SW Update/busy..." and all 4 LEDs will be in fast blink mode. The download will take approximately 2-3 minutes. The autoloader will automatically reboot when completed. m). After the device has been upgraded, the displayed tape device list will be refreshed. Device(s) upgraded should reflect having the new code level, "G12r", in the "Rev" field (see example below). n). If there is an additional device to be upgraded (same device type and desire to upgrade to the latest firmware), select that device as previously done in C.2.k). & C.2.l). above. Continue in this fashion until all desired devices have been upgraded. o). Quit the "tload" program by typing '0' (see example below). **NOTE** This upgrade may result in error messages in the console window and/or the terminal "tload" window. It is normal for an "Unexpected USCSICMD ioctl error: I/O error" message to appear in the console window for each device that is upgraded. p). Upon completion of upgrading all L8 tape autoloaders, the user may move the /kernel/drv/sgen.conf.original file back to the original /kernel/drv/sgen.conf file thus restoring the original sgen configuration. ****************************************************************************** C.3 EXAMPLE # ######################################### # # Launch Tape Firmware Download Utility: # ######################################### # # ./tload OR2S_R_1_20_L8LTO2_G12r_SCSI_Controller.fbi ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 G10r 0250F10011 Available Select Device(s) (ex: 1,3-4)0 to quit) [1]: 2 c4t0d0 ADIC FastStor 2 G10r 0250F10011 Selected Do you want to download firmware to this device [N]? y ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 G10r 0250F10011 Downloading Downloading /dev/scsi/changer/c4t0d0... please wait. ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 G10r 0250F10011 Writing Flash Select Device(s) (ex: 1,3-4) or 0 to quit) [2]: 0 ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 ---- 0250F10011 F/W Upgraded # ./tload OR2S_R_1_20_L8LTO2_G12r_SCSI_Controller.fbi ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 ---- 0250F10011 Available Select Device(s) (ex: 1,3-4)0 to quit) [1]: 2 c4t0d0 ADIC FastStor 2 ---- 0250F10011 Selected Do you want to download firmware to this device [N]? y ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 ---- 0250F10011 Downloading Downloading /dev/scsi/changer/c4t0d0... please wait. ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 ---- 0250F10011 Writing Flash Select Device(s) (ex: 1,3-4) or 0 to quit) [2]: 0 Unexpected USCSICMD ioctl error: I/O error Waiting for /dev/scsi/changer/c4t0d0 to become ready (15 seconds)... ATTACHED DEVICES: Device Supplier Product Rev Serial Number Device State -------------- -------- ---------------- ---- ------------- ------------- 1:0ln HP Ultrium 2-SCSI F53A E250040941 Available 2:c4t0d0 ADIC FastStor 2 G12r 0250F10011 F/W Upgraded # ######################################### # # The example above only upgrades one # device. You do not have to exit with # a "0" and initiate the 'tload' utility # again. You may continue instead and # directly upgrade the next tape device, # following the same steps as before # for each device until all devices # have been upgraded # ######################################### # # ######################################### # # After devices are upgraded, the Rev # will be G12r # ######################################### # # ######################################### # # To Quit, enter '0'. System prompt # will return. # ######################################### # ************************************************************************** ************************************************************************** C.4 tload (ABOUT THE UTILITY): tload - Firmware Download utility for tape drives. SYNOPSIS tload [ filename ] [ -v ] filename firmware/microcode filename DESCRIPTION tload is an firmware download utility for Sun supported tape devices. If the firmware_file is specified, then it will display the list of tape devices present on the host system and asks the user to select the tape device which is to be upgraded. If the firmware_file is not specified, then it will display the list of tape devices present on the host system along with their FIRMWARE revision levels. tload will exit upon completion; please do not attempt to halt or stop prior to utility's menu exit option being presented. The command can be run only as a super-user. DISCLAIMER This utility is ONLY supported for downloading, to Sun supported tape devices, the Sun supported firmware binary (firmware_file) which has officially been released via the official Sun Patch Process. This utility is only supported with the release of firmware (binary) bundled with said patch. Do not attempt to use any other version of 'tload' that may have been acquired previously else device damage may occur. Use only the version provided with this patch, version 4.1 (tload). Use of tload to load non-Sun supported tape devices is at the user's own risk, and is not supported. Use of tload to load Sun supported tape devices with firmware NOT bundled with the utility in an officially released Sun Patch is at the user's own risk, and is not supported. PROBLEMS Any problems regarding this utility by the user following proper procedures should be reported to the user's service provider along with the following items: 1) /var/adm/messages file 2) explorer dump 3) tload -v README -- Last modified date: Thursday, January 29, 2004