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-image command to update the dcs-agent image to the latest version.update-dcsagent command to update the agent to the 12.1.2.8 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 for 12.1.2.8.0, and to understand the patching options available to you in this patch set release.
About Oracle Database Appliance Software Updates
Note:
Oracle Database Appliance release 12.1.2.8.1 release introduces support for Oracle Database Appliance X6-2L and does not contain patches or 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 12.1.2.8.0 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.
Overview of the 12.1.2.8.0 Patch Upgrade
Oracle Database Appliance patch set release 12.1.2.8.0 includes new enhancements, including a comprehensive patching solution for Oracle Database Appliance X6–2S and X6–2M.
If you are using Oracle Database Appliance 12.1.2.7, then you must upgrade the dcs-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.
Note:
Before updating the repository, agent, server, or database, ensure that you do not have any jobs running or pending during the update window.Run the update-image command to update the dcs-agent image to the latest version.
Note:
You must update thedcs-agent to the latest version before using the patching command–line interface. The 12.1.2.8.0 dcs-agent includes information needed to use the command–line interface to install the update bundle and update the agent, server, and databases.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.
Use this procedure to 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 to the 12.1.2.8 version.
Example 6-1 Updating the DCS Agent to Version 12.1.2.8
Run the following command to update the DCS Agent to version 12.1.2.8:
# odacli update-dcsagent -v 12.1.2.8
{
"jobId" : "11a9dcb7-01bc-44b5-b178-334978ee5faf",
"status" : "Created",
"message" : null,
"reports" : [ ],
"createTimestamp" : "August 03, 2016 06:15:00 AM EDT",
"description" : "DcsAgent patching",
"updatedTime" : "August 03, 2016 06:15:00 AM EDT"
}
Example 6-2 Verifying that the DCS Agent is on Version 12.1.2.8
The following example uses job ID 11a9dcb7-01bc-44b5-b178-334978ee5faf from the previous example to get the job details.
# odacli describe-job -i "11a9dcb7-01bc-44b5-b178-334978ee5faf"
Job details
----------------------------------------------------------------
ID: 11a9dcb7-01bc-44b5-b178-334978ee5faf
Description: DcsAgent patching
Status: Success
Created: August 3, 2016 6:15:00 AM EDT
Message:
Task Name Start Time End Time Status
------------------- -------------------------------- ------------------------------ ------
location validation August 3, 2016 6:15:00 AM EDT August 3, 2016 6:15:00 AM EDT Success
Apply patch August 3, 2016 6:15:00 AM EDT August 3, 2016 6:15:01 AM EDT Success
Run the update-server command to update the operating system, firmware, Oracle Appliance Kit , Oracle Clusterware, and all other infrastructure components.
Example 6-3 Updating the Server to Version 12.1.2.8
Run the following command to update the server to version 12.1.2.8:
# /opt/oracle/dcs/bin/odacli update-server -v 12.1.2.8
{
"jobId" : "94685c73-55c2-40b1-a02e-265a23c45642",
"status" : "Created",
"message" : null,
"reports" : [ ],
"createTimestamp" : "August 03, 2016 06:16:19 AM EDT",
"description" : "GiHome Patching",
"updatedTime" : "August 03, 2016 06:16:19 AM EDT" }
Example 6-4 Verifying that the Server is on Version 12.1.2.8
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: GiHome Patching
Status: Running
Created: August 3, 2016 6:16:19 AM EDT
Message:
Task Name Start Time End Time Status
------------------------------- ------------------------------ ------------------------------ ------
location validation August 3, 2016 6:16:19 AM EDT August 3, 2016 6:16:19 AM EDT Success
Apply patch August 3, 2016 6:16:20 AM EDT August 3, 2016 6:16:40 AM EDT Success
Patch application verification August 3, 2016 6:16:40 AM EDT August 3, 2016 6:16:42 AM EDT Success
location validation August 3, 2016 6:16:42 AM EDT August 3, 2016 6:16:42 AM EDT Running
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. If you do not download the latest database bundle, you cannot use the Web Console to create an older version of the database. You can use the odacli create-database command to create different versions of the database without downloading the latest database end user bundle.
Example 6-5 Getting a List of Database Home IDs
The following example shows how to get a database home ID.
# /opt/oracle/dcs/bin/odacli list-dbhomes ID Name DB Version ------------------------------------ ----------------- ---------- 89427c39-7f87-43c7-a8bf-0a5f59c3a33a ODB12102_home1 12.1.0.2 (continued) Home Location ----------------------------------------- /u01/app/orauser/product/12.1.0.2/dbhome_1
Example 6-6 Updating the Database Home to Version 12.1.2.8
The following example updates database home ID 89427c39-7f87-43c7-a8bf-0a5f59c3a33a to Oracle Database Appliance version 12.1.2.8.
# /opt/oracle/dcs/bin/odacli update-dbhome -dh 89427c39-7f87-43c7-a8bf-0a5f59c3a33a -v 12.1.2.8
{
"jobId" : "801c3919-d235-4db1-9b00-6c2f382d8a07",
"status" : "Created",
"message" : null,
"reports" : [ ],
"createTimestamp" : "August 03, 2016 11:57:27 AM EDT",
"description" : "DbHome Patching: Home Id is 89427c39-7f87-43c7-a8bf-0a5f59c3a33a",
"updatedTime" : "August 03, 2016 11:57:27 AM EDT"
}
Example 6-7 Verifying that Database Home is on Version 12.1.2.8
The following example uses job ID 801c3919-d235-4db1-9b00-6c2f382d8a07 from the previous example to get the job details.
# /opt/oracle/dcs/bin/odacli describe-job -i "801c3919-d235-4db1-9b00-6c2f382d8a07"
Job details
----------------------------------------------------------------
ID: 801c3919-d235-4db1-9b00-6c2f382d8a07
Description: DbHome Patching: Home Id is 89427c39-7f87-43c7-a8bf-0a5f59c3a33a
Status: Running
Created: August 3, 2016 11:57:27 AM EDT
Message:
Task Name Start Time
--------------------------------- -------------------------------
Patch application verification August 3, 2016 11:57:27 AM EDT
location validation August 3, 2016 11:57:29 AM EDT
updateOpatch August 3, 2016 11:58:31 AM EDT
analyzing patch August 3, 2016 11:58:33 AM EDT
(continued)
End Time Status
--------------------------------- --------
August 3, 2016 11:57:29 AM EDT Success
August 3, 2016 11:57:34 AM EDT Success
August 3, 2016 11:58:33 AM EDT Success
August 3, 2016 11:58:33 AM EDT Running