82108_V5_0A Tru64 UNIX V5.0A I/O Barrier Support ECO Summary

TITLE: 82108_V5_0A Tru64 UNIX V5.0A I/O Barrier Support ECO Summary

Copyright (c) Compaq Computer Corporation 2000.  All rights reserved.

PRODUCT:    Tru64 UNIX V5.0A
SOURCE:     Compaq Computer Corporation

ECO INFORMATION:     

            ECO Name:  82108_V5_0A
            Kit Applies To:  Tru64 UNIX 5.0A

ECO KIT SUMMARY:

This patch (82108_v5_0a.tar) provides I/O barrier support on Tru64 UNIX V5.0A 
for 3rd party storage devices that do not support Persistent Reserve.

The prerequisite for installing this patch is that your system must have  
V5.0A Patch Kit 2 installed.

This patch applies only to cluster systems.

To implement I/O barrier support, complete the following two steps:

(1) Install the I/O barrier patch
(2) Modify the ddr.dbase files


(1) Installing the I/O Barrier Patch:

The I/O barrier patch consists of three .mods:
   cam_disk.mod
   cam.mod
   drd.mod

1. Unpack the tar file into a temporary directory.
   In the following examples, the temporary directory is /usr/users/myhome:
   
   cd /usr/users/myhome
   tar -sxvf 82108_v5.0a.tar

2. Save the original modules and copy the patches modules into build directories

   cd /sys/BINARY
 	cp -p cam.mod cam.mod_orig
        cp /usr/users/myhome/cam.mod cam.mod
        chmod 0644 cam.mod
        chown bin:bin cam.mod

        cp -p cam_disk.mod cam_disk.mod_orig
        cp /usr/users/myhome/cam_disk.mod cam_disk.mod
        chmod 0644 cam_disk.mod
        chown bin:bin cam_disk.mod

  cd /usr/opt/TruCluster/sys 
        cp -p drd.mod drd.mod_orig
        cp /usr/users/myhome/drd.mod drd.mod
        chmod 0644 drd.mod
        chown bin:bin drd.mod



(2) Modifying the ddr.dbase files 

General Instructions
--------------------

Customers must modify the ddr.dbase file for each node in their 
cluster. The ddr.dbase file is not a cluster global file, and
each node has a separate ddr.dbase file.

If you have any questions on the ddr entry that describes your 
third-party SCSI device, please contact the device vendor.

Devices from Compaq Computer Corporation do not need modification
in the ddr.dbase file.


Specific Instructions
---------------------

Repeat the following three steps for EACH NODE in the cluster:

1). Edit the /etc/ddr.dbase file and find the third-party SCSI 
device entries that need to be modified. Add the following lines
to those device entries:

  ATTRIBUTE:
    AttributeName   = "DSBLflags"
    Length          = 4
    ubyte[0]        = 
     **Contact the disk vendor for the correct ubyte[0] setting**


  For example, the following entry represents the HSG family of Fibre
  Channel devices. It is provided ONLY as an EXAMPLE.

  This entry was modified to indicate that the family does not support
  Persistent Reserve functionality and that does not propagate 
  BUS RESETS:


  SCSIDEVICE
    #
    # Matches everyone in the HSGx family
    # Entry for Fibre Channel (Stype=2/sim_type=FC)
    #
    Type = disk
    Stype = 2
    Name = "DEC" "HSG"
    #
    PARAMETERS:
        TypeSubClass        = hard_disk, raid
        BlockSize           = 0
        BadBlockRecovery    = disabled
        DynamicGeometry     = true
        DisperseQueue       = true
        LongTimeoutRetry    = enabled
        ReadyTimeSeconds    = 90
        TagQueueDepth       = 25
        RequestSenseLength  = 255
        PwrMgmt_Capable     = false
    ATTRIBUTE:
        # This value for tunes the VPDinfo control_flags to disable
        # the use of START UNIT commands when probing the Inquiry VPD pages.
        AttributeName = "VPDinfo"
        Length = 16
        ubyte[6] = 4
    ATTRIBUTE:
        # The presence of this attribute enables the reporting of the
        # CHANGEABLE DEVICE IDENTIFIER for the phys_locator attribute
        # instead of a B/T/L value.
        AttributeName = "rpt_chgbl_dev_ident"
        Length = 4
    ATTRIBUTE:
        AttributeName   = "DSBLflags"
        Length          = 4
        ubyte[0]        = 17

(End of example)


2). Recompile the /etc/ddr.base file. Use the following command:   

	ddr_config -c

3). Rebuild the kernel and copy it to the boot disk. Use the 
    following commands:


	doconfig -c NODE_NAME

	cp /vmunix /vmunix.orig
	cp /sys/NODE_NAME/vmunix /vmunix

   NOTE: - DO NOT use the mv command. This destroys the CDSL
   (Context Dependent Symbolic Link).


When these three steps are complete for each node in the cluster,
shutdown the cluster using the following command:
  
	shutdown -c TIME (where TIME is now or some future time)

[R] UNIX is a registered trademark in the United States and other countries
    licensed exclusively through X/Open Company Limited.

Copyright Compaq Computer Corporation 2000.  All Rights reserved.

  This software is proprietary to and embodies the confidential technology
  of Compaq Computer Corporation.  Possession, use, or copying of this
  software and media is authorized only pursuant to a valid written license
  from DIGITAL or an authorized sublicensor.

       This ECO has not been through an exhaustive field test process.
       Due to the experimental stage of this ECO/workaround, Compaq
       makes no representations regarding its use or performance.  The
       customer shall have the sole responsibility for adequate protection
       and back-up data used in conjunction with this ECO/workaround.

Colorado Site
Georgia Site

82108_v5_0a.README
82108_v5_0a.CHKSUM
82108_v5_0a.tar