oraswgi_install

Install Grid Infrastructure / ORacle Restart software.

This role has a dependency to orahost_meta and orasw_meta for default parameter.

Known Issues from Oracle:

  • TOP Note: Solutions for Typical Grid Infrastructure/RAC Database runInstaller/DBCA for RAC Issues (Doc ID 1056713.1)
  • INS-06006 GI RunInstaller Fails If OpenSSH Is Upgraded to 8.x (Doc ID 2555697.1)

Table of contents

Requirements

  • Minimum Ansible version: 2.16.0

Default Variables

cvuqdisk_rpm

Name of RPM for cvuqdisk.

RPM is installed from {{ oracle_home_gi }}/cv/rpm/

Default value

cvuqdisk_rpm: cvuqdisk-1.0.10-1.rpm

default_dbpass

Default value

default_dbpass: '{% if item.0.oracle_db_passwd is defined %}{{ item.0.oracle_db_passwd }}{% else %}Oracle123{% endif %}'

default_gipass

Default password for Grid-Infrastructure and ASM-Users.

Important

It is mandatory to set this variable in your inventory!

Default value

default_gipass: ''

endoracle_scan_port

Port for SCAN-Listener

gi_ignoreprereq

false => Do not ignore failed runcluvfy.sh true => Ignore failed runcluvfy.sh

Default value

gi_ignoreprereq: false

oracle_asm_init_dg

1st Diskgroup where ASM SPFile is placed.

Default value

oracle_asm_init_dg: crs

oracle_asm_storage_option

Default value

oracle_asm_storage_option: "{% if oracle_install_version_gi is version('12.2', '>=') %}FLEX_ASM_STORAGE{% else %}LOCAL_ASM_STORAGE{% endif %}"

oracle_cluster_mgmdb

Create _MGMTBD on cluster.

Default value

oracle_cluster_mgmdb: false

oracle_cluster_name

Name of Grid-Infrastructure Cluster.

The maximum length allowed for clustername is 63 characters. The name can be any combination of lower and uppercase alphabets (A - Z), (0 - 9) and hyphens (-).

Only set this variable, when orasw_meta_cluster_hostgroup contains a ‘_’.

Important! Ansible hostgrouds could not contain a ‘-’ in name!

Default value

oracle_cluster_name: '{{ orasw_meta_cluster_hostgroup }}'

oracle_gi_cluster_type

Define clusterware type.

Default value

oracle_gi_cluster_type: STANDARD

oracle_gi_gns_subdomain

Define ths GNS subdomain for Cluster

oracle_gi_gns_vip

Define GNS VIP for Clusterware.

Default value

oracle_gi_gns_vip:

oracle_gi_nic_priv

Name of private network interface.

Default value

oracle_gi_nic_priv: eth1

oracle_gi_nic_pub

Name of public network interface.

Default value

oracle_gi_nic_pub: eth0

oracle_ic_net

Defines the network for the interconnect.

Important!

Only used, when configure_interconnect=true and ansible_os_family='RedHat' during cluster installations.

Default value

oracle_ic_net: 3.3.3.{{ ansible_all_ipv4_addresses[0].split(".")[-1] }}

oracle_scan

SCAN DNS-Name

oracle_scan_port

Default value

oracle_scan_port: 1521

oracle_sw_image_gi

List of version sepcific GI installation images

NOTE: Image files are expected to be found by their filename under oracle_sw_source_local, or oracle_sw_source_www respectively, unless a filesource dict element provides a full path / complete URL to the image file.

Default value

oracle_sw_image_gi:
  - {filename: LINUX.X64_2326100_grid_home.zip, version: 26.1.0.0, creates: install/.img.bin}
  - {filename: LINUX.X64_213000_grid_home.zip, version: 21.3.0.0, creates: install/.img.bin}
  - {filename: LINUX.X64_193000_grid_home.zip, version: 19.3.0.0, creates: install/.img.bin}
  - {filename: LINUX.X64_180000_grid_home.zip, version: 18.3.0.0, creates: install/.img.bin}
  - {filename: linuxx64_12201_grid_home.zip, version: 12.2.0.1, creates: xdk/mesg/lsxja.msb}
  - {filename: linuxamd64_12102_grid_1of2.zip, version: 12.1.0.2, creates: grid/stage/sizes/oracle.crs.12.1.0.2.0.sizes.properties}
  - {filename: linuxamd64_12102_grid_2of2.zip, version: 12.1.0.2, creates: grid/install/.oui}
  - {filename: linuxamd64_12c_grid_1of2.zip, version: 12.1.0.1}
  - {filename: linuxamd64_12c_grid_2of2.zip, version: 12.1.0.1}

Example usage

oracle_sw_image_gi:
  # LINUX.X64_213000_grid_home.zip located under `oracle_sw_source_local`
  - {filename: LINUX.X64_213000_grid_home.zip, version: 21.3.0.0, creates: 'install/.img.bin'}
  # LINUX.X64_193000_grid_home.zip located under /mnt/images
  - {filename: LINUX.X64_193000_grid_home.zip, filesource: /mnt/images/LINUX.X64_193000_grid_home.zip, version: 19.3.0.0, creates: 'install/.img.bin'}
  # LINUX.X64_180000_grid_home.zip download
  - {filename: LINUX.X64_180000_grid_home.zip, filesource: https://downloadserver/images?id=180000_grid_home, version: 18.3.0.0, creates: 'install/.img.bin'}

oracle_vip

suffix added to hostnames for VIPs.

{{ ansible_hostname }}{{ oracle_vip }}

Important!

oracle_node_vip defines a fixed hostname for the VIP.

That replaces the logic from oracle_vip for the VIP!

Default value

oracle_vip: -vip

oraswgi_install_remove_obsolete_homes

Remove obsolete Grid Infrastructure homes of Oracle Restart with deinstall.

Obsolete homes are all Grid Infrastructure homes in the central inventory except crs_home in /etc/oracle/olr.loc and oracle_home_gi, e.g. the old home after an Out-of-Place Patching.

The removal is done only, when Oracle Restart runs from oracle_home_gi and deinstall -checkonly reports the home as not configured.

Homes, which are not registered in the central inventory, are not touched.

Default value

oraswgi_install_remove_obsolete_homes: false

run_configtoolallcommand

Run configtoolcommand during installation.

Do not disable this!

Default value

run_configtoolallcommand: true

Discovered Tags

always

asmfd

crsctl

cvuqdisk

directories

dsset

glogingi

nfsmountdb

nfsumountdb

opatchls

oragridinstall

oragridsw

oragridswunpack

responsefileconfigtool

responsefilegi

runcluvfy

runconfigtool

runroot

updatenodelist

Open Tasks

  • (bug): ConfigTools should not depend on olr.loc…
  • (bug): ConfigTools should not depend on olr.loc…
  • (bug): ConfigTools should not depend on olr.loc…
  • (information): add selectattr to asm_diskgroups
  • (information): Check if path for patches is ok with patch_id/patch_id
  • (information): add selectattr to asm_diskgroups
  • (information): Check if path for patches is ok with patch_id/patch_id
  • (information): add selectattr to asm_diskgroups
  • (information): Check if path for patches is ok with patch_id/patch_id

Dependencies

  • orahost_meta
  • orasw_meta
  • oraswgi_meta

License

license (MIT)

Author

Mikael Sandström, Thorsten Bruhns

Last modified November 12, 2026: oraswgi_install: remove obsolete Grid Infrastructure homes of Oracle Restart (ad42b386)