gihome Commands

Use commands with the gihome keyword to add or delete nodes to Oracle Grid Infrastructure home and, move and upgrade Oracle Grid Infrastructure home.

rhpctl addnode gihome
Adds one or more nodes to an Oracle Grid Infrastructure installation.
rhpctl deletenode gihome
Removes one or more nodes from an Oracle Grid Infrastructure installation.
rhpctl move gihome
Moves the Oracle Grid Infrastructure software stack from one home to another.
rhpctl upgrade gihome
Upgrades the Oracle Grid Infrastructure from a source working copy or source home path to a destination working copy.

Parent topic: RHPCTL Command Reference

rhpctl addnode gihome

Adds one or more nodes to an Oracle Grid Infrastructure installation.

Syntax

rhpctl addnode gihome {-workingcopy workingcopy_name | -client cluster_name}
  -newnodes node_name:node_vip[:node_role][,node_name:node_vip[:node_role]...]
  {-root | -cred cred_name | -sudouser sudo_user_name
    -sudopath sudo_binary_location | 
    -auth plugin_name [-arg1 name1:value1 [-arg2 name2:value2 ...]]}
  [-targetnode node_name] [-force] [-setupssh] [-useractiondata user_action_data]
  [-eval] [-schedule timer_value]

Parameters

Table A-20 rhpctl addnode gihome Command Parameters

Parameter	Description
`-workingcopy workingcopy_name`	Specify the name of the working copy of the active Oracle Grid Infrastructure home that you want to install and configure on the specified node.
`-client cluster_name`	Alternatively, you can specify the name of the client cluster to which to add cluster nodes.
`-newnodes node_name:node_vip[:node_role]`	Specify a comma-delimited list of nodes on which Oracle Clusterware will be provisioned in the following format: `node_name:node_vip[:node_role]...]` If the target is a Flex Cluster, then `node_role` must be specified as either HUB or LEAF. For example, `-newnodes srv3:srv3-vip:HUB`
`-root \| -cred cred_name \| -sudouser sudo_user_name -sudopath sudo_binary_location \| -auth plugin_name plugin_args`	You must choose either `root`, a credential name, `sudo`, or an authentication plugin to access the remote node. Choose `-root` to perform super user operations as `root`. Alternatively, you can choose either to specify a credential name to associate the user name and password credentials to access a remote node, to perform super user operations as a `sudo` user by specifying a `sudo` user name and the path to the `sudo` binary, or to use an authentication plugin to access the remote node.
`-targetnode node_name`	Optionally, you can specify the name of a node in a remote cluster that has no Fleet Patching and Provisioning Client.
`–force`	Optionally, you can use this parameter to forcibly add nodes ignoring any previously failed add-node operation.
`-setupssh`	Sets up passwordless SSH user equivalence on the remote nodes for the provisioning user.
`-useractiondata user_action_data`	Optionally, you can pass a value to the `useractiondata` parameter of the user action script.
`–eval`	Optionally, you can use this parameter to evaluate the impact of this command on the system without actually running the command.
`-schedule timer_value`	Optionally, you can schedule a time to run this command in ISO-8601 format. For example: 2018-01-21T19:13:17+05.

Usage Notes

You can specify the target for the operation using the working copy name or, if the target is a Fleet Patching and Provisioning Client, then using the client cluster name.
You must provide either root credentials, a credential name, a sudo user, or an authentication plugin.
A target node is required if the target cluster is an Oracle Clusterware 11g release 2 (11.2) or 12c release 1 (12.1) cluster and must be the node name of an existing cluster node.

Parent topic: gihome Commands

rhpctl deletenode gihome

Removes one or more nodes from an Oracle Grid Infrastructure installation.

Syntax

rhpctl deletenode gihome {-workingcopy workingcopy_name | -client cluster_name}
  -node node_list {-root | -sudouser sudo_username -sudopath sudo_binary_path
    -cred cred_name | -auth plugin_name [-arg1 name1:value1...]}
  [-targetnode node_name] [-useractiondata user_action_data] [-eval]

Parameters

Table A-21 rhpctl deletenode gihome Command Parameters

Parameter	Description
`-workingcopy workingcopy_name`	Specify the name of a working copy of the Oracle Grid Infrastructure home that you want to remove from the specified node.
`-client cluster_name`	Alternatively, you can specify the name of the client cluster from which to remove cluster nodes.
`–node node_list`	Specify a comma-delimited list of node names from which to delete Oracle Grid Infrastructure.
`-root \| -sudouser sudo_username -sudopath sudo_binary_path \| -cred cred_name \| -auth plugin_name [-arg1 name1:value1...]`	You must choose either `sudo` or `root` to access the remote nodes. If you choose `sudo`, then you must specify a user name to run super-user operations, and a path to the location of the `sudo` binary. Optionally, you can choose to specify a credential name to associate the user and password credentials to access a remote node. Alternative to `–sudouser`, `–root`, or `–cred`, you can use `–auth` to specify an authentication plugin to access a remote node.
`-targetnode node_name`	Name of a node in a remote cluster with no Fleet Patching and Provisioning Client.
`-useractiondata user_action_data`	Optionally, you can pass a value to the `useractiondata` parameter of the user action script.
`–eval`	Optionally, you can use this parameter to evaluate the impact of this command on the system without actually running the command.

Usage Notes

You can specify the target for the operation using the working copy name or, if the target is a Fleet Patching and Provisioning Client, then using the client cluster name.
You must provide either root credentials or a sudo user.
A target node is required if the target cluster is an Oracle Clusterware 11g release 2 (11.2) or 12c release 1 (12.1) cluster and must be the node name of an existing cluster node.

Parent topic: gihome Commands

rhpctl move gihome

Moves the Oracle Grid Infrastructure software stack from one home to another.

Syntax

rhpctl move gihome {-destwc destination_workingcopy_name |
   -desthome destination_oracle_home_path}
  {{-sourcewc source_workingcopy_name | -sourcehome oracle_home_path} [-usepatchedhome]
   [-targetnode target_node_name] [-ignorewcpatches] [-nonrolling] 
   [-keepplacement] [-auto -dbhomes mapping_of_Oracle_homes [-dblist db_name_list
    | -excludedblist db_name_list] [-nodatapatch] [-disconnect]
    [-stopoption stop_option] [-drain_timeout timeout]]
   [-batches list_of_batches | -smartmove [-saf availability]]
   [-schedule timer_value] | -continue | -revert |-abort}
  [-root | -cred cred_name | -sudouser sudo_username -sudopath path_to_sudo_binary
   | -auth plugin_name [-arg1 name1:value1 [-arg2 name2:value2 ...]]] [-cleanpids]
  [-useractiondata user_action_data] [-schedule timer_value] [-eval] [-excludedbs file_path]

Parameters

Table A-22 rhpctl move gihome Command Parameters

Parameter	Description
`-destwc destination_workingcopy_name`	Specify the name of the destination working copy to which you want to move Oracle Grid Infrastructure.
`-desthome destination_oracle_home_path`	Alternative to specifying the name of the destination working copy, you can specify the path to the destination for the move of an Oracle home when you are moving the Oracle Grid Infrastructure home.
`-sourcewc working_copy_name`	If you want to move Oracle Grid Infrastructure from a working copy, then specify the name of the source working copy from which you want to move the Grid home.
`-sourcehome oracle_home_path`	If you are moving Oracle Grid Infrastructure from an unmanaged (not provisioned by Fleet Patching and Provisioning) Oracle home, then specify the path to the Oracle home from which you want to move Oracle Grid Infrastructure.
`-usepatchedhome`	Specify this parameter to use patched home to run Oracle Fleet Patching Provisioning Server and Client for Oracle Grid Infrastructure patching.
`-targetnode target_node_name`	Name of a node in a remote cluster with no Fleet Patching and Provisioning Client.
`-ignorewcpatches`	Use this parameter to ignore if the patched working copy is missing some patches which are present in the source path or working copy.
`-nonrolling`	Use this parameter to move the Oracle home in a non-rolling fashion.
`-keepplacement`	Specify this parameter to ensure that services of administrator-managed Oracle RAC or Oracle RAC One Node databases are running on the same instances before and after the move operation.
`-auto -dbhomes mapping_of_Oracle_homes`	Specify this parameter to automatically patch databases when you patch Oracle Grid Infrastructure.
`-dblist db_name_list`	Optionally, you can specify the unique names of the databases (`DB_UNIQUE_NAME` without `DB_DOMAIN`) on which you want to perform the patching operation. Note: If you are moving a non-clustered (single-instance) database, then, for the value of the `-dbname` parameter, you must specify the SID of the database instead of the database name.
`-excludedblist db_name_list`	Alternative to using the `-dbname` parameter, you can use the `-excludedblist` parameter to patch all databases except specific databases.
`-nodatapatch`	Optionally, you can use this parameter to indicate not to run `datapatch` for databases being moved.
`-disconnect`	Optionally, you can use this parameter to disconnect all sessions before stopping or relocating services.
`-stopoption stop_option`	Optionally, you can choose one of the following stop options for the database: ABORT, IMMEDIATE, NORMAL, TRANSACTIONAL, or TRANSACTIONAL_LOCAL.
`-drain_timeout session_drain_time`	Optionally, you can use this parameter to specify a service drain timeout, in seconds.
`-batches list_of_batches`	Optionally, you can specify a comma-delimited list of batches of nodes (where each batch is a comma-delimited list of node names enclosed in parentheses) enclosed in double quotation marks (`""`) in the format: `"(nA,nB,...),(...,nY,nZ)"`.
`-smartmove [-saf availability`	Alternatively, you can use the `-smartmove` parameter to auto-generate a list of batches of nodes and move databases by restarting instances after each batch. Optionally, you can use the `-saf` parameter to specify the service availability factor, which is the minimum percentage of instances on which a service must remain running during the move.
`-schedule timer_value`	Optionally, you can schedule a time to run this command in ISO-8601 format. For example: 2018-01-21T19:13:17+05.
`-continue`	Use this parameter to continue restarting the Oracle Clusterware stack on the next batch of nodes.
`-revert`	Use this parameter to revert back to before the move operation.
`-abort`	Use this parameter to abort an ongoing move operation.
`-root \| -cred cred_name \| -sudouser sudo_user_name -sudopath sudo_binary_location \| -auth plugin_name plugin_args`	If you choose to use the `-targetnode` parameter, then you must choose either `root`, a credential name, `sudo`, or an authentication plugin to access the remote node. Choose `-root` to perform super user operations as `root`. Alternatively, you can choose either to specify a credential name to associate the user name and password credentials to access a remote node, to perform super user operations as a `sudo` user by specifying a `sudo` user name and the path to the `sudo` binary, or to use an authentication plugin to access the remote node.
`-cleanpids`	When using a persistent home path for both the source and destination working copies, specify `-cleanpids` to ensure processes are stopped completely on the source home.
`-useractiondata user_action_data`	Optionally, you can pass a value to the `useractiondata` parameter of the user action script.
`-schedule timer_value`	Optionally, you can use this parameter to schedule a time to run this operation, in ISO-8601 format, as in the following example: `2018-07-25T19:13:17+05`
`-eval`	Use this parameter to evaluate the `rhpctl move gihome` command and print automatically generated batches of nodes and the sequence of moves without actually running the command.
`-excludedbs file_path`	Use this parameter to start all patched databases except for the database names specified in the input file. This parameter accepts path of a file that contains comma-separated list of database names, which is `DB_UNIQUE_NAME`.

Usage Notes

If you choose to use the -schedule parameter, then you must run this command on the Fleet Patching and Provisioning Server.

Example

Assume there is a target cluster running Oracle Grid Infrastructure 12c release 1 (12.1.0.2) from a working copy named grid12102wcpy, and one of the nodes in the cluster is named bposvr141. After provisioning the patched working copy, called grid12102PSU (using the -softwareonly parameter with the rhpctl add workingcopy command), move the Grid home to the patched working copy, as follows:

$ rhpctl move gihome -sourcewc grid12102wcpy -destwc grid12102PSU -root -targetnode bposvr141

Parent topic: gihome Commands

rhpctl upgrade gihome

Upgrades the Oracle Grid Infrastructure from a source working copy or source home path to a destination working copy.

Syntax

rhpctl upgrade gihome {-sourcewc source_workingcopy_name | 
     -sourcehome oracle_home_path -targetnode target_node_name} 
   -destwc destination_workingcopy_name
  {-root | -sudouser sudo_user_name -sudopath sudo_binary_location]
      -cred cred_name | 
      -auth plugin_name [-arg1 name1:value1...]  [-arg2 name2:value2 ...]}
  [-ignoreprereq] [-useractiondata user_action_data]
  [-eval] [-batches list_of_batches] [-abort | -continue]
  [-schedule {timer_value | NOW}]

Parameters

Table A-23 rhpctl upgrade gihome Command Parameters

Parameter	Description
`-sourcewc source_workingcopy_name`	Specify the name of the source working copy from which the Oracle Grid Infrastructure home needs to be upgraded.
`-sourcehome oracle_home_path`	Alternative to specifying the name of the source working copy, you can specify the path to the unmanaged Oracle Grid Infrastructure home.
`-targetnode target_node_name`	In addition to specifying the source Oracle Grid Infrastructure home, you must also specify a node that is in a remote cluster that has no Fleet Patching and Provisioning Client.
`-destwc destination_workingcopy_name`	Specify the name of the destination working copy to which the Oracle Grid Infrastructure home is to be upgraded.
`-root \| -sudouser sudo_username -sudopath sudo_binary_path \| -cred cred_name`	If you choose to use the `-targetnode` parameter, then you must choose either `sudo` or `root` to access the remote node. If you choose `sudo`, then you must specify a user name to run super-user operations, and a path to the location of the `sudo` binary. Optionally, you can choose to specify a credential name to associate the user and password credentials to access a remote node. Alternative to `–sudouser`, `–root`, or `–cred`, you can use `–auth` to specify an authentication plugin to access a remote node.
`-auth plugin-name [-arg1 name1:value1 [-arg2 name2:value2 ...]]`	Use an authentication plugin to access the remote node. Optionally provide a list of arguments to the plugin.
`-ignoreprereq`	Use this parameter to ignore the CVU prerequisite checks.
`-schedule {timer_value \| NOW}`	Optionally, you can schedule a time to run this command in ISO-8601 format. For example: 2018-01-21T19:13:17+05. If `NOW` is specified, then the job is scheduled immediately.
`-useractiondata user_action_data`	Value to be passed to `useractiondata` parameter of the `useraction` script.
`-eval`	Evaluate without executing the command.
`-batches list_of_batches`	List of batches of nodes in the format: `"(Ba),...,(Bz)"`.
`-abort \| -continue`	Abort the ongoing move operation or continue restarting the CRS stack on the next batch of nodes.

Parent topic: gihome Commands