README: IBM 7334-410 8mm Tape Library Microcode ------------------------------------------------------------------------ Table of Contents *README: IBM 7334-410 8mm Tape Library Microcode <#Header_1>* # Date: January 26, 2004 <#Header_2> # Drive Microcode Version: 07wR <#Header_3> # Robotics Microcode Version: 2.2 <#Header_4> # General information <#Header_5> # Operating System levels supported: <#Header_7> # Installation Time: <#Header_8> # Can microcode be installed Concurrently? <#Header_9> # Is system reboot needed to activate the microcode <#Header_10> # Drive Microcode Download information: <#Header_11> # Library Microcode Download information: <#Header_12> # Atape <#Header_13> # Additional Cautions <#Header_14> # Machines Affected: <#Header_15> # Microcode History <#Header_16> # Drive Microcode History <#Header_17> # Robotics Microcode History <#Header_18> # Display Tape Drive Microcode Level <#Header_19> # Change in Machine Type Model Information <#Header_21> # Multiple Microcode Downloads Required <#Header_22> # Display Robotics Microcode Level <#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> # Check Microcode Checksum <#Header_29> # Installing Drive Microcode <#Header_30> # Installing Microcode with AIX Diagnostics <#Header_31> # Installing Both Microcode Files with AIX Diagnostics <#Header_32> # Installing the Mammoth2 Microcode File only with AIX Diagnostics <#Header_33> # Installing Both Microcode Files with Genucode <#Header_34> # Installing the Mammoth2 Microcode File only with Genucode <#Header_35> # Installing Robotics Microcode <#Header_36> # Install with Atape <#Header_37> # How to Use AIX 5.1 Diagnostics Microcode Download <#Header_38> ------------------------------------------------------------------------ README: IBM 7334-410 8mm Tape Library Microcode <#ToC_1> Date: January 26, 2004 <#ToC_2> Drive Microcode Version: 07wR <#ToC_3> Robotics Microcode Version: 2.2 <#ToC_4> ------------------------------------------------------------------------ General information <#ToC_5> ******* Please read this entire notice ********* This package is being provided to allow the update of older IBM 7334-410 8mm Tape Library to the latest level of microcode that is currently shipping from IBM. The Robotics microcode is the same level shipped with all 7334-410 Libraries. Since the latest Robotics microcode is the same as shipped with the library, the Robotics microcode is not included with this package. Information to determine the Robotics microcode level and update the Robotics microcode level are included in this package as a reference only. * * *Customers are encouraged to install the latest microcode level themselves. The microcode and instructions are available the IBM external web site: http://techsupport.services.ibm.com/server/mdownload/download.html * ------------------------------------------------------------------------ Operating System levels supported: <#ToC_7> All levels of AIX that this product was announced on. ------------------------------------------------------------------------ Installation Time: <#ToC_8> 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_9> Yes, but the tape drive must be available with no tape in the drive, and no other processing running to the tape drive. ------------------------------------------------------------------------ Is system reboot needed to activate the microcode <#ToC_10> A reboot is not needed as the microcode is active in the drive when the drive completes microcode download. But to have the Vital Product Data show the new level you must use the AIX rmdev and mkdev commands. ------------------------------------------------------------------------ Drive Microcode Download information: <#ToC_11> In order to complete the microcode download to the tape drive you will need to use the AIX 5.1 diagnostics and higher, or the Genucode program. If the system does not have the AIX 5.1, or later, diagnostics you will need to get the Genucode package from the WEB at: * http://techsupport.services.ibm.com/server/mdownload/download.html * For either the AIX diagnostics or for Genucode you will need the * microcode * and * dsdata * files in this package. This tape drive package will get you to step where you will need to use the AIX 5.1 and higher Diagnostics or Genucode to download the microcode into the tape drive. ------------------------------------------------------------------------ Library Microcode Download information: <#ToC_12> In order to complete the microcode download to a IBM 7334-410 * Library Controller * you will need the Atape Device Driver installed on the system. * Use the Tapeutil part of Atape to download microcode to the 7334-410 Robotics. * ------------------------------------------------------------------------ Atape <#ToC_13> The Atape program was shipped with the IBM 7334-410. It is also available from: * ftp://ftp.software.ibm.com/storage/devdrvr/AIX * ------------------------------------------------------------------------ Additional Cautions <#ToC_14> * * *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_15> All 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_16> Drive Microcode History <#ToC_17> The microcode update will bring the IBM 60GB 8mm tape drive up to the current level which is: * 07wR * *Table 1. Microcode History* Tape Drive P/N Tape Drive FRU P/N Microcode Level Load ID What does this microcode change 19P0196 19P0207 02pR A1700296 First Microcode level shipped. 19P0196 19P0207 02sR A1700296 Fixes failure on diagnostics when diagnostics was run multiple times. Changes the time for the "Clean Soon" message and the Cleaning Amber LED coming on from 140 tape motion hours to 100. Adds message to messages displayed "Worn Tape"(a tape that exceeds 20,000 passes over any one spot on the tape). 19P0196 19P0207 03cR A1700296 Fixes one cause of Tape_Err2(Fault Symptom Code 8C) Machine type changes from IBM-60GB to Mammoth2 19P0196 19P0207 03nR A1700296 Fixes one cause of Tape_Err2(Fault Symptom Code 8C). 19P0196 19P0207 03rR A1700296 Improves Mammoth2(60GB 8mm) read time of Mammoth1(20GB 8mm) written tapes. 19P0196 19P0207 03sR A1700296 Fixes one cause of Tape_Err2(Fault Symptom Code 8C). Fixes AIX diagnostics indicating a drive failure when the tape drive was tested under AIX diagnostics and the diagnostic test was done without using the test tape. 19P0196 19P0207 07wR A1700296 Time between cleanings now 30 tape motion hours. Drive will now eject tape if the tape path internally in the drive exceeds 47 degrees C. The drive will display a message indicating "OVER TEMP". Improved reading of Mammoth 1 written tapes. Fixes several causes of Tape_Err2(Fault Symptom Code 8C). Change some Mammoth1 media errors sense data to properly indicate a media error(sense key 03) instead of a hardware error(sense key 04). Improved rejection of unsupported tape cartridges(VXA). Improved end of tape handling on 22m Mammoth1 tape cartridges. Changed some sense data error reporting on Read/Write errors to more correctly report the type of failure. Use "Active Negation" when the tape drive operates in Single Ended(SE) mode. This will reduce the chance of SCSI errors on very active SCSI buses. Corrected some causes of Fault Symptom Code(FSC) "8C", Controller firmware logic error, involving SmartClean. Improves the tape buffer handling when data is in the compressed mode. A reliability improvement when data compression is enabled (changes to the code decrease the number of start/stops resulting in less stress on the reel servo mechanism and on tape). Robotics Microcode History <#ToC_18> The microcode update will bring the IBM 7334-410 Robotics up to the current level of microcode which is: * 2.2 * *Table 2. Microcode History* Microcode Level What does this microcode change 2.2 First Microcode level shipped. ------------------------------------------------------------------------ Display Tape Drive Microcode Level <#ToC_19> *Note: *In some cases you may already have the most current level of microcode already installed. The following instructions show you how to check the tape drive microcode level. To display the level of microcode in the IBM 7334-410 8mm tape drive do the following AIX command: * lscfg -vl rmt0 <--- change the drive number to reflect the actual rmt address of the IBM 7334-410 8mm tape drive. * The output of the lscfg command will look like one of the following with the * "Device Specific.(Z1)" * showing the microcode level: * * * DEVICE LOCATION DESCRIPTION rmt0 10-78-00-4,0 Differential SCSI 8mm Tape Drive (60000 MB) Manufacturer................EXABYTE Machine Type and Model......IBM-60GB Device Specific.(Z1)........02pR Serial Number...............62022379 Device Specific.(LI)........A1700296 Part Number.................19P0196 FRU Number..................19P0207 EC Level....................H27309 Device Specific.(Z0)........0180020283000030 Device Specific.(Z3)........ * *OR* * DEVICE LOCATION DESCRIPTION rmt0 10-78-00-4,0 Differential SCSI 8mm Tape Drive (60000 MB) Manufacturer................EXABYTE Machine Type and Model......Mammoth2 Device Specific.(Z1)........07wR Serial Number...............62022379 Device Specific.(LI)........A1700296 Part Number.................19P0196 FRU Number..................19P0207 EC Level....................H27309 Device Specific.(Z0)........0180020283000030 Device Specific.(Z3)........ * Change in Machine Type Model Information <#ToC_21> Starting with microcode level * 03cR * the * Machine Type and Model * change * From: Machine Type and Model......IBM-60GB To: Machine Type and Model......Mammoth2 * ------------------------------------------------------------------------ Multiple Microcode Downloads Required <#ToC_22> If the * Machine Type and Model * do not show * Mammoth2 * it will be necessary to do two(2) microcode downloads to the tape drive. This is necessary because AIX Diagnostics and Genucode check the Machine Type and Model as part of the verification for microcode download to the tape drive. If the * Machine Type and Model * has *IBM-60GB * then it is necessary to install * both: * * *IBM-60GB.03cR.A1700296 * microcode file* * * *Mammoth2.07wR.A1700296 * microcode file If the * Machine Type and Model * has *Mammoth2 * then it is only necessary to install * only: * * *Mammoth2.07wR.A1700296 * microcode file ------------------------------------------------------------------------ Display Robotics Microcode Level <#ToC_23> To display the level of microcode in the IBM 7334-410 Robotics do the following AIX command: * * * lscfg -vl smc0 <--- change the drive number to reflect the actual smc address of the IBM 7334-410 Robotics controller * *The output of the lscfg command will look like the following with the * "Device Specific.(FW)" * showing the microcode level: * * DEVICE LOCATION DESCRIPTION smc0 10-78-00-0,0 IBM 7334 Tape Medium Changer (60000 MB) Manufacturer................IBM Machine Type and Model......IBM-7334-410 Serial Number...............67000047 Device Specific.(FW)........2.2 * ------------------------------------------------------------------------ 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 * 60GB8mmL.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_26> * If the CD-ROM process is used to put the * 60GB8mmL.bin * file on the user system the microcode files will expanded into the * /tmp/60GB8mmL_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/60GB8mmL_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_27> AIX bin file <#ToC_28> * Download the * 60GB8mmL.bin * file to the system to the * /tmp * directory. * Do the following AIX commands to make the file executable: * cd /tmp chmod +x 60GB8mmL.bin * * To expand the * 60GB8mmL.bin * file use the following command: * 60GB8mmL.bin * * This will put the following files in the * /tmp/60GB8mmL_web * directory: * * o *dsdata * o *IBM-60GB.03cR.A1700296 * o *Mammoth2.dsdata * o *Mammoth2.07wR.A1700296 * * Change to the directory just built: * cd /tmp/60GB8mmL_web * ------------------------------------------------------------------------ Check Microcode Checksum <#ToC_29> To insure the file downloaded correctly to your AIX system you should use the AIX command * sum * to verify the checksum of the downloaded file. * cd /tmp/60GB8mmL_web sum IBM-60GB.03cR.A1700296 * 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. * 18242 1 IBM-60GB.03cR.A1700296 OR sum Mammoth2.07wR.A1700296 * The output will be: * 16750 1192 Mammoth2.07wR.A1700296 * ------------------------------------------------------------------------ Installing Drive Microcode <#ToC_30> Installing Microcode with AIX Diagnostics <#ToC_31> If the system has AIX 5.1 or higher installed you can update the microcode in the tape drive with the AIX diagnostics. To update the microcode using the AIX diagnostics it is necessary to copy the files from the * /tmp/60GB8mmL_web * directory to the * /etc/microcode * directory with new names as AIX diagnostics only looks for microcode in the * /etc/microcode * directory. Additionally AIX diagnostics require the microcode and dsdata file to have a different naming convention then genucode uses. For instructions on using the AIX Diagnostics microcode download capability refer to the section of this document titled "How to Use AIX 5.1 Diagnostics Microcode Download". Installing Both Microcode Files with AIX Diagnostics <#ToC_32> Use the following AIX commands to copy the files to the * /etc/microcode * directory: * cd /tmp/60GB8mmL_web cp dsdata /etc/microcode/IBM-60GB.A1700296.dsdata cp IBM-60GB.03cR.A1700296 /etc/microcode/IBM-60GB.A1700296.03cR cp Mammoth2.dsdata /etc/microcode/Mammoth2.A1700296.dsdata cp Mammoth2.07wR.A1700296 /etc/microcode/Mammoth2.A1700296.07wR Run AIX 5.1 Diagnostics(or higher) selecting the 03cR microcode to download. Run AIX 5.1 Diagnostics(or higher) selecting the 07wR microcode to download. * Installing the Mammoth2 Microcode File only with AIX Diagnostics <#ToC_33> Use the following AIX commands to copy the files to the * /etc/microcode * directory: * cd /tmp/60GB8mmL_web cp Mammoth2.dsdata /etc/microcode/Mammoth2.A1700296.dsdata cp Mammoth2.07wR.A1700296 /etc/microcode/Mammoth2.A1700296.07wR Run AIX 5.1 Diagnostics(or higher) selecting the 07wR microcode to download. * Installing Both Microcode Files with Genucode <#ToC_34> *Note: *The dsdata file for the IBM-60GB and Mammoth2 microcode files are unique to each microcode file, so it is necessary to copy the particular microcode file and its associated dsdata file just prior to running genucode for that microcode file. The /. (slash dot) in the following commands uses the input name for the output name of the file. Use the following AIX commands to copy the files to the * /etc/microcode * directory: * cd /tmp/60GB8mmL_web cp dsdata /tmp/. cp IBM-60GB.03cR.A1700296 /tmp/. Run genucode * *Note: *It is not necessary to recycle power to the drive or do the AIX commands rmdev and mkdev after the first microcode download. The microcode is active in the drive when the download completes. * cp dsdata /tmp/. cp Mammoth2.07wR.A1700296 /tmp/. Run genucode * Follow the instructions in the Genucode package to do the microcode download. After completing the Genucode instructions be sure to do the AIX commands: * rmdev -l rmt0 mkdev -l rmt0 * This will update the Vital Product Data in AIX so the new microcode level plus any other data that was changed will be shown. Installing the Mammoth2 Microcode File only with Genucode <#ToC_35> If the tape drive Machine Type and Model already is Mammoth2 then it is only necessary to install the new Mammoth 2 microcode files. The /. (slash dot) in the following commands uses the input name for the output name of the file. Use the following AIX commands to copy the files to the * /etc/microcode * directory: * cd /tmp/60GB8mmL_web cp dsdata /tmp/. cp Mammoth2.07wR.A1700296 /tmp/. Run genucode * Follow the instructions in the Genucode package to do the microcode download. After completing the Genucode instructions be sure to do the AIX commands: * rmdev -l rmt0 mkdev -l rmt0 * This will update the Vital Product Data in AIX so the new microcode level plus any other data that was changed will be shown. ------------------------------------------------------------------------ Installing Robotics Microcode <#ToC_36> The Atape device driver is required to install microcode into the 7334-410 Robotics. 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 the Atape device driver is installed skip *to the step "Install with Atape". * If the * Atape * device driver * is not installed* you now need to install Atape. A copy of Atape was shipped with 7334-410 and is also available from the IBM web site listed previously in these instructions. ------------------------------------------------------------------------ Install with Atape <#ToC_37> You now need to issue the Atape tapeutil command: * tapeutil * Then select * Tape Drive Service Aids * Then select * Microcode load * Then select the tape drive you are going to download microcode to. Then enter the file name of the microcode file you are going to use for the download: * /tmp/IBM-60GB.Robotics.xxx * Follow the remaining instructions to complete the install. ------------------------------------------------------------------------ How to Use AIX 5.1 Diagnostics Microcode Download <#ToC_38> There are 2 ways to do the microcode download using the AIX diagnostics. * Using the AIX Diagnostics menu * Using the AIX Diagnostics via command line input. Using the AIX Diagnostics menu To use the AIX 5.1 diagnostics menu for microcode download do the following: * diag (enter) Task Selection (enter) Download Microcode (enter) * 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 the AIX Diagnostics via command line input. The command line to download microcode will use the highest level of microcode in the /etc/microcode directory for the device selected. To use the AIX 5.1 diagnostics command line input for microcode download 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) *