Oracle® Database Oracle Clusterware and Oracle Real Application Clusters Installation Guide 10g Release 2 (10.2) for Solaris Operating System Part Number B14205-07 |
|
|
View PDF |
This chapter describes the system configuration tasks that you must complete before you start Oracle Universal Installer. It includes information about the following tasks:
Cluster Verification Utility (CVU) is a tool that performs system checks. This guide provides CVU commands to assist you with confirming that your system is properly configured for Oracle Clusterware and Oracle Real Application Clusters installation.
This section describes the following topics:
Using CVU to Determine if Installation Prerequisites are Complete
Using Cluster Verification Utility with Oracle 10g Release 1
Note:
You must have the utility unzip installed and configured with a path command forruncluvfy.sh
to run.Before the database is installed, to enter a CVU command, change directory and use the following syntax to start CVU:
$ /mountpoint/crs/Disk1/cluvfy/ $ ./runcluvfy.sh options
In the preceding example, the variable mountpoint represents the mountpoint path for the installation media, and the variable options
represents the CVU command options that you select. For example:
$ /dev/dvdrom/crs/Disk1/cluvfy/ $ ./runcluvfy.sh comp nodereach -n node1,node2 -verbose
By default, when you enter a CVU command, CVU provides a summary of the test. During pre-installation, Oracle recommends that you obtain detailed output by using the -verbose
argument with the CVU command. The -verbose
argument produces detailed output of individual checks. Where applicable, it shows results for each node in a tabular layout.
Note:
The scriptruncluvfy.sh
contains temporary variable definitions which enable it to be run before installing Oracle Clusterware or Oracle Database. After you install Oracle Clusterware, use the command cluvfy
to check prerequisites and perform other system readiness checks.You can use CVU to determine which system prerequisites for installation are already completed. Use this option if you are installing Oracle 10g Release 2 (10.2) on a system with a pre-existing Oracle software installation. In using this option, note the following:
You must complete the prerequisites for using CVU
CVU can assist you by finding pre-installation steps that need to be completed, but it cannot perform pre-installation tasks
Use the following syntax to determine what pre-installation steps are completed, and what pre-installation steps must be performed
/$ ./runcluvfy.sh stage -pre crsinst -n node_list
In the preceding syntax example, replace the variable node_list
with the names of the nodes in your cluster, separated by commas.
For example, for a cluster with mountpoint /dev/dvdrom/, and with nodes node1
, node2
, and node3
, enter the following command:
$ cd /dev/dvdrom/crs/Disk1/cluvfy/ $ ./runcluvfy.sh stage -pre crsinst -n node1,node2,node3
Review the CVU report, and proceed to the sections of the pre-installation chapter to complete additional steps as needed.
The cluvfy
commands have context-sensitive help that shows correct syntax usage based on the command line arguments that you enter.
If you enter an invalid CVU command, then CVU shows the correct usage for that command. For example, if you type runcluvfy.sh stage -pre dbinst
, then CVU shows the correct syntax for the database pre-installation checks that CVU performs with the dbinst
stage option. The following is a list of context help commands.
cluvfy
: CVU displays high-level generic usage text describing the stage and component syntax.
cluvfy -help
: CVU displays detailed CVU command information.
cluvfy comp -list
: CVU displays a list of components that can be checked, and brief descriptions of how each component is checked.
cluvfy comp -help
: CVU displays detailed syntax for each of the valid component checks.
cluvfy stage -list
: CVU displays a list of valid stages.
cluvfy stage -help
: CVU displays detailed syntax for each of the valid stage checks.
You can use CVU on the Oracle 10g Release 2 (10.2) media to check system requirements for Oracle 10g Release 1 (10.1) installations. To use CVU to check 10. 1 installations, append the command flag -r 10gR1 to the standard CVU system check commands.
For example, to perform a verification check for a Cluster Ready Services 10. 1 installation, on a system where the media mountpoint is /dev/dvdrom/, and the cluster nodes are node1
, node2
, and node3
, enter the following command:
$ ./runcluvfy.sh stage -pre crsinst -n node1,node2,node3 -r 10gR1
If you run CVU using the -verbose
argument, and a CVU command responds with UNKNOWN
for a particular node, then this is because the CVU cannot determine whether a check passed or failed. The following is a list of possible causes for an "Unknown" response:
The node is down
Executables required by CVU are missing in the CRS_home /bin
or Oracle home directory
The user account starting CVU does not have privileges to run common operating system executables on the node
The node is missing an operating system patch, or a required package
The node has exceeded the maximum number of processes or maximum number of open files, or there is a problem with IPC segments, such as shared memory or semaphores
Before you install the Oracle software, you must complete several tasks as the root
user. To log in as the root
user, complete one of the following procedures:
If you are installing the software from an X Window System workstation or X terminal, then:
Start a local terminal session, for example, an X terminal (xterm
).
If you are not installing the software on the local system, then enter the following command to enable remote hosts to display X applications on the local X server:
$ xhost + hostname
The hostname is the name of the local host.
If you are not installing the software on the local system, then use the ssh
, rlogin
, or telnet
command to connect to the system where you want to install the software:
$ telnet remote_host
If you are not logged in as the root
user, then enter the following command to switch the user to root
:
$ su - root password: #
If you are installing the software from a PC or other system with X server software installed, then:
Note:
If necessary, refer to your X server documentation for more information about completing this procedure. Depending on the X server software that you are using, you may need to complete the tasks in a different order.Start the X server software.
Configure the security settings of the X server software to permit remote hosts to display X applications on the local system.
Connect to the remote system where you want to install the software and start a terminal session on that system, for example, an X terminal (xterm
).
If you are not logged in as the root
user on the remote system, then enter the following command to switch user to root
:
$ su - root password: #
Depending on whether this is the first time Oracle software is being installed on this system and on the products that you are installing, you may need to create several operating system groups and an operating system user account.
The following operating system groups and user are required if you are installing Oracle Database:
The OSDBA group (typically, dba
)
You must create this group the first time you install Oracle Database software on the system. This group identifies operating system user accounts that have database administrative privileges (the SYSDBA privilege). The default name for this group is dba
.
If you want to specify a group name other than the default dba
group, then you must choose the Custom installation type to install the software or start Oracle Universal Installer as a user that is not a member of this group. In this case, Oracle Universal Installer prompts you to specify the name of this group.
The OSOPER group (typically, oper
)
This is an optional group. Create this group if you want a separate group of operating system users to have a limited set of database administrative privileges (the SYSOPER privilege). By default, members of the OSDBA group also have the SYSOPER privilege.
If you want to specify a separate OSOPER group, other than the default dba
group, then you must choose the Custom installation type to install the software or start Oracle Universal Installer as a user that is not a member of the dba
group. In this case, Oracle Universal Installer prompts you to specify the name of this group. The usual name chosen for this group is oper
.
Verify that the unprivileged user nobody
exists on the system. The nobody
user must own the external jobs (extjob) executable after the installation.
The following operating system group and user are required for all installations:
The Oracle Inventory group (typically, oinstall
)
You must create this group the first time you install Oracle software on the system. The usual name chosen for this group is oinstall
. This group owns the Oracle Inventory, which is a catalog of all Oracle software installed on the system.
Note:
If Oracle software is already installed on the system, then the existing Oracle Inventory group must be the primary group of the operating system user that you use to install new Oracle software. The following sections describe how to identify an existing Oracle Inventory group.The Oracle software owner user (typically, oracle
)
You must create this user the first time you install Oracle software on the system. This user owns all of the software installed during the installation. The usual name chosen for this user is oracle
. This user must have the Oracle Inventory group as its primary group. It must also have the OSDBA and OSOPER groups as secondary groups. In Oracle documentation, when this user account is referred to, it is called the oracle
user.
A single Oracle Inventory group is required for all installations of Oracle software on the system. After the first installation of Oracle software, you must use the same Oracle Inventory group for all subsequent Oracle software installations on that system. However, you can choose to create different Oracle software owner users, OSDBA groups, and OSOPER groups (other than oracle
, dba
, and oper
) for separate installations. By using different groups for different installations, members of these different groups have DBA privileges only on the associated databases rather than on all databases on the system.
See Also:
Oracle Database Administrator's Reference for UNIX Systems and Oracle Database Administrator's Guide for more information about the OSDBA and OSOPER groups and the SYSDBA and SYSOPER privilegesThe following sections describe how to create the required operating system user and groups:.
Note:
The following sections describe how to create local users and groups. As an alternative to creating local users and groups, you can create the appropriate users and groups in a directory service, such as Network Information Services (NIS). For information about using directory services, contact your system administrator or refer to your operating system documentation.Oracle Universal Installer (OUI) helps you to choose a group to use as the Oracle Inventory group. If you have an existing Oracle Inventory group, then provide this group name and path when prompted.
The following subsections describe how to determine the Oracle Inventory group name, if it exists, and how to create it if necessary.
Determining If the Oracle Inventory Exists
When you install Oracle software on the system for the first time, Oracle Universal Installer creates the oraInst.loc
file. This file identifies the name of the Oracle Inventory group (typically, oinstall
), and the path of the Oracle Inventory directory.
If you have an existing Oracle Inventory, then ensure that you use the same Oracle Inventory for all Oracle software installations.
If you do not have an existing Oracle Inventory, then you should create an Oracle Inventory group.
To determine whether you have an Oracle Inventory on your system, enter the following command:
# more /var/opt/oracle/oraInst.loc
If the oraInst.loc
file exists, then the output from this command is similar to the following:
inventory_loc=/u01/app/oracle/oraInventory inst_group=oinstall
In the previous output example:
The inventory_loc
group shows the location of the Oracle Inventory
The inst_group
parameter shows the name of the Oracle Inventory group (in this example, oinstall
).
Creating the Oracle Inventory Group If an Oracle Inventory Does Not Exist
If the oraInst.loc
file does not exist, then create the Oracle Inventory group by entering a command similar to the following:
# /usr/sbin/groupadd oinstall
You must create an OSDBA group in the following circumstances:
An OSDBA group does not exist, for example, if this is the first installation of Oracle Database software on the system
An OSDBA group exists, but you want to give a different group of operating system users database administrative privileges for a new Oracle Database installation
If the OSDBA group does not exist or if you require a new OSDBA group, then create it as follows. In the following procedure, use the group name dba
unless a group with that name already exists:
# /usr/sbin/groupadd dba
Create an OSOPER group only if you want to identify a group of operating system users with a limited set of database administrative privileges (SYSOPER operator privileges). For most installations, it is sufficient to create only the OSDBA group. If you want to use an OSOPER group, then you must create it in the following circumstances:
If an OSOPER group does not exist; for example, if this is the first installation of Oracle Database software on the system
If an OSOPER group exists, but you want to give a different group of operating system users database operator privileges in a new Oracle installation
If you require a new OSOPER group, then create it as follows. In the following, use the group name oper
unless a group with that name already exists.
# /usr/sbin/groupadd oper
You must create an Oracle software owner user in the following circumstances:
If an Oracle software owner user does not exist; for example, if this is the first installation of Oracle software on the system
If an Oracle software owner user exists, but you want to use a different operating system user, with different group membership, to give database administrative privileges to those groups in a new Oracle Database installation
Note:
If you intend to use multiple Oracle software owners for different Oracle homes, then you should create a separate Oracle software owner for Oracle Clusterware, and install Oracle Clusterware using the Oracle Clusterware software owner.Determining if an Oracle Software Owner User Exists
To determine whether an Oracle software owner user named oracle
exists, enter the following command:
# id -a oracle
If the oracle
user exists, then the output from this command is similar to the following:
uid=440(oracle) gid=200(oinstall) groups=201(dba),202(oper)
If the user exists, then determine whether you want to use the existing user, or create another oracle
user. If you want to use the existing user, then ensure that the user's primary group is the Oracle Inventory group and that it is a member of the appropriate OSDBA and OSOPER groups. Refer to one of the following sections for more information:
Note:
If necessary, contact your system administrator before using or modifying an existing user.To modify an existing user, refer to the "Modifying an Existing Oracle Software Owner User" section.
To create a user, refer to the following section.
Creating an Oracle Software Owner User
If the Oracle software owner user does not exist, or if you require a new Oracle software owner user, then create it as follows. In the following procedure, use the user name oracle
unless a user with that name already exists.
To create the oracle
user, enter a command similar to the following:
# /usr/sbin/useradd -u 200 -g oinstall -G dba[,oper] oracle
In the preceding command:
The -u option specifies the user ID. Using this command flag is optional, as you can allow the system to provide you with an automatically generated user ID number. However, you must make note of the oracle user ID number, as you require it later during pre-installation.
The -g
option specifies the primary group, which must be the Oracle Inventory group--for example, oinstall
The -G
option specifies the secondary groups, which must include the OSDBA group, and, if required, the OSOPER group. For example: dba
, or dba,oper
Set the password of the oracle
user:
# passwd oracle
Refer to the section "Verifying That the User nobody Exists".
Modifying an Existing Oracle Software Owner User
If the oracle
user exists, but its primary group is not oinstall
, or it is not a member of the appropriate OSDBA or OSOPER groups, then enter a command similar to the following to modify it. Specify the primary group using the -g
option and any required secondary group using the -G
option:
# /usr/sbin/usermod -g oinstall -G dba[,oper] oracle
Repeat this procedure on all of the other nodes in the cluster.
Before installing the software, complete the following procedure to verify that the user nobody exists on the system:
To determine if the user exists, enter the following command:
# id nobody
If this command displays information about the nobody
user, then you do not have to create that user.
If the nobody
user does not exist, then enter the following command to create it:
# /usr/sbin/useradd nobody
Repeat this procedure on all the other nodes in the cluster.
Note:
You must complete the following procedures only if you are using local users and groups. If you are using users and groups defined in a directory service such as NIS, then they are already identical on each cluster node.The Oracle software owner user and the Oracle Inventory, OSDBA, and OSOPER groups must exist and be identical on all cluster nodes. To create these identical users and groups, you must identify the user ID and group IDs assigned them on the node where you created them, then create the user and groups with the same name and ID on the other cluster nodes.
Identifying the User and Group IDs
To determine the user ID (UID) of the Oracle software owner user and the group IDs (GID) of the Oracle Inventory, OSDBA, and OSOPER groups, follow these steps:
Enter following command:
# id oracle
The output from this command is similar to the following:
uid=440(oracle) gid=200(oinstall) groups=201(dba),202(oper)
From the output, identify the user ID (UID) for the oracle
user and the group identities (GIDs) for the groups to which it belongs.
Creating the User and Groups on the Other Cluster Nodes
To create the user and groups on the other cluster nodes, repeat the following procedure on each node:
Log in to the next cluster node as root
.
Enter commands similar to the following to create the oinstall
and dba
groups, and if required, the oper
group. Use the -g
option to specify the correct GID for each group.
# /usr/sbin/groupadd -g 200 oinstall # /usr/sbin/groupadd -g 201 dba # /usr/sbin/groupadd -g 202 oper
Note:
If the group already exists, then use thegroupmod
command to modify it if necessary. If you cannot use the same group ID for a particular group on this node, then view the /etc/group
file on all nodes to identify a group ID that is available on every node. You must then specify that ID for the group on all of the nodes.To create the oracle
user, enter a command similar to the following:
# /usr/sbin/useradd -u 200 -g oinstall -G dba[,oper] oracle
In the preceding command:
The -u
option specifies the user ID, which must be the user ID that you identified in the previous subsection
The -g
option specifies the primary group, which must be the Oracle Inventory group, for example oinstall
The -G
option specifies the secondary groups, which must include the OSDBA group and if required, the OSOPER group. For example: dba
or dba,oper
Note:
If theoracle
user already exists, then use the usermod
command to modify it if necessary. If you cannot use the same user ID for the oracle
user on this node, then view the /etc/passwd
file on all nodes to identify a user ID that is available on every node. You must then specify that ID for the user on all of the nodes.Set the password of the oracle
user:
# passwd oracle
Before you install and use Oracle Real Application Clusters, you should configure secure shell (SSH) for the oracle
user on all cluster nodes. Using SSH provides greater security than Berkeley services remote shell (RSH). Oracle Universal Installer uses the rsh
and scp
commands during installation to run remote commands on and copy files to the other cluster nodes. You must configure SSH (or RSH) so that these commands do not prompt for a password.
Note:
This section describes how to configure OpenSSH version 3. If SSH is not available, then Oracle Universal Installer attempts to usersh
and rcp
instead.
To determine if SSH is running, enter the following command:
$ ps -ef | grep sshd
If SSH is running, then the response to this command is process ID numbers. To find out more about SSH, enter the following command:
$ man ssh
Also note that Oracle Net Configuration Assistant (NetCA) and Database Configuration Assistant (DBCA) require scp
and ssh
to be located in the path /usr/local/bin
. If scp
and ssh
are not in this location, then create a symbolic link in /usr/local/bin
to the location where scp
and ssh
are found.
To configure SSH, you must first create RSA and DSA keys on each cluster node, and then copy the keys from all cluster node members into an authorized keys file on each node. For example, with a two-node cluster, node_A
and node_B
, you create RSA and DSA keys on the local host, node_A
; create RSA and DSA keys on the second node, node_B
; and then copy RSA and DSA codes from both node_A
and node_B
to each node.
Complete the following steps:
Create RSA and DSA keys on each node: Complete the following steps on each node:
Log in as the oracle
user.
If necessary, create the .ssh
directory in the oracle
user's home directory and set the correct permissions on it:
$ mkdir ~/.ssh $ chmod 700 ~/.ssh $ chmod 700
Enter the following commands to generate an RSA key for version 2 of the SSH protocol:
$ /usr/bin/ssh-keygen -t rsa
At the prompts:
Accept the default location for the key file.
Enter and confirm a pass phrase that is different from the oracle
user's password.
This command writes the public key to the ~/.ssh/id_rsa.pub
file and the private key to the ~/.ssh/id_rsa
file. Never distribute the private key to anyone.
Enter the following commands to generate a DSA key for version 2 of the SSH protocol:
$ /usr/bin/ssh-keygen -t dsa
At the prompts:
Accept the default location for the key file
Enter and confirm a pass phrase that is different from the oracle
user's password
This command writes the public key to the ~/.ssh/id_dsa.pub
file and the private key to the ~/.ssh/id_dsa
file. Never distribute the private key to anyone.
Add keys to an authorized key file: Complete the following steps:
On the local node, determine if you have an authorized key file (~/.ssh/authorized_keys
). If the authorized key file already exists, then proceed to step 2. Otherwise, enter the following commands:
$ touch ~/.ssh/authorized_keys $ cd ~/.ssh $ ls
You should see the id_dsa.pub
and id_rsa.pub
keys that you have created.
Using SSH, copy the contents of the ~/.ssh/id_rsa.pub
and ~/.ssh/id_dsa.pub
files to the file ~/.ssh/authorized_keys
, and provide the Oracle user password as prompted. This process is illustrated in the following syntax example with a two-node cluster, with nodes node1 and node2, where the Oracle user path is /home/oracle:
[oracle@node1 .ssh]$ ssh node1 cat /home/oracle/.ssh/id_rsa.pub >> authorized_keys oracle@node1's password: [oracle@node1 .ssh]$ ssh node1 cat /home/oracle/.ssh/id_dsa.pub >> authorized_keys [oracle@node1 .ssh$ ssh node2 cat /home/oracle/.ssh/id_rsa.pub >> authorized_keys oracle@node2's password: [oracle@node1 .ssh$ ssh node2 cat /home/oracle/.ssh/id_dsa.pub >>authorized_keys oracle@node2's password:
Note:
Repeat this process for each node in the cluster.Use SCP (Secure Copy) or SFTP (Secure FTP) to copy the authorized_keys
file to the Oracle user .ssh directory on a remote node. The following example is with SCP, on a node called node2, where the Oracle user path is /home/oracle
:
[oracle@node1 .ssh]scp authorized_keys node2:/home/oracle/.ssh/
Repeat step 2 and 3 for each cluster node member. When you have added keys from each cluster node member to the authorized_keys file on the last node you want to have as a cluster node member, then use SCP to copy the complete authorized_keys file back to each cluster node member
Note:
The Oracle user's/.ssh/authorized_keys
file on every node must contain the contents from all of the /.ssh/id_rsa.pub
and /.ssh/id_dsa.pub
files that you generated on all cluster nodes.Change the permissions on the Oracle user's /.ssh/authorized_keys
file on all cluster nodes:
$ chmod 600 ~/.ssh/authorized_keys
At this point, if you use ssh
to log in to or run a command on another node, you are prompted for the pass phrase that you specified when you created the DSA key.
To enable Oracle Universal Installer to use the ssh
and scp
commands without being prompted for a pass phrase, follow these steps:
On the system where you want to run Oracle Universal Installer, log in as the oracle
user.
Enter the following commands:
$ exec /usr/bin/ssh-agent $SHELL $ /usr/bin/ssh-add
At the prompts, enter the pass phrase for each key that you generated.
If you have configured SSH correctly, then you can now use the ssh
or scp
commands without being prompted for a password or a pass phrase.
If you are on a remote terminal, and the local node has only one visual (which is typical), then use the following syntax to set the DISPLAY environment variable:
Bourne, Korn, and Bash shells
$ export DISPLAY=hostname:0
C shell:
$ setenv DISPLAY 0
For example, if you are using the Bash shell, and if your hostname is node1, then enter the following command:
$ export DISPLAY=node1:0
To test the SSH configuration, enter the following commands from the same terminal session, testing the configuration of each cluster node, where nodename1
, nodename2
, and so on, are the names of nodes in the cluster:
$ ssh nodename1 date $ ssh nodename2 date . . .
These commands should display the date set on each node.
If any node prompts for a password or pass phrase, then verify that the ~/.ssh/authorized_keys
file on that node contains the correct public keys.
If you are using a remote client to connect to the local node, and you see a message similar to "Warning: No xauth data; using fake authentication data for X11 forwarding," then this means that your authorized keys file is configured correctly, but your ssh configuration has X11 forwarding enabled. To correct this, proceed to step 6.
Note:
The first time you use SSH to connect to a node from a particular system, you may see a message similar to the following:The authenticity of host 'node1 (140.87.152.153)' can't be established. RSA key fingerprint is 7z:ez:e7:f6:f4:f2:4f:8f:9z:79:85:62:20:90:92:z9. Are you sure you want to continue connecting (yes/no)?
Enter yes
at the prompt to continue. You should not see this message again when you connect from this system to that node.
If you see any other messages or text, apart from the date, then the installation can fail. Make any changes required to ensure that only the date is displayed when you enter these commands.
You should ensure that any parts of login scripts that generate any output, or ask any questions, are modified so that they act only when the shell is an interactive shell.
To ensure that X11 forwarding will not cause the installation to fail, create a user-level SSH client configuration file for the Oracle software owner user, as follows:
Using any text editor, edit or create the ~oracle/.ssh/config
file.
Make sure that the ForwardX11 attribute is set to no
. For example:
Host * ForwardX11 no
You must run Oracle Universal Installer from this session or remember to repeat steps 2 and 3 before you start Oracle Universal Installer from a different terminal session.
During an Oracle Clusterware installation, Oracle Universal Installer uses SSH (if available) to run commands and copy files to the other nodes. During the installation, hidden files on the system (for example, .bashrc or .cshrc) will cause installation errors if they contain stty commands.
To avoid this problem, you must modify these files to suppress all output on STDERR, as in the following examples:
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
Note:
When SSH is not available, the Installer uses thersh
and rcp
commands instead of ssh
and scp
.
If there are hidden files that contain stty commands that are loaded by the remote shell, then OUI indicates an error and stops the installation.
You run Oracle Universal Installer from the oracle
account. However, before you start Oracle Universal Installer you must configure the environment of the oracle
user.
To configure the environment, you must:
Set the default file mode creation mask (umask) to 022 in the shell startup file
Set the DISPLAY, ORACLE_BASE, and ORACLE_HOME environment variables in preparation for the Oracle Clusterware installation
You should also ensure that the PATH variable contains $ORACLE_HOME/bin
To set the oracle
user's environment, follow these steps:
Start a new terminal session; for example, start an X terminal (xterm
).
Enter the following command to ensure that X Window applications can display on this system:
$ xhost + hostname
The hostname is the name of the local host.
If you are not already logged in to the system where you want to install the software, then log in to that system as the oracle
user.
If you are not logged in as the oracle
user, then switch user to oracle
:
$ su - oracle
To determine the default shell for the oracle
user, enter the following command:
$ echo $SHELL
Open the oracle
user's shell startup file in any text editor:
Bourne shell (sh
), Bash shell (bash
) or Korn shell (ksh
):
% vi .bash_profile
C shell (csh
or tcsh
):
% vi .login
Enter or edit the following line, specifying a value of 022 for the default file mode creation mask:
umask 022
If the ORACLE_SID
, ORACLE_HOME
, or ORACLE_BASE
environment variable is set in the file, then remove the appropriate lines from the file.
Save the file, and exit from the text editor.
To run the shell startup script, enter one of the following commands:
Bourne, Bash, or Korn shell:
$ . ./.profile
C shell:
% source ./.login
If you are not installing the software on the local system, then enter a command similar to the following to direct X applications to display on the local system:
Bourne, Bash, or Korn shell:
$ DISPLAY=local_host:0.0 ; export DISPLAY
C shell:
% setenv DISPLAY local_host:0.0
In this example, local_host
is the host name or IP address of the system that you want to use to display Oracle Universal Installer (your workstation or PC).
If you determined that the /tmp
directory has less than 400 MB of free disk space, then identify a file system with at least 400 MB of free space and set the TEMP
and TMPDIR
environment variables to specify a temporary directory on this file system:
Note:
You cannot use a shared file system as the location of the temporary file directory (typically/tmp
) for RAC installation. If you place /tmp
on a shared file system, then the installation fails.Use the df -k
command to identify a suitable file system with sufficient free space.
If necessary, enter commands similar to the following to create a temporary directory on the file system that you identified, and set the appropriate permissions on the directory:
$ su - root # mkdir /mount_point/tmp # chmod 775 /mount_point/tmp # exit
Enter commands similar to the following to set the TEMP and TMPDIR environment variables:
Bourne, Bash, or Korn shell:
$ TEMP=/mount_point/tmp $ TMPDIR=/mount_point/tmp $ export TEMP TMPDIR
C shell:
% setenv TEMP /mount_point/tmp % setenv TMPDIR /mount_point/tmp
Each system must meet the following minimum hardware requirements:
At least 1 GB of physical RAM
Swap space equivalent to the multiple of the available RAM, as indicated in the following table:
Available RAM | Swap Space Required |
---|---|
Between 1 GB and 2 GB | 1.5 times the size of RAM |
More than 2 GB | Equal to the size of RAM |
400 MB of disk space in the /tmp
directory
4 GB of disk space for the Oracle software, depending on the installation type and platform
1.2 GB of disk space for a preconfigured database that uses file system storage (optional)
Note:
The disk space requirement for databases that use Automatic Storage Management or raw device storage is described later in this chapter.Additional disk space, either on a file system or in an Automatic Storage Management disk group, is required for the flash recovery area if you choose to configure automated backups.
To ensure that each system meets these requirements:
To determine the physical RAM size, enter the following command:
# /usr/sbin/prtconf | grep "Memory size"
If the size of the physical RAM installed in the system is less than the required size, then you must install more memory before continuing.
To determine the size of the configured swap space, enter the following command:
# /usr/sbin/swap -s
If necessary, refer to your operating system documentation for information about how to configure additional swap space.
To determine the amount of disk space available in the /tmp
directory, enter the following command:
# df -k /tmp
If there is less than 400 MB of disk space available in the /tmp
directory, then complete one of the following steps:
Delete unnecessary files from the /tmp
directory to meet the disk space requirement.
Set the TEMP
and TMPDIR
environment variables when setting the oracle
user's environment (described later).
Extend the file system that contains the /tmp
directory. If necessary, contact your system administrator for information about extending file systems.
To determine the amount of free disk space on the system, enter the following command:
# df -k /tmp
The following table shows the approximate disk space requirements for software files for each installation type:
Installation Type | Requirement for Software Files (GB) |
---|---|
Enterprise Edition | 4 |
Standard Edition | 4 |
Custom (maximum) | 4 |
To determine whether the system architecture can run the Oracle software you have obtained, enter the following command:
# /bin/isainfo -kv
Note:
The following is the expected output of this command:64-bit SPARC installation:
64-bit sparcv9 kernel modules
32-bit x86 installation:
32-bit i386 kernel modules
64-bit x86 installation:
64-bit amd64 kernel modules
Ensure that the Oracle software you have is the correct Oracle software for your processor type.
If the output of this command indicates that your system architecture does not match the system for which the Oracle software you have is written, then you cannot install the software. Obtain the correct software for your system architecture before proceeding further.
Check that you have the networking hardware and internet protocol (IP) addresses required for an Oracle Real Application Clusters installation.
Note:
For the most up-to-date information about supported network protocols and hardware for RAC installations, refer to the Certify pages on the OracleMetaLink Web site athttp://metalink.oracle.com
Network Hardware Requirements
Each node in the cluster must meet the following requirements:
Each node must have at least two network adapters: one for the public network interface, and one for the private network interface (the interconnect).
The public interface names associated with the network adapters for each network must be the same on all nodes, and the private interface names associated with the network adaptors should be the same on all nodes.
For example: With a two-node cluster, you cannot configure network adapters on node1 with hme0
as the public interface, but on node2 have hme1
as the public interface. Public interface names must be the same, so you must configure hme0 as public on both nodes. You should configure the private interfaces on the same network adapters as well. If hme1
is the private interface for node 1, then hme1
should be the private interface for node 2.
For increased reliability, configure redundant public and private network adapters for each node.
For the public network, each network adapter must support TCP/IP.
For the private network, the interconnect must support the user datagram protocol (UDP) using high-speed network adapters and switches that support TCP/IP (Gigabit Ethernet or better recommended).
Note:
UDP is the default interconnect protocol for RAC, and TCP is the interconnect protocol for Oracle Clusterware.Token-Ring is not supported for the interconnect.
For the private network, the endpoints of all designated interconnect interfaces must be completely reachable on the network. There should be no node that is not connected to every private network. You can test whether an interconnect interface is reachable using a ping
command.
NFS Parameter Requirements
If you are using NFS for your shared storage, then you must set the values for the NFS buffer size parameters rsize
and wsize
to at least 16384. Oracle recommends that you use the value 32768.
For example, if you decide to use rsize and wsize buffer settings with the value 32768, then update the /etc/vfstab
file on each node with an entry similar to the following:
nfs_server:/vol/DATA/oradata /home/oracle/netapp nfs -yes rw,hard,bg, nointr,rsize=32768,wsize=32768,tcp,noac,vers=3,timeo=600,actimeo=0
If you use NFS mounts, then Oracle recommends that you use the option forcedirectio
to force direct I/O for better performance. However, if you add forcedirectio
to the mount option, then the same mount point cannot be used for Oracle software binaries, executables, shared libraries, and objects. You can only use the forcedirectio
option for Oracle data files, the OCR, and voting disks. For these mount points, enter the following line:
clusternode:/vol/DATA/oradata /home/oracle/netapp nfs -yes rw,hard,nointr,rsize=32768,wsize=32768,tcp,noac,forcedirectio,vers=3
Before starting the installation, you must have the following IP addresses available for each node:
An IP address with an associated network name registered in the domain name service (DNS) for the public interface. If you do not have an available DNS, then record the network name and IP address in the system hosts file, /etc/hosts
.
One virtual IP (VIP) address with an associated network name registered in DNS. If you do not have an available DNS, then record the network name and VIP address in the system hosts file, /etc/hosts
. Select an address for your VIP that meets the following requirements:
The IP address and network name are currently unused
The VIP is on the same subnet as your public interface
Before installation, check that the default gateway can be accessed by a ping
command. During installation, OUI uses the ping
command to ensure that the VIP is reachable. To find the default gateway, use the route
command, as described in your operating system's help utility. After installation, configure clients to use either the VIP address, or the network name associated with the VIP. If a node fails, then the node's virtual IP address fails over to another node.
A private IP address with a host name for each private interface
Oracle recommends that you use private network IP addresses for these interfaces (for example: 10.*.*.* or 192.168.*.*). Use the /etc/hosts
file on each node to associate private network names with private IP addresses. The private IP address must be available in each node's /etc/hosts
file, unless you are using a Sun Cluster on x86 systems. In that case, clusternodeX-priv
can be used as a private interconnect for Oracle Clusterware and RAC.
For example, with a two node cluster where each node has one public and one private interface, you might have the configuration shown in the following table for your network interfaces, where the hosts file is /etc/hosts
:
Node | Interface Name | Type | IP Address | Registered In |
---|---|---|---|---|
rac1 | rac1 | Public | 143.46.43.100 | DNS (if available, else the hosts file) |
rac1 | rac1-vip | Virtual | 143.46.43.104 | DNS (if available, else the hosts file) |
rac1 | rac1-priv | Private | 10.0.0.1 | Hosts file |
rac2 | rac2 | Public | 143.46.43.101 | DNS (if available, else the hosts file) |
rac2 | rac2-vip | Virtual | 143.46.43.105 | DNS (if available, else the hosts file) |
rac2 | rac2-priv | Private | 10.0.0.2 | Hosts file |
To enable VIP failover, the configuration shown in the preceding table defines the public and VIP addresses of both nodes on the same subnet, 143.46.43. When a node or interconnect fails, then the associated VIP is relocated to the surviving instance, enabling fast notification of the failure to the clients connecting through that VIP. If the application and client are configured with transparent application failover options, then the client is reconnected to the surviving instance.
Before starting the installation, ensure that each member node of the cluster is set as closely as possible to the same date and time. Oracle strongly recommends using the Network Time Protocol feature of most operating systems for this purpose, with all nodes using the same reference Network Time Protocol server.
To verify that each node meets the requirements, follow these steps:
If necessary, install the network adapters for the public and private networks and configure them with either public or private IP addresses.
Register the host names and IP addresses for the public network interfaces in DNS.
For each node, register one virtual host name and IP address in DNS.
For each private interface on every node, add a line similar to the following to the /etc/hosts
file on all nodes, specifying the private IP address and associated private host name:
10.0.0.1 rac1-priv1
To identify the interface name and associated IP address for every network adapter, enter the following command:
# /sbin/ifconfig -a
From the output, identify the interface name and IP address for all network adapters that you want to specify as public or private network interfaces.
Note:
When you install Oracle Clusterware and RAC, you will require this information.To prevent network hangs with failovers from public to virtual IP addresses with RAC databases using NAS devices or NFS mounts, the Name Service Cache Daemon (nscd
) needs to be started. On Solaris, it is started by default. If needed, enter the following command as root to enable nscd
:
As the Oracle user, enter a command using the following syntax to verify node connectivity among all of the nodes for which your cluster is configured:
/mountpoint/crs/Disk1/cluvfy/runcluvfy.sh comp nodecon -n node_list [-verbose]
In the preceding syntax example, the variable node_list
is a comma-separated list of nodes in your cluster. This command detects all the network interfaces available on the cluster nodes, and verifies the connectivity among all the nodes through the network interfaces it finds.
Select the option -verbose
to receive progress updates as the CVU performs its system checks, and detailed reporting of the test results.
For example, to verify node connectivity on a two-node cluster with nodes node1 and node2, with the mountpoint /dev/dvdrom, and with updates and a summary of the verification checks the CVU performs, enter the following command:
/dev/dvdrom/crs/Disk1/cluvfy/runcluvfy.sh comp nodecon -n node1,node2 -verbose
Note:
You can use this command to obtain a list of all the interfaces available on the nodes that are suitable for use as VIPs, as well as a list of private interconnects that are connecting successfully on all nodes.Depending on the products that you intend to install, verify that the following software is installed on the system. The procedure following the table describes how to check these requirements.
Note:
Oracle Universal Installer (OUI) performs checks on your system to verify that it meets minimum installation requirements. To ensure that these verifications succeed, verify the requirements before you start OUI.The following is the list of supported Solaris platforms and requirements at the time of release:
Software Requirements List for Solaris Operating System (SPARC 64-Bit) Platforms
Software Requirements List for Solaris Operating System x86 Platforms
Software Requirements List for Solaris Operating System x86 (64-Bit) Platforms
Table 2-1 System Requirements for Solaris Operating System (SPARC 64-Bit)
Item | Requirement |
---|---|
Operating system |
One of the following 64-bit operating system versions:
|
Packages |
Solaris 8 and Solaris 9 SUNWarc SUNWbtool SUNWhea SUNWlibC SUNWlibm SUNWlibms SUNWsprot SUNWtoo SUNWi1of SUNWi1cs SUNWi15cs SUNWxwfnt SUNWsprox Solaris 10 Identical to Solaris 8 and 9, except that SUNWsprox is not needed. Note: You may also require additional font packages for Java, depending on your locale. Refer to the following Web site for more information: http://java.sun.com/j2se/1.4.2/font-requirements.html |
RAC |
Oracle Clusterware, or a supported Sun Cluster version. Sun Cluster is supported for use with RAC on SPARC systems but it is not required. If you use Sun Cluster, then you must install the following additional kernel packages: SUNWscucm SUNWudlmr SUNWudlm Note: You do not require the additional packages if you install Oracle Clusterware. In addition, you may need to install the following additional kernel packages depending on volume managers you have on your system: Clustered Solaris Volume Manager: SUNWscmd Clustered Veritas Volume Manager: SUNWcvm SUNWcvmr SUNWschwr Note: The SUNWschwr package installs disk fencing to protect data on the disks. It should be installed if you are using RAID but are not using Oracle Clusterware or a supported cluster volume manager. The disk fencing is also contained in the volume manager packages, so when using either of the volume manager options for RAC, the SUNWschwr package should not be installed even if the devices are hardware RAID. Review the following additional information for your operating system: |
|
Solaris 8 and Solaris 9 only:
For Sun Cluster, Oracle provides a UDLM patch that you must install onto each node in the cluster from the Note: At release date, Sun Cluster on Solaris 10 is not available. Check Certify on OracleMetaLink for updated support information. |
Oracle Messaging Gateway |
Oracle Messaging Gateway supports the integration of Oracle Streams Advanced Queuing (AQ) with the following software: IBM MQSeries V5.3, client and server Tibco Rendezvous 7.2 |
Pro*C/C++, Oracle Call Interface, Oracle C++ Call Interface, Oracle XML Developer's Kit (XDK), GNU Compiler Collection (GCC) |
Sun ONE Studio 8 (C and C++ 5.5) |
PL/SQL native compilation |
gcc 3.4.2 |
Oracle JDBC/OCI Drivers |
You can use the following optional JDK versions with the Oracle JDBC/OCI drivers, however they are not required for the installation:
Note: JDK 1.4.2_07 is installed with this release. |
Table 2-2 System Requirements for Solaris Operating System x86
Item | Requirement |
---|---|
Operating system |
The following 32-bit operating system release:
|
Packages |
SUNWarc SUNWbtool SUNWhea SUNWlibm SUNWlibms SUNWsprot SUNWtoo SUNWi1of SUNWi1cs SUNWi15cs SUNWxwfnt Note: You may also require additional font packages for Java, depending on your locale. Refer to the following Web site for more information: http://java.sun.com/j2se/1.4.2/font-requirements.html |
RAC |
Oracle Clusterware Note: Sun Cluster is not supported on x86 (32-bit) systems |
PL/SQL native compilation, Pro*C/C++, Oracle Call Interface, Oracle C++ Call Interface, Oracle XML Developer's Kit (XDK), GNU Compiler Collection (GCC) |
Sun ONE Studio 10 (C and C++ 5.5)
|
Oracle JDBC/OCI Drivers |
You can use the following optional JDK versions with the Oracle JDBC/OCI drivers:
Note: JDK 1.4.2_08 is installed with this release. Other JDK versions are not required for installation. |
Table 2-3 System Requirements for Solaris Operating System x86 (64-Bit)
Item | Requirement |
---|---|
Operating system |
Solaris 10 or later |
Packages |
SUNWarc SUNWbtool SUNWhea SUNWlibm SUNWlibms SUNWsprot SUNWtoo SUNWi1of SUNWi1cs SUNWi15cs SUNWxwfnt Note: You may also require additional font packages for Java, depending on your locale. Refer to the following Web site for more information: http://java.sun.com/j2se/1.4.2/font-requirements.html |
RAC |
Oracle Clusterware, or Sun Cluster version 3.1 plus SUNWscucm and one or more of the following packages depending on the volume manager being used: Clustered Solaris Volume Manager: SUNWscmd SUNWschwr Note: You do not require the additional packages if you install Oracle Clusterware. Sun Cluster is supported for use with RAC on x86 (64-bit) systems but it is not required. |
PL/SQL native compilation, Pro*C/C++, Oracle Call Interface, Oracle C++ Call Interface, Oracle XML Developer's Kit (XDK), GNU Compiler Collection (GCC) |
Sun ONE Studio 10 (C and C++ 5.5)
|
Pro*FORTRAN |
Fortran 95 |
Oracle JDBC/OCI Drivers |
You can use the following optional JDK versions with the Oracle JDBC/OCI drivers:
Note: JDK |
To ensure that the system meets these requirements, follow these steps:
To determine which version of Solaris is installed, enter the following command:
# uname -r 5.9
In this example, the version shown is Solaris 9 (5.9). If necessary, refer to your operating system documentation for information about upgrading the operating system.
To determine whether the required packages are installed, enter a command similar to the following:
# pkginfo -i SUNWarc SUNWbtool SUNWhea SUNWlibm SUNWlibms SUNWsprot \ SUNWsprox SUNWtoo SUNWi1of SUNWi1cs SUNWi15cs SUNWxwfnt
If a package that is required for your system architecture is not installed, then install it. Refer to your operating system or software documentation for information about installing packages.
Note:
There may be more recent versions of packages listed installed on the system. If a listed patch is not installed, then determine if a more recent version is installed before installing the version listed.You must verify that the required operating system patches for your system architecture are installed on the system. The procedure following the table describes how to check these requirements.
Note:
Your system may have more recent versions of the listed patches installed on it. If a listed patch is not installed, then determine if a more recent version is installed before installing the version listed.Select the table for your system architecture and review the list of required operating system patches:
Table 2-4 Solaris Operating System (SPARC 64-bit) Operating System Patches
Note:
The following patches are not required for silent installations:108652-66, X11 6.4.1: Xsun patch
108773-18, SunOS 5.8: IIIM and X I/O Method patch
108921-16, CDE 1.4: dtwm patch
108940-53, Motif 1.2.7 and 2.1.1: Runtime lib. patch for Solaris 8
To ensure that the system meets these requirements:
To determine whether an operating system patch is installed, and whether it is the correct version of the patch, enter a command similar to the following:
# /usr/sbin/patchadd -p | grep patch_number
For example, to determine if any version of the 112760 patch is installed, use the following command:
# /usr/sbin/patchadd -p | grep 112760
If an operating system patch is not installed, then download it from the following Web site and install it:
http://sunsolve.sun.com
Table 2-5 Solaris Operating System x86 (32-bit) Operating System Patches
Installation Type or Product | Requirement |
---|---|
All installations |
Patches for Solaris 10:
|
PL/SQL native compilation, Pro*C/C++, Oracle Call Interface, Oracle C++ Call Interface, Oracle XML Developer's Kit (XDK) |
Patches for Solaris 10:
|
RAC |
Sun Cluster Patches for Solaris 10:
|
To ensure that the system meets these requirements:
To determine whether an operating system patch is installed, and whether it is the correct version of the patch, enter a command similar to the following:
# /usr/sbin/patchadd -p | grep patch_number
For example, to determine if any version of the 112760 patch is installed, use the following command:
# /usr/sbin/patchadd -p | grep 112760
If an operating system patch is not installed, then download it from the following Web site and install it:
http://sunsolve.sun.com
If you require a CSD or a SupportPac for WebSphere MQ, then refer to the following Web site for download and installation information:
http://www-306.ibm.com/software/integration/wmq/
Table 2-6 Solaris Operating System x86 (64-bit) Operating System Patches
Installation Type or Product | Requirement |
---|---|
All installations |
Patches for Solaris 10:
|
PL/SQL native compilation, Pro*C/C++, Pro*FORTRAN, Oracle Call Interface, Oracle C++ Call Interface, Oracle XML Developer's Kit (XDK) |
Patches for Solaris 10:
|
RAC |
Sun Cluster Patches for Solaris 10:
|
To ensure that the system meets these requirements:
To determine whether an operating system patch is installed, and whether it is the correct version of the patch, enter a command similar to the following:
# /usr/sbin/patchadd -p | grep patch_number
For example, to determine if any version of the 112760 patch is installed, use the following command:
# /usr/sbin/patchadd -p | grep 112760
If an operating system patch is not installed, then download it from the following Web site and install it:
http://sunsolve.sun.com
If you require a CSD or a SupportPac for WebSphere MQ, then refer to the following Web site for download and installation information:
http://www-306.ibm.com/software/integration/wmq/
Note:
The kernel parameter and shell limit values shown in the following sections are recommended values only. For production database systems, Oracle recommends that you tune these values to optimize the performance of the system. Refer to your operating system documentation for more information about tuning kernel parameters.On Solaris Operating System (SPARC 64-bit) installations running Solaris 8 or Solaris9, on all nodes in the cluster, verify that the kernel parameters shown in the following table are set to values greater than or equal to the recommended value:
Note:
The following parameters are obsolete in Solaris 9:shmsys:shminfo_shmmin
shmsys:shminfo_shmseg
On Solaris 8 and Solaris 9 operating systems, use the following procedure to view the current value specified for these kernel parameters, and to change them if necessary:
To view the current value specified for these kernel parameters, and to change them if necessary:
To view the current values of these parameters, enter the following commands:
# grep noexec_user_stack /etc/system # /usr/sbin/sysdef | grep SEM # /usr/sbin/sysdef | grep SHM
If you must change any of the current values, then:
Create a backup copy of the /etc/system
file, for example:
# cp /etc/system /etc/system.orig
Open the /etc/system
file in any text editor and, if necessary, add lines similar to the following (edit the lines if the file already contains them):
set noexec_user_stack=1 set semsys:seminfo_semmni=100 set semsys:seminfo_semmns=1024 set semsys:seminfo_semmsl=256 set semsys:seminfo_semvmx=32767 set shmsys:shminfo_shmmax=4294967295 set shmsys:shminfo_shmmin=1 set shmsys:shminfo_shmmni=100 set shmsys:shminfo_shmseg=10
Enter the following command to restart the system:
# /usr/sbin/reboot
When the system restarts, log in and switch user to root
.
Repeat this procedure on all other nodes in the cluster.
On Solaris 10 operating systems, verify that the kernel parameters shown in the following table are set to values greater than or equal to the recommended value shown. The table also contains the resource controls that replace the /etc/system
file for a specific kernel parameter. The procedure following the table describes how to verify and set the values.
Note:
In Solaris 10, you are not required to make changes to the/etc/system
file to implement the System V IPC. Solaris 10 uses the resource control facility for its implementation. However, Oracle recommends that you set both resource control and /etc/system/ parameters. Operating system parameters not replaced by resource controls continue to affect performance and security on Solaris 10 systems. For further information, contact your Sun vendor.On Solaris 10, use the following procedure to view the current value specified for resource controls, and to change them if necessary:
To view the current values of the resource control, enter the following commands:
# id -p // to verify the project id uid=0(root) gid=0(root) projid=1 (user.root) # prctl -n project.max-shm-memory -i project user.root # prctl -n project.max-sem-ids -i project user.root
If you must change any of the current values, then:
To modify the value of max-shm-memory to 6 GB:
# prctl -n project.max-shm-memory -v 6442450944 -r -i project user.root
To modify the value of max-sem-ids to 256:
# prctl -n project.max-sem-ids -v 256 -r -i project user.root
Note:
When you use the commandprctl
(Resource Control) to change system parameters, you do not need to restart the system for these parameter changes to take effect. However, the changed parameters do not persist after a system restart.Use the following procedure to modify the resource control project settings, so that they persist after a system restart:
By default, Oracle instances are run as the oracle
user of the dba
group . A project with the name group.dba
is created to serve as the default project for the oracle user. Run the command id
to verify the default project for the oracle
user:
# su - oracle $ id -p uid=100(oracle) gid=100(dba) projid=100(group.dba) $ exit
To set the maximum shared memory size to 2 GB, run the projmod
command:
# projmod -sK "project.max-shm-memory=(privileged,2G,deny)" group.dba
Alternatively, add the resource control value project.max-shm-memory=(privileged,2147483648,deny)
to the last field of the project entries for the Oracle project.
After these steps are complete, check the values for the /etc/project
file using the following command:
# cat /etc/project
The output should be similar to the following:
system:0:::: user.root:1:::: noproject:2:::: default:3:::: group.staff:10:::: group.dba:100:Oracle default project:::project.max-shmmemory=(privileged,2147483648,deny)
To verify that the resource control is active, check process ownership, and run the commands id
and prctl
, as in the following example:
# su - oracle $ id -p uid=100(oracle) gid=100(dba) projid=100(group.dba) $ prctl -n project.max-shm-memory -i process $$ process: 5754: -bash NAME PRIVILEGE VALUE FLAG ACTION RECIPIENT project.max-shm-memory privileged 2.00GB - deny
Note:
For additional information, refer to the Solaris Tunable Parameters Reference Manual.The User Data Protocol (UDP) parameter settings define the amount of send and receive buffer space for sending and receiving datagrams over an IP network. These settings affect cluster interconnect transmissions. If the buffers set by these parameters are too small, then incoming UDP datagrams can be dropped due to insufficient space, which requires send-side retransmission. This can result in poor cluster performance.
On Solaris, the UDP parameters are udp_recv_hiwat
and udp_xmit_hiwat
. On Solaris 10 the default values for these parameters are 57344 bytes. Oracle recommends that you set these parameters to at least 65536 bytes.
To check current settings for udp_recv_hiwat and udp_xmit_hiwat, enter the following commands:
# ndd /dev/udp udp_xmit_hiwat # ndd /dev/udp udp_recv_hiwat
To set the values of these parameters to 65536 bytes in current memory, enter the following commands:
# ndd -set /dev/udp udp_xmit_hiwat 65536# ndd -set /dev/udp udp_recv_hiwat 65536
To set the values of these parameters to 65536 bytes on system restarts, open the /etc/system
file, and enter the following lines:
set udp:xmit_hiwat=65536 set udp:udp_recv_hiwat=65536
As the oracle
user, use the following command syntax to start Cluster Verification Utility (CVU) stage verification to check hardware and operating system setup:
/mountpoint/crs/Disk1/cluvfy/runcluvfy.sh stage –post hwos –n node_list [-verbose]
In the preceding syntax example, replace the variable node_list
with the names of the nodes in your cluster, separated by commas. For example, to check the hardware and operating system of a two-node cluster with nodes node1 and node2, with the mountpoint /dev/dvdrom/
and with the option to limit the output to the test results, enter the following command:
/dev/dvdrom/crs/Disk1/cluvfy/runcluvfy.sh stage –post hwos –n node1,node2
Select the option -verbose
to receive detailed reports of the test results, and progress updates about the system checks performed by Cluster Verification Utility.
As the oracle
user, use the following command syntax to check if your system meets the operating system requirement pre-installation tasks:
/mountpoint/crs/Disk1/cluvfy/runcluvfy.sh comp sys -n node_list -p {crs|database} -osdba osdba_group -orainv orainv_group -verbose
In the preceding syntax example:
The variable mountpoint is the mountpoint of the Oracle 10g Release 2 (10.2) installation media
The variable node_list
is the list of nodes in your cluster, separated by commas
The -p
flag identifies either crs
or database
, and indicates that checks are performed for Oracle Clusterware or Oracle Database system requirements
The variable osdba_group
is the name of your OSDBA group, typically dba
The variable orainv_group
is the name of your Oracle Inventory group, typically oinstall
You can select the option -verbose
to receive progress updates as the CVU performs its system checks, and detailed reporting of the test results.
For example, to perform a system check for an Oracle Clusterware installation on a two-node cluster with nodes node1 and node2, with the OSDBA dba
and Oracle inventory group oinstall
, and with the media mountpoint /dev/dvdrom/
, then enter the following command:
/dev/dvdrom/crs/Disk1/cluvfy/runcluvfy.sh comp sys -n node1,node2 -p crs -osdba crs -orainv oinstall
You must identify or create the following directories for the Oracle software, as follows:
The following subsections describe the requirements for these directories.
The Oracle base directory acts as a top-level directory for Oracle software installations. Optimal Flexible Architecture (OFA) guidelines recommend that you use a path similar to the following for the Oracle base directory:
/mount_point/app/oracle_sw_owner
mount_point
is the mount point directory for the file system that will contain the Oracle software.
The examples in this guide use /u01
for the mount point directory. However, you could choose another mount point directory, /oracle
or /opt/oracle
for example.
oracle_sw_owner
is the operating system user name of the Oracle software owner, for example oracle
.
You can use the same Oracle base directory for more than one installation or you can create separate Oracle base directories for different installations. If different operating system users install Oracle software on the same system, then each user must create a separate Oracle base directory. The following example Oracle base directories could all exist on the same system:
/u01/app/oracle /u01/app/orauser /opt/oracle/app/oracle
The following sections describe how to identify existing Oracle base directories that might be suitable for your installation and how to create an Oracle base directory if necessary.
Regardless of whether you create an Oracle base directory or decide to use an existing one, you must set the ORACLE_BASE environment variable to specify the full path to the Oracle base directory.
Note:
The Oracle base directory can be on a local file system or on an NFS file system on a certified NAS device.The Oracle Inventory directory (oraInventory
) stores an inventory of all software installed on the system. It is required by, and shared by, all Oracle software installations on a single system. The first time you install Oracle software on a system, Oracle Universal Installer prompts you to specify the path to this directory. If you are installing the software on a local file system, then Oracle recommends that you choose the following path:
oracle_base/oraInventory
If the Oracle base directory is located either on a cluster file system, or on a shared NFS file system on a NAS device, then you must place the Oracle Central Inventory directory on a local file system, privately mounted on each node, so that each node has a separate copy of the central inventory.
If you specify a shared location for the Oracle Central Inventory, then each node attempts to write to the same central inventory. This is not supported.
Oracle Universal Installer creates the directory that you specify, and sets the correct owner, group, and permissions for it. You do not need to create it.
Note:
All Oracle software installations rely on the Oracle base directory. Make sure that you back it up regularly.Do not delete the Oracle base directory unless you have completely removed all Oracle software from the system.
Oracle Clusterware Home Directory
The Oracle Clusterware home directory is the directory where you choose to install the software for Oracle Clusterware. You must install Oracle Clusterware in a separate home directory. When you run Oracle Universal Installer, it prompts you to specify the path to this directory, as well as a name that identifies it. Oracle recommends that you specify a path similar to the following for the Oracle Clusterware home directory:
/u01/app/oracle/product/crs
Note:
Because you must change the permissions of all of the parent directories of the Oracle Clusterware home directory after installing the software to grant write access only to theroot
user, the Oracle Clusterware home directory must not be a subdirectory of the Oracle base directory.The Oracle home directory is the directory where you choose to install the software for a particular Oracle product. You must install different Oracle products, or different releases of the same Oracle product, in separate Oracle home directories. When you run Oracle Universal Installer, it prompts you to specify the path to this directory, as well as a name that identifies it. The directory that you specify must be a subdirectory of the Oracle base directory. Oracle recommends that you specify a path similar to the following for the Oracle home directory:
oracle_base/product/10.2.0/db_1
Oracle Universal Installer creates the directory path that you specify under the Oracle base directory. It also sets the correct owner, group, and permissions on it. You do not need to create this directory.
Before starting the installation, you must either identify an existing Oracle base directory or if required, create one. This section contains information about the following:
Note:
You can choose to create an Oracle base directory, even if other Oracle base directories exist on the system.Identifying an Existing Oracle Base Directory
Existing Oracle base directories may not have paths that comply with OFA guidelines. However, if you identify an existing Oracle Inventory directory or existing Oracle home directories, then you can usually identify the Oracle base directories, as follows:
Identifying an existing Oracle Inventory directory
Enter the following command on all nodes in the cluster to view the contents of the oraInst.loc
file:
# more /var/opt/oracle/oraInst.loc
If the oraInst.loc
file exists, then the output from this command is similar to the following:
inventory_loc=/u01/app/oracle/oraInventory inst_group=oinstall
The inventory_loc
parameter identifies the Oracle Inventory directory (oraInventory
) on that system. The parent directory of the oraInventory
directory is typically an Oracle base directory. In the previous example, /u01/app/oracle
is an Oracle base directory.
Identifying existing Oracle home directories
Enter the following command on all nodes in the cluster to view the contents of the oratab
file:
# more /var/opt/oracl/oratab
If the oratab
file exists, then it contains lines similar to the following:
*:/u03/app/oracle/product/10.2.0/db_1:N *:/opt/orauser/infra_904:N *:/oracle/9.2.0:N
The directory paths specified on each line identify Oracle home directories. Directory paths that end with the user name of the Oracle software owner that you want to use are valid choices for an Oracle base directory. If you intend to use the oracle
user to install the software, then you could choose one of the following directories from the previous example:
/u03/app/oracle /oracle
Note:
If possible, choose a directory path similar to the first (/u03/app/oracle
). This path complies with the OFA guidelines.Before deciding to use an existing Oracle base directory for this installation, make sure that it satisfies the following conditions:
It should not be on the same file system as the operating system.
It must have an identical path on all nodes in the cluster, or it must be an NFS file system on a certified NAS device.
If you are not using an NFS file system, then create identical Oracle base directories on the other nodes.
It must have 1.4 GB free disk space on all the nodes in the cluster
To determine the free disk space on the file system where the Oracle base directory is located, enter the following command:
# df -k oracle_base_path
In the preceding command, replace the variable oracle_base_path
with the path for the Oracle base directory.
When you are configuring the oracle
user's environment in the section "Creating the Oracle Clusterware Home Directory", set the ORACLE_BASE environment variable to specify the directory you choose.
If an Oracle base directory does not exist on the system, or if you want to create an Oracle base directory, then refer to the following section.
Creating an Oracle Base Directory
Before you create an Oracle base directory, you must identify an appropriate file system. The Oracle base directory requires 1.5 GB of free disk space.
To identify an appropriate file system, follow these steps:
Use the df -
k
command to determine the free disk space on each mounted file system.
From the display, identify a file system that has appropriate free space.
Note:
The Oracle base directory can be on a local file system or on an NFS file system on a certified NAS device.The path to the Oracle base directory must be the same on all nodes.
Note the name of the mount point directory for the file system that you identified.
To create the Oracle base directory and specify the correct owner, group, and permissions for it, follow these steps:
Enter commands similar to the following to create the recommended subdirectories in the mount point directory that you identified, and to set the appropriate owner, group, and permissions on them:
# mkdir -p /mount_point/app/oracle_sw_owner # chown -R oracle:oinstall /mount_point/app/oracle_sw_owner # chmod -R 775 /mount_point/app/oracle_sw_owner
For example, if the mount point you identify is /u01
, and oracle
is the user name of the Oracle software owner, then the recommended Oracle base directory path is as follows:
/u01/app/oracle
If necessary, repeat the commands listed in the previous step to create the same directory on the other nodes in the cluster.
When you configure the oracle
user's environment later in this chapter, set the ORACLE_BASE environment variable to specify the Oracle base directory you have created in this task.
Oracle Universal Installer (OUI) creates the Oracle Clusterware home directory for you. Ensure before you start the installation that you provide sufficient disk space on a file system for the Oracle Clusterware directory, and the parent directory of the Oracle Clusterware directory space is writable by the Oracle user.
To identify an appropriate file system, follow these steps:
Use the df -k
command to determine the free disk space on each mounted file system.
From the display, identify a file system that has at least 1.4 GB of free disk space.
If you are using the same file system for the Oracle base directory, then this 1.4 GB of disk space is additional to the free disk space requirement that you identified previously.
Note:
The file system can be a local file system or an NFS file system on a certified NAS device. Do not create the Oracle Clusterware home directory on an OCFS file system.The path to the Oracle Clusterware home directory must be the same on all nodes.
Note the name of the mount point directory for the file system that you identified.
To create the Oracle Clusterware home directory and specify the correct owner, group, and permissions for it, follow these steps:
Enter commands similar to the following to create the recommended subdirectories in the mount point directory that you identified and set the appropriate owner, group, and permissions on them:
# mkdir -p /mount_point/crs/oracle_sw_owner/product/10/app # chown -R root:oinstall /mount_point/crs # chmod -R 775 /mount_point/crs/oracle_sw_owner
If the mount point you identified is /u01
, then the recommended Oracle Clusterware home directory path is as follows:
/u01/crs/oracle/product/10/crs
Note:
After installation, you should change permissions so that only the root user can write to the Oracle Clusterware home directory.If necessary, repeat the commands listed in the previous step to create the same directory on the other nodes in the cluster.
Enter commands similar to the following to set the ORACLE_BASE and ORACLE_HOME environment variable in preparation for the Oracle Clusterware installation:
Bourne, Bash, or Korn shell:
$ ORACLE_BASE=/u01/app/oracle $ ORACLE_HOME=/u01/crs/oracle/product/10/app $ export ORACLE_BASE $ export ORACLE_HOME
C shell:
% setenv ORACLE_BASE /u01/app/oracle % setenv ORACLE_HOME /u01/crs/oracle/product/10/app
Enter the following commands to ensure that the TNS_ADMIN environment variable is not set:
Bourne, Bash, or Korn shell:
$ unset TNS_ADMIN
C shell:
% unsetenv TNS_ADMIN
To verify that the environment has been set correctly, enter the following commands:
$ umask $ env | more
Verify that the umask
command displays a value of 22
, 022
, or 0022
and the environment variables that you set in this section have the correct values.
Table 2-7 provides an overview of what you need to do if you have an existing Oracle database on the system where you plan to install Oracle Database 10g Release 2 (10.2). Review the table, and perform tasks as required.
See Also:
Oracle Database Upgrade Guide for additional information about preparing for and performing upgrades.Table 2-7 Overview of System Preparation for Upgrades or Co-existing Databases
Installation Scenario | What you need to do |
---|---|
Upgrading from Oracle Database 10g Release 1 (10.1) to 10g Release 2 (10.2) |
No additional tasks. Refer to Installing Oracle 10g Release 2 on a System with Oracle 10g Release 1 |
installing Oracle Database 10g Release 2 (10.2) on a system to co-exist with Oracle Database 10g Release 1 (10.1) |
No additional tasks. Refer to Installing Oracle 10g Release 2 on a System with Oracle 10g Release 1 |
Upgrading from Oracle9i Release 9.2 to Oracle Database 10g Release 2 (10.2) |
Shut down the Global Service Daemon, and shut down a default listener on port 1521, if present. Refer to Installing Oracle 10g Release 2 on a System with Oracle9i Release 2 |
Installing Oracle Database 10g Release 2 (10.2) on a system to co-exist with Oracle9i Release 9.2 |
Shut down a default listener on port 1521, if present, and shut down the Global Service Daemon. Refer to Installing Oracle 10g Release 2 on a System with Oracle9i Release 2 |
Installing Oracle 10g Release 2 on a System with Oracle 10g Release 1
If your system has an Oracle Database Release 10g Release 10. 1 installation, and you install an Oracle Database 10g Release 2 (10.2) either to coexist with or to upgrade the 10.1, then most installation types configure and start a default Oracle Net listener using TCP/IP port 1521 and the IPC key value EXTPROC. One of the following occurs:
During a co-existing installation, Database Configuration Assistant (DBCA) automatically migrates the listener and related files from the 10.1 Oracle home to the 10.2 Oracle home.
During an upgrade, Oracle Database Upgrade Assistant (DBUA) automatically locates the Oracle 10g release 1 (10.1) listener, and migrates it to Oracle 10g release 2.
Proceed to Chapter 3.
Installing Oracle 10g Release 2 on a System with Oracle9i Release 2
This section provides instructions for preparing
Explanation of Tasks If you are installing an Oracle Database 10g Release 2 (10.2) on a system with an existing Oracle9i Release 2 (9.2) database, and the Oracle Net listener process is using the same port or key value as the default used with the Oracle 10g Release 2 (10.2) installation, port 1521, then Oracle Universal Installer can only configure the new listener; it cannot start it. To ensure that the new listener process starts during the installation, you must shut down any existing listeners before starting Oracle Universal Installer. To do this, refer to "Shutting Down the Listener"
You must shut down the Global Services Daemon (GSD), because otherwise, during 10g Release 2 (10.2) installation, the Oracle9i Release 9.2 SRVM shared data is upgraded into an Oracle Cluster Registry that the 9.2 GSD will not be able to use. The 10.2 Oracle Clusterware installation starts a 10g Release 2 (10.2) GSD to serve the Oracle9i 9.2 clients. To do this, refer to "Shutting down the Global Services Daemon"
Shutting Down the Listener To determine whether an existing Oracle9i listener process is running and to shut it down if necessary, follow these steps:
Switch user to oracle
:
# su - oracle
Enter the following command to determine whether an Oracle9i listener process is running and to identify its name and the Oracle home directory in which it is installed:
$ ps -ef | grep tnslsnr
This command displays information about the Oracle Net listeners running on the system:
... oracle_home1/bin/tnslsnr LISTENER -inherit
In this example, oracle_home1
is the Oracle home directory where the listener is installed and LISTENER
is the listener name.
Note:
If no Oracle Net listeners are running, then proceed to Chapter 3.Set the ORACLE_HOME environment variable to specify the appropriate Oracle home directory for the listener:
Bourne, Bash, or Korn shell:
$ ORACLE_HOME=oracle_home1
$ export ORACLE_HOME
C or tcsh shell:
% setenv ORACLE_HOME oracle_home1
Enter the following command to identify the TCP/IP port number and IPC key value that the listener is using:
$ $ORACLE_HOME/bin/lsnrctl status listenername
Note:
If the listener uses the default name LISTENER, then you do not have to specify the listener name in this command.Enter a command similar to the following to stop the listener process:
$ $ORACLE_HOME/bin/lsnrctl stop listenername
Repeat this procedure to stop all listeners running on this system and on all other nodes in the cluster.
Shutting down the Global Services Daemon As the Oracle user, on each node of the cluster, use the following syntax to shut down the GSD:
$ cd 92_Oracle_home
$ bin/gsdctl stop
In the preceding syntax example, the variable 92_Oracle_home is the Oracle9i Release 2 (9.2) database home.