patch Commands

Use commands with the patch keyword to apply or rollback one-off patches to the specified working copy using the in-place patching method.

rhpctl apply patch
Applies one-off patches to the specified working copy using in-place patching method.
rhpctl rollback patch
Rolls back the specified patch in the specified working copy.
rhpctl evaluate patch
Evaluates the specified home or gold image to get the health status and patch recommendations.
rhpctl query patch
Queries the current status of the specified Oracle Update Advisor request ID.

Parent topic: RHPCTL Command Reference

rhpctl apply patch

Applies one-off patches to the specified working copy using in-place patching method.

Syntax

rhpctl apply patch -workingcopy workingcopy_name
  [-patchloc patch_location_on_target] [-online [-dbname unique_db_name]]
  [-eval] [-targetnode target_node_name {-root | -cred cred_name | -sudouser sudo_username
  -sudopath path_to_sudo_binary | -auth plugin_name [-arg1 name1:value1
  [-arg2 name2:value2 ...]]}] [-schedule timer_value] [-jobtag tag_name]

Parameters

Table A-55 rhpctl apply patch Command Parameters

Parameter	Description
`-workingcopy workingcopy_name`	Specify a name for the working copy that you want to patch.
`-patchloc patch_location_on_target`	Specify the absolute path for the unzipped patch directory on the target.
`-online`	Specify this parameter to indicate that the patch type is online.
`-dbname unique_db_name`	Specify the unique name of the database (`DB_UNIQUE_NAME` without `DB_DOMAIN`) that you are patching.
`–eval`	Optionally, you can use this parameter to evaluate the impact of this command on the system without actually running the command.
`-targetnode target_node_name`	Specify the name of an `rhpclient`-less target.
`-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.
`-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: `2024-04-15T19:13:17+05` If `NOW` is specified or the option is omitted, then the job is scheduled immediately. If `PAUSE` is specified, then the job starts in the paused state and you need to resume the job using the `rhpctl resume job -jobid job_id` command.
`-jobtag tag_name`	Optionally, you can associate a user-defined tag with the scheduled jobs.

Examples

To patch a working copy on a client cluster:

rhpctl apply patch -workingcopy workingcopy_name -image image_name -online

Parent topic: patch Commands

rhpctl rollback patch

Rolls back the specified patch in the specified working copy.

Syntax

rhpctl rollback patch -patchid patch_ids -workingcopy workingcopy_name
  [-online [-dbname unique_db_name]] [-targetnode target_node_name {-root | -cred cred_name 
  | -sudouser sudo_username -sudopath path_to_sudo_binary | -auth plugin_name 
  [-arg1 name1:value1 [-arg2 name2:value2 ...]]}] 
  [-schedule timer_value] [-jobtag tag_name]

Parameters

Table A-56 rhpctl rollback patch Command Parameters

Parameter	Description
`-patchid patch_id`	Specify a comma-separated list of patch IDs that you want to roll back.
`-workingcopy workingcopy_name`	Specify a name for the working copy from which you want to rollback the patch.
`-online`	Specify this parameter to indicate that the patch type is online.
`-dbname unique_db_name`	Specify the unique name of the database (`DB_UNIQUE_NAME` without `DB_DOMAIN`) from which you want to rollback the patch.
`-targetnode target_node_name`	Specify the name of an `rhpclient`-less target.
`-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.
`-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: `2024-04-15T19:13:17+05` If `NOW` is specified or the option is omitted, then the job is scheduled immediately. If `PAUSE` is specified, then the job starts in the paused state and you need to resume the job using the `rhpctl resume job -jobid job_id` command.
`-jobtag tag_name`	Optionally, you can associate a user-defined tag with the scheduled jobs.

Examples

To rollback a patch from a working copy on a client cluster:

rhpctl rollback patch -patchid patch_id -workingcopy workingcopy_name -online

Parent topic: patch Commands

rhpctl evaluate patch

Evaluates the specified home or gold image to get the health status and patch recommendations.

Syntax

rhpctl evaluate patch {-image image_name | -path oracle_home_path} 
[-applyfrequency <MONTHLY|QUARTERLY|HALF_YEARLY|ANNUALLY>] [-updatelag LATEST | LATEST-1 | LATEST-2] 
[-additionalbuglist bug_list] [-generateimage -importtoimage target_image_name]

Table A-57 rhpctl evaluate patch Command Parameters

Parameter	Description
`-image image_name`	Specify the name of a deployed working copy that you want to evaluate. Note: This option is available only for Oracle FPP Server Mode.
`-path oracle_home_path`	Specify the absolute path for evaluating the Oracle home.
`-updatelag update_lag`	Specify the update lag policy for your image or Oracle home. LATEST: most recently released RU (default) LATEST-1: 1 RU before the most recent RU LATEST-2: 2 RUs before the most recent RU The default value is LATEST.
`-applyfrequency apply_frequency`	Specify how often you patch your working copy or Oracle home. MONTHLY: update software every month. QUARTERLY: update software every 3 months (Oracle recommended - default). HALF_YEARLY: update software every 6 months. ANNUALLY: update software every 12 months. The default and Oracle recommended patch frequency is QUARTERLY.
`-additionalbuglist bug_list`	Comma-separated list of additional bugs that you want to apply along with the Oracle Update Advisor recommended patches.
`-generateimage -importtoimage target_image_name`	Specify this parameter to generate a patched image and import the patched image to the specified gold image. Note: This option is available only for Oracle FPP Local Mode.

Examples

To evaluate an Oracle Grid Infrastructure home:

$ rhpctl evaluate patch -image DB236000 -generateimage -importtoimage DB238000
Operation "rhpctl evaluate patch" scheduled with the job ID "53".

Parent topic: patch Commands

rhpctl query patch

Queries the current status of the specified Oracle Update Advisor request ID.

Syntax

Note:

This command is only for Oracle FPP Local Mode.

rhpctl query patch [-requestid request_id]

Parameters

Table A-58 rhpctl query patch Command Parameters

Parameter Description

Parameter	Description
`-requestid request_id`	Specify a request ID for which you want to check the status. Note: If you do not specify a request ID, then it displays a list of all the requests.

-requestid request_id

Specify a request ID for which you want to check the status.

Note: If you do not specify a request ID, then it displays a list of all the requests.

Examples

To display status of the specified request ID:

rhpctl query patch -requestid 96643   
Software health status: "RED"   
Software health comment: "More than one cycle behind your policy.."   
Software Type: "DB"   
Current version: "23.7.0.0.0"   
Recommended version: "23.9"
Image is available to download. Please download it using below command.     
rhpctl downloadimage patchplan -requestid 96643 -downloadlocation <download_location>

To display a list of all the requests:

rhpctl query patch   
Home: /u01/app/oracle/product/23.7.0/dbhome_1
  Request id: 96643
  Request time: 2025-09-06 12:14:35   
Home: /u01/app/23.7.0/grid
  Request id: 96604
  Request time: 2025-09-05 12:51:43   
Home: /u01/app/oracle/product/23.7.0/dbhome_1  
  Request id: 96603
  Request time: 2025-09-05 12:16:33

Parent topic: patch Commands