Storage Foundation for Oracle Release Notesstatic-sort.symanteccloud.com/public/documents/sfha/4.0/aix/... · Export of this software from the United States of America may require

August 2004

VERITAS Storage Foundation™

4.0 for Oracle

Release Notes

AIX

Disclaimer

The information contained in this publication is subject to change without notice. VERITAS Software Corporation makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. VERITAS Software Corporation shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual.

Copyright

Copyright © 1999-2004 VERITAS Software Corporation. All rights reserved. VERITAS is a registeredtrademark of VERITAS Software Corporation in the US and other countries. The VERITAS logo and VERITAS Storage Foundation are trademarks of VERITAS Software Corporation. All other trademarksor registered trademarks are the property of their respective owners.

VERITAS Software Corporation350 Ellis St.Mountain View, CA 94043 USAPhone 650–527–8000Fax 650–527–2908www.veritas.com

Third-Party Copyrights

Data Encryption Standard (DES)

Copyright© 1990 Dennis Ferguson. All rights reserved.

Commercial use is permitted only if products which are derived from or include this software are made available for purchase and/or use in Canada. Otherwise, redistribution and use in source and binary forms are permitted.

Copyright© 1985, 1986, 1987, 1988, 1990 by the Massachusetts Institute of Technology. All Rights Reserved.

Export of this software from the United States of America may require a specific license from the United States Government. It is the responsibility of any person or organization contemplating export to obtain such a license before exporting.

WITHIN THAT CONSTRAINT, permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of M.I.T. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. M.I.T. makes no representations about the suitability of this software for any purpose. It is provided “as is” without express or implied warranty.

GNUPlot 3.7

Copyright © 1986-1993, 1998 Thomas Williams, Colin Kelley License: Permission to use, copy, and distribute this software and its documentation for any purpose with or without fee is hereby granted, provided the above copyright notice appear in all copies and both that copyright notice and this permission notice appear in supporting documentation. Permission to modify the software is granted, but not the right to distribute the complete modified source code. Modifications are to be distributed as patches to the released version. Permission to distribute binaries produced by compiling modified sources is granted, provided you 1. Distribute the corresponding source modifications from released version in the form of a patch file along with the binaries,2. Add special version identification to distinguish your version in addition to the base release version number,3. Provide your name and address as the primary contact for the support of your modified version, and4. retain our contact information in regard to use of the base software.Permission to distribute the releases version of the source code along with corresponding source modifications in the form of a patch file is granted with same provisions 2 through 4 for binary distributions.This software is provided "as is" without express or implied warranty to the extent permitted by applicable law. Authors: Original Software: Thomas Williams, Colin Kelley.Gnuplot 2.0 additions: Russell Lang, Dave Kotz, John Campbell.Gnuplot 3.0 additions: Gershon Elber and many others.

ii VERITAS Storage Foundation for Oracle Release Notes

http://www.veritas.com/

Apache Jakarta Lucene

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

VERITAS Storage Foundation for Oracle Release Notes iii

http://www.apache.org/licenses/LICENSE-2.0

iv VERITAS Storage Foundation for Oracle Release Notes

Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Standard and Enterprise Editions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Supported AIX and Oracle Combinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

AIX Operating System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Obtaining a License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Using the VERITAS vLicense Web site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Using the License Key Request Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

VERITAS File System Disk Layout Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Component Product Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

New Commands for the Command Line Interface and Online Manual Pages . . . . . . . 6

New Command Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Fixed Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Known Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Software Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Supporting zero offset volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Copying Oracle files under VxFS file system to JFS file system . . . . . . . . . . . . . . . . 16

Oracle Disk Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Upgrading to VERITAS Storage Foundation for Oracle 4.0 with the VVR license enabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

dbed_vmclonedb command and tempfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Packaging Changes and Setup Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

VERITAS Storage Foundation/HA for Oracle Information . . . . . . . . . . . . . . . . . . . . . . 20

Supported Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

v

Installing Storage Foundation/HA for Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Obtaining the VCS Agent for the Oracle Product . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

No Longer Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Accessing the VERITAS Support Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Subscribing to VERITAS Email Notification Service . . . . . . . . . . . . . . . . . . . . . . . . . 22

Accessing VERITAS Telephone and Fax Support . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Contacting VERITAS Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

The VRTSexplorer Diagnostic Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Downloading VRTSexplorer from the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Installing VRTSexplorer from the Software Disc . . . . . . . . . . . . . . . . . . . . . . . . . 24

vi VERITAS Storage Foundation for Oracle Release Notes

Important Release Information

Introduction This document provides release information for VERITAS Storage Foundation for Oracle, formerly known as VERITAS Database Edition for Oracle. Read this entire document before you install VERITAS Storage Foundation for Oracle.

Standard and Enterprise Editions VERITAS offers two versions of VERITAS Storage Foundation for Oracle:

◆ VERITAS Storage Foundation for Oracle Standard Edition

◆ VERITAS Storage Foundation for Oracle Enterprise Edition

The Enterprise Edition contains everything in the Standard Edition plus Storage Mapping, Database FlashSnap, Storage Checkpoints, and Storage Rollback.

VERITAS Volume Replicator is another option that can be purchased with the VERITAS Storage Foundation for Oracle Enterprise Edition and requires a separate license.

Note VERITAS Storage Foundation/HA for Oracle is available only for the Enterprise Edition.

Supported AIX and Oracle Combinations VERITAS Storage Foundation for Oracle can only be installed on a system running AIX 5.1 with maintenance level 6 or AIX 5.2 with maintenance level 3 with appropriate APARs. Also, make sure the minimum level for XLC.aix50.rte is at 6.0.0.7 or higher before installing VERITAS Storage Foundation for Oracle.

Installing the product on earlier AIX releases will fail. If necessary, upgrade your operating system before you install the VERITAS products.

1

AIX Operating System Requirements

The following table identifies the supported Oracle and AIX combinations for VERITAS Storage Foundation for Oracle :

Supported Oracle and AIX Combinations

Oracle Release AIX 5.1 maintenance level 6 with AIX 5.2 maintenance level 3 with APAR IY56488 APAR IY56497

8.1.7.4 only (32-bit) Yes (32-bit) Yes (32-bit)

9.2.0.2 and above (64-bit) Yes (32- and 64-bit) Yes (32- and 64-bit)

10.1.0.2 (64-bit) No Yes (32- and 64-bit)

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

Note To use the Storage Mapping functionality, you must install Oracle 9.2.0.5 or higher

AIX Operating System Requirements Make sure the following filesets are at the minimum level shown below.

◆ AIX 5.1 maintenance level 6 with APAR IY56488. The minimum fileset levels for bos.mp, bos.mp64, and bos.up are:

bos.mp 5.1.0.60 Base Operating System Multiprocessor Runtimebos.mp64 5.1.0.61 Base Operating System 64-bit Multiproc Runtimebos.up 5.1.0.60 Base Operations System Uniprocessor Runtime

◆ AIX 5.2 maintenance level 3 with APAR IY56497. The minimum fileset levels for bos.mp, bos.mp64, and bos.up are:

bos.mp 5.2.0.32 Base Operating System Multiprocessor Runtimebos.mp64 5.2.0.32 Base Operating System 64-bit Multiproc Runtimebos.up 5.2.0.32 Base Operating System Uniprocessor Runtime

Note For both AIX 5.1 and 5.2, the XLC.aix50.rte patch must be at level 6.0.0.7 or higher. To obtain this patch, contact IBM or go to the IBM Web site at http://www.ibm.com and search for the patch in the “Support and Downloads” section.

For the latest information on software updates, patches, and other issues regarding this release, refer to the following TechNote on the VERITAS Technical Support Web site:

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

2 VERITAS Storage Foundation for Oracle Release Notes

http://www.ibm.com

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

Obtaining a License Key

Obtaining a License Key VERITAS Storage Foundation for Oracle is a licensed product. When you purchase VERITAS products, you receive a license key, which is required during installation. VERITAS Storage Foundation for Oracle requires one license key for all the software packages included with the product and any optional features you may have purchased.

If you are upgrading from a previous version of VERITAS Database Edition for Oracle and have not purchased any new options, you do not need to obtain a new license. However, you will need to install the license utility package, VRTSvlic. See the VERITAS Storage Foundation for Oracle Installation Guide for details.

If you already have an evaluation license key, you need to obtain a permanent license key when you purchase the product.

To access VERITAS Storage Foundation for Oracle Enterprise Edition functions you must also get a new license key.

Note You must obtain your license key before using this product.

You can obtain your license key through the VERITAS vLicense Web site or by completing a License Key Request Form.

Using the VERITAS vLicense Web site You can obtain your license key through the VERITAS vLicense Web site. To use the Web site, make sure you have your customer number, order number, and serial number.

▼ To obtain a license key using the Web site

1. Use a web browser to access the VERITAS vLicense Web site.

http://vlicense.veritas.com

2. Create a new login using your customer number, order number, and serial number.

If you already have an account, you can simply log in.

3. Follow the instructions on the Web site.

You should receive your license key shortly. After receiving your license key, you can install the product.

Note For more information, see the Getting Started Guide.

VERITAS Storage Foundation for Oracle Release Notes 3



Obtaining a License Key

Using the License Key Request Form You can also obtain a license key using the License Key Request Form. You should have received this form when you purchased the product. The form is not shipped with the product. Contact your sales channel if you did not receive a License Key Request Form. To obtain a license key, contact VERITAS by phone or complete the License Key Request Form and send it to VERITAS:

◆ Phone: 1-800-634-4747 option 3

◆ Email: [email protected]

◆ Fax: 1-650-527-0952

▼ To obtain a license key using the License Key Request Form

1. Complete the License Key Request Form.

The License Key Request Form requires you to provide your system’s host ID and machine type. You can obtain the host ID using the following command:

# /usr/bin/uname -m

You should see output similar to the following:

000C80FF4C00

When providing the host ID to VERITAS to receive a license key, provide the number without the first two and last two characters (for example, 0C80FF4C).

You can obtain the machine type using the following command:

# /usr/bin/uname -MIBM,7044-170

2. Fax or email the form to VERITAS.

◆ Email: [email protected]

◆ Fax: 1-650-527-0952

VERITAS will send you a license key by return fax or email.

During installation, you are prompted for the license key. If the software is already installed and you are upgrading or replacing an evaluation license with a permanent license, follow the instructions that accompany the license key to replace the old license with the new one.

Note Make a note of your license key somewhere other than on the computer, so that the key is available if the system becomes unbootable or requires reinstallation.


New Features

New Features New or enhanced features specific to VERITAS Storage Foundation 4.0 for Oracle include:

◆ New versions of the following component products:

● VERITAS File System™ (VxFS) with Quick I/O for Databases, QuickLog, and Storage Checkpoints

● VERITAS Volume Manager™ (VxVM)

● VERITAS Enterprise Administrator™ (VEA)

◆ VERITAS Database FlashSnap

VERITAS Database FlashSnap is an additional option, for the Enterprise Edition, that requires a separate license.

◆ Storage Mapping

Storage Mapping is an additional option, for the Enterprise Edition, that requires a separate license.

◆ New Common Product Installer

This release of VERITAS Storage Foundation for Oracle contains a common product installer, installer, which simplifies the installation of VERITAS products. See the VERITAS Storage Foundation for Oracle Installation Guide and the Getting Started Guide for information on using the common product installer.

For details on these new VERITAS Storage Foundation for Oracle features, as well as an overview of the new features provided through the component products, see the VERITAS Storage Foundation for Oracle Database Administrator’s Guide.

VERITAS File System Disk Layout Changes VxFS 4.0 file systems employ disk layout Version 6. With this release, you can no longer create or mount Version 1 or Version 2 disk layout file systems. This is the last major release to support disk layout Version 4. VERITAS recommends upgrading any previously installed VxFS file system to the Version 6 disk layout available with this release. To upgrade to a new disk layout, see the “Upgrading VxFS Disk Layouts” section of the VERITAS Storage Foundation for Oracle Installation Guide.

With VxFS 4.0, you can use Versions 5 and 6, which can support files and file systems up to 32 TB in size and Version 6 supports up to 8 exabytes (2 63) in size.


Component Product Release Notes

Component Product Release Notes In addition to reading these Release Notes before you install VERITAS Storage Foundation for Oracle, it is also important that you read all the component product Release Notes. The component product Release Notes are on the VERITAS product disc in the storage_foundation_for_oracle/release_notes directory.

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

New Commands for the Command Line Interface and Online Manual Pages

The following VERITAS Storage Foundation for Oracle commands and corresponding online manual pages have been added:

Command Name Description

qio_recreate

vxstorage_stats

dbed_vmclonedb

dbed_vmsnap

Automatically recreates Quick I/O files after the database is recovered. The command creates all the necessary Quick I/O files before they are restored. The command expects to find a file named mkqio.dat in the directory where the qio_recreate command is run. The mkqio.dat file contains a list of the Quick I/O files used by the database and their sizes. If the mkqio.dat file is not in the directory, you will be prompted to create it using qio_getdbfiles. After creating mkqio.dat, you will be able to run the qio_recreate command successfully.

Prints I/O mapping and statistics about one or more VERITAS File System files. The statistics are recorded only for VxFS files and VxVM volumes. These statistics show I/O activity.

Creates or shuts down a clone database using snapshot volumes from a primary database.

Creates or resynchronizes a snapshot image of an Oracle database. This command also allows you to reverse resynchronize a snapshot image of an Oracle database.


New Command Names

Command Name Description

dbed_vmchecksnap Creates and validates the snapplan used to create a clone database. The command can also be used to list, remove, and copy snapplans.

For more information on these commands, see the VERITAS Storage Foundation for Oracle Database Administrator’s Guide.

New Command Names With this release of VERITAS Storage Foundation for Oracle, the following commands have been renamed:

Former Name New Name

vxckpt_create

vxckpt_display

vxckpt_mount

vxckpt_plan

vxckpt_remove

vxckpt_rollback

vxckpt_umount

vxdba

dbed_ckptcreate

dbed_ckptdisplay

dbed_ckptmount

dbed_ckptplan

dbed_ckptremove

dbed_ckptrollback

dbed_ckptumount

dbed_vxdba


Fixed Issues

Fixed Issues The following VERITAS Storage Foundation for Oracle fixes are included in this release:

Incident Description

34201 In the previous release, when restoring database files, Quick I/O files were not recreated automatically. This issue is resolved.

34295 Previously, you were not able to roll back a tablespace or datafile to a Storage Checkpoint using the GUI. This has been fixed in this release.

75741 Previously, error messages or informational messages that only allowed you to click OK to continue did not contain a mnemonic. To continue without using a mouse, you were required to press Enter on your keyboard to close the message. With this release, this issue has been corrected.

85155 In the earlier release, some Storage Checkpoint Capacity Planning messages were not internationalized. This issue is fixed in this release.

86431 Earlier, you were required to run the dbed_update command after upgrading to VERITAS Storage Foundation 4.0 for Oracle from a previous release. This allowed you to roll back to a Storage Checkpoint that was created prior to this release. This has been fixed.

86526 When Storage Foundation for Oracle removed a Storage Checkpoint based on your Storage Checkpoint Policy settings, the directory in which the Storage Checkpoint resided was not removed. This issue has been fixed in this release.

87408 In the previous release, if you tried to shut down the database in the GUI and the operation failed, the tablespaces for that database appeared to be offline. You were required to perform a rescan of the database or the tablespaces. This issue has been fixed.

104310 Debugging messages would appear in the VEA console when Storage Checkpoint related-operations were performed from the GUI. These debugging message have been removed.

104315 Selecting Resync Repository to refresh the GUI after dropping a database would result in unexpected error messages. This has been fixed.


Known Issues


110282 If you attempted to roll back an up-and-running database to an online Storage Checkpoint, the GUI would display an incorrect message stating that file or tablespace Storage Rollback options are available. This message has been corrected.

Known Issues ◆ If you create an Oracle instance using the spfile option, you must run the

dbed_update command before you can successfully perform any Storage Checkpoint or Database FlashSnap functions.

◆ When Oracle Disk Manager (ODM) is enabled for an Oracle instance, you cannot back up the database to a VxFS file system directly using RMAN (Oracle Bug reference number 238523). However, you can back up to a tape or JFS file system using RMAN. This is a Known Issue on Oracle9i Release 2 only.

If you are running Oracle9i Release 2 and using RMAN to perform “disk to disk” backup, you must install the Oracle patch set that includes the fix to this problem.

Without installing the Oracle patch set, you can backup to a VxFS file system only if you are using one of the SBT implementations, such as VERITAS NetBackup. In this scenario, the backup image files are managed by VERITAS NetBackup’s Media Manager.

◆ The manual pages for qio_convertdbfiles and qio_getdbfiles are identical. For qio_convertdbfiles, please refer to the manual page for qio_getdbfiles.

◆ The EMC Symmetrix VAIL provider can dump core if the following conditions occur:

◆ A Symmetrix device (symdev=xyz) has two or more bindings.

◆ The host running the EMC Symmetrix VAIL provider has multi-pathed access to the device through all the Symmetrix ports it is bound to (for example, the host's adapters are connected to all the ports the device is bound to and the device is masked to the host appropriately. So, if there are 'n' bindings on the device, the host sees 'n' different OS handles for the same device).

◆ If the principal OS handle to the device (“OSHandle#1”) is a substring of the other n-1 OS handles to the device (“OSHandle#2,” “OSHandle#3”...”OSHandle#n”).

“OSHandle#1” is the OS handle to the device as reported by symdev show xyz, displayed against “Device Physical Name.” “OSHandle#2,” “OSHandle#3,” ..”OSHandle#n” are the other OS handles to the device as shown by symdev show xyz, displayed under “Front Director Paths.”


Known Issues

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

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

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

If the EMC Symmetrix provider cores, do one of the following. The end objective is to have at least one OS handle that violates the substring condition or to have a binding that is not visible to the host:

◆ Create an additional binding on the Symmetrix device xyz, such that the device is not visible to the host running the EMC Symmetrix VAIL provider. Either of the following suffices:

◆ The host is not connected to the port newly bound to

◆ The device is not masked to the host through the port newly bound to

◆ Modify one of the existing bindings, such that the OS handle does not remain a superstring of OSHandle#1. Do one of the following:

◆ Unmask the device from the host for that port

◆ Change the SCSI mappings such that the device is visible to the host as a OS handle that is not a superstring of OSHandle#1.

Example:

In the example below, OSHandle#1 = /dev/rhdisk3, OSHandle#2 = /dev/rhdisk30. OSHandle#1 is a substring of OSHandle#2

====================================================p67a02:{root}:/>./symdev -sid 27 show 0036

Device Physical Name : /dev/rhdisk3Device Symmetrix Name : 0036Device Serial ID : 27036000Symmetrix ID : 000187400527:

<snipped>:Front Director Paths (2):{

POWERPATH DIRECTOR PORT LUN----

PdevName Type Type Num Sts VBUS TID SYMM Host

/dev/rhdisk3 N/A FA 04A:0RW 000 00 001 001/dev/rhdisk30 N/A FA 13A:0RW 000 00 001 001==================================================================

(Internal Reference 221759)


Known Issues

◆ Following are the known issues in this release:


none If you choose to install VERITAS Storage Foundation for Oracle using installp, you must install the VRTSveki package separately or use installp with the -g option.

none When database files or control files consist of VxFS files and non-VxFS files, the dbed_vmchecksnap command does not read the configuration properly. When you run the dbed_vmchecksnap command in a mixed environment, the following error messages are displayed:

DBED4421: ERROR: File ufs is not on a vxfs file system. DBED5643: ERROR: An error occurred while finding device from file list. /dev/vx/dsk/proddg/datavol /usr1/oracle/rw/DATA proddg vxfs rw,suid,delaylog,largefiles,qio,ioerror=mwdisable,dev2c80e9

none If you install the product packages using the installation script, but do not reboot, and then require to remove the packages using the deinstallation script, removal of the VRTSodm and VRTSvxfs packages may fail due to the device being busy. If this happens, exit from the deinstallation script and use the installp -u command to uninstall the packages.

none On a Japanese desktop, VEA may incorrectly display system fonts. Japanese characters may not be properly displayed when you select the non-default font for the VEA GUI.

32726 You cannot create a Storage Checkpoint of a database located on a mounted Storage Checkpoint.

33903 If a mount point is a symbolic link, the space monitoring agent may fail.


Known Issues


34106 Converting a Quick I/O file to a regular file will fail if you created a Quick I/O file for an Oracle datafile that has a smaller size. Oracle generates an error if the size of the regular file is not a multiple of the 2 K database block size (db_block_size). The error message displayed is similar to the following:

*** 2002-08-22 15:11:02.850

*** SESSION ID:(2.1) 2002-08-22 15:11:02.847

ORA-01157: cannot identify/lock data file 51 - see DBWR trace file

ORA-01110: data file 51:'/d05/oradata/rmdb/bill13_data.dbf'

ORA-27046: file size is not a multiple of logical block size

Additional information: 1

To work around this problem, extend the Quick I/O file such that the size is a multiple of both the file system block size and the database block size (db_block_size)

$ qiomkfile -r 2147500032 rbstest01.dbf

$ ls .rbstest01.dbf rbstest01.dbf

-rw-r--r-- 1 oracle dba 2147500032 Apr 3 20:27 .rbstest01.dbf

lrwxrwxrwx 1 oracle dba 26 Apr 3 20:27 rbstest01.dbf -

> .rbstest01.dbf::cdev:vxfs:

$ rm rbstest01.dbf

$ mv .rbstest01.dbf rbstest01.dbf

$ ls rbstest01.dbf

-rw-r--r-- 1 oracle dba 2147500032 Apr 3 20:27 rbstest01.dbf

The database will now start as expected.

34387 If 200 or more files reside in the /dev/rdsk directory, the dbed_filestat command may take a long time to display statistic information.

34433 VxFS disk layouts Version 5 and earlier are not supported with Storage Checkpoints.

If you attempt to retrieve quota information for a Storage Checkpoint in Version 5 or earlier, a message similar to the following displays:

Error number: 4646, Error description: DBED4646:ERROR: Unknown error code -30391108 (getquota) for DBED 46464....


Known Issues


34446 VERITAS Enterprise Administrator and the VxDBA menu utility do not display tablespace information when the v$table column names are changed.

34570 The Database FlashSnap features does not support RAID-5 volumes.

41192 Depending on what you have highlighted in the object tree in the GUI, some tool bar icons are truncated and some are not visible. If this happens, use the menu bar to access the operation you want to execute. This will be fixed in a future release.

87008 If you try to resynchronize the repository using the GUI on a database that has been shut down, you will receive the following error message:

DBED3141: ERROR: Oracle instance $v1 is not running.

The error message is incorrect and should be similar to the following:

DBED3141: ERROR: Oracle instance instance_name is not running.

where instance_name is the name of the Oracle database instance.

105379 Connecting to the localhost on an AIX machine can take a few minutes. This causes a delay and affects the performance of some functions.

To work around this issue, in the file /etc/netsvc.conf insert the following line, hosts = local,nis,bind


Known Issues


123233 Under normal circumstances, a clean-up routine is automatically executed if dbed_vmsnap fails to create a snapshot. However, if dbed_vmsnap fails to create a snapshot because a connection cannot be established with the VEA service (vxsvc), the clean up routine is not executed.

If dbed_vmsnap fails because it cannot connect to the VEA service, the following error message will appear:

Failed to connect to local object bus server.

In this event, you must manually recover the snapshot volumes by joining the split disk group back with the primary disk group and resynchronizing it with the primary database.

To manually recover the snapshot volumes:

1. If the primary database is in backup mode, take it out of backup mode.

2. If the snapshot disk group is split, join it back to the primary disk group: # vxdg join snapshot_diskgroup primary_diskgroup

3. Recover the snapshot volumes: # vxrecover -g primary_diskgroup -m snapshot_volume

4. Reattach every snapshot volume back to its original volume: # vxsnap -g primary_diskgroup reattach snapshot_volumes source=original_volume

5. After the snapshot volumes have been synchronized, re-run the dbed_vmsnap command using the -F option.

125578 You cannot remove a volume after the storage mapping PL/SQL procedure is run on a datafile.

Even though the contents of map_element are appropriate, the tablespace is dropped and the file system is unmounted. The database is not using any files residing on this file system. And, the removal of the volume using vxassist fails.

After storage mapping, perform the following steps to remove a volume:

1. Set file_mapping to false. # alter system set file_mapping=false

2. Make sure that the fmon process is not running. # ps -fu oracle | grep fmon

3. Run fuser on file system and make sure that no process is attached to the file system. # fuser -c /tbs1

4. Unmount the file system. # umount /tbs1

5. Remove the volume using vxassist. # vxassist -g testdg remove volume tbs1


Known Issues


129887 VERITAS Storage Foundation for Oracle does not support Japanese datafiles, names, and tablespace names. Also, Japanese SID for clone database when using dbed_clonedb and dbed_vmclonedb is not supported.

217003 If you install VERITAS Storage Foundation for Oracle and VERITAS Storage Foundation for DB2 on the same machine using an alternative method of installation (installation methods other than the VERITAS product installer or the installation script), you will receive multiple warning messages. It is safe to ignore these warning messages.

217441 To upgrade to VERITAS Storage Foundation for Oracle 4.0 from a previous version, using an alternative method, before starting upgrade perform the following steps:

1. Stop the VEA service manually using the following command: # /etc/rc.d/rc2.d/K50isisd

2. Install the VRTSveki package manually before installing the rest of the packages. # installp -acXd VRTSveki.bff VRTSveki

3. Proceed with the SMIT installation.

218987 Rescanning of the Oracle database instance does not work via the GUI. When the Oracle database instance is started and a Rescan operation is performed from the GUI, nothing happens. The Confirmation dialog is displayed immediately and the instance appears to be offline.

219607 You cannot use the Page Update or Print function in the GUI; using either of these functions results in an error.

221891 In the Topology/Statistics window of the GUI, the units for the Offset column are incorrectly labeled as KB or MB. The units refer to sectors, not bytes.


Software Notes

Software Notes

Supporting zero offset volumes To make VxVM raw volumes compatible with LVM, Oracle skipped the first 4 KB of VxVM raw volume. The Oracle header block started at an offset of 4 KB of the raw volume. For databases that have a db_block_size larger than 4 KB, this caused misaligned I/O at the stripe boundary of a striped volume. For example, for a database with db_block_size of 16 KB, a raw volume with stripe layout and stripe width 32 KB, every other db_block spanned two LUNS/disks.

To solve the misaligned I/O issue, AIX introduced a new volume with devsubtype, DS_LVZ, for Oracle 9iR2. These volumes are 'z' type LVM volumes. Oracle 9iR2 and later recognize the 'z' volumes and do not skip the first 4 KB in the volume.

VxVM was also enhanced and introduced a volume with devsubtype, DS_VMZ, for Oracle 9iR2. These volumes are 'o' type VxVM volumes. Oracle is now enhancing 9iR2 and 10g to recognize the 'o' VxVM volumes for which a patch (from Oracle) is required. The reference bug number for this Oracle patch is 3712203.

For more information about migrating to the 'o' type VxVM raw volumes, please contact VERITAS Customer Support and refer to incident 223668.

▼ To convert regular raw LVM Oracle datafiles to regular VxVM raw volumes

Copy the data using the dd command. For example,

# /usr/bin/dd if=/dev/lvm_raw_volume of=/dev/vx/oradg/raw_volbs=4k skip=1 seek=1

▼ To convert 'z' raw LVM Oracle datafiles to regular VxVM raw volumes

Skip the first 4 KB on VxVM and then copy the data. For example,

# /usr/bin/dd if=/dev/lvm_raw_volume of=/dev/vx/oradg/raw_volbs=4k seek=1

Copying Oracle files under VxFS file system to JFS file system If you use cp, mv, or cpio to copy or move a file with extent attributes from a VxFS to a JFS or JFS2 file system, the file is copied to the target without preserving the extent attributes of the source file.

Extent attributes can be preserved when the source and target files are both in VxFS file systems. On AIX, extent attributes are supported attributes with files in VxFS file systems only.


Software Notes

The following is an example of using the cp command to copy a VxFS file system file (db01.f on file system /oradata) to a target non-VxFS file system (/bkup):

# cp /oradata/db01.f /bkup/db01.f

Even though the file with extent attributes is copied or moved to the target non-VxFS file system, the cp, mv, or cpio commands display the following output:

cp: 0653-445 can not maintain extent attributes for db01.f

To avoid this output, which is not an error message, use the -E ignore option with cp, mv, or cpio commands. For example,

# cp -E ignore /oradata/db01.f /bkup/db01.f

Oracle Disk Manager Because Oracle Disk Manager uses the Quick I/O driver to perform asynchronous I/O, do not turn off the default Quick I/O mount option.

Upgrading to VERITAS Storage Foundation for Oracle 4.0 with the VVR license enabled

If you are upgrading to VERITAS Storage Foundation 4.0 for Oracle from a previous version of VERITAS Database Edition for Oracle with the VVR license enabled, you are required to install the latest patch for VM/VVR for AIX 1.2. Please contact customer support for the latest patch.

dbed_vmclonedb command and tempfiles Previously, when a clone database was brought up, the tempfiles were not created. As a result, operations requiring a temporary tablespace (TEMP) would fail. This issue has been fixed. Now, when a clone database is recovered and opened, the tempfiles are added if they were residing on the snapshot volumes.

If, however, the tempfiles were not residing on the same filesystems as the datafiles, the underlying volumes were not included in the snapshot. In this case, a warning message is issued and no tempfiles are added because no storage is provided by the snapshot where the tempfiles could reside.

In this scenario, you must add the tempfiles as needed. A script named add_tf.$ORACLE_SID.sql is provided in the /tmp directory for the purpose of recreating Oracle tempfiles. This script contains the SQL*Plus commands to recreate the missing tempfiles.


Packaging Changes and Setup Requirements

Please refer to the section “Recreating Oracle tempfiles" in the “Using Database FlashSnap for Backup and Off-Host Processing” chapter of the VERITAS Storage Foundation for Oracle Database Administrator’s Guide for complete information.


VERITAS Extension for Oracle Disk Manager

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

VERITAS Extension for Oracle Disk Manager requires VERITAS Volume Manager release 3.2 or later.

Online Documentation

VERITAS no longer ships hardcopy documentation with its products. However, Adobe Portable Document Format (.pdf) files of the following documents are supplied:

◆ VERITAS Storage Foundation for Oracle Release Notes (this document)

◆ VERITAS Storage Foundation for Oracle Installation Guide

◆ VERITAS Storage Foundation for Oracle Database Administrator’s Guide

◆ VERITAS Array Integration Layer Configuration Guide

◆ VERITAS Storage Foundation Release Notes

◆ VERITAS Volume Manager Administrator’s Guide

◆ VERITAS Volume Manager User’s Guide - VERITAS Enterprise Administrator

◆ VERITAS Volume Manager Intelligent Storage Provisioning Administrator's Guide

◆ VERITAS FlashSnap Point-In-Time Copy Solutions Administrator’s Guide

◆ VERITAS Volume Manager Cross-platform Data Sharing Administrator’s Guide

◆ VERITAS Volume Manager Troubleshooting Guide

◆ VERITAS Volume Manager Hardware Notes

◆ VERITAS File System Administrator’s Guide



You have the option to install the VERITAS Storage Foundation for Oracle documentation, which exists in three documentation packages. If you are installing the documentation packages, the /opt directory must exist and be writable. See the following table for installation information:

Contents of the Documentation Packages

Documentation Package Contents Installation Location

VRTSordoc VERITAS Storage Foundation for Oracle documentation

/opt/VRTS/docs

VRTSvmdoc VERITAS Volume Manager documentation

/opt/VRTS/docs

VRTSfsdoc VERITAS File System documentation /opt/VRTS/docs

Note The documentation disc also contains documentation, in PDF and HTML formats, for all products included on the media discs.

The Release Notes are not installed with the documentation packages. See “Component Product Release Notes” on page 6 for more information.

The Installation Guide is not installed with the documentation packages. A PDF file of the VERITAS Storage Foundation for Oracle Installation Guide is located on the product disc under the storage_foundation_for_oracle/docs directory and on the documentation disc under the storage_foundation_for_oracle directory.

The rest of the documentation is located on the documentation disc under the storage_foundation_for_oracle directory.


VERITAS Storage Foundation/HA for Oracle Information

The names of the following documents have changed from previous versions. Please be aware that the new file names are:

◆ sf_ora_ig.pdf - PDF version of the VERITAS Storage Foundation for Oracle Installation Guide

◆ sf_ora_dbag.pdf - PDF version of the VERITAS Storage Foundation for Oracle Database Administrator’s Guide

◆ sf_ora_notes.pdf - PDF version of the VERITAS Storage Foundation for Oracle Release Notes

Note VERITAS Volume Manager and VERITAS File System documentation is included with the VERITAS Storage Foundation for Oracle documentation on the documentation disc, under the storage_foundation_for_oracle directory.

VERITAS Storage Foundation/HA for Oracle Information VERITAS Storage Foundation/HA (VCS) for Oracle is available for database administrators with high availability needs. In addition to the VERITAS products included in the base VERITAS Storage Foundation for Oracle, VERITAS Storage Foundation/HA (VCS) for Oracle incorporates the following products:

◆ VERITAS Cluster ServerTM (VCS)

◆ VERITAS Cluster Server (VCS) Enterprise Agent for Oracle

Note VERITAS Storage Foundation/HA for Oracle is available only for the Enterprise Edition.

Supported Software ◆ AIX 5.1 maintenance level 6 with APAR IY56488

◆ AIX 5.2 maintenance level 3 with APAR IY56497

◆ VERITAS Volume Manager (VxVM) 4.0 or later

◆ VERITAS File System (VxFS) 4.0 or later


VERITAS Storage Foundation/HA for Oracle Information

Installing Storage Foundation/HA for Oracle The VERITAS software discs have an automated installation and licensing procedure that lets you install packages using the VERITAS product installer instead of installing from the command line. The Getting Started Guide, included with the VERITAS software discs, provides complete information on using the VERITAS product installer. Review the Getting Started Guide before installing VERITAS Storage Foundation for Oracle or VERITAS Storage Foundation/HA for Oracle.

Alternatively, you can go to the storage_foundation_for_oracle/pkgs directory on the product disc and install the individual component products using the installp command. Go to the cluster_server/pkgs directory on the appropriate product disc to install the HA functionality using the command line.

Review the individual product installation guides before starting the installation.

▼ To use the VERITAS product installer to install VERITAS Storage Foundation/HA for Oracle

1. Log in as root.

2. Insert the product disc that contains VERITAS Storage Foundation for Oracle into the CD-ROM drive and invoke the installer:

# mkdir /mnt# mount –V cdrfs –o ro /dev/cd0 /mnt# cd /mnt# ./installer

Choose Storage Foundation for Oracle from the list of products and follow the prompts you receive during installation.

3. After the installation completes, choose Cluster Server from the list of products.

This will complete the installation.

The VERITAS Cluster Server documentation explains the installation procedures for both VERITAS Cluster Server and the appropriate agents. The documentation is located on the documentation disc.

Obtaining the VCS Agent for the Oracle Product The VCS agent, VERITAS Cluster Server Oracle Enterprise Extension, is supplied with the VCS agents on the appropriate media disc that came with your software. You can access it from the /cluster_server_agents/oracle_agent directory.


No Longer Supported

No Longer Supported ◆ 4.0 is the last major release of VERITAS Storage Foundation for Oracle to support the

text-based VxDBA menu interface.

◆ 4.0 is the last major release of VERITAS Storage Foundation for Oracle to support the VERITAS Space Capacity Planning utility for Storage Checkpoints.

Getting Help VERITAS offers you a variety of support options.

Accessing the VERITAS Support Web Site The VERITAS Support Web site allows you to:

◆ contact the VERITAS Support staff and post questions to them

◆ get the latest patches, upgrades, and utilities

◆ view the VERITAS Storage Foundation for Oracle Frequently Asked Questions (FAQ) page

◆ search the knowledge base for answers to technical support questions

◆ receive automatic notice of product updates

◆ find out about VERITAS Storage Foundation for Oracle training

◆ read current white papers related to VERITAS Storage Foundation for Oracle

The address for the VERITAS Support Web site is:

◆ http://support.veritas.com

Subscribing to VERITAS Email Notification Service Subscribe to the VERITAS Email notification service to be informed of software alerts, newly published documentation, Beta programs, and other services.

Go to http://support.veritas.com. Select a product and click “Email Notifications” on the right side of the page. Your customer profile ensures you receive the latest VERITAS technical information pertaining to your specific interests.


http://support.veritas.com


Getting Help

Accessing VERITAS Telephone and Fax Support Telephone support for VERITAS Storage Foundation for Oracle is only available with a valid support contract. To contact VERITAS for technical support, dial the appropriate phone number listed on the Support Guide included in the product box and have your product license information ready for quick navigation to the proper support group.

The address for the VERITAS telephone support directory is:

◆ http://support.veritas.com

Contacting VERITAS Licensing For license information call 1-800-634-4747 option 3, fax 1-650-527-0952, or email [email protected].

The VRTSexplorer Diagnostic Program The VRTSexplorer program is available to assist VERITAS Customer Support engineers in diagnosing technical problems associated with VERITAS products. You can download this program from the VERITAS FTP site or install it from the VERITAS product disc. For more information about the VRTSexplorer program, consult the README file located in the top-level support directory.

Downloading VRTSexplorer from the Web

▼ To download VRTSexplorer

1. Use a web browser or the ftp program to download the VRTSexplorer program from the following URL:

ftp://ftp.veritas.com/pub/support/vxexplore.tar.Z

Save the file to a temporary directory, such as /tmp, as shown in the example below.

2. Log in as root on the system that is experiencing the problem. Extract the contents of the downloaded file to the directory /tmp/VRTSexplorer:

# cd /tmp# zcat vxexplore.tar.Z | tar xvf -

3. Run the VRTSexplorer program located in the VRTSexplorer directory:

# /tmp/VRTSexplorer/VRTSexplorer



ftp://ftp.veritas.com/pub/support/vxexplore.tar.Z

Getting Help

4. When VRTSexplorer prompts for a destination directory for the information that it collects, press Return to accept the default directory /tmp, or enter an alternative path name of your own choice. VRTSexplorer writes the results of its analysis to a compressed tar file named VRTSexplorer_casenumber_hostname.tar.Z in the specified directory.

5. Use the file upload facility of your web browser or the ftp program, to transfer the VRTSexplorer output file to the VERITAS Customer Support anonymous FTP site:

ftp://ftp.veritas.com/incoming

6. Telephone VERITAS Technical Support at the number listed under “Getting Help” on page 22. Tell them that you have run VRTSexplorer and provide the name of the file that you transferred to the FTP site.

Alternatively, if you are already assigned a call ID number by Customer Support, send an email to [email protected] and include your case ID number in the subject line.

Installing VRTSexplorer from the Software Disc

The VRTSspt.bff package is included on the product disc in the top-level support directory.

▼ To Load the Software from the Disc

1. Log in as superuser.

2. Place the VERITAS software disc into a CD-ROM drive connected to your system.

3. After inserting the disc, create a directory:

# mkdir -p /cdrom

4. Mount the directory:

# mount -V cdrfs -o ro /dev/cd0 /cdrom

5. Move to the support directory and install the VRTSspt package:

# cd /cdrom/support# installp -acX -d VRTSspt.bff VRTSspt

6. The program is installed in the /opt/VRTSspt directory. To run the program, enter:

# /opt/VRTSspt/VRTSexplorer/VRTSexplorer



Getting Help

7. Use the file upload facility of your web browser, or the ftp program, to transfer the VRTSexplorer output file to the VERITAS Technical Support anonymous FTP site:


8. Telephone VERITAS Technical Support at the number listed under “Getting Help” on page 22. Tell them that you have run VRTSexplorer and provide the name of the file that you transferred to the FTP site.

Alternatively, if you have already been assigned a call ID number by VERITAS Technical Support, send email to [email protected] and include your case ID number in the subject line.


Getting Help


Documents

Storage Foundation for Oracle Release Notesstatic-sort.symanteccloud.com/public/documents/sfha/4.0/aix/... · Export of this software from the United States of America may require