

                                                                  SSA MICROCODE
                                                      INSTALLATION INSTRUCTIONS

                                                               INSTALL SSAFLASH
                                               MICROCODE FOR SSA 4-PORT ADAPTER
                                                              FEATURE CODE 6214
                                      MICROCODE FOR ENHANCED SSA 4-PORT ADAPTER
                                                              FEATURE CODE 6216
                                                 MICROCODE FOR SSA RAID ADAPTER
                                                         FEATURE CODE 6217/6218
                                        MICROCODE FOR ENHANCED SSA RAID ADAPTER
                                                         FEATURE CODE 6215/6219
                                              MICROCODE FOR SSA DISKS DFHC/DCHC



                                                                 FIELD USE ONLY








                                                                    Mar 20,1998





                                                                    SSD 7133 PE
                                                                  MP148 Hursley
                                                          external 01705-817565
                                                            internal (7)-247565
                                                             SINCLAIR at WINVMD

                                             Written By:   D Sinclair/J Agombar


1.0  USING THE NEW ADAPTER AND DRIVE MICROCODE DISKETTES
___________________________________________________________________

This document describes how to install the new microcode for the SSA Adaptors
and SSA Dasd.  The microcode is supplied on four diskettes:

o   Adapter microcode diskette containing file ADAP2437.BFF
o   Adapter microcode diskette containing file ADAP1818.BFF
o   Disk Drive microcode diskette containing file DISK8893.BFF
o   Disk Drive microcode diskette containing file 6561.BFF


2.0 INSTALLING THE ADAPTER MICROCODE

The SSA Adapter Microcode diskettes contain the latest level of microcode
code for the SSA 4-Port Adapter, feature code 6214, the Enhanced SSA
4 Port Adapter, feature code 6216, the SSA Raid Adaptor, feature
code 6217 and 6218 and the Enhanced SSA Raid Adaptor, feature code 6215
and 6219.

To load the microcode:

1.  Log in as root

2.  Insert the ADAP2437.bff Adaptor Microcode diskette in the drive rfd0

3.  Enter the command: "installp -ac all"

4.  Insert the ADAP1818.bff Adaptor Microcode diskette in the drive rfd0

5.  Enter the command: "installp -ac all"

6.  On each system that is connected to a particular SSA loop, go into
    System Verification mode, and run diagnostics to ensure that all the
    adapters are in a valid loop.  (For example, a loop that contains
    an SSA 4-Port Adapter can include only one other adapter.)  Verify
    that the adaptor is in a loop rather than a string.

7.  ATTENTION:  Do not perform adaptor microcode downloads concurrently
    to systems that are in the same SSA loop.  This may cause
    a portion of the loop to be isolated and could prevent access to
    these disks from systems elsewhere in the loop.

8.  ATTENTION:  Do not run Advanced Diagnostics while downloads are
    in progress.  Advanced Diagnostics causes the SSA adaptor to
    be reset temporarily, thereby introducing a break in the loop.
    If this occurs concurrently with a download to an adaptor elsewhere
    in the loop, portions of the loop may become temporarily isolated
    and inaccessible.

9.  Run cfgmgr to download the adaptor microcode to every adaptor
    installed in the system.

10. If the adapter is on an SSA loop that includes an adapter in another
    system, you must update the adapter microcode in that other
    system.  See 2.1, "Installing the Adapter Microcode into Adapters in
    Other Systems."


2.1 INSTALLING THE ADAPTER MICROCODE INTO ADAPTERS IN OTHER SYSTEMS
___________________________________________________________________

It is recommended that on an SSA loop, all SSA adapters of a particular
type use a common level of microcode.  If the adapters are all in one
system, they automatically receive a common level of microcode. If the
adapters are in different systems, you should update the adapter
microcode in those systems as soon as is possible.  (However, do not
update adaptor microcode on more than one system in the same SSA loop
concurrently.  Each system must be updated in sequence).

Where appropriate:

1.  Log in as root.

2.  Insert the ADAP2437.bff Adaptor Microcode diskette in the drive rfd0

3.  Enter the command: "installp -ac all"

4.  Insert the ADAP1818.bff Adaptor Microcode diskette in the drive rfd0

5.  Enter the command: "installp -ac all"

6.  On each system that is connected to a particular SSA loop, go into
    System Verification mode, and run diagnostics to ensure that all the
    adapters are in a valid loop.  (For example, a loop that contains
    an SSA 4-Port Adapter can include only one other adapter.)  Verify
    that the adaptor is in a loop rather than a string.

7.  ATTENTION:  Do not perform adaptor microcode downloads concurrently
    to systems that are in the same SSA loop.  This may cause
    a portion of the loop to be isolated and could prevent access to
    these disks from systems elsewhere in the loop.

8.  ATTENTION:  Do not run Advanced Diagnostics while downloads are
    in progress.  Advanced Diagnostics causes the SSA adaptor to
    be reset temporarily, thereby introducing a break in the loop.
    If this occurs concurrently with a download to an adaptor elsewhere
    in the loop, portions of the loop may become temporarily isolated
    and inaccessible.

9.  Run cfgmgr to download the adaptor microcode to every adaptor
    installed in the system.


3.0 INSTALLING THE DISK8893.bff DISK DRIVE MICROCODE
______________________________________________________

This SSA Disk Drive Microcode diskette contains the latest level of
microcode (8877 and 9393) for SSA Disk Drives.

NOTE: This code can be downloaded with the service aids if the
4.1.5, 4.2.1 or 4.3.0 SSA device drivers are installed.  Alternatively,
the code may be downloaded via the diagnostics CDROM at levels 4.1.5,
4.2.1 or 4.3.

NOTE: The adapter microcode should be updated to the latest level on
      all adapters in the loop before downloading any disk drive
      microcode.

3.1  Downloading the Microcode to /etc/microcode
________________________________________________

1.  Insert the DISK8893.bff Disk Drive Microcode diskette
    in the drive rfd0

2.  Log in as root

3.  Enter the command: "installp -ac all"

3.2.1  Downloading the Microcode from /etc/microcode using ssadload
___________________________________________________________________

1. The following steps should be followed for all systems in the loop.
   Each system must be processed in sequence.  DO NOT perform the
   download procedure from multiple hosts at the same time.

   a/ Stop all io activity on the SSA drives you are loading uCode to.
   b/ Unmount all filesystems on the SSA drives you are loading uCode to.
   c/ varyoff all volume groups on the associated SSA drives

   NOTE: It is advisable to run diagnostics to all pdisks before
   starting the download procedure.  This only needs to be done from
   one system in the loop.  To do this, either run the diagnostic
   routines in system verification mode to all pdisks or execute
   the command:
     ssa_diag -l pdiskX
   for every pdisk.  If any errors are reported then follow the
   service procedures to ensure that they are fixed before continuing.

   Diagnostics must NOT be run once the download process has started.

2. Run the following command to load the latest available
   microcode to all drives that require it.

   ssadload -u

   NOTE: If there are other systems in the same SSA loop then ONLY
   perform this step on one system in the loop.  DO NOT perform it
   concurrently on multiple systems in the loop.

   NOTE: Disk microcode download is only possible in a complete SSA
   loop.  If you have powered off devices (disks or adaptors) in the
   loop so that it has become a string, you will need to bring these
   devices back up again before you can perform the download.

   If any problems occur during the download then see "Appendix A"
   at the end of this document.

3.2.1  Downloading the Microcode from CDROM diagnostics
______________________________________________________

The following steps should be followed for all systems in the loop.
Each system must be processed in sequence.  DO NOT perform the
download procedure from multiple hosts at the same time.

1.  Boot the system in CDROM diagnostics.
2.  Enter the SSA Service Aids menu and select the Download Service Aid
3.  Select the 'Download Latest Microcode to all Drives' option
4.  When prompted, indicate that the microcode is on diskette
5.  When prompted, place the microcode diskette in the diskette drive.
6.  Proceed, following the on screen prompts.

   NOTE: If there are other systems in the same SSA loop then ONLY
   perform this step on one system in the loop.  DO NOT perform it
   concurrently on multiple systems in the loop.


3.3 INSTALLING THE DISK DRIVE MICROCODE INTO DISKS IN OTHER SYSTEMS
___________________________________________________________________

Once a disk has been downloaded from one system, it is not necessary to
download the code to that same disk from other systems on the same SSA
loop.  However, it is sensible to install the latest disk drive code
onto all systems, in case this code is needed when additional disk drives
are attached to the system in future.  Where appropriate:

1.  Log in as root

2.  Insert the DISK8893.bff  Disk Drive Microcode diskette
    in the drive rfd0.

3.  Enter the command: "installp -ac all"

When new microcode has been downloaded to a disk from one system, the
entry in the ODM for the code level on that disk is also updated.  The
other systems that have that drive configured will now have incorrect
entries in the ODM.  To force the ODM to be updated on all other
systems that have that disk configured, enter the command:

    mkdev -l pdiskX     (for every pdisk that has been upgraded)
    or
    cfgmgr


3.4  INSTALLING THE 6561.bff DISK DRIVE MICROCODE
_________________________________________________

This microcode diskette provides the 6561 level of code for DFHC type
SSA disk drives.  If you are able to install the DISK8893.bff SSA disk
microcode as described in 3.1.1 you can omit installation of the
6561.bff SSA disk microcode, since the DISK8893.bff SSA disk microcode
supercedes the 6561.bff SSA disk microcode.

If you do need to load this microcode, perform the following
procedure:

1.  Insert the 6561.bff Disk Drive Microcode diskette in the drive rfd0

2.  Log in as root

3.  The following steps should be followed for all systems in the loop:

  a/ Stop all io activity on the SSA drives you are loading uCode to.
  b/ Unmount all filesystems on the SSA drives you are loading uCode to.
  c/ varyoff all volume groups on the associated SSA drives

4.  Enter the command: "installp -ac all"

5.  When you have finished installing all the microcode (adapter and disk)
    then reboot or run "cfgmgr" for the changes to take effect.

    If there are other systems in the same loop following the
    instructions in section 3.5.

3.5 INSTALLING THE DISK DRIVE MICROCODE INTO DISKS IN OTHER SYSTEMS
___________________________________________________________________

Once a disk has been downloaded from one system, it is not necessary to
download the code to that same disk from other systems on the same SSA
loop.  However, it is sensible to install the latest disk drive code
onto all hosts, in case this code is needed when additional disk drives
are attached to the system in future.  Where appropriate:

1.  Log in as root

2.  Insert the 6561.bff Disk Drive Microcode diskette in the
    drive rfd0

3.  Enter the command: "installp -ac all"

When new microcode has been downloaded to a disk from one system, the
entry in the ODM for the code level on that disk is also updated.  The
other systems that have that drive configured will now have incorrect
entries in the ODM.  To force the ODM to be updated on all other
systems that have that disk configured, enter the command:

    mkdev -l pdiskX     (for every pdisk that has been upgraded)
    or
    cfgmgr


3.6 ACTIONS TO BE TAKEN WHEN NEW DISKS ARE ADDED TO THE SYSTEM
________________________________________________________________

Since the disk download mechanism used for DISK8893.bff is a manual
process it is necessary to repeat from step (2) in 3.2 whenever new
disks are added to a particular system.  This ensures all
attached disks are kept at the latest level of code.

(Note: Disk drive code installed from 6561.bff is installed automatically
on SSA disks where required at boot time.  So, for this particular code
load, no manual intervention is required, except to run cfgmgr or
reboot the system when new disks are attached).


APPENDIX A: ACTIONS TO BE TAKEN IF A DRIVE DOWNLOAD FAILS
_________________________________________________________

If a download to a drive fails then there are a number of steps that
may be necessary before it can be retried.  Do not attempt to download
new code to other drives until this drive has been recovered.

1. The first step is to confirm that you still have a complete loop
   and have access to the pdisk in question.  Start diagnostics
   and using the SSA service aids run "Link Verification" to confirm
   that you have a complete loop with a path to the disk from two
   ports of the adapter.

2. If Link Verification does not show the failed pdisk or only
   shows access to it from one port of the adapter:
   a) Confirm that no devices have been powered off that will cause
      a break in the loop.
   b) Run the command:
        /usr/lpp/diagnostics/bin/run_ssa_healthcheck
      on all hosts that have an adapter in the loop with this pdisk.
   If Link Verification still does not show a complete loop then:
   c) Power cycle the disk in question by unplugging/replugging it.

   If at the end of these steps, the disk is still not part of a
   complete loop then call your support centre before continuing.

3. Once the loop is complete, retry the download to just this one pdisk:
    ssadload -d <pdiskX> -f <microcode_file>
   where:
     pdiskX is the disk in question
     microcode_file is the microcode file in question.  This must
     be the full path and will be of the format:
       /etc/microcode/ssadisk.ros.XXXX.XXXX
     Where XXXX.XXXX is the drivetype.codelevel.  List all of these
     files and choose the appropriate one for the pdisk in question.
     (see SSAFLASH README for further information on this).
