README: 35GB DLT Tape Drive and Library Microcode ------------------------------------------------------------------------ Table of Contents *README: 35GB DLT Tape Drive and Library Microcode <#Header_1>* # 7205-311 Drive Microcode Level: 296B(V107) <#Header_2> # 7337-305/306 Library Drive Microcode Level: 296B(V107) <#Header_3> # Library Controller Microcode Level: 1.63 <#Header_4> # Date: August 2, 2003 <#Header_5> # General Information <#Header_6> # Microcode Download <#Header_8> # Operating System levels supported: <#Header_9> # Can microcode be installed concurrently? <#Header_10> # Installation Time: <#Header_11> # Is system reboot needed to activate the microcode. <#Header_12> # Additional Cautions: <#Header_13> # Machines Affected: <#Header_14> # Microcode History <#Header_15> # 7205-311 External Differential Drive <#Header_16> # 7337-305 and 306 External Differential Library <#Header_17> # 7337-305 and 306 Library Controller <#Header_18> # Display Microcode Level <#Header_19> # Putting the microcode on the system <#Header_20> # From the IBM WEB site via the user downloading the files. <#Header_21> # From a CD-ROM. <#Header_22> # Packaged Microcode Files <#Header_23> # AIX bin file <#Header_24> # Check Microcode Checksum <#Header_25> # Copy the files to the appropriate directory <#Header_26> # Microcode Install <#Header_27> # Using AIX Diagnostics for the IBM 7205-311, IBM 7337-305 and 306 Drives <#Header_28> # Using Genucode for the IBM 7205-311, IBM 7337-305 and 306 Drives <#Header_32> # Using Atape for the Library Controller Microcode <#Header_33> # For Systems where ADSM is using the 35GB DLT Drives or Library <#Header_34> # Restart ADSM or Tivoli Storage Management <#Header_35> ------------------------------------------------------------------------ README: 35GB DLT Tape Drive and Library Microcode <#ToC_1> 7205-311 Drive Microcode Level: 296B(V107) <#ToC_2> 7337-305/306 Library Drive Microcode Level: 296B(V107) <#ToC_3> Library Controller Microcode Level: 1.63 <#ToC_4> Date: August 2, 2003 <#ToC_5> ------------------------------------------------------------------------ General Information <#ToC_6> ****** PLEASE READ THIS ENTIRE NOTICE ********* This package is being provided to allow the update of older IBM 35GB DLT Tape Drives to the current level of microcode that is currently shipping from IBM. This microcode update is for the: * * * *IBM 7205-311 * * *IBM 7337-305 * * *IBM 7337-306 * Additionally this package provides the microcode for the IBM 7337-305 and IBM 7337-306 library controller. * * *Customers are encouraged to install the latest microcode level themselves. The microcode and instructions are available at the IBM external web site: http://techsupport.services.ibm.com/server/mdownload/download.html * ------------------------------------------------------------------------ Microcode Download <#ToC_8> To download the microcode to the IBM 7205-311 or the IBM 7337-305 you will need the following: * For the IBM 7205-311 and the IBM 7337-305 and IBM 7337-306 drive microcode download you will need to use AIX 5.1(or higher) Diagnostics microcode download utility or get the GENUCODE package from the pSeries external web site: * http://techsupport.services.ibm.com/server/mdownload * Both AIX Diagnostics and Genucode use the microcode and DSDATA file in this package. * For the IBM 7337-305 and 306 Library Controller microcode download you need to use Atape(tapeutil) and the microcode file in this package. This package, the 35GB DLT package, will get you to step where you will use AIX Diagnostics, or Genucode, or Atape(tapeutil) to download the microcode into the tape drive or the Library Controller. *Note: * The Atape program is shipped with the IBM 7337-305 and 306 It is also available from: * ftp://ftp.software.ibm.com/storage/devdrvr/AIX * ------------------------------------------------------------------------ Operating System levels supported: <#ToC_9> All supported levels of AIX that these products were announced on. ------------------------------------------------------------------------ Can microcode be installed concurrently? <#ToC_10> Yes, but the tape drive must be available with no tape in the drive, and no other processing running to the tape drive, or in the case of the IBM 7337-305 or 306 no other processes running to the Library. If ADSM or Tivoli Storage Management is installed it is best to stop ADSM before doing the microcode install. ------------------------------------------------------------------------ Installation Time: <#ToC_11> The typical time to install this microcode is .5 hrs. The microcode becomes active when installed and does not require a system reboot to become active. ------------------------------------------------------------------------ Is system reboot needed to activate the microcode. <#ToC_12> A reboot is not needed as the microcode is active in the drive when the drive completes microcode download. If the microcode install was done using genucode, you must use the AIX rmdev and mkdev commands to have the Vital Product Data show the new microcode level. This is described in Genucode part of the install process. If ADSM is installed there are additional steps that are defined at the end of this README. ------------------------------------------------------------------------ Additional Cautions: <#ToC_13> Do not power off the tape drive during microcode download as this may damage the tape drive microcode requiring the tape drive to be replaced. Remove any tape cartridge from the drive prior to attempting the microcode download. ------------------------------------------------------------------------ Machines Affected: <#ToC_14> All IBM eServer pSeries and RS/6000 machines this product was announce on. In general if the tape drive configures and is available with the VPD showing the Machine Type and microcode level as described in this README the machine is one affected. ------------------------------------------------------------------------ Microcode History <#ToC_15> 7205-311 External Differential Drive <#ToC_16> The microcode update will bring the IBM 7205-311 35GB DLT tape drive up to the current level which is: * 296B also know as V107 * *Table 1. Microcode History* Tape Drive P/N Tape Drive FRU P/N Microcode Level What does this microcode change 59H3120 59H3121 1734(V52) First Microcode level shipped. 59H3120 59H3121 2150(V80) Improved read/write error recovery. 59H3120 59H3121 2560(V96) Improved read error recovery. Improved media handling during tape load. Improved cleaning indication. Fix cleaning indication when a DLT8000 tape is inserted in the drive. 59H3120 59H3121 276A(V106) Improved processing of "Blank" data cartridges. 59H3120 59H3121 296B(V107) Previous microcode level sometimes increased the time it takes a tape to become ready. This level reduces unnecessary tape movement during tape load. Improves the time it takes for the tape to become ready. Eliminates the cause for a drive failure to complete an operation due to errors in the drive calibrating to the media. Fix when the tape drive encounters a hard error(I/O Error TAPE_ERR1 in AIX error log), and subsequent command may fail with a SCSI check condition(I/O Error). Improved processing of "Blank" data cartridges. 7337-305 and 306 External Differential Library <#ToC_17> The microcode update will bring the 35GB DLT tape drive library up to the current level which is: * 296B also know as V107 * *Table 2. Microcode History* Tape Drive P/N Tape Drive FRU P/N Microcode Level What does this microcode change 59H3557 59H3570 1734(V52) First Microcode level shipped. 59H3557 59H3570 1B41(V65) Improved tape handling. 59H3557 59H3570 2150(V80) Improved read/write error recovery. 59H3557 59H3570 2560(V96) Improved read error recovery. Improved media handling during tape load. Improved cleaning indication. Fix cleaning indication when a DLT8000 tape is inserted in the drive. 59H3557 59H3570 276A(V106) Improved processing of "Blank" data cartridges. 59H3557 59H3570 296B(V107) Previous microcode level sometimes increased the time it takes a tape to become ready. This level reduces unnecessary tape movement during tape load. Improves the time it takes for the tape to become ready. Eliminates the cause for a drive failure to complete an operation due to errors in the drive calibrating to the media. Fix when the tape drive encounters a hard error(I/O Error TAPE_ERR1 in AIX error log), and subsequent command may fail with a SCSI check condition(I/O Error). Improved processing of "Blank" data cartridges. 7337-305 and 306 Library Controller <#ToC_18> The microcode update will bring the IBM 7337-305 Library Controller up to the current level which is: * 1.63 * *Table 3. Microcode History* Microcode Level What does this microcode change 1.61 First Microcode level shipped. 1.63 Improved timing for tape handling. ------------------------------------------------------------------------ Display Microcode Level <#ToC_19> *Note: *In some cases you may already have this microcode update already installed. Instructions in the package will show you how to check your system to see if it requires the updated microcode to be installed. This can be checked by doing the AIX command listed these instructions. To display the level of microcode in the 7205-311 or the 7337-305 and 306 drive do the following AIX command: * lscfg -vl rmt0 <--- change the drive number to reflect the actual rmt address of the 35GB DLT tape drive. * To display the level of microcode in the 7337-305 or 306 press the function keys on the operator panel to put the library in off-line or diagnostic mode. The operator panel will display the following: * IBM XXX7 X.XX <--- The X.XX is the Library Controller level. DIAGNOSTIC OFFLINE A. DLT7000 VNN-T1<--- The VNN is drive microcode level. B. DLT7000 VNN-T2 * Be sure to put the library back to normal mode after displaying the microcode levels. ------------------------------------------------------------------------ Putting the microcode on the system <#ToC_20> There are 2 ways a user can get the microcode files. Each of these will put the microcode on the user's system but the user may have to move the files to appropriate directory for system use. From the IBM WEB site via the user downloading the files. <#ToC_21> When the user downloads the microcode files from the IBM web site the packaged microcode files will be put into the * /tmp * directory. * If the user downloads the * 35GBDLT.bin * file the user will put the downloaded file into the * /tmp * directory and then use the instructions in the section of this README titled * "AIX bin file". * From a CD-ROM. <#ToC_22> * If the CD-ROM process is used to put the * 35GBDLT.bin * file on the user system the microcode files will expanded into the * /tmp/35GBDLT_web * directory. The next step is to follow the instructions in this README titled * "Check Microcode Checksum". * The building and putting of the files into the * /tmp/35GBDLT_web * directory was done by the user when they used the CD-ROM build instructions. *Note: * * AIX commands and file names are case sensitive. If the users AIX permission does not allow the copy to the above stated directory or file then the user will be prompted for a new location. * ------------------------------------------------------------------------ Packaged Microcode Files <#ToC_23> AIX bin file <#ToC_24> * Download the * 35GBDLT.bin * file to the system to the * /tmp * directory. * Do the following AIX commands to make the file executable: * cd /tmp chmod +x 35GBDLT.bin * * To expand the * 35GBDLT.bin * file use the following command: * 35GBDLT.bin * * This will put the following files in the * /tmp/35GBDLT_web * directory: * * o *IBM-7205.296B.A0B00E24 * o *IBM-7205.A0B00E24.dsdata * o *DLT7000.296B.A0B00E24 * o *DLT7000.A0B00E24.dsdata * o *DLT7000.Controller.163 * * Change to the directory just built: * cd ./35GBDLT_web * ------------------------------------------------------------------------ Check Microcode Checksum <#ToC_25> To insure the microcode downloaded correctly to the system do the following AIX commands: * cd /tmp/35GBDLT_web sum IBM-7* Or sum DLT7* * The output of the command will be the checksum and it must match the following, if it does not match then redo the download and file extraction. * 58507 648 IBM-7205.296B.A0B00E24 And 64220 1 IBM-7205.A0B00E24.dsdata Or 40017 648 DLT7000.296B.A0B00E24 And 51713 1 DLT7000.A0B00E24.dsdata And 31546 348 DLT7000.Controller.163 * ------------------------------------------------------------------------ Copy the files to the appropriate directory <#ToC_26> You will now need to copy from the new directory to the appropriate directory with the appropriate names. * For AIX Diagnostics the microcode files need to be put into the /etc/microcode directory. For Genucode or Atape the microcode files need to be put into the /tmp directory. * * For the IBM 7205-311 * AIX Diagnostics: cp IBM-7205.A0B00E24.dsdata /etc/microcode/IBM-7205.A0B00E24.dsdata cp IBM-7205.296B.A0B00E24 /etc/microcode/IBM-7205.A0B00E24.296B Genucode: cp IBM-7205.A0B00E24.dsdata /tmp/dsdata cp IBM-7205.296B.A0B00E24 /tmp/IBM-7205.296B.A0B00E24 * * For the IBM 7337-305 and the 7337-306 * AIX Diagnostics and ATAPE: cp DLT7000.A0B00E24.dsdata /etc/microcode/DLT7000.A0B00E24.dsdata cp DLT7000.296B.A0B00E24 /etc/microcode/DLT7000.A0B00E24.296B cp DLT7000.Controller.163 /tmp/DLT7000.Controller.163 Genucode and ATAPE: cp DLT7000.A0B00E24.dsdata /tmp/dsdata cp DLT7000.296B.A0B00E24 /tmp/DLT7000.296B.A0B00E24 cp DLT7000.Controller.163 /tmp/DLT7000.Controller.163 * *Note: * * * *If the tape drive or controller you are updating is used by ADSM or Tivoli Storage Manager you will need to read the section of these instructions "For Systems where ADSM is using the 35GB DLT Drives or Library" for special instructions for these applications. Read these instructions before using downloading the microcode to the drive(s) or controller. * ------------------------------------------------------------------------ Microcode Install <#ToC_27> Using AIX Diagnostics for the IBM 7205-311, IBM 7337-305 and 306 Drives <#ToC_28> AIX Diagnostics requires the microcode and dsdata file to be in the /etc/microcode directory with specific names different from Genucode. AIX Diagnostics offers 2 ways to install the tape drive microcode: * Via the AIX Diagnostics standard interface * Via command line input. Using AIX Diagnostics standard interface To install the tape drive microcode using the AIX diagnostics 5.1 or higher do the following: * diag Press: Enter Then select: Task Selection Then select: Download Microcode Select the drive you wish to download microcode to and follow the system instructions. * *Note: *When the system asks where the microcode file is to be found select /etc/microcode, not diskette. Using AIX Diagnostics command line input To install the tape drive microcode using the AIX diagnostics 5.1 or higher do the following: *Note: *If the previous level of microcode is not in the /etc/microcode directory you will need to use the -f option(force) as the diagnostics expect the previous level to be present in the /etc/microcode directory. * diag -c -d rmt0 -T "download" (enter) * *or* *diag -c -d rmt0 -T "download -f" (enter) * Where the * rmt * is the tape drive you wish to download the microcode to. Using Genucode for the IBM 7205-311, IBM 7337-305 and 306 Drives <#ToC_32> You now need to use the instructions in the Genucode package to complete the microcode install. Using Atape for the Library Controller Microcode <#ToC_33> If you are updating the microcode in the IBM 7337-305 and 306 Library controller you will need to determine if the Atape device driver is installed. If the Atape device driver is not installed you must install the Atape driver prior to attempting the update of the microcode in the Library Controller in the IBM 7337-305 and 306 using Atape. To determine if the Atape device driver is installed do the following AIX command: * lslpp -l Atape.driver * This will show the level of the Atape driver if it is installed. If Atape is installed you now need to issue the tapeutil command to download the microcode to the controller: * tapeutil * * Select * Tape Drive Service Aids * * Select * Microcode load * * Select the Library Controller you are going to download microcode to, such as *smc0 * * Enter the file name of the microcode file you are going to use for the download: * * * */tmp/DLT7000.Controller.163 * Follow the tapeutil prompts to complete the Library Controller microcode install. ------------------------------------------------------------------------ For Systems where ADSM is using the 35GB DLT Drives or Library <#ToC_34> ADSM requires that after microcode download to the tape drive or Library Controller that the tape drive and Library Controller be logically removed from the system and then added back into the system. The reason that they have to be removed and added back is that the finger print(Vital Product Data) of the tape drive or medium changer was changed by upgrading the microcode. If ADSM or Tivoli Storage Manager is installed do not start them until the following steps are performed: * Save the current configuration to aid in reconfigure the drives back to their original location. o * **lsdev -Cc tape >/tmp/current.config * o *lsdev -Cc library >>/tmp/current.config * o *lsdev -C | grep scsi >>/tmp/current.config * * Delete the drives both native AIX and ADSM if installed. o * **rmdev -dl rmtX * o *rmdev -dl mtXr * o *rmdev -dl smcX * o *rmdev -dl lbX * Where X is the number of the drive. * Run config manager to bring back the native AIX devices if the location in not critical or use mkdev if the location is critical. * cfgmgr * * If the drive needs to be reconfigured at the original location do the following: *For AIX drivers: * o To get the list of drives and adapters: * cat /tmp/current.config * * smc0 Available 04-01-00-6,0 IBM 7337 Tape Medium Changer rmt0 Available 04-01-00-4,0 Differential SCSI DLT Tape Drive mt0 Available 04-01-00-4,0 Tivoli Storage Manager rmt1 Available 04-01-00-5,0 Differential SCSI DLT Tape Drive mt1 Available 04-01-00-5,0 Tivoli Storage Manager Tape Drive lb0 Available 04-01-00-6,0 Tivoli Storage Manager Library scsi0 Available 04-A0 Wide SCSI I/O Controller scsi1 Available 04-B0 Wide SCSI I/O Controller scsi2 Available 04-01 Wide SCSI I/O Controller * o To recreate the rmtX device issue this command for each drive: * mkdev -c tape -t '7337' -s 'scsi' -l 'rmtX' -p 'scsi2' -w '4,0' * *For ADSM/Tivoli Storage Manager * o To recreate the ADSM mtX device issue this command for each drive: * mkdev -c adsmtape -t 'ADSM-SCSI-MT' -s 'scsi' -l 'mtX' -p 'scsi2' -w'4,0' * Where X is the number of the drive. o To recreate smc0 just issue: * cfgmgr * o To recreate the ADSM Library/Medium Changer issue this command: * mkdev -c library -t 'ADSM-SCSI-LB' -l lbX -s 'scsi' -p 'scsi2' -w'6,0' * Restart ADSM or Tivoli Storage Management <#ToC_35> After doing the microcode update and any mkdev's or cfgmgr you should restart ADSM or Tivoli Storage Management. Then for ADSM from a ADSM command prompt: * update library device= /dev/lvX update drive device= /dev/mtX * Where X is the number of the drive. Do these commands for each library and each drive.