General Installation Requirements

Before installing VERITAS Storage Foundation, read the following sections to make sure you understand and comply with the basic requirements of the software.

VERITAS Product Licensing

Product keys are available on the License Key certificate. The certificate also includes the number of product licenses purchased. A single key enables product installation on the number and the type of systems for which you purchased the license. A key may enable the operation of more products than specified on the certificate, but you are legally limited to the number of product licenses purchased.

The VRTSvlic package enables VERITAS product licensing. The following commands and their manual pages are available on the system after VRTSvlic is installed:

vxlicinst - installs a license key for a VERITAS product

vxlicrep - displays currently installed licenses

vxlictest - retrieves features and their descriptions encoded in a license key

If you encounter problems while licensing your product, visit the VERITAS licensing support website at http://www.veritas.com/buy/vLicense/vLicenseHome.jhtml.

System Requirements

The following sections provide requirements that your system must meet before installing the VERITAS software.

Dependencies

VERITAS Storage Foundation and VERITAS Storage Foundation for Oracle can only be installed on a system running the September 2004 HP-UX 11i version 2.0 release or later.

  To verify the operating system version

Use the swlist command as follows:

JFS must be installed on your system prior to installing any VERITAS software.

  To verify that JFS is installed

Use the swlist command as follows:

Software and Hardware Requirements

For information on hardware requirements, see the VERITAS Volume Manager Hardware Notes.

For information on specific HA setup requirements, see Chapter 2, "Preparing to Install VCS 4.1," in the VERITAS Cluster Server Installation Guide.

Oracle Requirements

The following list identifies the supported Oracle and HP-UX combinations if you plan to use VERITAS Storage Foundation with an Oracle database:

Refer to the appropriate Oracle installation guide that accompanied your Oracle software for additional preinstallation information.

In order to use VERITAS Extension for Oracle Disk Manager, you must use Oracle9i release 92 or later. Refer to Oracle bug number 1824061.

To use the Storage Mapping functionality, you must install Oracle 9.2.0.3 or higher.

Using Asynchronous I/O on Oracle

If you did not use raw devices for your database, it is likely that your system was not configured to perform asynchronous I/O. VERITAS Storage Foundation for Oracle supports asynchonous I/O on Quick I/O files and Oracle Disk Manager files.

For the Oracle database to take advantage of the asynchronous I/O capability offered by VERITAS Storage Foundation for Oracle, you must create the following device:

Refer to your Oracle Administrator's Reference Guide for instructions on how to create this device.

There are system and database configuration requirements that must be met before enabling asynchronous I/O. To make sure your environment meets those requirements, see your Oracle documentation.

Required HP-UX Patches

The 4.1 release of VERITAS File System operates only on HP-UX 11i 64-bit operating systems with the September 2004 HP-UX 11i Version 2.0 (or later) release installed. The 4.1 release requires the following HP-UX patches. The VERITAS Volume Manager patches must be installed only if you are using VxFS in conjunction with VxVM:

HP-UX Patch ID	Description
PHCO_32385	Enables fscat(1M).
PHCO_32387	Enables getext(1M).
PHCO_32388	Enables setext(1M).
PHCO_32389	Enables vxdump(1M).
PHCO_32390	Enables vxrestore(1M).
PHCO_32391	Enables vxfsstat(1M).
PHCO_32392	Enables vxtunefs(1M).
PHCO_32393	Enables vxupgrade(1M).
PHCO_32488	Enables LIBC for VxFS 4.1 file system.
PHCO_32523	Enhancement to quota(1) for supporting large uids.
PHCO_32524	Enhancement to edquota for supporting large uids.
PHCO_32551	Enhancement to quotaon/quotaoff for supporting large uids.
PHCO_32552	Enhancement to repquota for supporting large uids.
PHCO_32596	Enables df(1M).
PHCO_32608	Enables bdf(1M).
PHCO_32609	Enables fstyp(1M).
PHCO_32610	Enables mount(1M).
PHCO_32611	Fix fs_wrapper to accept "vxfs" from subtype.
PHKL_31500	Sept04 Base Patch
PHKL_32272	Changes to fix intermittent failures in getacl/setacl.
PHKL_32425	Changes to fix the leaking of VM pages in case of I/O errors.
PHKL_32430	Changes to separate vxfs symbols from libdebug.a, so that VxFS 4.1 symbols are easily available in q4/p4.
PHKL_32431	Changes to disallow mounting of a file system on a vnode having VNOMOUNT set. Enhancements for supporting quotas on large uids.

In addition to the above patches the EnableVXFS41 bundle needs to be installed before installing the VxFS 4.1 file system. This bundle is an HP bundle and contains enhancements to various commands to understand the new Version 6 layout. The EnableVXFS41 bundle contains the following patches:

HP-UX Patch ID	Description
FsLibEnh	Enhancements to LIBC libraries to understand VxFS disk layout Version 6.
DiskQuota-Enh	Enhancements to various quota related commands to support large uids.
FsCmdsEnh	Enhancements to the mount command to support VxFS 4.1.

HP may release patches that supersede the ones in this list. To verify that you have the latest HP-UX patches, go to the VERITAS support website to view the following TechNote:

http://support.veritas.com/docs/275787

Also, you can get the patches from Hewlett-Packard's Patch Database offered under the Maintenance and Support section of the HP Services & Support - IT Resource Center. HP's Patch Database provides fast, accurate searches for the latest recommended and superseded patches available for VERITAS File System or VERITAS Volume Manager.

Disk Space

Before installing any of the VERITAS Storage Foundation products, confirm that your system has enough free disk space. Use the "Perform a Preinstallation Check" (P) option of the product installer to determine whether there is sufficient space.

The following table shows the approximate disk space used by the Storage Foundation products for all (both the required and optional) packages:

Package Information

The following table shows the package name and contents for each package:

/opt Directory

The directory /opt must exist, be writable and must not be a symbolic link. If you are upgrading, you cannot have a symbolic link from /opt to an unconverted volume. If you do have a symbolic link to an unconverted volume, the symbolic link will not function during the upgrade and items in /opt will not be installed.

Environment Variables

Most of the commands used in the installation are in the /sbin or /usr/sbin directory. However, there are additional variables needed to use the VERITAS Storage Foundation product after installation. Add the following directories to your PATH environment variable:

• If you are using Bourne or Korn shell (sh or ksh), use the commands:

   $ PATH=$PATH:/usr/sbin:/opt/VRTS/bin:/opt/VRTSvxfs/sbin:\
   /opt/VRTSdbed/bin:/opt/VRTSob/bin:/opt/VRTSvcs/bin
   $ MANPATH=/usr/share/man:/opt/VRTS/man:$MANPATH
   $ export PATH MANPATH
• If you are using a C shell (csh or tcsh), use the commands:

   % set path = ( $path /usr/sbin /opt/VRTSvxfs/sbin \
    /opt/VRTSdbed/bin /opt/VRTSvcs/bin /opt \
    /opt/VRTSob/bin:/opt/VRTS/bin )
   % setenv MANPATH /usr/share/man:/opt/VRTS/man:$MANPATH

---

  Note    If you are not installing VERITAS Storage Foundation for Oracle, you can omit /opt/VRTSdbed/bin.

If you are not installing an HA product, you can omit /opt/VRTSvcs/bin.

When VxFS 4.1 is installed, the /opt/VRTS/vxfs4.1 directory is automatically added to the MANPATH. Verify that /opt/VRTS/vxfs4.1 appears before /usr/share/man in the MANPATH variable. This displays the latest VxFS 4.1 manual pages.

---

Prerequisites for Remote and Cluster Installation and Uninstallation

Establishing communication between nodes is required to install VERITAS software from a remote system, or to install and configure a cluster. The node from which the installation utility is run must have permissions to run rsh (remote shell) or ssh (secure shell) utilities as root on all cluster nodes or remote systems. See "Configuring SSH or RSH Before Installing VERITAS Products" in the Getting Started Guide for more information.

Release Notes

Read the Release Notes for all products included with this product. Portable Document Format (.pdf) versions of the Release Notes are included on the software disc in the storage_foundation/release_notes directory.

Because product Release Notes are not installed by any packages, VERITAS recommends that you copy them from the disc to the /opt/VRTS/docs directory on your system so that they are available for future reference.