To keep Oracle Database Appliance running with the latest software, check for and apply Oracle Database Appliance patch bundles when they are released.
Topics:
update-dcsagent command to update the agent version.update-server command to update the operating system, firmware, Oracle Appliance Kit , Oracle Clusterware, and all other infrastructure components.update-dbhome command to update a specific RDBMS Home to the latest patch bundle version.Review this topic to understand the patching process, and to understand the patching options available to you in this patch set release.
About Oracle Database Appliance Software Updates
To keep Oracle Database Appliance running with the latest software, check for and apply Oracle Database Appliance patch bundles when they are released. As well as offering new features, patches may improve the functionality of existing features.
Oracle Database Appliance patch bundles are released on a quarterly schedule. My Oracle Support note 2144642.1 and 888888.1 provide information about the latest Oracle Database Appliance patch bundle. See My Oracle Support note 2144642.1 to obtain the most current updates and known issues for the Oracle Database Appliance patch bundle installation.
Caution:
Do not patch Oracle Database Appliance using individual patches for Oracle Grid Infrastructure, Oracle Database, or Oracle Linux. Also do not use individual infrastructure patches, such as firmware patches. You must only use Oracle Database Appliance patches.
If you use patches that are not intended for Oracle Database Appliance, or if you use Opatch, or a similar patching tool, then Oracle Database Appliance inventory is not updated, and you cannot complete future patch updates.
Minimum Supported Appliance Manager Software Versions
The table lists the minimum supported software version and the recommended supported software version for each Oracle Database Appliance hardware version.
Table 6-1 Minimum Supported Appliance Manager Software Versions
| Oracle Database Appliance Hardware Version | Minimum Supported Software Version | Recommended Supported Software Version |
|---|---|---|
|
X6-2S |
12.1.2.8.0 |
12.1.2.10.0 |
|
X6-2M |
12.1.2.8.0 |
12.1.2.10.0 |
|
X6-2L |
12.1.2.8.1 |
12.1.2.10.0 |
Overview of the Patch Upgrade
Oracle Database Appliance patch set releases include new enhancements, including a comprehensive patching solution for Oracle Database Appliance X6-2S, X6-2M, and X6-2L.
Note:
Before updating the repository, agent, server, or database, ensure that you do not have any jobs running or pending during the update window.Note:
If you are using Oracle Database Appliance 12.1.2.7, then you must upgrade thedcs-agent before installing the latest patch set. The dcs-agent upgrade includes changes that enable you to install the patch set bundle. Use the describe-job command to monitor the progress of each patching job.Download the Oracle Database Appliance patch set bundle from My Oracle Support and update the repository with the new patches.
update-repository command, ensure that your appliance has the latest version of the agent.Run the update-dcsagent command to update the agent version.
Example 6-1 Updating the DCS Agent Version
Run the following command to update the DCS Agent to version 12.1.2.10.0:
# odacli update-dcsagent -v 12.1.2.10.0
{
"jobId" : "77e454d3-eb68-4130-a247-7633f8d6192b",
"status" : "Created",
"message" : null,
"reports" : [ ],
"createTimestamp" : "January 26, 2017 10:30:02 AM EDT",
"description" : "DcsAgent patching",
"updatedTime" : "January 26, 2017 10:30:02 AM EDT"
}
Example 6-2 Verifying that the DCS Agent is on Version 12.1.2.10.0
The following example uses job ID 77e454d3-eb68-4130-a247-7633f8d6192b from the previous example to get the job details.
# odacli describe-job -i "77e454d3-eb68-4130-a247-7633f8d6192b"
Job details
----------------------------------------------------------------
ID: 77e454d3-eb68-4130-a247-7633f8d6192b
Description: DcsAgent patching
Status: Success
Created: January 26, 2017 10:39:02 AM EDT
Message:
Task Name Start Time
------------------- --------------------------------
dcsagent rpm version checking January 26, 2017 10:39:02 AM EDT
Patch location validation January 26, 2017 10:39:02 AM EDT
Apply dcsagent patch January 26, 2017 10:39:02 AM EDT
(Continued)
End Time Status
------------------------------ ------
January 26, 2017 10:39:02 AM EDT Success
January 26, 2017 10:39:02 AM EDT Success
January 26, 2017 10:39:02 AM EDT Success
Run the update-server command to update the operating system, firmware, Oracle Appliance Kit , Oracle Clusterware, and all other infrastructure components.
odacli update-server command , update the repository with the latest patch bundle, and update the DCS Agent to the latest version. Before updating the server, ensure that the agent is running.Example 6-3 Updating the Server Version
Run the following command to update the server to version 12.1.2.10.0:
# odacli update-server -v 12.1.2.10.0
{
"jobId" : ""94685c73-55c2-40b1-a02e-265a23c45642",
"status" : "Created",
"message" : "Success of Server Update may trigger reboot of node after 4-5 minutes. Please wait till node restart",
"reports" : [ ],
"createTimestamp" : "January 26, 2017 14:13:45 PM CST",
"resourceList" : [ ],
"description" : "Server Patching",
"updatedTime" : "January 26, 2017 14:13:45 PM CST"
}
Example 6-4 Verifying that the Server is on the Updated Version
The following example uses job ID 94685c73-55c2-40b1-a02e-265a23c45642 from the previous example to get the job details and status.
# /opt/oracle/dcs/bin/odacli describe-job -i "94685c73-55c2-40b1-a02e-265a23c45642"
Job details
----------------------------------------------------------------
ID: 94685c73-55c2-40b1-a02e-265a23c45642
Description: Server Patching
Status: Success
Created: January 26, 2017 11:02:30 AM EDT
Message:
Task Name Start Time
------------------------------- ------------------------------
dcscontroller rpm version checking January 26, 2017 11:02:30 AM EDT
Patch location validation January 26, 2017 11:02:31 AM EDT
Apply dcscontroller patch January 26, 2017 11:02:31 AM EDT
dcscli rpm version checking January 26, 2017 11:02:32 AM EDT
Patch location validation January 26, 2017 11:02:32 AM EDT
Apply dcscli patch January 26, 2017 11:02:32 AM EDT
oak rpm version checking January 26, 2017 11:02:33 AM EDT
Patch location validation January 26, 2017 11:02:33 AM EDT
Apply oak patch January 26, 2017 11:02:33 AM EDT
Checking Ilom patch Version January 26, 2017 11:03:02 AM EDT
Patch location validation January 26, 2017 11:03:05 AM EDT
Apply Ilom patch January 26, 2017 11:03:05 AM EDT
Copying Flash Bios to Temp location January 26, 2017 11:03:06 AM EDT
Patch application verification January 26, 2017 11:03:06 AM EDT
Patch location validation January 26, 2017 11:03:09 AM EDT
Opatch updation January 26, 2017 11:04:13 AM EDT
analyzing patch January 26, 2017 11:04:15 AM EDT
Apply gi patch January 26, 2017 11:04:50 AM EDT
Reboot Ilom January 26, 2017 11:16:17 AM EDT
(Continued)
End Time Status
------------------------------ ------
January 26, 2017 11:02:31 AM EDT Success
January 26, 2017 11:02:31 AM EDT Success
January 26, 2017 11:02:32 AM EDT Success
January 26, 2017 11:02:32 AM EDT Success
January 26, 2017 11:02:32 AM EDT Success
January 26, 2017 11:02:33 AM EDT Success
January 26, 2017 11:02:33 AM EDT Success
January 26, 2017 11:02:33 AM EDT Success
January 26, 2017 11:03:02 AM EDT Success
January 26, 2017 11:03:05 AM EDT Success
January 26, 2017 11:03:05 AM EDT Success
January 26, 2017 11:03:06 AM EDT Success
January 26, 2017 11:03:06 AM EDT Success
January 26, 2017 11:03:09 AM EDT Success
January 26, 2017 11:03:14 AM EDT Success
January 26, 2017 11:04:15 AM EDT Success
January 26, 2017 11:04:50 AM EDT Success
January 26, 2017 11:16:08 AM EDT Success
January 26, 2017 11:16:17 AM EDT Success
Run the update-dbhome command to update a specific RDBMS Home to the latest patch bundle version.
After patching, download the latest database end user bundles. You can use the odacli create-database command to create different versions of the database without downloading the latest database end user bundle.
Note:
Oracle recommends downloading the latest database bundle and use it to create any new databases.Example 6-5 Getting a List of Database Home IDs
The following example shows how to get a database home ID using JSON output:
# /opt/oracle/dcs/bin/odacli list-dbhomes -j
[ {
"id" : "ab3cecaf-2223-4726-b95c-488f0aec914a",
"name" : "OraDB12102_home1",
"dbVersion" : "12.1.0.2.161018 (24927502, 24340679)",
"dbHomeLocation" : "/u01/app/oracle/product/12.1.0.2/dbhome_1",
"createTime" : "February 17, 2017 08:46:52 AM PDT",
"state" : {
"status" : "CONFIGURED"
},
"updatedTime" : "February 17, 2017 11:55:55 AM PDT"
}, {
"id" : "d5b01e27-799e-4e8a-bfe6-07a781f79526",
"name" : "OraDB12102_home2",
"dbVersion" : "12.1.0.2.160719 (23739960, 23144544)",
"dbHomeLocation" : "/u01/app/oracle/product/12.1.0.2/dbhome_2",
"createTime" : "February 17, 2017 22:34:31 PM PDT", "state" : {
"status" : "CONFIGURED"
},
"updatedTime" : "February 17, 2017 22:36:59 PM PDT"
} ]
Example 6-6 Updating the Database Home Version
The following example updates database home ID d5b01e27-799e-4e8a-bfe6-07a781f79526 to Oracle Database Appliance version 12.1.2.10.0.
# odacli update-dbhome -i d5b01e27-799e-4e8a-bfe6-07a781f79526 -v 12.1.2.10.0
{
"jobId" : "576cdbfa-ece4-4e5f-becd-9bc6e6bf430b",
"status" : "Created",
"message" : null,
"reports" : [ ],
"createTimestamp" : "February 18, 2017 11:08:35 AM PDT",
"description" : "DbHome Patching: Home Id is d5b01e27-799e-4e8a-bfe6-07a781f79526",
"updatedTime" : "February 18, 2017 11:08:35 AM PDT"
}
Example 6-7 Verifying that Database Home is Updated
The following example uses job ID 576cdbfa-ece4-4e5f-becd-9bc6e6bf430b from the previous example to get the job details.
# /opt/oracle/dcs/bin/odacli describe-job -i "576cdbfa-ece4-4e5f-becd-9bc6e6bf430b"
Job details
----------------------------------------------------------------
ID: 576cdbfa-ece4-4e5f-becd-9bc6e6bf430b
Description: DbHome Patching: Home Id is d5b01e27-799e-4e8a-bfe6-07a781f79526
Status: Success
Created: February 18, 2017 11:08:35 AM PDT
Message:
Task Name Start Time
--------------------------------- -------------------------------
Patch application verification February 18, 2017 11:08:35 AM PDT
location validation February 18, 2017 11:08:37 AM PDT
updateOpatch February 18, 2017 11:09:41 AM PDT
analyzing patch February 18, 2017 11:09:43 AM PDT
Apply db patch February 18, 2017 11:10:17 AM PDT
(continued)
End Time Status
--------------------------------- --------
February 18, 2017 11:08:37 AM PDT Success
February 18, 2017 11:08:42 AM PDT Success
February 18, 2017 11:09:43 AM PDT Success
February 18, 2017 11:10:17 AM PDT Success
February 18, 2017 11:14:13 AM PDT Success
The patch bundle updates provide all relevant patches for the entire system and are designed to work with Oracle Database Appliance and future update patch bundles.
The patch bundle includes relevant patches, including the following:
BIOS
Hardware drivers, Hardware Management Pack (HWM), and firmware drivers
Oracle Appliance Manager
Oracle Linux
Oracle VM
Java Development Kit (JDK)
Oracle Integrated Lights Out Manager (Oracle ILOM)
Oracle Database Patch Set Update (PSU)
Oracle Auto Service Request (Oracle ASR)
Oracle Grid Infrastructure
Intelligent Platform Management Interface (IPMI)
Caution:
Do not patch Oracle Database Appliance using individual patches for Oracle Grid Infrastructure, Oracle Database, and most Oracle Linux RPM updates. Do not use individual infrastructure patches, such as firmware patches. You must only use Oracle Database Appliance patches.
If you use patches that are not intended for Oracle Database Appliance, or if you use Opatch, or a similar patching tool, then you can encounter problems with storage, communication, and applying patch updates in the future.
Updating Oracle Linux RPMs
While not recommended, you can update some Oracle Linux RPMs for database nodes. Do not update or customize Oracle Linux kernel, Oracle Optimal Flexible Architecture, Oracle InfiniBand, or related software. Other software may be installed, updated, or customized. However, the Oracle Database Appliance update may not carry newer version dependencies of customized components. Therefore, you might be required to remove and subsequently reapply site-specific changes to successfully update Oracle Database Appliance in the future.
Caution:
For database nodes, do not update the following:
Oracle Linux Kernel (kernel*)
Oracle Optimal Flexible Architecture (ofa*)
Oracle InfiniBand-related packages (ofed*)
For storage, do not apply any RPM updates.
Using a Different Version of Java Development Kit (JDK)
Oracle Database Appliance depends on a specific version of JDK. If you want to use a different version of JDK for a specific application, then install it in a different directory and only point to it for that application.