Response file variable definitions for Oracle RAC

The variable definitions for Oracle RAC are grouped in tabular format for the following Oracle tasks:

Creating Oracle user and group

See Table: Variables for creating Oracle user and group.

Creating storage for OCR and voting disk

See Table: Variables for creating storage for OCR and voting disk.

Configuring the private IP address and PrivNIC resource under VCS

See Table: Variables for configuring the private IP address and PrivNIC resource under VCS.

Configuring the private IP address and MultiPrivNIC resource under VCS

See Table: Variables for configuring the private IP addresses and the MultiPrivNIC resource under VCS.

Installing Oracle Clusterware

See Table: Variables for installing Oracle Clusterware.

Installing Oracle database

See Table: Variables for installing Oracle database.

Configuring CSSD resource

See Table: Variables for configuring CSSD resource.

Relinking Oracle RAC libraries

See Table: Variables for relinking Oracle RAC libraries.

Note:

Some of the variable definitions may occur in multiple sections, for example $CFG{oracle_user}. These variables need not be repeated if all the tasks are performed as a single installation activity. However, if you perform these tasks independently, make sure that all the required variables, as indicated in the table for each task, are supplied in the response file.

Table: Variables for creating Oracle user and group lists the variables that are used to create the Oracle user and group.

Table: Variables for creating Oracle user and group

Variable

List or Scalar

Description

$CFG{create_oracle_user_group}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that Oracle user and group will be created.

The value 0 indicates that Oracle user and group will not be created.

$CFG{grid_user}

Scalar

Required

Defines the name of the grid user.

$CFG{oracle_user}

Scalar

Required

Defines the name of the Oracle user.

$CFG{oracle_uid}

Scalar

Required

Defines the user ID of the Oracle user.

$CFG{oracle_group}

Scalar

Required

Defines the primary group of the Oracle user.

$CFG{oracle_gid}

Scalar

Required

Defines the group ID of the Oracle user.

$CFG{oracle_user_home}

Scalar

Required

Defines the full path of the Oracle user's home directory.

$CFG{oracle_secondary_group}

List

Optional

Defines the list of secondary groups for the Oracle user.

$CFG{oracle_secondary_gid}

List

Optional

Defines the list of secondary group IDs for the Oracle user. The elements of this variable must be in the same order as that of the elements in the variable $CFG{oracle_secondary_group}.

Table: Variables for creating storage for OCR and voting disk lists the variables that are used to create the storage for OCR and voting disk.

Table: Variables for creating storage for OCR and voting disk

Variable

List or Scalar

Description

$CFG{create_ocr_vote_storage}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that the storage for OCR and voting disk will be created.

The value 0 indicates that the storage for OCR and voting disk will not be created.

$CFG{enable_mirroring}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that the storage for OCR and voting disk is mirrored. Provide two disks as input for the variable $CFG{ocrvotedisks}.

The value 0 indicates that the storage for OCR and voting disk is not mirrored.

$CFG{ocrvotedgoption}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that an existing disk group will be used to create the storage for OCR and voting disk.

Note:

If you choose to use an existing disk group, use the $CFG{ocrvotedgname} variable to specify the name of an existing disk group that has a minimum of two disks (for mirroring).

The value 0 indicates that a new disk group will be created for OCR and voting disk storage.

Note:

If you choose to create a disk group, you must set the following variables: $CFG{ocrvotedisks}, $CFG{ocrvotedgname}

$CFG{ocrvotescheme}

Scalar

Required

Defines the storage scheme to be used for OCR and voting disk.

The value 1 indicates Clustered File System.

The value 0 indicates CVM raw volumes.

$CFG->{enable_sep_filesys}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that OCR and voting disk are located on separate file systems. Provide values for the following variables: $CFG->{ocrvolname}, $CFG->{ocrvolsize}, $CFG->{votevolname}, $CFG->{votevolsize}, $cfg->{ocrmount}, $cfg->{votemount}

The value 0 indicates that OCR and voting disk are located on the same file system. Provide a single volume name using the variable $CFG{ocrvotevolname}, a single mount point using the variable $CFG{ocrvotemount}, and the size using the variable $CFG{ocrvotevolsize}.

$CFG{ocrvotedisks}

List

Required

Defines the list of shared disks to be used for OCR and voting disk.

$CFG{ocrvotedgname}

Scalar

Required

Defines the name of the disk group to be used for OCR and voting disk.

$CFG{ocrvotevolname}

Scalar

Required

Defines the volume name for OCR and voting disk. This variable must be used only if you have set the storage scheme to 1 (Clustered File System).

$CFG{ocrvotevolsize}

Scalar

Required

Defines the size of the OCR and voting disk volume. This variable must be used only if you have set the storage scheme to 1 (Clustered File System).

$CFG{ocrvotemount}

Scalar

Required if you have chosen to locate OCR and voting disk on the same file system.

Defines the full path to the CFS mount point. This variable must be used only if you have set the storage scheme to 1 (Clustered File System).

$CFG{ocrmount}

Scalar

Required if you have chosen to locate OCR and voting disk on separate file systems.

Defines the full path to the CFS mount point for OCR. This variable must be used only if you have set the storage scheme to 1 (Clustered File System).

$CFG{votemount}

Scalar

Required if you have chosen to locate OCR and voting disk on separate file systems.

Defines the full path to the CFS mount point for voting disk. This variable must be used only if you have set the storage scheme to 1 (Clustered File System).

$CFG{ocrvolname}

Scalar

Required

Defines the volume name for OCR. This variable must be used only if you have set the storage scheme to 0 (CVM Raw Volumes).

$CFG{ocrvolsize}

Scalar

Required

Defines the size of the OCR volume. This variable must be used only if you have set the storage scheme to 0 (CVM Raw Volumes).

$CFG{votevolname}

Scalar

Required

Defines the volume name for voting disk. This variable must be used only if you have set the storage scheme to 0 (CVM Raw Volumes).

$CFG{votevolsize}

Scalar

Required

Defines the size of the voting disk volume. This variable must be used only if you have set the storage scheme to 0 (CVM Raw Volumes).

$CFG{oracle_user}

Scalar

Required

Defines the name of the Oracle user.

$CFG{oracle_group}

Scalar

Required

Defines the primary group of the Oracle user.

Table: Variables for configuring the private IP address and PrivNIC resource under VCS lists the variables that are used to configure the private IP address and PrivNIC resource under VCS.

Table: Variables for configuring the private IP address and PrivNIC resource under VCS

Variable

List or Scalar

Description

$CFG{config_privnic}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that the PrivNIC and private IP address information will be configured for Oracle Clusterware.

The value 0 indicates that the PrivNIC and private IP address information will not be configured for Oracle Clusterware.

$CFG{privnic_resname}

Scalar

Required

Defines the PrivNIC resource name in the main.cf file.

$CFG{privnic_interface_priority}

String

Required

Defines the priority that determines which NIC will be used in the event of a failover. Set the priority in decreasing order.

For example, the following priority setting indicates that eth2 will be given priority in the event of a failover:

$CFG{privnic_interface_priority}="eth2 eth3";

$CFG{host1}{privnicip}

Scalar

Required

Defines the IP address to be configured for the PrivNIC resource on the node.

Repeat this variable for each node in the cluster. For example, if you have two nodes in the cluster, you must provide this variable for each node.

For example:

$CFG{galaxy}{privnicip}
="192.168.12.1"
$CFG{nebula}{privnicip}
="192.168.12.2"

$CFG{nic_reuseip}

Scalar

Required

Defines a boolean value 0 or 1.

The value 1 indicates that the existing IP addresses in the /etc/hosts file will be used.

The value 0 indicates that the IP addresses will not be reused.

$CFG{host}{hostname_for_ip}

Scalar

Required

Defines the private node name of the IP address (hostname_for_ip) for the PrivNIC resource and the node (system) for which the resource is configured.

Repeat this variable for each node in the cluster. For example, if you have two nodes in the cluster, you must provide this variable for each node.

For example:

$CFG{galaxy}{hostname_for_ip}
="galaxy-priv"
$CFG{nebula}{hostname_for_ip}
="galaxy-priv"

$CFG{nic_netmask}

Scalar

Required

Defines the netmask for the private network.

$CFG{nic_add_ip_to_files}

Scalar

Required

Defines a boolean value 0 or 1.

The value 1 indicates that the IP addresses are added to the /etc/hosts file.

Note:

Make sure that the IP addresses for the NIC resource are not already present in the files or set the $CFG{nic_reuseip} and $CFG{nic_reusealias} variables, otherwise the network configuration step fails.

The value 0 indicates that the IP addresses may already be present in the file.

$CFG{nic_reconfigure_existing_resource}

Scalar

Optional

Defines a boolean value 0 or 1.

The value 1 indicates that the existing PrivNIC resource in the main.cf file will be deleted and reconfigured.

The value 0 indicates that the existing PrivNIC resource in the main.cf file will be reused.

$CFG{nic_reusealias}

Scalar

Required

Defines a boolean value 0 or 1.

The value 1 indicates that the installer will not check the /etc/hosts file to determine whether the host name alias for the private IP addresses exist or not. The installer assumes that the host names alias information is present in the file. Make sure that the alias information is present in the file.

The value 0 indicates that the installer checks whether the host name alias information is present in the /etc/hosts file. Make sure that the alias information is present in the file otherwise the installation fails.

Table: Variables for configuring the private IP addresses and the MultiPrivNIC resource under VCS lists the variables that are used to configure the private IP addresses and the MultiPrivNIC resource under VCS.

Table: Variables for configuring the private IP addresses and the MultiPrivNIC resource under VCS

Variable

List or Scalar

Description

$CFG{config_multiprivnic}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that the MultiPrivNIC and private IP address information will be configured for Oracle Clusterware.

The value 0 indicates that the MultiPrivNIC and private IP address information will not be configured for Oracle Clusterware.

$CFG{multiprivnic_resname}

Scalar

Required

Defines the MultiPrivNIC resource name in the main.cf file.

$CFG{nic_add_ip_to_files}

Scalar

Required

Defines a boolean value 0 or 1.

The value 1 indicates that the IP addresses are added to the /etc/hosts file.

Note:

Make sure that the IP addresses for the NIC resource are not already present in the files or set the $CFG{nic_reuseip} and $CFG{nic_reusealias} variables, otherwise the network configuration step fails.

The value 0 indicates that the IP addresses may already be present in the file.

$CFG{host1}{NIC1}{multiprivnicip}

List

Required

Defines the list of IP addresses for the MultiPrivNIC resource.

Note:

The private IP addresses must be configured for each node and each interface in the cluster.

For example, if you have two nodes galaxy and nebula in the cluster:

$CFG{galaxy}{eth1}
{multiprivnicip}="192.168.12.1";
$CFG{galaxy}{eth2}
{multiprivnicip}=="192.168.2.1";
$CFG{nebula}{eth1}
{multiprivnicip}="192.168.12.2";
$CFG{nebula}{eth2}
{multiprivnicip}="192.168.2.2";

$CFG{host1}{NIC1}{hostname_for_ip}

List

Required

Defines the list of private node names (hostname_for_ip) for the IP addresses configured in the MultiPrivNIC resource for the interface (inf) on the node (system) .

Note:

The private IP address must be configured for each node and each interface in the cluster.

For example, if you have two nodes galaxy and nebula in the cluster:

$CFG{galaxy}{eth1}
{hostname_for_ip}="galaxy-priv";
$CFG{galaxy}{eth2}
{hostname_for_ip}="galaxy-priv1";
$CFG{nebula}{eth1}
{hostname_for_ip}="nebula-priv";
$CFG{nebula}{eth2}
{hostname_for_ip}="nebula-priv1";

$CFG{nic_netmask}

Scalar

Required

Defines the netmask for the private network.

$CFG{nic_reconfigure_existing_resource}

Scalar

Optional

Defines a boolean value 0 or 1.

The value 1 indicates that the existing MultiPrivNIC resource in the main.cf file will be deleted and reconfigured.

The value 0 indicates that the existing MultiPrivNIC resource in the main.cf file will be reused.

$CFG{nic_reuseip}

Scalar

Required

Defines a boolean value 0 or 1.

The value 1 indicates that the existing IP addresses in the /etc/hosts file will be used.

The value 1 indicates that the existing IP addresses in the /etc/hosts or /etc/inet/ipnodes files will be used.

The value 0 indicates that the IP addresses will not be reused.

$CFG{nic_reusealias}

Scalar

Required

Defines a boolean value 0 or 1.

The value 1 indicates that the installer will not check the /etc/hosts file to determine whether the host name alias for the private IP addresses exist or not. The installer assumes that the host names alias information is present in the file. Make sure that the alias information is present in the file.

The value 0 indicates that the installer checks whether the host name alias information is present in the /etc/hosts file. Make sure that the alias information is present in the file otherwise the installation fails.

Table: Variables for installing Oracle Clusterware lists the variables that are used to install Oracle Clusterware.

Table: Variables for installing Oracle Clusterware

Variable

List or Scalar

Description

$CFG{install_oracle_clusterware}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that Oracle Clusterware will be configured.

The value 0 indicates that Oracle Clusterware will not be configured.

$CFG{oracle_user}

Scalar

Required

Defines the name of the Oracle user.

$CFG{oracle_group}

Scalar

Required

Defines the primary group of the Oracle user.

$CFG{oracle_base}

Scalar

Required

Defines the base directory for the Oracle RAC installation.

$CFG{crs_home}

Scalar

Required

Defines the Oracle Clusterware home directory.

The value in this variable must be the same as that of the 'ORACLE_HOME' variable in the Oracle Clusterware response file.

$CFG{crs_installpath}

Scalar

Required

Defines the full path of the Oracle Clusterware installation binaries.

$CFG{oracle_version}

Scalar

Required

Defines the version of the Oracle RAC binaries (for example, 11.2.0.1.0). This definition is overridden if a different Oracle RAC version is detected during the installation.

$CFG{crs_responsefile}

Scalar

Required

Defines the full path of the Oracle Clusterware response file.

Table: Variables for installing Oracle database lists the variables that are used to install Oracle database.

Table: Variables for installing Oracle database

Variable

List or Scalar

Description

$CFG{install_oracle_database}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that the Oracle RAC database will be configured.

The value 0 indicates that the Oracle RAC database will not be configured.

$CFG{oracle_user}

Scalar

Required

Defines the name of the Oracle user.

$CFG{oracle_group}

Scalar

Required

Defines the primary group of the Oracle user.

$CFG{oracle_base}

Scalar

Required

Defines the base directory for the Oracle RAC installation.

$CFG{crs_home}

Scalar

Required

Defines the Oracle Clusterware home directory.

The value in this variable must be the same as that of the 'ORACLE_HOME' variable in the Oracle Clusterware response file.

$CFG{db_home}

Scalar

Required

Defines the Oracle RAC database home directory.

The value in this variable must be the same as that of the 'ORACLE_HOME' variable in the Oracle RAC database response file.

$CFG{db_installpath}

Scalar

Required

Defines the full path of the Oracle RAC database installation binaries.

$CFG{oracle_version}

Scalar

Required

Defines the version of the Oracle RAC binaries (for example, 11.2.0.1.0). This definition is overridden if a different Oracle RAC version is detected during the installation.

$CFG{db_responsefile}

Scalar

Required

Defines the full path of the Oracle database response file.

Table: Variables for configuring CSSD resource lists the variables that are used to configure CSSD resource.

Table: Variables for configuring CSSD resource

Variable

List or Scalar

Description

$CFG{config_cssd_agent}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that the CSSD agent will be configured after Oracle RAC installation.

The value 0 indicates that the CSSD agent will not be configured after Oracle RAC installation.

$CFG{reconfigure_cssd_resource}

Scalar

Required

Defines a boolean value 0 or 1.

The value 1 indicates that the SF Oracle RAC installer deletes the existing CSSD resource from the main.cf file and reconfigures it.

The value 0 indicates that the SF Oracle RAC installer does not delete and reconfigure the resource. The installer exits the task with the message that the resource exists.

Table: Variables for relinking Oracle RAC libraries lists the variables that are used to relink Oracle RAC libraries.

Table: Variables for relinking Oracle RAC libraries

Variable

List or Scalar

Description

$CFG{relink_oracle_database}

Scalar

Required

Defines a Boolean value 0 or 1.

The value 1 indicates that the SF Oracle RAC libraries will be relinked with the Oracle RAC database after Oracle RAC installation.

The value 0 indicates that the SF Oracle RAC libraries will not be relinked with the Oracle RAC database after Oracle RAC installation.

$CFG{oracle_user}

Scalar

Required

Defines the name of the Oracle user.

$CFG{oracle_group}

Scalar

Required

Defines the primary group of the Oracle user.

$CFG{crs_home}

Scalar

Required

Defines the Oracle Clusterware home directory.

The value in this variable must be the same as that of the 'ORACLE_HOME' variable in the Oracle Clusterware response file.

$CFG{db_home}

Scalar

Required

Defines the Oracle RAC database home directory.

The value in this variable must be the same as that of the 'ORACLE_HOME' variable in the Oracle RAC database response file.

$CFG{oracle_version}

Scalar

Required

Defines the version of the Oracle RAC binaries (for example, 11.2.0.1.0). This definition is overridden if a different Oracle RAC version is detected during the installation.