Applying a Patch and Rolling Back a Patch for an Oracle Java Cloud Service Instance

Purpose

This tutorial explains how to apply a patch and roll back a patch for an Oracle Java Cloud Service instance.

Last Updates

May 2017, Release 17.2.3

Please note that Oracle develops its cloud services in an agile manner and makes rapid changes to meet our users' needs. Therefore this tutorial may not reflect all of the changes since the last update to this service. For the very latest information see:

• What's New for Oracle Java Cloud Service

Time to Complete

Approximately 30 minutes

Background

Patching and rollback are one-click processes that do not interrupt Oracle Java Cloud Service operation.

Scenario

To keep your service current, you can apply patches that Oracle makes available quarterly.

What Do You Need

A web browser is required for working with Oracle Cloud Services. These are the minimum requirements:

• Microsoft Internet Explorer 9 or 10.
  • Set Browser Mode to IE9 or IE10
  • Set Document Mode to IE9 or IE10 standards
• Google Chrome 29 and later
• Mozilla Firefox 24 and later
• Apple Safari 6 and later

Before starting this tutorial, you should have:

1. Created an Oracle Java Cloud Service instance. See the tutorial Getting Started with Oracle Java Cloud Service.
2. Deployed and started an application on that instance. See the Deploying an Application by Using the WebLogic Server Administration Console tutorial.

Before you patch your instance, perform the following steps to verify that your application is running.

1. Navigate to the Java Cloud Service Console.

   

2. Select the instance you have created.

   

   The Java Cloud Service Instance Overview page is displayed.

   

3. Note the IP address of the load balancer. You will need this information later to run your application.

   

4. Click the menu icon on the top right corner of the page, and select Open WebLogic Server Console.

   

5. A message might appear, warning of an untrusted certificate. Allow the exception.

6. Enter your log-in credentials to complete access. These are the credentials you specified when you created the instance.

   

The WebLogic Server Administration Console home page is displayed.



7. On the Administration Console, click domain > Deployments, where domain is the domain where the application is deployed.

   

8. Find your application on the deployments table and verify that the status is Active.

   

9. Leave the Administration Console open.

10. Open a browser window and type the following information into the address bar:

    https://IP_addr_load_balancer/context_root_of_app

    In this example, the URL is:

    https://IP_addr_load_balancer/benefits

    The application is displayed.

    

To apply a patch, perform the following steps:

1. Navigate to the Patching page.

   • Open the Oracle Java Cloud Service Console.

     

   • Click the name of the instance you want to patch.

     

     The Java Cloud Service Instance page is displayed with the Overview tile in focus.

     

   • Click the Administration Tile. It shows how many patches are available to apply, and the date and time of the last backup.

     

   • Click the Patching tab.The Patching page is displayed.

     

2. In the Available Patches section, click the menu to the right of the patch you want to apply and select Patch.

   

   Note: You can choose to run patching prechecks in order to identify and address any issues found before you attempt to patch the service instance. In this case, we choose to proceed directly to patching.

3. In the Patch Service dialog:

   • Type a note for your reference, describing the purpose of the patch. Note: This note is required.

     

   • If Oracle Coherence is enabled for your instance: Select the Confirm checkbox to override the default behavior, which is to verify the high availability status of the data stored in the Coherence data tier before shutting down a node to apply the patch.

     When Confirm is selected, know that this means there's a possibility of data loss by not requiring the services within the Coherence cluster to reach NODE-SAFE before stopping a server to apply the patch. If Confirm is not selected, understand that patching will fail if NODE-SAFE cannot be reached.

     If there's only one Managed Server on the Coherence data tier of your instance, the Confirm checkbox is selected and disabled by default.

     Note: If Coherence is not enabled, the Coherence information on this dialog does not appear.

4. In the Patch Service dialog, click Patch.

   An hourglass is superimposed on the patch icon for the patch you are applying to show that patching is in progress.

   

   Note the status message shown on the Administration tile. The software will be updated to the version number shown.

   

1. Return to the Deployments table on the Administration Console.

   

2. On the Domains table, look for the status of your application.

   

   The application is still active while patching is in progress.

3. Leave the Administration Console open.

4. Open your browser and verify that your application is running.

   

1. Return to the Oracle Java Cloud Service Instance page.

2. Click the Backup tab.The Backup page is displayed.

   

   A message shows that the backup is for applying a patch.

   

   If you need to restore the original state of the service instance, you can perform a restoration from the Backup page.

1. Click the Patching tab to return to the Patching page.

   When the patching operation completes, information about the patch is displayed in the Patch History section.

   

   A Roll Back button is displayed adjacent to the patch.

   

After applying a patch, verify that the application you deployed is still running.

To verify that your application is running:

1. Return to the Administration Console.

2. Find your application on the deployments table and check that the status is Active.

   

3. Leave the Administration Console open.

4. Go back to your browser window and check that the application is still running.

   

To roll back a patch, perform the following steps:

1. Return to the Patching page.

   

2. In the Patch History section, click the Roll Back button adjacent the patch you want to roll back.

   

3. The Roll Back Service dialog is displayed. Click Roll Back.

   

A Rolling Back... message appears on the Rollback button.



Note the status message on the Administration tile. The version number is shown.



The service instance returns to the previous patch state.

When the operation is complete, the Roll Back button in the Patch History section becomes inactive, preventing you from trying to rollback the patch again.



The patch returns to the Available Patches section.

_

The Administration tile shows that the original patches are available. It also shows the last backup, which occurred during the patching operation.



Rolling back a patch has returned the service instance to its previous patch state.

Rollback does not undeploy your application, and in most cases the application remains running. If your application depends upon new features applied by the patch, the application remains deployed, but will not start.

To verify that your application is running:

1. Return to the Administration Console.

2. Find your application on the deployments table and check that the status is Active.

   

3. Return to your browser window and check that the application is still running.

   

• About Patching Oracle Java Cloud Service in the Oracle Help Center
• Oracle Java Cloud Service Tutorials in the Oracle Help Center
• Oracle Java Cloud Service Documentation in the Oracle Help Center