Patch-ID# 107502-01

NOTE:
***********************************************************************
READ THE TERMS OF THE AGREEMENT ("AGREEMENT") IN THE LEGAL_LICENSE.TXT
FILE CAREFULLY BEFORE USING THIS SOFTWARE. BY USING THE SOFTWARE, YOU
AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE
TERMS, PROMPTLY DESTROY THE UNUSED SOFTWARE.
***********************************************************************

Keywords: l280, v80 f/w upgrade for dlt7000 and f/w 2.07 for autoloader
Synopsis: Hardware, Tape: L280 autoloader / Libraries
Date: Mar/17/1999


Install Requirements: NA                      
                      
Solaris Release: 2.5.1 2.6 7 8 9 10

SunOS Release: 5.5.1 5.6 5.7 5.8 5.9 5.10

Unbundled Product: Hardware/Tape

Unbundled Release: N/A

Xref: 

Topic: 

Relevant Architectures: 

BugId's fixed with this patch: 
	NOTE: This changes are enhancements, no bugid#s are associated 
	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: 

README.107502-01
T-load
and
d7oml3.v80,
firmware_207.tar,
sg_drv.tar.Z,

Problem Description:

ECR14393 will require the loading of f/w v80 to the DLT drive 
and f/w 2.07 to the autoloader for the L280. Both  new f/w s are for enhancements 
purpose and do not affect the fit, form or function of the L280. The loading of 
the f/w to the DLT drive and the autoloader will require two distinct but simple 
procedures to be followed as will be explained below.
README.107502-01
(Please read all instructions completely before starting.)
Sec A Attention-1
A.1  The L280 is a differential scsi device and is not single end. If the L280 is 
    connected to a single-end scsi interface host, the L280 will not operate and no 
    IDs recognition.
A.2 Connect the small scsi jumper cable between the DLT and the Autoloader.
A.3 Terminate the autoloader side using a DIFFERENTIAL terminator only. Do not 
    use single-end
    terminator since the L280 will fail to function.
A.4  Connect the other side of the DLT scsi connector to a differential scsi host 
    adapter.
A.5  In order to load the f/w 2.07 to the autoloader, one needs to install and use 
    the sg driver first and  
    then run the utility after unzipping the file sg_drv.tar.Z.
A.6  It is advisable to create a Fup tape (FirwareUPgrade) if there are many L280 
    to be downloaded  with f/w v80.
    Once the Fup tape is created it can be used over and over again until all of 
    the DLT drives receive the v80 f/w. Also once the Fup tape is created, the L280 
    control panel can be used to download the f/w to the DLT drive only,  without
    the use of scsi bus and in an off-line condition.
A.7 If the use of the Fup tape procedure is preferred, the Autoloader MUST be 
   first loaded with the new autoloader f/w 2.07. The old 2.04 f/w does not have
   the capability to download f/w from a  Fup tape to the DLT drive.
A.8 Another procedure to follow is by using the scsi bus and download the v80 f/w 
   directly to the  DLT drive. This will require the use of the T-Load utility to
   be run in order to load the f/w.
A.9 Insure at least 50MBytes of free disk space on the Sun workstation to be used 
   for the download operation.
All the procedures necessary to accomplish successful downloading of both f/ws 
will be given below  in more details. 
F/W file Names & Utilities Explanation:
a) firmware_207.tar  --> This tar file contains the 2.07 f/w for the autoloader 
                         and the utility needed to do the f/w download to the L280 
                         autoloader controller.
b) sg_drv.tar.Z  --> This tar file contains the sg driver
c)  d7oml3.v80  --> This file contains the binary, v80 f/w for the DLT7000 tape 
                    drive
d) T-load --> This is the utility file required to download the DLT f/w only via 
              scsi bus.
Procedure Contents:
====================
     Autoloader Procedure:
     --------------------
Sec B1- How to install the sg driver
Sec C2- How to download the autoloader f/w 2.07 
    DLT drive Procedure:
    -------------------
Sec D3- How to create a Fup tape
Sec E4- How to download DLT drive f/w from a Fup tape or
Sec F5- How to download f/w to the DLT drive via the scsi bus
PROCEDURE:
=========
Sec B1.0 How to install the sg driver Sun Media Manager package that is 
    required for the L280 Library Download Program.
==================================================
Make a directory to work from, such as /L280/sg_driver  
    mkdir /L280/sg_driver
Move the file sg_drv.tar.Z   to  /L280/sg_driver
    mv sg_drv.tar.Z  /L280/sg_driver/sg_drv.tar.Z
Uncompress and un-tar the files.
    uncompress sg_drv.tar.Z
    tar xvf sg_drv.tar
It will uncompress the media manager package, then do a
pkgadd -d /L280/sg_driver
Select the HSM Media Manager package.  SUNWmmgr  
Note: During the install process, select default on all the questions asked.
After installation, select "q" to quit.
Once the package is installed, finish the install of the sg_driver by executing 
the following:
/usr/openv/volmgr/bin/driver/sg.install
Sec C2.0 How to download the autoloader f/w 2.07
===========================================
These instructions are for performing a firmware upgrade on the L280 
Autoloader/Library controller only.  
These are not for the DLT drive.
In order to use the L280_dnld (L280 download) program, you must first install 
the sg driver.
Note: See section 1 above first, "How to install the sg driver".
***************************************************************
Once the sg driver is installed you can proceed with these instructions.
***************************************************************
Create a working directory for the firmware files and download programs.
    mkdir /L280/firmware
Move the firmware and download programs tar file to this directory. 
    mv firmware_207.tar /L280/firmware/firmware_207.tar
Un-tar the firmware/download file.
    tar xvf firmware_207.tar 
There should be the program files L280_dnld and scan_scsi and the firmware 
files.  The firmware files should look like DNLD_001 through DNLD_006.
The capital letters are important.
Run scan_scsi to determine the device driver name for the HP   C6280-7000.
It should look something like /dev/sg/16.  Using the driver information, you can 
download the new code, DNLD_001 through DNLD_006. This process will creat the 
f/w 2.07 for the autoloader.
Make sure the drive is empty.  Unload the tape if one is present.
Perform the download:
     L280_dnld  -d  /dev/sg/16  
The above command says download the files (it knows they are named as requested 
above) to the device (-d)  named (/dev/sg/16 or whatever the scan_scsi command 
returned.)
The LCD display will indicate that firmware files by number x are being 
downloaded.  
Wait until the loader has finished the download and gone through a self-reset 
and then it is a good idea to again power cycle the drive to be certain it is 
fully reset and is stable.  You can verify the change of the f/w by checking the 
LCD panel of the L280  under ADMIN > PASSWORD > INFO > Library
Sec D3.0 How to create a Fup tape
============================
 CREATING A DLT FUP TAPE ON SUN PLATFORMS
The following describes how to create a DLT firmware upgrade (FUP) tapes on SUN 
platforms.  Once created the FUP tape can be used to upgrade f/w for the DLT 
tape drives for L280 Libraries/Autoloaders.
The hardware configuration requirements are a DLT7000 tape drive loaded with OEM 
controller firmware and that the DLT drive is attached and functioning with a 
Sun system. The DLT controller firmware image file must be accessible from the 
Sun system. It is important that the firmware image file remain intact before, 
during and after transportation to the target system. The DLT firmware update 
will fail if the image file has been altered. After the image file has been 
transferred, verify that the source and destination byte counts are the same. 
Prior to creating the FUP tape, make sure that the DLT tape cartridge is 
compatible with both the source and target DLT drive.
      Create the FUP tape as follows:
 D3.1 Load a  tape cartridge (source) into the magazine of the L280 and then  
      using the front panel menu, Load the source cartridge into the drive.
      Make sure the cartridge is not write protected and manually override data 
      compression as uncompressed using the library LCD  panel density select menu
      item.  
      This selection is found in the menu tree under ADMIN >> enter password >>
      CONFIG >> COMPRESSION.  
      See the L280 manual for further information on using the library front 
      panel and switches.  
Note: The Fup tape when created should not be in compressed mode. 
           A DLT4000 or DLT7000 may also be used to creat a Fup tape.
  D3.2 Use the dd command to copy the DLT firmware controller image file onto  
      the tape. 
       Generally, the dd command for this operation has the following construct:
               dd if=<DLT firmware file> of=<DLT device file> bs=8192
      Where:
       <DLT firmware file> is the DLT firmware controller image file path.
       <DLT device file> is the DLT device file path.
   Example Using Type IV media in 7000 drive:   
         SUN:  dd if=L280/d7oml3.v80 of=/dev/rmt/3h bs=8192
    Assumes firmware named d7oml3.v80 located in L280 subdirectory and device 
    name  /dev/rmt/3h.  The h in 3h sets compression off for the  7000 write mode. 
    This matches with the block size recommended above.
  D3.3 Upon successful completion, you have created a firmware upgrade   tape for 
    use in the L280. 
    You can unload the tape from the drive  using the front panel on the 
    L280.   The tape needs to be in the  magazine to be used in the L280 firmware 
    upgrade routine as will be expalined below.  
Sec E4.0- How to download DLT drive f/w from a Fup tape  (Recommended method)
========================================================================
Attention-2 If the use of the Fup tape procedure is preferred, the Autoloader 
MUST be first loaded with the new autoloader f/w 2.07. The old 2.04 f/w does not 
have the capability to download f/w from a Fup tape.
Since the L280, DLT7000 drive dose not have buttons on the drive bezel itself, 
please follow the Autoloader display Menu Tree on page 2-12 for the User''s 
Manual Sun p/n 805-3957-11 and using the control panel buttons, dowload f/w. 
However, first creat a Fup tape using the instruction in section 3.0.  
Using the control panel of the L280, follow the flow to "Update Drive Firmware" 
and execute. The Fup tape must be first placed in slot 1, which is the left most 
slot as viewed from the front of the six tape cartridge holder. 
After the tape is loaded re-cycle power and check for the f/w using the control 
panel of the L280.
The following is a synopsis of the above instruction.
 E4.1. To upgrade the drive firmware using an upgrade tape, start with the tape 
      in the magazine, (slot 1), and then  using the front panel menu and switches, 
      select the UPDATE DRIVE FW under ADMIN.  
   ADMIN  >>  password >> UPDATE DRIVE FW  >> SELECT UPDATE CARTRIDGE>> 1
   The tape will loaded into the drive, update the firmware, and then  be 
   returned to the magazine.
   This will takes several minutes.
 E4.2 You can verify the new firmware by checking the menu for the firmware  
     information.  
       ADMIN  >>  password >> INFO  >> DRV FW
Sec F5- How to download f/w to the DLT drive via the scsi bus
========================================================
  (Note:This is not recommended, use the Fup tape methode in section 4.0)
  T-load - Firmware Download utility for tape drives.
SYNOPSIS
   T-load [ firmware_file ]
DESCRIPTION
   T-load is an firmware downloader for tape drives.
   If the firmware_file is specified, then it would display  the list of tape 
   devices present on the system and asks the  user to select the tape drive to 
   which firmware has to be  upgraded. Only One Tape drive can be upgraded at a
   time.
   If firmware_file is not specified, then it would display  all the list of 
   tape drives present on the system along with  their FIRMWARE revision levels.
   The command can be run only as a super-user.
Caution: When doing f/w download, allow at least 5 minutes after completion of 
download for the f/w to be properly loaded and be stable in the drive. Then 
power cycle by physically removing and re-inserting the AC cord at the back of 
the L280.
EXAMPLES 1 shows how to determine available drives and their revs
# T-load        . 
AVAILABLE SCSI  TAPE DEVICES:
                          Vendor          Product                 Rev      
Serial Number
0:/dev/rmt/3ln  QUANTUM     DLT7000             1E48    qH''+ 
1:/dev/rmt/3ln  EXABYTE     EXB-89008E030203    V37f        
Example 2 shows how to download the firmware rev V80.
This assumes that the f/w file d7oml3.v80 is in the same directory as the T-load 
utility.
# T-load  d7oml3.v80     
AVAILABLE SCSI  TAPE DEVICES:
                Vendor      Product            Rev      Serial Number
0:/dev/rmt/3ln  QUANTUM     DLT7000             1E48    qH''+ 
1:/dev/rmt/3ln  EXABYTE     EXB-89008E030203    V37f                 
Select Tape Device[ 0 - 1 (-1 to quit)]: select 0 for Quantum drive
Do You Want to Download Firmware to this tape device (Y/N) :
    Y, to perform the download.
NOTES
   Each Tape Drive has different modes for download tape drives.
   In the current tool, there is support for
	EXABYTE,TANDBERG,HP,ARCHIVE and Quantum DLT tape drives.
  For other tape drives, a default single WRITE BUFFER Command
  with mode (5) can use used to download the firmware.
  It is the responsibility of the administrator to download the correct firmware 
  to the correct tape drive.
  If tape is present on the system, then it would be ejected  before firmware 
  download takes place.
  Download of firmware can happen in multiple WRITE BUFFER Commands and it is 
  advised that the downloading not be interrupted during this time else the tape
  drive can become totaly unusable.
END

Patch Installation Instructions:
0

Special Install Instructions:
0

README -- Last modified date:  Monday, November 7, 2005

