README: 40GB DLT Tape Drive and Library Microcode ------------------------------------------------------------------------ Table of Contents *README: 40GB DLT Tape Drive and Library Microcode <#Header_1>* # Drive Microcode Level: 0255(V85) <#Header_2> # Library Controller Microcode Level: 2.67.0001 <#Header_3> # Date: May 12, 2003 <#Header_4> # General Information <#Header_5> # Microcode Install Information: <#Header_7> # Operating System levels supported: <#Header_8> # Installation Time: <#Header_9> # Can microcode be installed concurrently? <#Header_10> # Is system reboot needed to activate the microcode. <#Header_11> # Additional Cautions: <#Header_12> # Machines Affected: <#Header_13> # Microcode History <#Header_14> # Display Microcode Level <#Header_18> # 7205-440 Vital Product Data <#Header_19> # 7337-360 Vital Product Data <#Header_20> # 7337-360 Library Controller Microcode Level <#Header_21> # 7337-360 Library Tape Drive Microcode Level <#Header_22> # Microcode Download <#Header_23> # Putting the microcode on the system <#Header_24> # From the IBM WEB site via the user downloading the files. <#Header_25> # From a CD-ROM. <#Header_26> # Packaged Microcode Files <#Header_27> # AIX bin file: <#Header_28> # RPM files: <#Header_29> # Verifying the Microcode <#Header_30> # Copying Files <#Header_31> # For Genucode and the 7205-440 <#Header_32> # For AIX Diagnostics and the 7205-440 <#Header_33> # For Genucode and the 7337-360 <#Header_34> # For AIX Diagnostics and the 7337-360 <#Header_35> # Checking the files <#Header_36> # Library Controller Microcode Install using Atape <#Header_40> # IBM 7205-440 and IBM 7337-360 Drive Microcode Install <#Header_41> # Drive Microcode Install using Genucode <#Header_42> # Drive Microcode Install using AIX Diagnostics <#Header_43> # For Systems where TSM/ADSM is using the 40GB DLT Drives or Library <#Header_47> # Restart TSM or ADSM <#Header_48> ------------------------------------------------------------------------ README: 40GB DLT Tape Drive and Library Microcode <#ToC_1> Drive Microcode Level: 0255(V85) <#ToC_2> Library Controller Microcode Level: 2.67.0001 <#ToC_3> Date: May 12, 2003 <#ToC_4> ------------------------------------------------------------------------ General Information <#ToC_5> ****** PLEASE READ THIS ENTIRE NOTICE ********* This package is being provided to allow the update of older IBM 40GB DLT Tape Drives to the current level of microcode that is currently shipping from IBM. This microcode update is for the: * * * *IBM 7205-440 40GB DLT Tape Drive * * *IBM 7337-360 DLT Tape Library * * *IBM 7337-360 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 Install Information: <#ToC_7> To download the microcode to the IBM 7205-440 or the IBM 7337-360 you will need the following: * For the IBM 7205-440 or the IBM 7337-360 drive microcode download you will need to do one of the following: o If the tape drive is attached to an AIX system with AIX diagnostics Level 5.1, or higher, you can use the AIX diagnostic utility "Download Microcode" from the diagnostics "Task Selection" menu. along with the microcode and DSDATA file in this package. * Or * o Use the Genucode package from the IBM web site along with the microcode and DSDATA file in this package. Genucode is available from the IBM web site: * http://techsupport.services.ibm.com/server/mdownload/download.html Both the AIX diagnostics and Genucode use the microcode and DSDATA file in this package. * * For the IBM 7337-360 Library Controller microcode download you need to use Atape(tapeutil) and the microcode file in this package. This package, the 40GB DLT package, will get you to step where you will need to use GENUCODE or AIX Diagnostics, 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-360. It is also available from: * ftp://ftp.software.ibm.com/storage/devdrvr/AIX * ------------------------------------------------------------------------ Operating System levels supported: <#ToC_8> All supported levels of AIX that these products were announced on. ------------------------------------------------------------------------ Installation Time: <#ToC_9> 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. ------------------------------------------------------------------------ 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-360 no other processes running to the Library. If Tivoli Storage Management(TSM) or ADSM is installed it is best to stop TSM or ADSM before doing the microcode install. ------------------------------------------------------------------------ Is system reboot needed to activate the microcode. <#ToC_11> A reboot is not needed as the microcode is active in the drive when the drive completes microcode download. If Genucode was used to download the microcode to the tape drive it will be necessary to use the AIX commands rmdev and mkdev to have the Vital Product Data show the new level of microcode. The use of rmdev and mkdev are described in Genucode part of the install process. If TSM or ADSM is installed there are additional steps that are defined at the end of this README. ------------------------------------------------------------------------ Additional Cautions: <#ToC_12> 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_13> 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_14> The microcode update will bring the IBM 40GB DLT tape drive up to the current level which is: * 0255 * also know as * V85 * 7205-440 40GB DLT Tape Drive *Table 1. Microcode History* Tape Drive P/N Tape Drive FRU P/N Load ID Microcode Level What does this microcode change 10P2026 10P2042 A17002A3 0235(V53) First Microcode level shipped. 10P2026 10P2042 A17002A3 0250(V80) Fixes possible microcode download problem when a data cartridge is in the drive. Improved error reporting after the tape drive is cleaned. Improved error detection. Improved blank tape handling. 10P2026 10P2042 A17002A3 0255(V85) Improves error data maintained in the drives log pages. Improved write error recovery. Improves drive power handling when the drive is idle with a cartridge loaded in the drive in the rewound condition. Maintain un-buffered mode if drive set to un-buffered mode. Improved space forward processing after a write failure. 7337-360 DLT Library *Table 2. Microcode History* Tape Drive P/N Tape Drive FRU P/N Load ID Microcode Level What does this microcode change 10P1627 10P1629 A17002A4 0235(V53) First Microcode level shipped. 10P1627 10P1629 A17002A4 0250(V80) Fixes possible microcode download problem when a data cartridge is in the drive. Improved error reporting after the tape drive is cleaned. Improved error detection. Improved blank tape handling. 10P1627 10P1629 A17002A4 0255(V85) Improves error data maintained in the drives log pages. Improved write error recovery. Improves drive power handling when the drive is idle with a cartridge loaded in the drive in the rewound condition. Maintain un-buffered mode if drive set to un-buffered mode. Improved space forward processing after a write failure. Improved library port command handling for the ring buffer. 7337-360 Library Controller The microcode update will bring the IBM 7337-360 Library Controller up to the current level which is: * 2.67.0001 * *Table 3. Microcode History* Microcode Level What does this microcode change 2.12.0002 First Microcode level shipped. 2.67.0001 Fixes some causes of DLT cartridge not loading into the drive. ------------------------------------------------------------------------ Display Microcode Level <#ToC_18> *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 in these instructions. To display the level of microcode in the 7205-440 or the 7337-360 drive do the following AIX command: * lscfg -vl rmt0 <--- change the drive number to reflect the actual rmt address of the 40GB DLT tape drive. * The output of the lscfg command will look similar to the following where the * Device Specific.(Z1)........ * indicates the current microcode level in the tape drive. 7205-440 Vital Product Data <#ToC_19> * * * DEVICE LOCATION DESCRIPTION rmt1 1P-19-00-5,0 Differential SCSI DLT Tape Drive (40000 MB) Manufacturer................QUANTUM Machine Type and Model......DLT8000 Device Specific.(Z1)........0250 Serial Number...............B02P4343 Device Specific.(LI)........A17002A3 Part Number.................19P2026 FRU Number..................19P2042 EC Level....................H27532 Device Specific.(Z0)........0180020283000138 Device Specific.(Z3)........ * * Or * *7337-360 Vital Product Data <#ToC_20>* *DEVICE LOCATION DESCRIPTION rmt1 10-78-00-0,0 Differential SCSI DLT Tape Drive (40000 MB) Manufacturer................QUANTUM Machine Type and Model......DLT8000 Device Specific.(Z1)........0250 Serial Number...............A40P2688 Device Specific.(LI)........A17002A4 Part Number.................19P1627 FRU Number..................19P1629 EC Level....................H27531 Device Specific.(Z0)........0180020283000138 Device Specific.(Z3)........ * 7337-360 Library Controller Microcode Level <#ToC_21> To display the level of Library Controller microcode in the 7337-360 * Press: more Then Press: About * The resulting display will look similar to the following: * IBM 7337 - 360 (C) 2000 IBM Ser Num: 73370123456 Version: 2.67.000` * The * Version * is the microcode level of the library. Be sure to put the library back to normal mode after displaying the microcode levels. 7337-360 Library Tape Drive Microcode Level <#ToC_22> To display the level of tape drive microcode in the 7337-360 * Press: Status Then Press: Drives * The resulting display will look similar to the following: * Drive: 01 Type: DLT Ser Num: 0123456 Version: 0235 * The * Version * is the microcode level of the tape drive. Be sure to put the library back to normal mode after displaying the microcode levels. ------------------------------------------------------------------------ Microcode Download <#ToC_23> *Note: * *Sometimes at the completion of the download of the microcode to the tape drive the user may be told the microcode failed to download even when it successfully completed download. We are working to correct this problem but for now if you get a message that the microcode failed to download do the following: * * *Wait until all the LEDs have stop flashing on the tape drive. * * *Power off the tape drive or library and wait 60 seconds before powering it back on. * * Power the drive or library back on and check the drives microcode level by doing the following AIX commands: rmdev -l rmt0 mkdev -l rmt0 lscfg -vl rmt0 This will show the drives microcode level. If the current level is not shown in the drive retry the microcode download. * ------------------------------------------------------------------------ Putting the microcode on the system <#ToC_24> 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_25> 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 * 40GBDLT.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". * * If the user downloads the * TapeDLT40GB-0255-01.rpm * file the user will put the downloaded file into the * /tmp * directory and then use the instructions in the section of this README titled * "RPM file". * From a CD-ROM. <#ToC_26> * If the CD-ROM process is used to put the * 40GBDLT.bin * file on the user system the microcode files will expanded into the * /tmp/40GBDLT_web * directory. The next step is to follow the instructions in this README titled * "AIX bin file" * and copy the files to the appropriate directory. The building and putting of the files into the * /tmp/40GBDLT_web * directory was done by the user when they used the CD-ROM build instructions. * If the CD-ROM process is used to put the * TapeDLT40GB-0255-01.rpm * file on the user system the microcode files will be in the * tmp/microcode/RPM * directory. To put the microcode in the appropriate directory for the system the user executes the following AIX commands: * cd /tmp/microcode/RPM rpm -ihv --ignoreos TapeDLT40GB-0255-01.rpm * This puts the following files in the /etc/microcode and /tmp directory for system use: * * o */etc/microcode/DLT8000.A17002A3.0255 * o */etc/microcode/DLT8000.A17002A3.dsdata * o */etc/microcode/DLT8000.A17002A4.0255 * o */etc/microcode/DLT8000.A17002A4.dsdata * o */tmp/DLT8000.Controller.2.67.0001 * The next step is to follow the instructions in this README titled * "Verifying the Microcode". * *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_27> AIX bin file: <#ToC_28> * Download the bin file to the eServer pSeries or RS/6000 to the * /tmp * directory. * Do the following AIX commands to make the file executable: * cd /tmp chmod +x 40GBDLT.bin * * To expand the bin file use the following command: * 40GBDLT.bin * * The following files will be in the * /tmp/40GBDLT_web * directory when the download and expansion of the bin files is complete: * * o *DLT8000.0255.A17002A3 * o *DLT8000.0255.A17002A3.dsdata * o *DLT8000.0255.A17002A4 * o *DLT8000.0255.A17002A4.dsdata * o *DLT8000.Controller.2.67.0001 * o *DLT8000.A17002A3.0255 * o *DLT8000.A17002A3.dsdata * o *DLT8000.A17002A4.0255 * o *DLT8000.A17002A4.dsdata * RPM files: <#ToC_29> * Download the * TapeDLT40GB-0255-01.rpm * file to the eServer pSeries or RS/6000 to the * /tmp * directory. * To expand the * TapeDLT40GB-0255-01.rpm * file use the following commands: * cd /tmp rpm -ihv --ignoreos TapeDLT40GB-0255-01.rpm * * You will have the following files in the * /etc/microcode and /tmp * directory: * * o */etc/microcode/DLT8000.A17002A3.0255 * o */etc/microcode/DLT8000.A17002A3.dsdata * o */etc/microcode/DLT8000.A17002A4.0255 * o */etc/microcode/DLT8000.A17002A4.dsdata * o */tmp/DLT8000.Controller.2.67.0001 * ------------------------------------------------------------------------ Verifying the Microcode <#ToC_30> To insure the file was downloaded without error do the following AIX commands: * cd /tmp/40GBDLT_web or cd /etc/microcode or cd /tmp * Use the AIX command sum to get the checksum of the microcode files: * sum DLT* * Compare the sum you get with the sum of the file here, if they do not match recheck your steps in creating the file on the System: * 62995 1160 DLT8000.0255.A17002A3 59480 1 DLT8000.0255.A17002A3.dsdata 08587 1160 DLT8000.0255.A17002A4 26713 1 DLT8000.0255.A17002A4.dsdata 62995 1160 DLT8000.A17002A3.0255 59480 1 DLT8000.A17002A3.dsdata 08587 1160 DLT8000.A17002A4.0255 26713 1 DLT8000.A17002A4.dsdata 24403 1409 DLT8000.Controller.2.67.0001 * ------------------------------------------------------------------------ Copying Files <#ToC_31> If you downloaded and executed the * RPM * file the microcode files are in the correct directory with the correct name for AIX diagnostics to use. If you downloaded and executed the * bin * file the microcode files need to be copied to specific AIX directories. The files you copy and to what directory you copy them to will depend on what tool you are going to use to download microcode to the drive or controller with: * Genucode requires the microcode file and dsdata file to be in the * /tmp * directory. * AIX diagnostics requires the microcode file and dsdata file to be in the */etc/microcode * directory. * ATAPE will use the microcode file in whatever directory you specify, such as the *./40GBDLT_web * directory. * * *The naming conventions used for the microcode and dsdata file are not the same for Genucode and the AIX diagnostics. It is necessary to copy the specific file to the specific directory depending on which program you choose to use for microcode download. * Change to the * /tmp/40GBDLT_web * directory by doing the following AIX command: * cd /tmp/40GBDLT_web * Use the AIX command * cp * to copy the files to the required directory. * * *The /. (slash dot) in the following commands uses the input name for the output name of the file. * For Genucode and the 7205-440 <#ToC_32> * cp DLT8000.0255.A17002A3 /tmp/. cp DLT8000.0255.A17002A3.dsdata /tmp/dsdata * For AIX Diagnostics and the 7205-440 <#ToC_33> * cp DLT8000.A17002A3.0255 /etc/microcode/. cp DLT8000.A17002A3.dsdata /etc/microcode/. * For Genucode and the 7337-360 <#ToC_34> * cp DLT8000.0255.A17002A4 /tmp/. cp DLT8000.0255.A17002A4.dsdata /tmp/dsdata * For AIX Diagnostics and the 7337-360 <#ToC_35> * cp DLT8000.A17002A4.0255 /etc/microcode/. cp DLT8000.A17002A4.dsdata /etc/microcode/. * Checking the files <#ToC_36> Once you have done the copying of the files you will have the following depending if you selected a IBM 7205-440 or IBM 7337-360 or 7337-360 Controller. For the 7205-440: * * *For use with Genucode: * * */tmp/DLT8000.0255.A17002A3 * * */tmp/dsdata * *For use with AIX 5.1 Diagnostics and higher levels of AIX diagnostics: * * */etc/microcode/DLT8000.A17002A3.0255 * * */etc/microcode/DLT8000.A17002A3.dsdata * For the 7337-360: * For use with Genucode: * * */tmp/DLT8000.0255.A17002A4 * * */tmp/dsdata * *For use with AIX 5.1 Diagnostics and higher levels of AIX diagnostics: * * */etc/microcode/DLT8000.A17002A4.dsdata * * */etc/microcode/DLT8000.A17002A4.0255 * For the 7337-360 Controller: * * *For use with ATAPE download of controller microcode: * * *./40GBDLT_web/DLT8000.Controller.xxx * ------------------------------------------------------------------------ Library Controller Microcode Install using Atape <#ToC_40> If you are updating the microcode in the IBM 7337-360 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-360 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/DLT8000.Controller.xxx * Follow the tapeutil prompts to complete the Library Controller microcode install. ------------------------------------------------------------------------ IBM 7205-440 and IBM 7337-360 Drive Microcode Install <#ToC_41> *Note: *If TSM or ADSM are installed refer to the section "For Systems where TSM/ADSM is using the 40GB DLT Drives or Library" before doing the microcode download. Drive Microcode Install using Genucode <#ToC_42> You now need to use the instructions in the GENUCODE package to complete the microcode install. Drive Microcode Install using AIX Diagnostics <#ToC_43> The restore you did previously restored the linked files to the /etc/microcode directory where the AIX diagnostics requires the files to be. The diag command requires that you have root authority. 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. ------------------------------------------------------------------------ For Systems where TSM/ADSM is using the 40GB DLT Drives or Library <#ToC_47> TSM and ADSM require 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 TSM or ADSM 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 TSM or ADSM * 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 TSM or ADSM <#ToC_48> After doing the microcode update and any mkdev's or cfgmgr you should restart TSM or ADSM. 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.