Date: 2008-12-20 
OS: HPUX
OS Version:11.31
Packages:VRTSodm GA RP2
Etrack Incidents: 1451946, 1453996

Errors/Problems Fixed:
1451946 : odm_lockpages() can deadlock with multiple pglists
1453996 : odmmkfile/qiomkfile should fail for non-root users

Fixes Applied for Products:
VRTSodm

1. Install and Uninstall Instructions for the ODM patch:
----------------------------------------------------

1.1. To install the ODM 5.0-RP2 patch:

a) The ODM 5.0(GA) must be installed before applying this
  patch.

b) To verify the Veritas Oracle Disk Manager level, execute:

     # swlist -l product | egrep -i 'VRTSodm'

  VRTSodm     5.0.31.0        Veritas Oracle Disk Manager

c) All prerequisite/corequisite patches must be installed. The Kernel patch
  requires a system reboot for both installation and removal.

d) To install the patch, execute the following command:

# swinstall -x autoreboot=true -s <patch_directory> PHKL_39130

If the patch is not registered, you can register it
using the following command:

# swreg -l depot <patch_directory>

The <patch_directory> is the absolute path where the patch resides.

1.2. To remove the ODM 5.0-RP2 patch:

a) Execute the following command:

# swremove -x autoreboot=true PHKL_39130


IMPORTANT : READ BEFORE INSTALLATION & USE:

1. There is a panic in ASYNC I/O codepaths in HPUX 11.31. See etrack incident
   848725. HP provided a patch for ic148. Patch your machine before you install
   VRTSvxvm package. See Installation steps below for how to put this patch.

2. After installing VRTSvxfs package, copy the following binaries 
  - fsclustadm, qiomkfile, qioadmin, qiostat, vxfsckd, vxgetmsg 
    from, 
     /usr/lbin/fs/vxfs5.0
    to, 
     /usr/sbin
   This is fixed after 5.0_11.31-2006-11-15a drop was delivered. Please see 
   etrack incident 820774. Fix will be part of next drop.
3. After installing VRTSodm package and after every reboot,
   the ODM module is not getting loaded automatically.
   To check the module state fire : 
	   kcmodule -v odm
   To Load the odm module explicitly : 
	   kcmodule -v odm=loaded
   This behaviour is due to VRTSvxvm's  dmp et.al modules issue. Please see
   etrack incident 859475

4. After installing VRTSodm package and after every reboot,
  /dev/odm is not getting mounted automatically. 
  You need to mount it explicitly using the following command.
	mount -F odm /dev/odm /dev/odm
   This behaviour is also due to VRTSvxvm's  dmp et.al modules issue. Please 
   see etrack incident 859475

5. umount of a filesystem on which odm files sit may return EBUSY (see etrack
   incident 856896.
   Please use "vxumount -o force <mount-point-name>" in that case.

   Also note that you need to unmount (or force unmount) all VxFS file-systems
   on which odm files are sitting, before going to unmount /dev/odm.

6. There is a cache-coherency issue in FDD (a module in VRTSvxfs), due to
   which you may not see the data written through ODM files in clones or
   shared-mmaps. (See etrack incidents 843809 and 857983)

INSTALLATION STEPS:
- Copy the vm_vasm patch to /usr/conf/mod/ to a 
  freshly installed ic148 perf machine
- Install VRTSvlic 
- Install VRTSvxvm
- Install VRTSvxfs 
- Install VRTSodm
Known Issues
============
Smartsync Option not supported for ODM 5.0 on HP-UX 11iv3

The Beta releases of SFORA 5.0 and SFRAC 5.0 on HP-UX 11iv3 will not 
support ODM (Oracle Disk Manager) to be used in the smartsync mode 
of operation. ODM will be mounted in the 'nosmartsync' mode by default. 
Using ODM in the smartsync mode of operation might lead to unexpected 
behavior for the applications.