Search <book_title>...

Storage Foundation for Oracle® RAC 8.0.2 Configuration and Upgrade Guide - AIX

Last Published: 2023-06-05

Product(s): InfoScale & Storage Foundation (8.0.2)

Platform: AIX

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 Creating storage for OCR and voting disk .	See Table: Variables for creating storage for OCR and voting disk.
Configuring the private IP address for HAIP	See Table: Variables for configuring the private IP address for HAIP.
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 one of the following values: 0: Indicates that a new non-FSS disk group will be created for OCR and voting disk storage. 1: Indicates that an existing non-FSS disk group will be used to create the storage for OCR and voting disk. 2: Indicates that a new FSS disk group will be created for OCR and voting disk storage. 3: Indicates that an existing FSS 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). 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. Note: If choose to create an FSS disk group, the attribute includes the node information, for example, $CFG{ocrvotedisks}=[qw(node_1:disk_1 node_2:disk_2...)], where node_x indicates the node to which the disk is physically connected.
$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 for HAIP lists the variables that are used to configure the private IP address for HAIP.

Table: Variables for configuring the private IP address for HAIP

Variable	List or Scalar	Description
$CFG{host}{haip}	Scalar	Required Defines the IP address to be configured for HAIP 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{sys1}{haip} = "192.168.12.1" $CFG{sys2}{haip} = "192.168.12.2"
$CFG{host}{hostname_for_ip}	Scalar	Required Defines the private node name of the IP address to be configured for HAIP 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{sys1}{hostname_for_haip} = "sys1-haip"; $CFG{sys2}{hostname_for_haip} = "sys2-haip";
$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. The value 0 indicates that the IP addresses may already be present in the file.

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 en2 will be given priority in the event of a failover: `$CFG{privnic_interface_priority}="en2 en3";`
$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{sys1}{privnicip} ="192.168.12.1" $CFG{sys2}{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{sys1}{hostname_for_ip} ="sys1-priv" $CFG{sys2}{hostname_for_ip} ="sys2-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 sys1 and sys2 in the cluster: $CFG{sys1}{en1} {multiprivnicip}="192.168.12.1"; $CFG{sys1}{en2} {multiprivnicip}=="192.168.2.1"; $CFG{sys2}{en1} {multiprivnicip}="192.168.12.2"; $CFG{sys2}{en2} {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 sys1 and sys2 in the cluster: $CFG{sys1}{en1} {hostname_for_ip}="sys1-priv"; $CFG{sys1}{en2} {hostname_for_ip}="sys1-priv1"; $CFG{sys2}{en1} {hostname_for_ip}="sys2-priv"; $CFG{sys2}{en2} {hostname_for_ip}="sys2-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.3.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.3.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.

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.3.0). This definition is overridden if a different Oracle RAC version is detected during the installation.