gridSetup.sh -configureCluster

The gridSetup.sh -configureCluster command configures Oracle Grid Infrastructure for a Cluster software on the specified set of cluster nodes.

Syntax

gridSetup.sh -configureCluster -OSDBA sysdba_group -OSASM osasm_group -ORACLE_BASE Oracle_base_dir  
-clusterName cluster_name -networkInterfaceList interface_name_with_usage_value 
[-executePrereqs] [-OSOPER osoper_group] [-clusterUsage <RAC | GENERAL_PURPOSE>] [-configureAsExtendedCluster -sites site_names] 
{[-scanName scan_name -scanPort scan_port]} | [-scanClientDataFile client_data_file_path]} 
[-configureGNS -gnsVIPAddress GNS_VIP -gnsSubDomain GNS_subdomain [-configureDHCPAssignedVIPs]] [-clusterNodes list_of_node_names] 
[-storageOption <FLEX_ASM_STORAGE | CLIENT_ASM_STORAGE | FILE_SYSTEM_STORAGE> {[-diskGroupName disk_group_name {-diskList list_of_disks |
-disksWithFailureGroupNames failure_group_disk_names -failureGroups failure_group_names -quorumFailureGroupNames quorum_failure_groups} 
[-redundancy <NORMAL | HIGH | EXTERNAL | FLEX | EXTENDED>] [-auSize <1 | 2 | 4 | 8 | 16>] [-diskString disk_discovery_string] [-configureAFD] 
[-backupDGName OCR_backup_disk_group_name {-backupDGDiskList backup_DG_disk_list | -backupDGDisksWithFailureGroupNames 
-backupDGFailureGroups backup_DG_failure_group_name -backupDGQuorumFailureGroups backup_quorum_failure_groups}]]
| [-clientDataFile client_data_file] | [-ocrLocations OCR_file_location -votingFilesLocations voting_file_location]}]  
[-enableAutoFixup] [-useIPMI -bmcBinpath BMC_binary_loc -bmcUsername BMC_user_name] [-managementOption <CLOUD_CONTROL | NONE> -omsHost EM_hostname 
-omsPort EM_port -emAdminUser EM_admin_username] [-INVENTORY_LOCATION central_inventory_location] 
[-executeConfigTools] [-executeRootScript -configMethod ROOT]

Parameters

Table A-4 gridSetup.sh -configureCluster Command Parameters

Parameter	Mandatory?	Description
`-OSDBA sysdba_group`	Yes	The name of the `SYSDBA` privileged operating system group. The default is `dba`. Note: If you have already setup an Oracle Grid Infrastructure home, then this parameter is not required.
`-OSASM osasm_group`	Yes	The name of the `SYSASM` privileged operating system group. Note: If you have already setup an Oracle Grid Infrastructure home, then this parameter is not required.
`-ORACLE_BASE Oracle_base_dir`	Yes	Complete path to the Oracle base location to use for the Oracle Grid Infrastructure installation. Note: If you have already setup an Oracle Grid Infrastructure home, then this parameter is not required.
`-clusterName cluster_name`	Yes	Name for the cluster that you are creating.
`-networkInterfaceList interface_name_with_usage_value`	Yes	Planned use for each network adapter (or network interface) that are available on your cluster node.
`-OSOPER osoper_group`	No	The name of the `SYSOPER` privileged operating system group. Note: If you have already setup an Oracle Grid Infrastructure home, then this parameter is not required.
`-executePrereqs`	No	Run prerequisite checks to ensure that all necessary conditions and requirements are met before proceeding with the installation or configuration process.
`-clusterUsage <RAC \| GENERAL_PURPOSE>`	No	Usage for the cluster, which can be to host Oracle Real Application Clusters (Oracle RAC) database or to host generic applications. The default value is RAC.
`-configureAsExtendedCluster [-sites site_names]`	No	Extend an Oracle RAC cluster across two or more separate sites, each equipped with its own storage. If you are configuring an Extended Cluster, then specify the list of sites.
`-scanName {-scanPort scan_port}`	No	Name for the Single Client Access Name (SCAN) and an unused port number for the SCAN service to create a SCAN locally.
`-scanClientDataFile client_data_file_path`	No	Complete path to the SCAN client data file to use a shared SCAN.
`-configureGNS`	No	Specify this option if you want to configure Grid Naming Service (GNS).
`-gnsVIPAddress GNS_VIP {-gnsSubDomain GNS_subdomain}`	No	An unused virtual hostname and GNS subdomain for the GNS service.
`-configureDHCPAssignedVIPs`	No	Specify this option if you want to assign SCAN name VIP and Node VIPs by DHCP.
`-clusterNodes list_of_node_names`	No	A comma-separated list of cluster nodes on which you want to install the Oracle Grid Infrastructure software.
`-storageOption <FLEX_ASM_STORAGE \| CLIENT_ASM_STORAGE \| FILE_SYSTEM_STORAGE>`	No	Storage to use for Oracle Cluster Registry (OCR) and Voting Files. Default value is `FLEX_ASM_STORAGE`. Use `FLEX_ASM_STORAGE` to store OCR and voting files on an Oracle ASM disk group. Use `CLIENT_ASM_STORAGE` to store OCR and voting files on an Oracle ASM disk group configured on a storage server cluster. Use `FILE_SYSTEM_STORAGE` to store OCR and voting files on a shared file system.
`-diskGroupName disk_group_name`	No	Name for the Oracle ASM disk group, for example `DATA`.
`-diskList list_of_disks`	No	A list of Oracle ASM disks to create an Oracle ASM disk group. Note: Use this variable only if failure group configuration is not required.
`-disksWithFailureGroupNames failure_group_disk_names {-failureGroups failure_group_names \| -quorumFailureGroupNames quorum_failure_groups}`	No	A list of failure groups to be marked as `QUORUM`. A quorum failure group, a special type of failure group, contains mirror copies of voting files when voting files are stored in normal or high redundancy disk groups.
`-redundancy <NORMAL \| HIGH \| EXTERNAL \| FLEX \| EXTENDED>`	No	The Oracle ASM redundancy level to use for the Oracle ASM disk group. Default value is `NORMAL`.
`-auSize <1 \| 2 \| 4 \| 8 \| 16>`	No	The allocation unit size for Oracle ASM. Default value is 1.
`-diskString disk_discovery_string`	No	Disk discovery string, a path and pattern match for the Oracle ASM disks, to discover the disks for creating an Oracle ASM disk group.
`-configureAFD`	No	Specify this option if you want to configure Oracle ASM Filter Driver (Oracle ASMFD).
`-backupDGName OCR_backup_disk_group_name`	No	Name for the OCR backup Oracle ASM disk group.
`-backupDGDiskList backup_DG_disk_list`	No	A list of Oracle ASM disks to create an OCR backup Oracle ASM disk group. Note: Use this variable only if failure group configuration is not required.
`-backupDGDisksWithFailureGroupNames {-backupDGFailureGroups backup_DG_failure_group_name \| -backupDGQuorumFailureGroups backup_quorum_failure_groups}`	No	A list of failure groups to be marked as `QUORUM`. A quorum failure group, a special type of failure group, contains mirror copies of OCR when OCR is stored in normal or high redundancy disk groups.
`-clientDataFile client_data_file`	No	Complete path to the Oracle ASM client data file if you are using Oracle ASM disk group configured on a storage server cluster.
`-ocrLocations OCR_file_location {-votingFilesLocations voting_file_location}`	No	Storage option for Oracle Cluster Registry (OCR) and voting files.
`-enableAutoFixup`	No	Specify this option if you want to configure automatic self correction for your installation. The automated fixup framework for Configuration Verification Utility (CVU) identifies and corrects any configuration errors.
`-useIPMI`	No	Specify this option if you want to configure Intelligent Power Management Interface (IPMI).
`-bmcBinpath BMC_binary_loc`	No	Location of the `ipmiutil` binary.
`-bmcUsername BMC_user_name`	No	Username for using the IPMI service.
`-managementOption <CLOUD_CONTROL \| NONE>`	No	Management option to use for managing the Oracle home. Default value is `NONE`.
`-omsHost EM_hostname`	No	The OMS host to connect to Enterprise Manager Cloud Control.
`-omsPort EM_port`	No	The OMS port to connect to Enterprise Manager Cloud Control.
`-emAdminUser EM_admin_username`	No	The Admin username to connect to Enterprise Manager Cloud Control.
`-INVENTORY_LOCATIONcentral_inventory_location`	No	Complete path to the location where you want to store the inventory files. You do not need to specify this parameter if you have previously installed an Oracle software on this computer.
`-help`	No	Displays `gridSetup.sh -configureCluster` command help.

Example

The following example shows you how to install and configure Oracle Grid Infrastructure on a three node cluster:

gridSetup.sh -configureCluster -OSDBA sysdba -OSASM osasm -ORACLE_BASE /u01/app/grid -clusterName mycluster1 
-networkInterfaceList ens3:100.70.80.0:1,ens4:192.168.1.0:5,ens5:192.168.2.0:3 -OSOPER osoper  -clusterUsage RAC -scanName RACScan -scanPort 1521 
-clusterNodes node1,node2,node3 -storageOption FLEX_ASM_STORAGE -diskGroupName DATA -diskList /dev/sd1,/dev/sd2,/dev/sd3 -redundancy NORMAL 
-auSize 8 -diskString /dev/sd* -configureAFD -backupDGName RECO -backupDGDiskList /dev/bk1,/dev/bk2,/dev/bk3 -enableAutoFixup 
-managementOption NONE -INVENTORY_LOCATION /u01/app/oraInventory -executeConfigTools -executeRootScript -configMethod ROOT

Parent topic: Oracle Grid Infrastructure Command-Line Options