Oracle® Database

Oracle Real Application Clusters Installation and Configuration Guide

The Oracle Real Application Clusters Installation and Configuration Guide has been revised. You can download a copy of the revised book, part number B10766-04, from the Documentation section of the OTN Web site:

http://otn.oracle.com/documentation

Oracle CRS Installation on an Oracle9i RAC Cluster

If you install Oracle CRS on a system that also contains an Oracle9i Real Application Clusters (RAC) cluster, you must reboot all of the Oracle CRS nodes. You can reboot the nodes one at a time to avoid affecting any Oracle9i databases that may be in use.

Oracle assumes that when you install Oracle CRS 10g software, you will also install Oracle Real Application Clusters 10g. If there will be a significant delay before you perform phase two of the RAC installation to install Oracle Real Application Clusters 10g, then run the /crs_home/bin/gsdctl start command to start the GSD manually to service the 9.2 SRVCTL tool and assistants. Then before installing Oracle Real Application Clusters 10g, run the /crs_home/bin/gsdctl stop command to stop the GSD.

Oracle CRS Silent Installation

If you perform a silent installation of Oracle CRS on multiple nodes, on a system that does not have other Oracle installations, the Installer does not set up the Oracle Inventory correctly. In this case, after the installation is complete, follow these steps:

1. Run the orainstRoot.sh script on a local node.

2. Copy the oraInventory directory from the local node to each of the remote nodes.

3. Log in as the root user and run the following script on each remote node:

   oraInventory/orainstRoot.sh
   

Oracle CRS Installation Errors Caused by stty Commands

During an Oracle CRS installation, the Installer uses SSH (if available) to run commands and copy files to the other nodes. During the installation, you might see errors similar to the following if a "dot" file on the system (for example, .bashrc or .cshrc) contains stty commands:

 stty: standard input: Invalid argument 
 stty: standard input: Invalid argument 

To avoid this problem, Oracle recommends that you modify these files to suppress all output on STDERR, as follows:

• Bourne, Bash, or Korn shell:

  if [ -t 0 ]; then
     stty intr ^C
  fi
  
  

• C shell:

  test -t 0
  if ($status == 0) then
     stty intr ^C
  endif
  

This issue is tracked through Oracle bug 3414362.

Silent Installations that Use Automatic Storage Management

You cannot use the silent installation method to install Oracle Database 10g and create a database that uses Automatic Storage Management (ASM) for database storage during the same installation. This is because the root.sh script must run before the Database Configuration Assistant (DBCA) can start an ASM instance.

If you want to use the silent installation method to install Oracle Database 10g and create a database that uses ASM, follow these steps:

1. Use the enterprise.rsp response file to complete a software-only installation.

2. Run $ORACLE_HOME/root.sh after the installation completes.

3. Use the dbca.rsp response file to run DBCA in silent mode, using a command similar to the following:

   $ $ORACLE_HOME/bin/dbca -silent -responseFile /full_path/dbca.rsp
   

ASM Instance Clean Up Procedures for Node Deletion

To remove the ASM instances, the delete node procedure requires the following additional steps on UNIX-based systems:

1. If this is the Oracle home from which the per-node listener named LISTENER_nodename runs, then use NetCA to remove this listener and its CRS resources. If necessary, re-create this listener in another Oracle home.

2. If this is the Oracle home from which the ASM instance runs, then enter the following commands to remove the ASM configuration:

   $ srvctl stop asm -n node
   $ remove asm -n node
   
   

3. If you are using a cluster file system for your ASM Oracle home, then run the following commands on the local node:

   $ rm -r $ORACLE_BASE/admin/+ASM
   $ rm -f $ORACLE_HOME/dbs/*ASM*
   
   

4. If you are not using a cluster file system for your ASM Oracle home, then run the rm commands listed in the previous step on each node on which the Oracle home exists.

5. Remove oratab entries beginning with +ASM.

Backing Up the Voting Disk after Installing RAC

After installing Oracle RAC 10g and after ensuring that the system is functioning properly, make a backup of the voting disk. In addition, make a backup of the voting disk contents after you complete any node additions or node deletions and after running any de-installation procedures.

Remote Undo Tablespaces Do Not Autoexetend in RAC Seed Databases

If you create a RAC database with two or more instances and you choose to create General Purpose, Transaction Processing, or Data Warehouse databases, and if you use a shared cluster file system or Automatic Storage Management (ASM) for database files, then the Database Configuration Assistant (DBCA) creates undo tablespace datafiles with an initial size of 25 MB and AUTOEXTEND ON for the local instance but AUTOEXTEND OFF for remote instances.

You can set AUTOEXTEND ON for undo tablespace datafiles for remote instances after creating a RAC database using DBCA as follows:

1. Connect to the database instance on the node from which you ran DBCA:

   $ sqlplus "/ AS SYSDBA"
   
   

2. Enter the following command to find the datafile names for UNDOTBS tablespaces for remote instances:

   SQL> SELECT file_name FROM SYS.DBA_DATA_FILES
        WHERE tablespace_name LIKE 'UNDOTBS%' AND AUTOEXTENSIBLE='NO';
   
   

3. Set AUTOEXTEND ON for the datafiles that you found in the previous step:

   SQL> ALTER DATABASE DATAFILE datafile_name AUTOEXTEND ON;
   
   

Upgrading a Database

If you choose the Custom installation path and have previous versions of Oracle databases installed, then the Oracle Universal Installer gives you the option of upgrading the existing databases. If you choose to upgrade an existing database, the Oracle Universal Installer displays another screen asking whether you want to create a starter database.If you choose to create a starter database, the DBCA upgrades the older version of the database to Oracle Database 10g release 1 (10.1), but does not create a starter database.

Upgrading an Oracle9i Database to Oracle Database 10g

If you upgrade an Oracle9i database to Oracle Database 10g release 1, Oracle Flashback features using a timestamp may fail. To work around this problem, enter the following SQL script from the Oracle Database 10g database:

SQL> DELETE FROM smon_scn_time WHERE orig_thread <> 0;
SQL> COMMIT;

This issue is tracked with Oracle bug 3994270.

Upgrading Oracle9i Release 2 (9.2) to Oracle Database 10g

On Tru64 UNIX systems, before upgrading Oracle9i release 2 (9.2) to Oracle Database 10g, do the following:

1. Review Oracle bug 2586417.

2. If necessary, contact Oracle Support Services for assistance with the instructions in this bug.

Upgrading OPS Release 8.1.7 to Oracle RAC 10g

Before upgrading OPS release 8.1.7 to Oracle RAC 10g, perform the following steps:

1. Contact Oracle Support Services to optain an upgrade patch.

2. Install the patch in the OPS release 8.1.7 home directory.

3. Enter the following command to list the nodes in the Oracle RAC 10g installation:

   $ /oracle10g_home/bin/lsnodes -n 
   
   

4. If necessary, e dit the /oracle817_home/ops/conf/db_name.conf file to ensure that the node numbers listed in the node_list parameter correspond to the node numbers for the same nodes listed by the lsnodes -n command.

In the following example, OPS release 8.1.7 is installed on two cluster nodes, patruoq3 and patruoq4, and the database name is u817:

1. Change directory to the oracle10g_home/bin directory and enter the following command:

   $ lsnodes -n
   
   

   This command returns the following output:

   patruoq3        3 patruoq1        1 patruoq2        2 patruoq4        4 
   
   

2. Enter the following command to view the contents of the $ORACLE_HOME/ops/conf/u817.conf:

   $ cat $ORACLE_HOME/ops/conf/u817.conf 
   
   

   This command returns the following output:

   node_list = "1,2" inst_oracle_sid = (u8171,u8172) lsnr_listener_name = "LISTENER1" 
    
   

3. Compare the output from step 1 and step 2.

   In this example, the node_list parameter in the u817.conf file has the value "1,2", and the node numbers of patruoq3 and patruoq4 are 3 and 4.

4. Change the value of the node_list parameter in the u817.conf file to "3,4".

This issue is tracked through Oracle bug 3518091.

Net Configuration Assistant Help

In the Net Configuration Assistant (NetCA) help, the link to the Select Oracle Context help topic is broken. The text for this topic is as follows:

Directory Usage Configuration, Select Oracle Context

Oracle administrative content has been found in more than one location in the directory. Oracle administrative content is stored in an Oracle Context, a subtree in the directory that stores Oracle entries.

From the list, select or enter the location you want to use as the default Oracle Context location from which this computer will access Oracle entries, such as connect identifiers.

Flashback Table or Flashback Analysis

If a user invokes the Flashback Table or Flashback Analysis operation, and that user has FLASHBACK ANY TABLE privileges but does not have specific flashback privileges on the objects that flashback is invoked on and does not have DBA privileges, then the following errors may occur:

ORA-02002: error while writing to audit trail 
ORA-00600: internal error code, arguments: [kzasps1], [4], [47], [],[],  

To fix this problem, as SYSDBA grant the user FLASHBACK privilege on the objects that are referred to in the FLASHBACK TABLE statement and then invoke the flashback operation.

For example:

SQL> GRANT FLASHBACK ON SCOTT.EMP_1 TO user1;

This issue is tracked through Oracle bug 3403666.

Oracle Workflow

Although Oracle Workflow is listed on the Companion CD installation screens, it is not included on the Companion CD for this release.

Enabling Automated Backups

While installing Oracle Database, the Specify Backup and Recovery Options screen may appear truncated if your system does not have the required fonts installed. If your system has only fixed-width fonts, you may not be able to fully specify the required information in the Backup Job Credentials area of the screen. To work around this issue, do not select Enable Automated Backups on this screen. After the installation is complete, use the Oracle Enterprise Manager 10g Database Control to enable automated backups.

Oracle Internet Directory

This release includes the Oracle Internet Directory (OID) client tools, but it does not include OID server components. OID server components are included with Oracle Application Server 10g. If you require the OID server tools for Oracle Database components, then run them from an Oracle Application Server 10g installation.

The OID client tools include:

• LDAP command-line tools

• Oracle Internet Directory SDK

• Oracle Directory Manager

The OID server components include the following servers and tools for starting and stopping them:

• Directory server

• Directory replication server

• Directory integration server

Error When Viewing Period SQL Execution Plan in Korean

Viewing the execution plan of a Period SQL in Korean causes an internal server error. This problem is unique to Korean; it does not reproduce in Japanese or Chinese. The only workaround currently available is to run the product in a language other than Korean when you need to view this page.

Quick Tour Not Available in Oracle Change Management Pack

Quick Tour is not available in Oracle Change Management Pack. If you try to run it, then an error results.

extjob Executable Required Directory Permissions

To enable the extjob executable to locate required libraries, the $ORACLE_HOME/lib directory and all of its parent directories must have execute permissions for group and other.

Grid Features

Oracle Database New Features for Oracle Database 10g release 1 (10.1) lists two Grid features that are not available in the first release of Oracle Database 10g; Resonance and Transparent Session Migration. These features will be available in a future release.

Oracle DCE Integration

Oracle DCE Integration requires DCE 4.3.1 or later.

exec_disable_arg_limit Attribute

In addition to the attributes listed in the Oracle Database Installation Guide for UNIX Systems and the Oracle Database Quick Installation Guide for hp Tru64 UNIX, you must also set the exec_disable_arg_limit attribute in the proc subsystem to 1.

Additional Required OS Patches for Tru64 5.1B Patch Kit 2

In addition to the patches listed in the Oracle Database Installation Guide for UNIX Systems and the Oracle Database Quick Installation Guide for hp Tru64 UNIX, the following patches are required for Tru64 UNIX V5.1B Patch Kit 2:

T64KIT0021665-V51BB22-E-20040220 
T64KIT0021681-V51BB22-E-20040223 
T64KIT0019662-V51BB22-E-20030818

shm_max Kernel Subsystem Attribute

You can set the shm_max kernel subsystem attribute to greater than 4 GB. The recommended value for a single instance database is 4278190080 (4 GB minus 16 MB).

INSO Filters

For this release, INSO filters are not supported on Tru64 UNIX.

Cross-Platform Transportable Tablespace

For this release, cross-platform transportable tablespaces are not supported on Tru64 UNIX.

Removing Cloned Oracle Homes

If you use the Installer to remove a cloned Oracle home, and the cloned Oracle home is on the same system as the source Oracle home, the Installer removes essential files from the source Oracle home. To avoid this issue, remove the cloned Oracle home as follows:

1. Remove the cloned Oracle home manually by deleting the cloned Oracle home directory.

2. Start the Installer from the source Oracle home directory:

   $ source_oracle_home/oui/bin/runInstaller
   
   

3. In the Welcome window, click Deinstall Products.

   The Inventory window appears, listing all of the Oracle homes on the system.

4. In the Inventory window, select the cloned Oracle home, then click Remove.

This issue is tracked through Oracle bug 3417663.

Installing Enterprise Security Manager

To install Enterprise Security Manager (ESM), install Oracle Client and choose the Administrator installation type.

Updates for Real Application Clusters Documentation

The following sections describe corrections and supplemental information for the Oracle Real Application Clusters 10g documentation for UNIX platforms:

• Installing Oracle CRS

• De-Installation Procedure Change for UNIX-Based Systems

• Adding Nodes

• Deleting Nodes

• Real Application Clusters Services Deployment Example

• Running DBCA on RAC

ORACLE_HOME/bin/localconfig delete

SRV_PRECONNECT VERSION=1.0 service=db_unique_name.db_domain 
database=database_name instance instance_name host=host_name 
status=preconn_up reason=timestamp=27-Jan-2004 16:53:58 
reported=Tue Jan 27 16:53:59 PST 2004 

SRV_PRECONNECT VERSION=1.0 service=db_unique_name.db_domain
database=database_name instance=instance_name host=host_name
status=preconn_down reason=timestamp=27-Jan-2004 16:58:01
reported=Tue Jan 27 16:58:02 PST 2004

@ SRV_PRECONNECT VERSION=1.0 service=MYSERV.us.oracle.com 
database=RACEY instance=RACEY1 host=sun880-1 
status=preconn_up reason=timestamp=27-Jan-2004 16:53:58
reported=Tue Jan 27 16:53:59 PST 2004 

@ SRV_PRECONNECT VERSION=1.0 service=MYSERV.us.oracle.com
database=RACEY instance=RACEY1 host=sun880-1 
status=preconn_down reason=timestamp=27-Jan-2004 16:58:01
reported=Tue Jan 27 16:58:02 PST 2004

sys_context('userenv', 'instance_name');
sys_context('userenv', 'server_host');
sys_context('userenv', 'service_name');
sys_context('userenv', 'db_unique_name');

Updates for Other Documentation

The following sections contain updates to the Oracle Database 10g documentation:

• Installing Oracle HTML DB

• Globalization Support

• Full-Text Searching with Oracle Text

• View Descriptions

• Configuring Management Service Processes

• Monolingual Linguistic Sorting

• XDK Error Messages

• Support for Hearing and Speech Impaired Customers

CREATE TABLE PurchaseOrder of XMLTYPE
  XMLSCHEMA http://localhost:8080/home/SCOTT/poSource/xsd/purchaseOrder.xsd
  ELEMENT "PurchaseOrder"
  VARRAY "XMLDATA"."ACTIONS"."ACTION"
    STORE AS TABLE ACTION_TABLE ((PRIMARY KEY 
       (NESTED_TABLE_ID, ARRAY_INDEX)))
  VARRAY "XMLDATA"."LINEITEMS"."LINEITEM"
     STORE AS TABLE LINEITEM_TABLE ((PRIMARY KEY 
       (NESTED_TABLE_ID, ARRAY_INDEX)));

http://otn.oracle.com/tech/xml/doc/production10g/Javaerrormsgs.html