Skip Headers
Oracle® Enterprise Manager Cloud Control Administrator's Guide
12c Release 1 (12.1.0.1)

Part Number E24473-15
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

14 Updating Cloud Control

The Self Update feature allows you to expand Enterprise Manager's capabilities by updating Enterprise Manager components whenever new or updated features become available. Updated plug-ins are made available via the Enterprise Manager Store, an external site that is periodically checked by Enterprise Manager Cloud Control to obtain information about updates ready for download.

This chapter contains the following sections:

Using Self Update

The Self Update feature is accessed via the Self Update home page, a common dashboard used to obtain information about new updates and a common workflow to review, download and apply the updates. The Self Update console frees you from having to monitor multiple channels to get informed about new updates that are available from Oracle. The Self Update console automatically informs you whenever new updates are made available by Oracle. Only those updates that are applicable to your site are shown, eliminating the need to wade through unrelated updates.

What Can Be Updated?

Specific updates authored by Oracle that are usually bundled with specific Cloud Control releases can be updated via Self Update. Some examples are Oracle authored Management Plug-ins or Deployment Procedures. In general, Oracle-supplied entities are read-only. You can create a copy and customize the copy as per your needs but you cannot modify the original Oracle-supplied entity.

These entities can also be published on Oracle Web sites such as Oracle Technology Network (OTN) and My Oracle Support (MOS). You can download and import the entity archive into their Cloud Control deployment using specific import features provided by the updatable entity.

Entity Types That Can Be Updated

Examples of updatable entity types are:

  • Management Agents

  • Management Plug-ins

  • Management Connectors

  • Database Profiles and Gold Images

  • Application Server Profiles and Gold Images

  • Provisioning Bundles

  • Enterprise Manager Deployment Prerequisite Checks

  • Compliance Content

  • Diagnostic Checks

Setting Up Self Update

Before you can use the Self Update feature, you must satisfy these prerequisites:

Review the following sections for instructions on setting up Self Update:

Setting Up Enterprise Manager Self Update Mode

In order to set up or modify the Enterprise Manager Self Update feature, you must have Enterprise Manager Super Administrator privileges.

  1. Log in to Enterprise Manager as an administrator with Super Administrator privileges.

  2. From the Setup menu, select Extensibility, then select Self Update. The Self Update console appears with the default setup displayed.

  3. From the General status area, click the Connection Mode status to set either offline or online mode. Enterprise Manager takes you to the Patching Setup page to specify online and offline settings.

  4. Once the desired connection mode has been selected, return to the Self Update console.

    From here you can select entity types and schedule updates from the Enterprise Manager Update Store.

Assigning Self Update Privileges to Users

Enterprise Manager administrators must have the requisite privileges to use the Self Update feature. The Enterprise Manager Super Administrator must assign the following Self Update roles to these administrators:

  • VIEW_SELF_UPDATE–User can view the Self Update console and can monitor the status of download and apply jobs.

  • MANAGE_SELF_UPDATE–User can schedule download and apply jobs. User can also suppress/unsuppress updates. This privilege implicitly contains VIEW_SELF_UPDATE.

  • EM_INFRASTRUCTURE_ADMIN–User can perform all self update operations.

To assign Self Update privileges to regular Enterprise Manager administrators:

  1. From the Setup menu, select Security, then select Administrators.

  2. Select an administrator and click Edit.

  3. From the Roles page, assign the appropriate Self Update roles.

Setting Up the Software Library

The Software Library is a repository that stores software patches, virtual appliance images, reference gold images, application software and their associated directive scripts. It allows maintaining versions, maturity levels, and states of entities.

In the context of applying updates, it is the "local store" that entities are downloaded to before deployment.

Follow these steps to set up the Software Library:

  1. Create a folder in the system where Enterprise Manger is installed. For example, /net/hostname/sample/swlib1.

  2. From the Enterprise menu, select Provisioning and Patching, then select Software Library.

  3. Click Actions, then Administration.

  4. Click Add.

  5. In the pop-up window, enter a name and location for the folder you want to use as the Software Library. For example, swlib1 and /net/hostname/sample/swlib1. This should be the folder that you created in Step 1.

  6. Wait for the processing to complete.

Setting Up the EM CLI Utility (Optional)

If you plan to apply software updates in offline mode, you will need to use the Enterprise Manager Command Line Utility, or EM CLI, to import entity archives for deployment to Enterprise Manager.

A page is provided in the Cloud Control console with instructions on setting up EM CLI. Access the page by appending /console/emcli/download to the URL used to access the Cloud Control console:

https://emcc_host:emcc_port/em

For example:

https://emcc_host:emcc_port/em/console/emcli/download

Applying an Update

The process for applying updates is essentially as follows:

Review the following sections to learn how to apply an update:

Applying an Update in Online Mode

Updates must be downloaded to the Software Library (the local store) before they can be applied. You can review the latest available updates from the Self Update console.

Note that Enterprise Manager must have access to the Enterprise Manager Store via the Internet to download available updates. If this access is not possible, you can download entities in offline mode. See Applying an Update in Offline Mode for details.

  1. From the Setup menu, select Extensibility, then select Self Update.

  2. Click Check Updates to submit a job to check for new updates from Oracle. Click OK to close the confirmation message.

  3. When the job completes, select the desired entity type, then select Open from the Actions menu. The entity type page appears.

  4. Select an update from the list of available updates.

  5. Click Download. The Schedule Download dialog appears.

  6. Select when to download the update. Note that multiple downloads can be scheduled simultaneously.

    The following options are available:

    • Immediately

    • Later (specified time)

    • Whether or not to send a notification when the download is complete

  7. Click Select. An Enterprise Manager job is created to download the update to the Software Library.

    Enterprise Manager starts downloading the archive from the Oracle Enterprise Manager store. Wait for the download to complete. (When in offline mode the system starts reading from the specified location.)

    When the download is complete, Enterprise Manager displays the Confirmation page.

    Note:

    The page is not refreshed automatically. Click the refresh icon to view the updated download status.
  8. Once an entity has been downloaded to the Software Library, it is ready to be applied to your installation. Select an update from the list whose status is Downloaded, then click Apply.

    Note that the application process varies according to the entity type:

    • For connectors, diagnostic checks, and compliance content, clicking Apply will install the update to Enterprise Manager. No further action is required.

    • For plug-ins, you will be redirected to the plug-in deployment page.

    • For provisioning bundles, you will need to exit the Enterprise Manager console, run Opatch and other commands via a terminal, and then restart the OMS.

Applying an Update in Offline Mode

Under certain circumstances, such as in high security environments, an active Internet connection between Enterprise Manager and the Enterprise Manager Update Store may not be available. In such situations, the Self Update feature can be used in offline mode.

The update process still requires that a computer exist at your site that has Internet access, as a connection to the Enterprise Manager Update Store is still required to obtain the updates. Update files from this computer can then be transferred to a computer behind your firewall.

The generic offline mode update procedure is as follows:

  1. Ensure that Cloud Control is set to offline mode. From the Setup menu, select Provisioning and Patching, then select Offline Patching.

  2. Change the setting for Connection to Offline.

  3. Click Check Updates on the Self Update home page. A message is displayed that contains the URL to be accessed to download a catalog of all updates.

  4. From an Internet-enabled computer, download the catalog file using the aforementioned URL.

  5. Copy the downloaded file to the Oracle Management Service host or the Management Agent host you will deploy the update to.

  6. Run the emcli import_update_catalog command to import the file into the Oracle Management Service instance or the Management Agent you want to update.

  7. Review the update from Self Update Home and click Download in the Actions menu. A message displays with a URL and instructions.

  8. Click Apply in the Actions menu to apply the update.

Accessing Informational Updates

The Self Update feature also serves as a news feed, providing new product announcements, news stories, industry updates, and any number of other items of interest to the Oracle community. These informational updates occur on an ad hoc basis and typically include useful links where you can obtain additional information and download items.

  1. From the Setup menu, select Extensibility, then select Self Update.

  2. On the Self Update page, click the Informational Updates link at the top-right corner, as shown in Figure 14-1. The link includes the number of new updates. A number appears only if there are new (unread) updates.

    Figure 14-1 Informational Updates Link on the Self Update Home Page

    Informational updates link highlighted on Self Update page

    The Informational Updates dialog opens.

  3. Select an update notification in the table and click Details.

    A popup appears describing the new product and listing applicable links.

    Figure 14-2 shows the informational update announcing availability of Enterprise Manager Cloud Control Mobile, a new iPhone app that enables you to connect to Enterprise Manager remotely. Notice in this case that the announcement includes a link to iTunes where you can go to download the app.

    Figure 14-2 Informational Update for Mobile App

    Details of mobile app availability
  4. Click OK to close the details display and return to the table of announcements.

    By default, the table displays only unread announcements. You can choose to display all or only read announcements. You can also toggle selected items between read and unread states. Note that if you mark an item as read, you are doing so for all users. A warning to this effect appears.

Acquiring or Updating Management Agent Software

Management Agent software for the various platforms (operating systems) supported by Enterprise Manager Cloud Control can be downloaded to the Software Library using the Self Update console. Once a Management Agent is persisted to the Software Library, it can be installed on host machines that you want to bring under Cloud Control management using the Add Host Targets wizard.

Steps for obtaining Management Agent software in both online and offline modes are discussed below.

Acquiring Management Agent Software in Online Mode

Using Self Update in online mode requires Enterprise Manager to have access to My Oracle Support via the Internet.

  1. From the Setup menu, select Extensibility, then select Self Update.

  2. Select the entity type Agent Software, then select Open from the Actions menu. The entity type page appears to show agent software for different platforms.

  3. Select an update from the list of available updates. All entries other than the one which matches the platform of the OMS host should show their status as Available.

  4. Click Download. The Schedule Download dialog opens.

  5. Select when to download the update. The following options are available:

    • Immediately

    • Later (specified time)

    • Whether or not to send a notification when the download is complete

  6. Click Select. An Enterprise Manager job is created to download the Agent software to the Software Library.

    Enterprise Manager starts downloading the archive from the Oracle Enterprise Manager store. Wait for the download to complete. (When in offline mode the system starts reading from the specified location.)

    When the download is complete, Enterprise Manager displays the Confirmation page.

  7. Once the download is complete, select the Management Agent, then click Apply. This step will stage the Agent software in the Software Library and make it available to the Add Host Targets wizard, which you will use to install the Agent on host machines.

  8. Click Agent Software to launch the Add Host Targets wizard.

Acquiring Management Agent Software in Offline Mode

Follow this Self Update process only when Enterprise Manager is in offline mode.

  1. Ensure Cloud Control is set to offline mode. From the Setup menu, select Provisioning and Patching, then select Offline Patching.

  2. Change the setting for Connection to Offline and click Apply.

  3. From the Setup menu, select Extensibility, then select Self Update.

  4. On the Self Update home page, click Check Updates. A message is displayed that contains the URL to be accessed to download a catalog of all updates.

    Note that the archive containing the Management Agent software should also be available from the Oracle Technology Network (OTN) site.

  5. From an Internet-enabled computer, download the catalog file using the aforementioned URL.

    Note:

    Do not unzip the file.
  6. Copy the downloaded file to either of the following:

    • To any host that has a Management Agent and EM CLI installed

    • To the Oracle Management Service (OMS) host

  7. Navigate to the 12.1 MOS home/bin directory and log in to emcli, running the command as the install user, for example:

    ./emcli login -username=sysman
    
  8. Perform emcli synchronize (mandatory).

  9. Run the emcli import_update_catalog command to import the archive into the Oracle Management Service instance or the Management Agent you want to update. For example:

    ./emcli import_update_catalog -omslocal  -file=zip file absolute path
    

    Tip:

    For a multi-OMS setup, run emcli help import_update_catalog for more options.
  10. Return to the Self Update home page and do a refresh to see a count of new updates in the Available Updates column.

  11. Select the entity type Agent Software, then select Open from the Actions menu. The entity type page appears displaying agent software for different platforms.

  12. Select an update from the list of available updates. All entries other than the one that matches the platform of the Oracle Management Service host will show their status as Available.

  13. Click Download. A message displays with a URL and instructions.

  14. From an Internet-enabled computer, download the file from the URL displayed in Step 13. Do one of the following:

    • Copy the file to a Management Agent host and follow the instructions displayed in Step 13.

    • Copy the file to Oracle Management Service host and follow the instructions displayed in Step 13.

    At this stage, the update will show up in a downloaded state in the Self Update home page.

  15. Once the download is complete, select the Management Agent, then click Apply. This step will stage the Management Agent software in the Software Library and make it available to the Add Host Targets wizard, which you will use to install the Management Agent on host machines.

  16. Click Agent Software to launch the Add Host Targets wizard.