Oracle Exalogic Elastic Cloud 2.x: Update a vServer Guest OS



This tutorial shows you how to use an existing YUM repository to update a vServer's operating system libraries according to Oracle's best practices.

Time to Complete

Approximately 30 minutes


Oracle provides a base vServer template that includes an Oracle Linux 5 installation along with Exalogic-specific packages and configurations. Like any instance of Oracle Linux, vServers can register with a YUM repository in order to locate and download the latest OS package updates. This can be the public Oracle repository or a local repository in your data center.

All of Exalogic's hardware and software components, including the guest operating system image, have been engineered and tested together. Therefore, Oracle does not permit the modification or removal or certain OS libraries. These items must be configured as YUM exceptions.


Before starting this tutorial, you should have:

  • Root access to an existing vServer.
  • The configuration file for an existing YUM repository in your data center, if not using the public Oracle YUM repository. Any private YUM repository must be accessible from one of the vServer's networks (EoIB or IPoIB).

Register the vServer with ULN (Optional)

If you have a support account with the Unbreakable Linux Network (ULN), then you can register your vServer as a machine in this account.

  1. Log in to a vServer as the root user:

    ssh root@myserver1
  2. Install the Oracle Linux public key:

    rpm --import /usr/share/rhn/RPM-GPG-KEY
  3. If a proxy server is required for the vServer to access the Internet, edit the file /etc/sysconfig/rhn/up2date and configure the proxy settings.

  4. Start the registration process:

    up2date-nox --register
  5. When prompted, enter your ULN user name, password, and Customer Service Identifier (CSI).

Configure a Connection to the YUM Repository

A YUM repository configuration file identifies one or more URLs from which packages can be downloaded. The configuration file for the public Oracle YUM repository is available online. If instead you are using a private repository in your data center, you must obtain the location of its configuration file from your Linux administrator.

  1. Log in to a vServer as the root user:

    ssh root@myserver1
  2. Determine the version of Oracle Linux that is being run by the vServer:

    cat /etc/oracle-release
    Oracle Linux Server release 5.8
  3. Verify that you can access your YUM repository from the vServer:

    ping -c 1
  4. Change directories to /etc/yum.repos.d:

    cd /etc/yum.repos.d
  5. Download the Oracle Linux 5 YUM configuration file from your repository to the vServer:

  6. Edit the configuration file. Verify that these entries are enabled at a minimum:

    name=Oracle Linux $releasever Latest ($basearch)
    name=Oracle Linux $releasever Update 8 installation media copy ($basearch)
    name=Enterprise Linux $releasever Add ons ($basearch) 
    name=Latest Unbreakable Enterprise Kernel for Oracle Linux $releasever ($basearch)

Configure Excluded Packages

Certain standard and Exalogic-specific packages must be excluded from the YUM update process. These packages are updated only through the Exalogic patching mechanisms.

  1. Edit the file /etc/yum.conf.

  2. Add this line to the end of the file:

    exclude=kernel* compat-dapl* dapl* ib-bonding* ibacm* ibutils* ibsim* 
    infiniband-diags* kmod-ovmapi-uek* libibcm* libibmad* libibumad* libibverbs*
    libmlx4* libovmapi* librdmacm* libsdp* mpi-selector* mpitests_openmpi_gcc*
    mstflint* ofed* openmpi_gcc* opensm* ovm-template-config* ovmd* perftest*
    qperf* rds-tools* sdpnetstat* srptools* xenstoreprovider* initscripts* 

Update Packages

Use the YUM repository to obtain the latest package updates for the vServer's guest operating system.

  1. Install the Oracle Linux public key if you did not do this previously:

    rpm --import /usr/share/rhn/RPM-GPG-KEY
  2. Check for package updates:

    yum check-update
  3. From the output identify the candidate package updates.

  4. Update all packages:

    yum update
  5. When prompted for confirmation, enter y.

  6. Verify that the packages were successfully updated.


YUM is a simple tool that allows Linux administrators to quickly update their OS installations with the latest enhancements and bug fixes, and from either a public or local repository. YUM can be used on Exalogic vServers to update the guest Linux OS, but you must be careful to avoid updating certain packages.

In this tutorial, you learned to:

  • Create a YUM repository configuration file
  • Exclude specific packages from YUM updates
  • Check for and install updates by using YUM



  • Lead Curriculum Developer: TJ Palazzolo
  • Other Contributors: Albert Leigh, Larry Justice

To navigate this Oracle by Example tutorial, note the following:

Topic List:
Click a topic to navigate to that section.
Expand All Topics:
Click the button to show or hide the details for the sections. By default, all topics are collapsed.
Hide All Images:
Click the button to show or hide the screenshots. By default, all images are displayed.
Click the button to print the content. The content that is currently displayed or hidden is printed.

To navigate to a particular section in this tutorial, select the topic from the list.