A cluster installation uses Oracle Universal Installer to install software on the nodes of a cluster that are network reachable and bound together by Oracle Clusterware. You can use Oracle Universal Installer to extend the Oracle home of a product installation to include additional nodes on the cluster.
This chapter includes the following sections:
Oracle Universal Installer and Oracle Real Application Clusters
General System Installation Requirements for Oracle Real Application Clusters
Cluster Setup and Pre-installation Configuration Tasks for Oracle Real Application Clusters
Pre-installation Tasks for Oracle Real Application Clusters on UNIX
Pre-installation Tasks for Real Application Clusters on Windows
Converting Single-instance Nodes to Real Application Clusters
Troubleshooting Real Application Clusters / Oracle Clusterware Installation
The Oracle Universal Installer facilitates the installation of Oracle grid infrastructure for a cluster, which includes Oracle Clusterware and Oracle Automatic Storage Management (Oracle ASM). You must install Oracle grid infrastructure before you install Oracle Real Application Clusters (Oracle RAC). In most cases, you use the graphical user interface (GUI) provided by the Oracle Universal Installer to install the software. However, you can also use the Oracle Universal Installer to complete non-interactive (or "silent") installations without using the GUI.
The Oracle inventory maintains records of Oracle software versions and patches. Each installation has a Central Inventory where the Oracle home is registered. Oracle software installations have a local home directory, whose path location is recorded in the Central Inventory. The local inventory directory for each Oracle software installation contains a list of components and applied interim patches associated with that software. Because faulty inventory information can corrupt your Oracle software installation, the Oracle Universal Installer must perform all read and write operations on Oracle inventories. Ensure that you do not modify files in the Central Inventory or the Oracle home inventory.
When you install Oracle grid infrastructure for a cluster or Oracle Real Application Clusters, the Oracle Universal Installer copies the Oracle software onto the node from which you are running it. If your Oracle home is not on a shared file system, the Oracle Universal Installer propagates the software onto the other nodes that you have selected to be part of your Oracle Universal Installer installation session. The Oracle inventory maintains a list of each node that is a member of the Oracle Real Application Clusters database, and lists the paths to each node's Oracle home. This is used to maintain patches and updates for each member node of the Oracle Real Application Clusters database.
When the Oracle Universal Installer installs the Oracle software, Oracle recommends that you select a preconfigured database, or use the Database Configuration Assistant (DBCA) interactively to create your cluster database. You can also manually create your database as described in the Oracle Database Administrator's Guide.
Oracle ASM is installed as part of the Oracle grid infrastructure installation. Oracle recommends that you use Oracle ASM. If you are not using Oracle ASM, configure Oracle RAC on a supported storage option.
The Oracle Universal Installer installs Oracle Clusterware on each node on which the Oracle Universal Installer detects that third-party vendor clusterware is present. If third-party vendor clusterware is not present, you must use the Oracle Universal Installer to enter the nodes on which you want the Oracle Clusterware to be installed. The Oracle Clusterware home can be either shared by all nodes, or private to each node, depending on your responses when you run the Oracle Universal Installer.
When third-party vendor clusterware is present, Oracle Clusterware can interact with the third-party vendor clusterware. In using third-party vendor clusterware, note that Oracle Clusterware can integrate with third-party vendor clusterware for all operating systems except Linux and Windows. You need to have Oracle Cluster Registry and Voting Disks shared across all nodes.
All instances in an Oracle Real Application Clusters environment share the control file, server parameter file, redo log files, and all data files. These files reside on a shared cluster file system or on shared disks. Either of these types of file configurations are accessed by all the cluster database instances. Each instance also has its own set of redo log files. During failures, shared access to redo log files enables surviving instances to perform recovery.
Each node that is going to be part of your Oracle Real Application Clusters installation must meet the following hardware and software requirements. You will perform step-by-step tasks for hardware and software verification for the platform-specific pre-installation procedures.
Each node in a cluster requires the following hardware:
External shared disks for storing the Oracle Clusterware files.
See the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2) for information on the available disk configuration options. Review these options before you decide which storage option to use in your Oracle Real Application Clusters environment.
One private Internet protocol (IP) address for each node to serve as the private interconnect. The following must be true for each private IP address:
– It must be separate from the public network.– It must be accessible on the same network interface on each node.– It must have a unique address on each node.The private interconnect is used for inter-node communication by both Oracle Clusterware and Oracle Real Application Clusters. If the private address is available from a network name server (DNS), you can use that name. Otherwise, the private IP address must be available in each node's /etc/hosts
file on UNIX and %SystemRoot%\system32\drivers\etc\hosts
on Windows.
During Oracle Clusterware installation, the information you enter as the private IP address determines which private interconnects are used by Oracle Real Application Clusters database instances.
One public IP address for each node to be used as the Virtual IP address for client connections and for connection failover.
This public Virtual IP address (VIP) must be associated with the same interface name on every node that is part of your cluster. Additionally, the IP addresses that you use for all of the nodes that are part of a cluster must be from the same subnet. If you have a domain name server (DNS), register the host names for the VIP with DNS. The Virtual IP address should not be in use at the time of the installation, because this is a Virtual IP address that Oracle manages.
One public fixed host name address for each node, typically assigned by the system administrator during operating system installation. If you have a DNS, register both the fixed IP and the VIP address with DNS. If you do not have DNS, you must make sure that both public IP addresses are in the node host file.
Each node in a cluster requires a supported interconnect software protocol to support Cache Fusion, and to support Oracle Clusterware polling. Your interconnect must be certified by Oracle for your platform. You should also have a Web browser, both to enable Oracle Enterprise Manager, and to view online documentation. For Oracle Database 11g requirements, Oracle Clusterware provides the same functionality as third-party vendor clusterware. Using Oracle Clusterware also reduces installation and support complications. However, you may require third-party vendor clusterware if you use a non-ethernet interconnect, or if you have deployed clusterware-dependent applications on the same cluster where you deploy Oracle Real Application Clusters.
Before installing Oracle Real Application Clusters, perform the following procedures:
Ensure that you have a certified combination of operating system and Oracle software version by referring to the OracleMetaLink certification information, which is located at the following Web site:
http://metalink.oracle.com
Click Certify & Availability, and select 1.View Certifications by Product.
Note:
The layout of the OracleMetaLink site and the site's certification policies are subject to change.Configure a high-speed interconnect that uses a private network. Some platforms support automatic failover to an additional interconnect.
Determine the storage option for your system and configure the shared disk.
Ensure that the directory structure is similar in all nodes.
Ensure that all nodes in the cluster have the same time zone settings.
Install the operating system patches for the Oracle software. For more information, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
You need to complete the following pre-installation tasks before you start the Oracle Universal Installer:
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, enter the following command to enable remote hosts to display X applications on the local X server:
$ xhost +
If you are not installing the software on the local system, 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, enter the following command to switch user to root
:
$ su - root password: #
If you are installing the software from a PC or other system with X server software installed:
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, enter the following command to switch user to root
:
$ su - root password: #
Depending on whether it is the first time an Oracle software product is being installed on a system and on the products that you are installing, you may need to create several UNIX groups and a UNIX user account. The following UNIX group and users are required for all installations:
The Oracle Inventory group (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.
The Oracle software owner user (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.
You need to create other groups and users in addition to the ones created above. For more information on creating the required groups and users, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
The Oracle software users and 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 to 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. You must create identical users and groups on other cluster nodes only if you are using local users and groups. If you are using users and groups defined in a directory service such as NIS, they are already identical on each cluster node.
To determine the user ID (UID) and the group IDs (GID) for the 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 identity (UID) for the Oracle user and the group identities (GIDs) for the groups to which it belongs.
To create the user and groups on the other cluster nodes, repeat the following procedure on each node:
Log in to the cluster node in which you want to create the user and groups as root
.
Enter commands as per the syntax to create the respective groups. Use the -g
option to specify the correct GID for each group:
# /usr/sbin/groupadd -g <group_id> <group_name>
Before you install and use Oracle Real Application Clusters, you must configure secure shell (SSH) for the oracle
user on all cluster nodes. Oracle Universal Installer uses the ssh
and scp
commands during installation to run remote commands on and copy files to the other cluster nodes. You must configure SSH so that these commands do not prompt for a password. SSH is also used by the configuration assistants, Enterprise Manager, and when adding nodes to the cluster.
You can configure SSH from the Oracle Universal Installer (OUI) interface during installation for the user account running the installation. The automatic configuration creates passwordless SSH connectivity between all cluster member nodes. You can use an SSH Connectivity button available in the Cluster Node information page for this purpose.
To enable the script to run, you must remove stty commands from the profiles of any Oracle software installation owners, and remove other security measures triggered during a login and that generate messages to the terminal. These messages, mail checks, and other displays prevent Oracle software installation owners from using the SSH configuration script that is built into the Oracle Universal Installer. If they are not disabled, you must manually configure SSH before running an installation.
On Linux systems, to enable Oracle Universal Installer to use the ssh and scp commands without being prompted for a pass phrase, you must have user equivalency in the cluster. User equivalency exists in a cluster when the following occurs on all nodes in the cluster:
A given user has the same user name, user ID (UID), and password.
A given user belongs to the same groups.
A given group has the same group ID (GID).
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. However, these services are disabled by default on most Linux systems.To configure SSH, complete the following steps on each cluster 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 for it:
$ mkdir ~/.ssh $ chmod 700 ~/.ssh
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 different pass phrase 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 command 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.
Copy the contents of the ~/.ssh/id_rsa.pub
and ~/.ssh/id_dsa.pub
files to the ~/.ssh/authorized_keys
file on this node and to the same file on all other cluster nodes.
Note:
The~/.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 ~/.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 use the ssh
or scp
commands without being prompted for a password or a pass phrase.
To test the SSH configuration, enter the following commands from the same terminal session, testing the configuration of each cluster node:
$ 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, verify that the ~/.ssh/authorized_keys
file on that node contains the correct public keys.
Note:
The first time you use SSH to connect to a node from a particular system, you might see a message stating that the authenticity of the host could not be established. 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, 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 only act when the shell is an interactive shell.
To ensure that X11 forwarding does 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, the Oracle Universal Installer uses SSH to run commands and copy files to the other nodes. During the installation, hidden files on the system (for example, .bashrc
or .cshrc
) can cause installation errors if they contain stty
commands.
To avoid this problem, Oracle recommends that you 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
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. For more information on configuring the environment, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
Each system must meet certain minimum hardware requirements. For more information on hardware requirements, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
There are some minimum networking hardware and Internet protocol (IP) address requirements. Check that you have the networking hardware and Internet protocol (IP) address required for an Oracle Real Application Clusters installation.
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 interface names associated with the network adapters for each network must be the same on all nodes.
For increased reliability, you can 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 Real Application Clusters and TCP is the interconnect protocol for Oracle Clusterware. Token-Ring is not supported for the interconnect.For the private network, the end points of all designated interconnect interfaces must be completely reachable on the network.
If you are using NFS, 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.
Before starting the installation, you must identify or obtain the following IP addresses for each node:
An IP address and an associated host name registered in the domain name service (DNS) for each public network interface.
One unused virtual IP address and an associated virtual host name registered in DNS, or resolved in the host file, or both, that you will configure for the primary public network interface.
The virtual IP address must be in the same subnet as the associated public interface. After installation, you can configure clients to use the virtual host name or IP address. If a node fails, then its virtual IP address fails over to another node.
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.
The Oracle Universal Installer performs checks on your system to verify that it meets the requirements listed for your platform. To ensure that these checks pass, verify the requirements before you start the Installer.
Depending on the Oracle products that you intend to install, verify that the required software is installed on the system. For more information on software requirements, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
Each cluster node must meet the recommended kernel values. For information on verifying and setting the kernel parameters, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
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. It is analogous to the C:\Oracle
directory used for Oracle software installations on Windows systems. On UNIX systems, the 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
In this example:
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, such as /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, 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
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 this directory.
Note:
The Oracle base directory can be on a local file system or on an NFS file system on a certified NAS device. Do not create the Oracle base directory on an OCFS version 1 file system.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, Oracle recommends that you choose the following path:
oracle_base/../oraInventory
If the Oracle base directory is on a cluster file system, or on an NFS file system on a NAS device, you must specify a path for the Oracle Inventory directory on a local file system. The Oracle base directory must be on a local file system to enable all of the nodes to have separate inventories.
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.
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/crs/oracle/product/11.2.0/app
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 the root 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/11.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. For more information on identifying or creating an Oracle Base Directory, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
Oracle Universal Installer 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 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/11.2.0/crs # chown -R root:oinstall /mount_point/crs # chmod -R 775 /mount_point/crs/oracle_sw_owner
If the mount point you identified is /u01
, the recommended Oracle Clusterware home directory path is as follows:
/u01/crs/oracle/product/11.2.0/crs
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 variables in preparation for the Oracle Clusterware installation:
Bourne, Bash, or Korn shell:
$ ORACLE_BASE=/u01/app/oracle $ ORACLE_HOME=/u01/crs/oracle/product/11.2.0/crs $ export ORACLE_BASE $ export ORACLE_HOME
C shell:
% setenv ORACLE_BASE /u01/app/oracle % setenv ORACLE_HOME /u01/crs/oracle/product/11.2.0/crs
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.
You need to complete the following pre-installation tasks before you start the Oracle Universal Installer to install Oracle Clusterware and Oracle Real Application Clusters on Microsoft Windows systems.
Oracle recommends you to review the certification matrix on the OracleMetaLink Web site for the most up-to-date list of certified hardware platforms and operating system versions for Oracle software. This Web site also provides patches and workaround information for bugs. For more information on accessing the OracleMetaLink site, see "Download and Install Patches".
Each system must meet minimum hardware requirements. For more information on hardware requirements and the steps involved to check them, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
Each system must meet minimum software requirements. For more information on software requirements and the steps involved to check them, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
There are some minimum networking hardware and Internet protocol (IP) address requirements. Check that you have the networking hardware and Internet protocol (IP) address required for an Oracle Real Application Clusters installation. For more information on the steps involved in checking these requirements, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
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 private and public network interface names must be different from each other and cannot contain any multibyte language characters. The names are case-sensitive.
The private network interface name must be the same on all nodes.
The public network interface name must be the same on all nodes.
The public interface must be listed first in the ipconfig list.
Oracle supports the TCP/IP protocol for the public and private networks.
Before starting the installation, you must identify or obtain the following IP addresses for each node:
An IP address and an associated host name registered in the domain name service (DNS) for each public network interface.
One unused virtual IP address and an associated virtual host name registered in DNS that you will configure for the primary public network interface.
The virtual IP address must be in the same subnet as the associated public interface. After installation, you can configure clients to use the virtual host name or IP address. If a node fails, then its virtual IP address fails over to another node.
A private IP address and optional host name for each private interface.
Oracle recommends that you use private network IP addresses for the private interfaces; for example: 10.*.*.* or 192.168.*.*. You can use the %SystemRoot%\system32\drivers\etc\hosts
file on each node to associate private host names with private IP addresses.
Depending on the Oracle products that you intend to install, verify the required components for the Oracle software you are installing and ensure they are installed on the system. You can find more information on the components in the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
You need to perform certain storage configuration tasks before you start Oracle Universal Installer. For detailed information on the storage configuration tasks, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2).
This section provides you with information about how to use the Oracle Universal Installer to install Oracle Clusterware on UNIX.
Complete the following steps to install Oracle Clusterware on your cluster. At any time during installation, if you have a question about what you are being asked to do, click Help in the Oracle Universal Installer page.
Start the runInstaller
command with the -formCluster
option from the main directory on the Oracle Clusterware 11g Release 2 (11.2) CD-ROM. This is a separate CD that contains the Oracle Clusterware software. When the Oracle Universal Installer displays the Welcome page, click Next.
Oracle Universal Installer displays the Installation Prerequisite Checks page. This screen shows the name, type, and status for all prerequisite checks designed for the installation. Click Next.
Oracle Universal Installer displays the Specify Cluster Nodes for Node Addition page. Specify public, private, virtual IPs in this page and click Next.
Oracle Universal Installer displays the Specify Local Host Name page. Specify at least one public and one private interface in this page and click Next.
Specify the Oracle Cluster Registry location option to provide a redundant OCR location and click Next.
Specify the VD (Voting Disk Location) location option to provide redundant VD locations and click Next.
Oracle Universal Installer displays the Summary page. Click Install and proceed.
After the installation is done, Oracle Universal Installer prompts you to run orainstRoot.sh
and root.sh
. You need to run these scripts and click OK.
After you run root.sh
on all of the nodes, the Oracle Universal Installer runs the Oracle Notification Server Configuration Assistant and Oracle Private Interconnect Configuration Assistant. These assistants run without user intervention.
Oracle Universal Installer displays the End of Installation page. Click Exit.
You can run the Oracle Universal Installer in silent mode to install Oracle Clusterware by entering the following command:
./runInstaller -silent -responseFile <response file path>
For Oracle Clusterware, you need to use the -formCluste
r flag. You can pass session variables like nodelist, ocr, voting disk location, and so forth from the command line for silent installation.
The following processes must be running in your environment after the Oracle Clusterware installation for Oracle Clusterware to function:
oprocd
— Process monitor for the cluster.
evmd
— Event manager daemon that starts the racgevt
process to manage call-outs.
ocssd
— Manages cluster node membership and runs as the Oracle user; failure of this process results in node restart.
crsd
— Performs high availability recovery and management operations such as maintaining the OCR. Also manages application resources and runs as the root user and restarts automatically upon failure.
This section provides you with information about how to use the Oracle Universal Installer to install Oracle Clusterware on Windows.
Complete the following steps to install Oracle Clusterware on your cluster. At any time during installation, if you have a question about what you are being asked to do, click Help in the Oracle Universal Installer page.
Log in to Windows with Administrative privileges and run the setup.exe
command on the Oracle Clusterware media. This opens the Oracle Universal Installer Welcome page.
After you click Next in the Welcome page, the Specify File Locations page enables you to accept the displayed path name for the Oracle Clusterware products or select a different one. You can also accept default directory and path name for the location of your Clusterware home or browse for an alternate directory and destination. You must select a destination that exists on each cluster node that is part of this installation. Click Next to confirm your choices and proceed to the Language Selection page.
Select the language or languages for your Oracle Clusterware installation in the Language Selection page, then click Next for the Cluster Configuration page.
The Cluster Configuration page contains predefined node information if the Oracle Universal Installer detects that your system has the Oracle 10g Release 2 Clusterware. Otherwise, the Oracle Universal Installer displays the Cluster Configuration page without predefined node information.
Provide your own cluster name if you do not want to use the name provided by the Oracle Universal Installer. Note that the selected cluster name must be globally unique throughout the enterprise, and its allowable character set is the same as that for host names; that is, underscores (_), hyphens (-), and single-byte alphanumeric characters (a to z, A to Z, and 0 to 9).
Enter a public and a private host name for each node. Neither the public nor the private name should have a domain qualifier. When you enter the public host name, use the primary host name of each node; that is, the name displayed by the hostname
command. The private node refers to an address that is only accessible by the other nodes in this cluster, and which Oracle uses for Cache Fusion processing. You can enter either a private host name or a private IP address for each node.
Click Next after you have entered the cluster configuration information. This saves your entries and opens the Specify Network Interface Usage page.
In the Specify Network Interface Usage page, the Oracle Universal Installer displays a list of cluster-wide interfaces. Use the drop-down menus on this page to classify each interface as Public, Private, or Do Not Use. The default setting for each interface is Do Not Use. You must classify at least one interconnect as Public and one as Private. Click Next when you have made your selections to open the Select Disk Formatting Options page.
In the Select Disk Formatting Options page, you indicate what OCFS you want the Oracle Universal Installer to format for you.
The formatting options are as follows:
Format two logical drives for data and software storage. In this case, the Oracle Universal Installer creates two cluster file systems, one for the database files and one for the Oracle home. The OCR and voting disk are created in the data file directory.
Format one logical drive for software storage. In this case, the Oracle Universal Installer creates one cluster file system for the Oracle home and requires two additional partitions, one for the OCR and one for the voting disk. If you select this option, you must have already configured the partitions before proceeding with the installation. These partitions are stamped with "ocrcfg" for the OCR and "votedsk" for the voting disk.
Format one logical drive for data file storage. In this case, the Oracle Universal Installer creates one cluster file system for the database files which is also used to store the OCR and voting disk.
Do not format any logical drives. In this case, the Oracle Universal Installer requires two partitions: one for the OCR and one for the voting disk. If you select this option, you must have already configured the partitions before proceeding with the installation. These partitions are stamped with "ocrcfg" for the OCR and "votedsk" for the voting disk.
Click Next after making your selection in the Select Disk Formatting Options page. The next page that the Oracle Universal Installer displays depends on your selection on the Select Disk Formatting Options page, as described in the following step.
If you selected the "Format two logical drives for data and software storage" option on the Select Disk Formatting Options page, you must complete the Select Software Storage Drive page and the Select Data Storage Drive page as described in Steps a and b, respectively.
If you selected the "Format one logical drive for software storage" option on the Select Disk Formatting Options page, you must complete the Select Software Storage Drive page, the Disk Configuration - Oracle Cluster Registry (OCR) page, and the Disk Configuration - Voting Disk page as described in Steps a, c, and d, respectively.
If you selected the "Format one logical drive for data file storage" option on the Select Disk Formatting Options page, you must complete the Select Data Storage Drive page as described in Step b.
If you selected the "Do not format any logical drives" option on the Select Disk Formatting Options page, you must complete the Disk Configuration - Oracle Cluster Registry (OCR) page and the Disk Configuration - Voting Disk page as described in Steps c and d, respectively.
On the Select Software Storage Drive page, choose a shared drive to see a list of available partitions on that drive. Choose a partition with sufficient space to hold your Oracle home and select the partition's disk number and partition number from the list. Click Next to proceed.
On the Select Data Storage Drive page, choose a shared drive to see a list of available partitions on that drive. Choose a partition with sufficient space to hold your database files and select the partition's disk number and partition number from the list. Click Next to proceed.
On the Disk Configuration - Oracle Cluster Registry (OCR) page, choose a partition with sufficient space to hold your OCR and select the partition's disk number and partition number from the list. Click Next to proceed.
On the Disk Configuration - Voting Disk page, choose a partition with sufficient space to hold your voting disk and select the partition's disk number and partition number from the list. Click Next to proceed.
Note:
The Oracle Universal Installer pages described in this step displays logical drives from which you must make your selections. To be valid for selection, a logical drive must be located on a disk without a primary partition.After you click Next, the Oracle Universal Installer checks whether the remote inventories are set. If they are not set, the Oracle Universal Installer sets up the remote inventories by setting registry keys. The Oracle Universal Installer also verifies the permissions to enable writing to the inventory directories on the remote nodes. After completing these actions, the Oracle Universal Installer displays a Summary page that shows the cluster node information along with the space requirements and availability. Verify the installation that the Oracle Universal Installer is about to perform and click Finish.
When you click Finish, the Oracle Universal Installer installs the OCFS and Oracle Clusterware software on the local node and validates the installation again. The Oracle Universal Installer also creates any required OCFS file systems. After validating the installation, the Oracle Universal Installer completes the Oracle Clusterware software installation and configuration on the remote nodes.
You can run the Oracle Universal Installer in silent mode to install Oracle Clusterware by entering the following command:
./setup.exe -silent -responseFile <response file path>
For Oracle Clusterware, you need to use the -formCluster
flag. You can pass session variables like nodelist, ocr, voting disk location, and so forth from the command line for silent installation.
The following processes must be running in your environment after the Oracle Clusterware installation for Oracle Clusterware to function:
oprocd
— Process monitor for the cluster.
evmd
— Event manager daemon that starts the racgevt
process to manage call-outs.
ocssd
— Manages cluster node membership and runs as the Oracle user; failure of this process results in node restart.
crsd
— Performs high availability recovery and management operations such as maintaining the OCR. Also manages application resources and runs as the root user and restarts automatically upon failure.
If you want to add more nodes to the cluster, complete the following procedure:
Perform a single-node cluster Oracle Clusterware installation on node1.
Execute the prerequisite checks required on the remote nodes in order to add the nodes:
$CRS_HOME/bin/cluvfy stage -pre nodeadd -n <new nodes separated by commas> -verbose
Go to the $CRS_HOME/oui/bin directory. The variable $CRS_HOME
represents the Oracle Clusterware home directory of the successfully installed Oracle Clusterware software.
Run the following command:
./addNode.sh -silent "CLUSTER_NEW_NODES=<comma-separated new nodes>" "CLUSTER_NEW_VIRTUAL_HOSTNAMES=<comma-separated new vips>"
addNode is not supported in GUI mode in version 11.2.
If prompted to do so, run the orainstroot.sh
script on the new nodes.
When prompted, run the root.sh
script on each of the new nodes.
After you have installed clusterware and completed pre-installation tasks, you are ready to install the cluster-ready product on the cluster. To do this, you can use Oracle Universal Installer in interactive mode, command line mode, or silent mode using a response file.
See Also:
See "Modes of Installation" for more information on the different modes.When Oracle Universal Installer detects that the destination you entered on the File Locations page is part of a cluster, one of two dialogs appear:
If the Oracle home name entered is new, the Specify Hardware Installation Mode page appears. Use this page to select between cluster and non-cluster installation:
Cluster installation: Select the nodes for your installation from the list of nodes on which clusterware has been installed.
Non-cluster installation: Install on a single-node only, even though that node is part of a cluster.
If the Oracle home name entered is a pre-existing home, the Selected Nodes page appears. This is an information-only page that displays the nodes associated with the Oracle home. The installation is performed on all selected nodes. If any of the selected nodes are down, the installation is not allowed to proceed.
Note:
In Oracle Universal Installer, click Installed Products to display the Inventory panel, which lists all installed Oracle homes. Clustered Oracle homes, which are homes installed on multiple cluster nodes, have an attribute called Cluster Nodes, which lists all the nodes associated with that home.When the user clicks Next on the Specify Hardware Installation Mode page or Selected Nodes page, Oracle Universal Installer performs the following availability checks on the nodes:
Network reachability: Tests whether the remote cluster nodes are up and running.
Network configuration: Tests whether the remote cluster nodes are properly network-configured.
Inventory setup: Tests whether the inventory is set up on the remote nodes. If not set up on UNIX, Oracle Universal Installer prompts you to run root scripts on the remote nodes to set up the inventory. On Windows, Oracle Universal Installer sets up the inventory location in the Windows registry.
Inventory permission: Tests whether you can write to the Central Inventory location.
Oracle home permission: Tests whether you can write to the Oracle home.
If all selected nodes are available, the installation process continues to the next step. If a node (or nodes) is not available, the page redisplays with a Status column indicating the results of the check. You must fix the problem or choose another set of nodes in order to proceed.
If any of the remote nodes is unreachable, check if those nodes are up and running and if they are properly network-configured. If either the inventory or the Oracle home is not writable, check for the appropriate permissions on the remote nodes for these directories.
In a typical cluster installation, when clusterware is present, Universal Installer installs the Oracle software onto the node on which Oracle Universal Installer is running, then propagates the Oracle home from the local node installation to the other nodes that are part of the installation. Then Universal Installer runs -attachHome
on the remote nodes to update the inventory. After this, you need to run orainstRoot.sh
(if required) and root.sh
on the local and remote nodes. After the scripts are run, the configuration steps are executed.
If the cluster is Cluster File System (CFS) or Network File System (NFS) mounted, Oracle Universal Installer does not propagate the Oracle home to other nodes, as files are shared across nodes and the installation will exist on the shared disk.
Note:
For cluster installations, you must runoraInstRoot.sh
on each node of the cluster to set up the inventory.For Real Application Clusters installation, you can specify the -local
flag, CLUSTER_NODES, REMOTE_NODES,
and LOCAL_NODE
session variables to indicate the nodes on which the installation needs to be done.
When you use the -local
flag in a cluster installation, it means that the installation or inventory operation needs to be performed only on the local node. The CLUSTER_NODES
session variable indicates that the specified nodes are part of the cluster.
./runInstaller -local "CLUSTER_NODES={a,b,c,d}"
In the above example, the installation would be performed in the local node, and nodes a, b, c, and d would be taken as the part of the cluster.
When you use the REMOTE_NODES
session variable in a cluster installation, it means that the installation or the inventory operation needs to be performed on the local node and the other nodes apart from the local node.
./runInstaller "REMOTE_NODES={c,d}" "CLUSTER_NODES={a,b,c,d}"
In the above example, the installation would be performed on the local node a and nodes c and d. The nodes a, b, c, and d would be taken as the part of the cluster.
When using Oracle Universal Installer in suppressed or silent mode, specify the path to the remote copy or shell program on the local node to use for cluster installations using the following optional flags:
-remoteShell <path to program> -remoteCopy <path to program>
The default for remoteShell
is /usr/local/bin/ssh
. The default for remoteCopy
is /usr/local/bin/scp
. If these are not present, Oracle Universal Installer defaults to rsh
and rcp
, respectively.
Oracle Universal Installer enables you to add language support for the products you have installed. To add a language definition for the products already installed in the Oracle Home, you use the addLangs flag of runInstaller.
User Interface-based Installation
From the shiphome or from the Oracle Home, start OUI by entering the following command and flag:
./runInstaller -addLangs
Select the product location of the shiphome.
Select the new language set from the languages panel. The language upgrade is performed for all the components in the shiphome that are located in the Oracle Home.
View the summary window with the new “Language Updates” node. The elements of this node provide the component information for which the language updates are performed.
In the installation phase, OUI copies the files for the languages to be installed.
Make sure the response file specifies the new languages. For silent installations, by default the language update is performed for the languages specified in the response file.
From the shiphome or from the Oracle Home, start OUI by entering the following command and flags:
./runInstaller -silent -addLangs
The language upgrade is performed for all the components in the shiphome that are located in the Oracle Home. In the installation phase, OUI copies the files for the languages to be installed.
Oracle Universal Installer enables you to upgrade a product from one version to another version. An upgrade is a major product enhancement that often requires installation of the upgraded software. For example, if you convert your Oracle 10g Database to Oracle 11gR1 Database, then it is called an upgrade.
A group of patches form a patchset. For example, if you convert your Oracle 11gR1 from version 11.1.1 to version 11.1.2, then it is called applying a patchset.
After completing a Real Application Clusters installation, it is advisable that you perform the following tasks:
After your Oracle product with Real Application Clusters installation is complete, go to $ORACLE_HOME/Opatch
on each node and execute the following command:
$ORACLE_HOME/OPatch/opatch lsinventory -detail
This command lists the components installed inside the Oracle home and also lists the local and remote nodes for the home. Verify this information. You may also want to look at installation logs inventory.xml
and oraclehomeproperties.xml
.
See "Troubleshooting Real Application Clusters / Oracle Clusterware Installation" in case the check fails.
After your Oracle product with Real Application Clusters installation is complete and after you are sure that your system is functioning properly, make a back-up of the contents of the disk.
Also make a back-up of the disk contents after you complete any node additions or node deletions and after running any de-installation procedures.
Go to the OracleMetaLink Web site for required patches for your installation. To download the required patches:
Use a Web browser to view the OracleMetaLink Web site:
http://metalink.oracle.com
Log in to OracleMetaLink.
On the main OracleMetaLink page, click Patches.
On the Select a Patch Search Area page, click New MetaLink Patch Search.
On the Simple Search page, click Advanced.
On the Advanced Search page, click the search icon next to the Product or Product Family field.
In the Search and Select: Product Family field, enter the Oracle product name in the For field and click Go.
Select the Oracle product under the Results heading and click Select. The product name appears in the Product or Product Family field, and the current release appears in the Release field.
Select your platform from the list in the Platform field and click Go.
Any available patches appear under the Results heading.
Click the number of the patch that you want to download.
On the Patch Set page, click View README and read the page that appears. The README page contains information about the patch set and how to apply the patches to your installation.
Return to the Patch Set page, click Download, and save the file on your system.
Use the unzip utility provided with Oracle software to uncompress the Oracle patches that you downloaded from OracleMetaLink. The unzip utility is located in the $ORACLE_HOME/bin
directory.
Note:
By default, the patches would only be applied on the nodes on which the Oracle software installation was done. You can change the node list by using the-enableRollingUpgrade
option.Many Oracle products and options must be configured before you use them for the first time. Before using individual Oracle products or options, refer to the manual in the product documentation library that is available on the documentation CD-ROM or on the Oracle Technology Network Web site.
If you need to deinstall Real Application Clusters software, you must run the Oracle Universal Installer to deinstall the software on the same node from which you performed the installation. You must first deinstall the Oracle product before deinstalling the Oracle Clusterware software.
Perform the following procedures as described in the following sections to deinstall Oracle product and Oracle Clusterware software.
The following steps describe how to use Oracle Universal Installer to remove Oracle software from an Oracle home on UNIX systems:
Note:
Always use Oracle Universal Installer to remove Oracle software. Do not delete any Oracle home directories without first using Oracle Universal Installer to remove the software.If necessary, log in as the oracle
user:
$ su - oracle
Set the ORACLE_HOME
environment variable to specify the path of the Oracle home directory that you want to remove:
Bourne, Bash, or Korn shell:
$ ORACLE_HOME=/u01/app/oracle/product/11.2.0/db_1 $ export ORACLE_HOME
C shell:
$ setenv ORACLE_HOME /u01/app/oracle/product/11.2.0/db_1
Stop all processes running in this Oracle home.
Start Oracle Universal Installer using the Deinstall tool. For information on this tool, see "Removing Oracle Database Client Software" in the Oracle Database Client Installation Guide 11g Release 2 (11.2) for Linux.
The following steps describe how to use Oracle Universal Installer to remove Oracle software from an Oracle home on Windows systems:
Note:
Always use Oracle Universal Installer to remove Oracle software. Do not delete any Oracle home directories without first using Oracle Universal Installer to remove the software.Stop all the Oracle services running in this Oracle home.
Start Oracle Universal Installer: from the Start menu, select Programs, then ORACLE_ HOME_NAME, then Oracle Installation Products, then Oracle Universal Installer.
The Welcome screen for Oracle Universal Installer appears.
Click Deinstall Products.
The Inventory screen appears.
Expand the tree of installed components until you find the components to remove. For example, if you installed a database with the Enterprise Edition option and later installed additional components with the Custom option, expand the Oracle home component to display all the components installed in the Oracle home.
Select the components to remove.
Click Remove.
The Confirmation screen appears.
Click Yes to remove the selected components to initiate the removal process.
After the components are removed from your computer, the Inventory screen appears without the removed components.
Click Close to close the Inventory screen.
Click Cancel to exit Oracle Universal Installer.
Click Yes to confirm that you want to exit.
For detailed instructions on deinstalling an Oracle product, see the respective Oracle product installation guide.
Before deinstalling Oracle Cluster software, ensure that you have removed the respective Oracle product's home in each node by following the steps in the preceding section. The following section explains deinstallation on Windows and UNIX.
Deinstall each Oracle product Real Application Clusters home by running the procedure in the previous section. Then complete the deinstallation by removing the Oracle Clusterware software using the following procedure:
Run the command $CRS_HOME/install/rootdelete.sh
to disable the Oracle Clusterware applications running on the cluster node. The rootdelete.sh
script requires three arguments. If you are running this command on a remote node of the cluster, use remote
as the first argument; otherwise, use local
as the first argument. If the ocr.loc
file is on a shared file system, use sharedvar
. Otherwise, use nosharedvar
as the second argument. If the Oracle Clusterware home is on a shared file system, use sharedhome
; otherwise, use nosharedhome
as the third argument. Repeat this step on each node of the cluster from which you want to deinstall Oracle Clusterware.
Run the script $CRS_HOME/install/rootdeinstall.sh
on a local node to remove the OCR. You only need to run this script once.
Start Oracle Universal Installer. In the Welcome page, click Deinstall Products to display the list of installed products. Select the Oracle Clusterware home to deinstall.
Deinstall each Oracle product Real Application Clusters home by running the procedure in the previous section. Then complete the deinstallation by removing the Oracle Clusterware software using one of the following procedures:
Deinstalling Oracle Clusterware with No Previous Cluster Software Versions.
Deinstalling Oracle Clusterware with Clusterware Downgrade to 10.2.
Perform the following steps to deinstall Oracle 11g Clusterware software from a Windows environment:
Click Start and navigate to Settings, then to Control Panel, then to Administrative Tools, and then to Services. Stop the service oracleremexec
.
Start the Oracle Universal Installer. On the Welcome page, click Deinstall Products to display the list of installed products. Select the Oracle Clusterware home you want to deinstall.
If you have services with names such as OracleCRSTokenname
, remove them by running the following command:
crsuser remove user_name where user_name is a user name.
Shut down and restart each node that is a member of your cluster.
If you are not using a cluster file system, on each node use Windows Explorer to delete the Oracle directory, its subdirectories, and their contents.
Perform the following steps to deinstall Oracle 11g Clusterware software from a Windows environment that also has 10.2 Real Application Clusters:
Run $CRS_HOME\bin\GuiOracleOBJManager.exe
to make sure that the symbolic link named srvcfg
exists and points to a disk partition, if you are not using OCFS to store the OCR.
If Oracle10g release 10.2 Clusterware uses Oracle CFS (Cluster File System), ensure the following is true for all nodes:
The registry key HKLM\SOFTWARE\Oracle\osd9i\ocr
exists.The registry key HKLM\SOFTWARE\Oracle\osd9i\ocr
has a string value CfsOcrRoot
that points to a release 10.2 OCR (CFS) location.
Run $CRS_HOME\bin\ocrconfig -downgrade
to downgrade the Cluster Registry to a release 10.2 OCR.
On each node, copy $CRS_HOME\cfs\OcfsFindVol.exe
to %SYSTEMROOT%\system32\osd9i\cfs
.
Run $CRS_HOME\oui\bin\setup.exe
to start Oracle Universal Installer. On the Welcome page, click Deinstall Products to list all the installed products. Select the Oracle Clusterware home name from the displayed products, and click Remove to deconfigure and deinstall the product.
On each node, run %SYSTEMROOT%\system32\osd9i\olm\OracleOBJService.exe /install
to reinstall the Oracle 10.2 object service. Then start Oracle Object Service.
On each node, run %SYSTEMROOT%\system32\osd9i\cfs\OcfsFindVol.exe /i:%SYSTEMROOT%\system32\osd9i\cfs\OcfsFindVol.exe
to reinstall the Oracle Cluster Volume service. Then start the Oracle Cluster Volume service.
From a 10.2 Real Application Clusters Oracle home on each node, run the command ORACLE_HOME\bin\gsdservice.exe -install
. Then start the OracleGSDService
.
On each node, copy %SYSTEMROOT%\system32\osd9i\orafencedrv.sys %SYSTEMROOT%\system32\drivers\orafenceservice.sys
.
You can convert single-instance nodes to Real Application Clusters using Oracle Universal Installer. For details on converting single instance nodes to Real Application Clusters, see the Oracle Real Application Clusters Installation Guide 11g Release 2 (11.2) for your platform.