SCSD Tape/Optical Ucode Download Application

------------------------------------------------------------------------


  Table of Contents

*SCSD Tape/Optical Ucode Download Application <#Header_1>*

# Date: March 19, 2007 <#Header_2>
# Version: 1.30 <#Header_3>

# Description of Genucode <#Header_4>
# Current Genucode supported devices: <#Header_5>
# Overview: <#Header_6>
# Step 1: Download the microcode for the drive <#Header_7>
# Step 2: Putting Genucode on the system <#Header_8>
# From the IBM WEB site via the user downloading the files. <#Header_9>
# From a CD-ROM. <#Header_10>
# Packaged Microcode Files <#Header_11>
# AIX bin file <#Header_12>
# Check File Checksum <#Header_13>
# Copying Files <#Header_14>

# Step 3: Install Genucode <#Header_15>
# Step 4: Updating the drive microcode <#Header_16>
# Special Notice for 7205-311 <#Header_17>
# Microcode update instructions: <#Header_18>

# Step 5: Update the Vital Product Data(VPD) <#Header_19>
# Genucode Return Codes <#Header_20>
# Sample DSDATA files: <#Header_21>
# 13GB 1/4"(QIC-5010) Tape Drive <#Header_22>
# 60GB 8mm Tape Drive <#Header_23>

------------------------------------------------------------------------


  SCSD Tape/Optical Ucode Download Application <#ToC_1>


      Date: March 19, 2007 <#ToC_2>


      Version: 1.30 <#ToC_3>

------------------------------------------------------------------------


    Description of Genucode <#ToC_4>

The Generic SCSI microcode download utility for Self Configuring SCSI
Devices(SCSD), genucode, is a tool for downloading over the SCSI bus
microcode for IBM SCSD devices such as tape and optical drives on a
eServer pSeries or RS/6000.

------------------------------------------------------------------------


    Current Genucode supported devices: <#ToC_5>

    * 4GB 1/4"(QIC-4GB-DC) Tape Drive
    * 13GB 1/4"(QIC-5010) Tape Drive
    * 12GB 4mm DDS3 Tape Drive
    * 20GB 4mm DDS4 Tape Drive
    * 36GB 4mm DAT72 Tape Drive
    * 80GB VXA-2 Tape Drive
    * 160GB VXA-320 Tape Drive
    * 20GB 8mm Tape Drive
    * 60GB 8mm Tape Drive
    * 35GB DLT Tape Drive
    * 40GB DLT Tape Drive
    * 160GB DLT Tape Drive
    * 32x CDROM
    * 40x CDROM 

* *

*Additional supported SCSD devices may be defined in the microcode
package for that device. *

------------------------------------------------------------------------


    Overview: <#ToC_6>

The Genucode Utility has been integrated into AIX Diagnostics for most
devices since AIX 5.1., which means if your system has AIX 5.1 or
higher, you don't need to download the Genucode Utility. However 32x and
40x CD-ROM still requires the standalone Genucode Utility for microcode
updating process.

The dsdata and microcode files are still necessary for all the microcode
update processes (through AIX Diagnostic or the Genucode Utility).

There are 5 separate steps to the download and installation of both
Genucode and the microcode you wish to download: *

     Step 1 - Download the microcode for the drive using the instructions
              in the microcode package for the specific drive you are
              working with.
 
     Step 2 - Download Genucode or Copy Genucode from CD-ROM.
 
     Step 3 - Install Genucode.
 
     Step 4 - Update the microcode in the drive.
 
     Step 5 - Update the Vital Product Data(VPD) in the system for the
              drive.

*

------------------------------------------------------------------------


    Step 1: Download the microcode for the drive <#ToC_7>

Follow the instructions in the microcode package for the drive.

------------------------------------------------------------------------


    Step 2: Putting Genucode on the system <#ToC_8>

*Note: *The * "Genucode: Generic SCSI microcode download utility for
SCSD devices" * program is found at the bottom of the IBM web page for
the microcode downloads. It is also found in the * "media" * section of
same IBM web page. You must download this manually.

There are 2 ways a user can download the Genucode files. Each of these
will put Genucode on the user's system but the user will have to move
the files to appropriate directory for system use.


      From the IBM WEB site via the user downloading the files. <#ToC_9>

When the user downloads the Genucode files from the IBM web site the
packaged Genucode files should be put into the * /tmp * directory.

*Note: *Sign on the eServer pSeries or RS/6000 with root authority as
you need root authority to do the microcode install.

    * If the user downloads the * web_microcode.bin * file the user
      should 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_10>

    * If the CD-ROM process is used to put the * web_microcode.bin *
      file on the user system the microcode files will expanded into the
      * /tmp/web_microcode * directory. The next step is to follow the
      instructions in this README titled * "Check File Checksum". * The
      building and putting of the files into the * /tmp/web_microcode *
      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_11>


      AIX bin file <#ToC_12>

    * Download the * web_microcode.bin * file to the system to the *
      /tmp * directory.
    * Do the following AIX commands to make the file executable:
      * cd /tmp
      chmod +x web_microcode.bin *
    * To expand the * web_microcode.bin * file use the following command:
      * ./web_microcode.bin *

      *Note: *The previous command is dot(.) slash(/) to insure the
      command executed is the command in the /tmp directory as some
      systems do not look for the command to be executed in the current
      directory.

    * This will put the following files in the * /tmp/web_microcode *
      directory: * *
          o *genucode.README *
          o *genucode *
          o *genucode.cat *
          o *cpcat *


      Check File Checksum <#ToC_13>

To insure Genucode downloaded correctly to the system do the following
AIX command:  
* sum /tmp/web_microcode/genucode *
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.
* 28882 21 /tmp/web_microcode/genucode *


      Copying Files <#ToC_14>

*Note: *All AIX commands and file names are case sensitive, be sure to
use the commands and file names exactly as listed here. Errors in
spelling or case will cause the commands or Genucode not to work properly.

Copy * cpcat, genucode.cat, and genucode * to the * /tmp * directory by
executing the following AIX commands:
* cp /tmp/web_microcode/cpcat /tmp/cpcat
cp /tmp/web_microcode/genucode.cat /tmp/genucode.cat
cp /tmp/web_microcode/genucode /tmp/genucode *

------------------------------------------------------------------------


    Step 3: Install Genucode <#ToC_15>

Genucode requires a catalog entry that is not standard with AIX. To add
this catalog entry the script cpcat will copy the required entry to the
appropriate catalog.

    * Execute the cpcat script to copy genucode.cat to
      /usr/lpp/diagnostics/catalog/default (This only needs to be done
      once per system) by issuing the command:
      * cd /tmp
      ./cpcat *

      *Note: *The previous command is dot(.) slash(/) to insure the
      command executed is the command in the /tmp directory as some
      systems do not look for the command to be executed in the current
      directory.

------------------------------------------------------------------------


    Step 4: Updating the drive microcode <#ToC_16>

*Note: *Do not power the drive off immediately after the microcode says
it is complete as the drive may be still doing internal processing that
will take a few minutes to complete.

If the drive has just been powered on and no other AIX commands have
been issued to the drive genucode may indicate a failure to download the
microcode. The workaround to this is to retry the microcode download.
If genucode returns an error on completion, retry the command as this
may clear the error condition.


      Special Notice for 7205-311 <#ToC_17>

Before doing a microcode update to the tape drive remove any tape
cartridge from the drive and close the tape drive door.

When genucode indicates successful completion of the microcode download
on the 7205-311, wait until all LEDs stop flashing and the Green Open
Door LED is the only LED on before powering off or using the drive.


      Microcode update instructions: <#ToC_18>

    * If the drive to be updated is a tape drive remove any tape
      cartridge from the tape drive before doing a microcode update.
    * If the cleaning LED is ON on the tape drive, clean the drive prior
      to attempting microcode download. Microcode download may fail if
      the drive is indicating it needs to be cleaned when the microcode
      download is attempted.
    * Genucode will use the DSDATA file and the microcode previously
      downloaded in step 1.
    * There are several ways to run genucode but the simplest is to use
      the command line form detailed next. Be aware the command line
      form will not prompt you before executing. Issue the following
      commands to update the drive microcode:
      * cd /tmp
      ./genucode -s rmt0 *
      Where the rmt0 is the drive to be updated. If the drive is other
      than rmt0, change the name to the appropriate drive name, such as
      rmt2 or cd1, etc.. 

------------------------------------------------------------------------


    Step 5: Update the Vital Product Data(VPD) <#ToC_19>

Update the Vital Product Data(VPD) data in the system for the drive.

To update the systems VPD data to show the microcode in the drive do the
following AIX commands: *
rmdev -l rmt0
mkdev -l rmt0 *
Where the rmt0 is the drive to be updated. If the drive is other than
rmt0, change the name to the appropriate drive name, such as rmt2 or
cd1, etc..

*Note: *For most drives is not necessary to recycle the system or the
drive to have the drive microcode active. If it is necessary to recycle
the drive this will be in the information provided with the drive
microcode.
If you are going to recycle the system or the drive, MAKE SURE the
microcode download IS COMPLETE before recycling the system or the drive.

------------------------------------------------------------------------


    Genucode Return Codes <#ToC_20>

Program failed with Return_code: -xx

*

 NO INIT ODM     (-1)
 EXIT MAIN PANEL (-2)
 EXIT SELECT RES (-3)
 NO OPEN DSDATA  (-4)
 DSDATA ERROR    (-5)
 EXIT SELECT DEV (-6)
 INQUIRY FAILED  (-7)
 MISMATCHED PARM (-8)
 EXIT CONF DL    (-9)
 DOWNLOAD FAILED (-10)
 NO RES DEVS     (-11)
 EXIT CFGRES DEV (-12)
 CFGREQ FAIL     (-13)
 EXIT RES FAIL   (-14)
 RESTORE FAIL    (-15)
 NO DL DEVS      (-16)
 NO OPEN DEV     (-17)
 BAD INPUT PARM  (-18)

*

------------------------------------------------------------------------


    Sample DSDATA files: <#ToC_21>

Dsdata files are unique to each drive. The attached samples show the
dsdata file for some of the eServer pSeries and RS/6000 drives.

*Note: *The * at the front of the line in the dsdata file denotes this
is a comment only, the information in the line is not used by the
program. The comments are used to provide information for the user.


      13GB 1/4"(QIC-5010) Tape Drive <#ToC_22>

*

* dsdata - Drive Specific Data for microcode download
* Format
* LINE1:(continued) timeout_value(decimal) write_buffer_type{4 or 7}
* LINE1:(continued) {PdDVLn string found from odmget -qname=devicex CuDv}
* LINE2: (vendorname) inquiry_page page_offset field_length value
* LINE3: (firmware level) inquiry_page page_offset field_length value
* LINE4: (loadid) inquiry_page page_offset byte_length hexvalue
008000 000000 524464 0180 07 tape
00 10 08 IBM-6100
00 20 04 0106
00 2C 04 A0B00E11


The microcode file name would be: IBM-6100.0106.A0B00E11 *


      60GB 8mm Tape Drive <#ToC_23>

*

* Mammoth 2 Dsdata File   60GB 8mm Tape Drive
* September 6, 2002 V:01
* dsdata - Drive Specific Data for microcode download
*
* The dsdata file is used by both AIX Diagnostics, level 5.1 and higher,
* and the separate program "Genucode" available from the IBM pSeries
* external WEB site.
*
* Format of the data:
* LINE1: blocksize(3-hex) buffer_offset(3-hex) binary_filesize(decimal)
* LINE1:(continued) timeout_value(decimal) write_buffer_type{4 or 7}
* LINE1:(continued) {PdDVLn string found from odmget -qname=devicex CuDv}
* LINE2: (vendorname) inquiry_page page_offset field_length value
*
* Note:
*      "Genucode" requires the firmware level in line 3 to match the
*        firmware level you wish to download.
*
*        Naming conventions for Genucode are:
*        Microcode file:   /tmp/Mammoth2.07pR.A1700295
*        dsdata    file:   /tmp/dsdata
*
*      AIX Diagnostics "Microcode Download" does not require the firmware
*      level to match the firmware level you wish to download.
*
*        Naming conventions for AIX diagnostics are:
*        Microcode file:   /etc/microcode/Mammoth2.A1700295.07pR
*        dsdata    file:   /etc/microcode/Mammoth2.A1700295.dsdata
*
* LINE3: (firmware level) inquiry_page page_offset field_length value
* LINE4: (loadid) inquiry_page page_offset byte_length hexvalue
*
008000 000000 1201664 0600 07 tape
00 10 08 Mammoth2
00 20 04 07pR
00 2C 04 A1700295


The microcode file name would be: Mammoth2.07pR.A1700295 *