Oracle Linux 5.8 Release Notes

                                                   Updated February 2012

   --------------------------------------------------------------------------

Introduction

   This document covers the following topics regarding Oracle Linux 5.8.

     * Changes from the upstream release
     * New packages added in this release
     * Packages added by Oracle
     * Kernel and Driver Updates

          * Red Hat Compatible Kernel
          * Red Hat Compatible Kernel with Bug Fixes by Oracle

               * Bug Fixes
               * Installation

          * Unbreakable Enterprise Kernel

               * Introduction
               * Features

     * Technology Preview Features
     * Known Issues
     * Oracle Linux Support

   For the latest updates please refer to the online version of these release
   notes available at:

   http://oss.oracle.com/el5/docs/

   NOTE: An upgrade of Oracle Linux from a beta release is not supported.
   Further, an in-place upgrade between major versions of Oracle Linux is not
   supported. Oracle does not recommend an upgrade from earlier major
   versions of Oracle Linux even though anaconda provides an option to do
   this upgrade. A fresh installation is strongly recommended rather than a
   system upgrade between major versions.

Changes from the Upstream Release

   The following RPMs are modified from the upstream release. All changes are
   trademark and look/feel related unless otherwise noted below under the
   specific RPM.

     * anaconda -- Path of the Distribution changed from RedHat to Enterprise
       on the install CDs.
     * anacron
     * autofs
     * basesystem
     * booty
     * bug-buddy
     * clustermon
     * cmirror-kmod
     * conga
     * cyrus-imapd
     * device-mapper-multipath
     * eclipse
     * efax
     * eruby
     * filesystem
     * firefox
     * firstboot
     * freeipmi
     * fuse
     * gfs-kmod
     * gnbd-kmod
     * gnome-desktop
     * gnome-session
     * gpm
     * gstreamer
     * gtk2
     * gzip
     * httpd
     * ibutils
     * infiniband-diags
     * initscripts
     * iptables
     * iptraf
     * irqbalance
     * iscsi-initiator-utils
     * java-1.6.0-openjdk
     * jpackage-utils
     * jsch
     * kdbg
     * kdeadmin
     * kdeartwork
     * kdebase
     * kdelibs
     * kernel -- Additional kernel containing additional fixes by Oracle (see
       Kernel and Driver Update section)
     * kexec-tools
     * kvm
     * libvirt
     * libwvstreams
     * libxml2
     * libxslt
     * lvm2
     * mcelog
     * mdadm
     * memtest86+
     * microcode_ctl
     * mkbootdisk
     * mkinitrd
     * net-snmp
     * nfs-utils
     * nmap
     * nss
     * numactl
     * openldap24-libs
     * openscap
     * pango
     * perl
     * perl-XML-Simple
     * piranha
     * pirut
     * procmail
     * psacct
     * python-virtinst
     * redhat-artwork
     * redhat-lsb
     * redhat-rpm-config
     * rhgb
     * rhpl
     * rhpxl
     * rpm
     * setroubleshoot
     * sgml-common
     * sgpio
     * sos
     * specspo
     * squirrelmail
     * stunnel
     * system-config-bind
     * system-config-date
     * system-config-httpd
     * system-config-kickstart
     * system-config-netboot
     * system-config-network
     * system-config-nfs
     * system-config-printer
     * system-config-samba
     * system-config-services
     * system-config-soundcard
     * system-config-users
     * tftp
     * tog-pegasus
     * tux
     * unzip
     * util-linux
     * w3m
     * wireshark -- ocfs2 related fix.
     * xorg-x11-drv-evdev
     * xorg-x11-server
     * xulrunner
     * yum
     * yum-rhn-plugin
     * udev

   The following packages have been removed

     * python-rhsm
     * subscription-manager
     * subscription-manager-migration-data
     * redhat-logos -- Replaced by oracle-logos
     * redhat-release -- Replaced by enterprise-release
     * redhat-release-notes-5Server -- Replaced by
       enterprise-release-notes-5Server
     * rhn-client-tools -- Replaced by up2date
     * rhnsd -- Replaced by up2date
     * virt-who

   The following documentation packages have been removed

     * Deployment_Guide
     * Virtualization
     * Global_File_System
     * Cluster_Administration

New Packages added in this release

   The following packages were added upstream for this release (5.8) which
   were not in the previous update release (5.7)

     * binutils220
     * buildsys-macros
     * cmake
     * ding-libs
     * iotop
     * libcxgb4
     * man-pages-overrides
     * mysql-connector-odbc64
     * openldap24-libs
     * openscap
     * perl-NetAddr-IP
     * postgresql-odbc64
     * python-ctypes
     * python-ethtool
     * python-simplejson
     * python-suds
     * tcsh617
     * unixODBC64
     * virt-what

Packages added by Oracle

   The following packages have been added to the release

     * oraclelinux-release
     * enterprise-release
     * enterprise-release-notes
     * irqbalance
     * kernel-uek
     * lantencytop
     * ocfs2 (1.4)
     * ocfs2-tools
     * oracle-linux
     * oracle-logos
     * oracleasm
     * oracleasm-support
     * oracle-validated
     * up2date

Kernel and Driver Updates

   Oracle Linux 5.8 ships with the following kernel packages

     * Unbreakable Enterprise kernel [kernel-uek-2.6.32-300.10.1.el5uek

          * Installed and booted by default

     * Red Hat compatible Kernel [kernel-2.6.18-308.el5].

          * Installed by default

     * Red Hat compatible Kernel with bug fixes added by Oracle
       [kernel-2.6.18-308.0.0.0.1.el5]

          * This kernel is available on x86 and x86-64, can only be installed
            manually (see below for details)

   Note:Oracle Linux 5.8 includes both a 32 bit and a 64 bit Unbreakable
   Enterprise Kernel. Both Unbreakable Enterprise kernel and Red Hat
   compatible kernel are installed and the system boots with Unbreakable
   Enterprise kernel by default. If needed /etc/grub.conf can be modifed to
   make the system boot with Red Hat compatible kernel by default.

  Red Hat Compatible Kernel

   This section covers significant changes in the Red Hat compatible kernel
   in this release.

    Driver Updates from the upstream distribution provider

   Storage

     * The megaraid driver to version 5.40, which provides a fix for FastPath
       I/O to work with degraded RAID 1.
     * The qla2xxx 4G and 8G driver firmware to version 5.06.01.
     * The qla2xxx driver to version 8.03.07.09.05.08-k, which provides
       support for ISP82xx to capture a dump (a minidump) on when failure
       occurs.
     * The qla4xxx driver to version 5.02.04.00.05.08-d0.
     * The lpfc driver to version 8.2.0.108.1p.
     * The bnx2i driver to version 2.7.0.3.
     * The bfa firmware to version 3.0.2.2.
     * The mpt2sas driver to version 09.100.00.00, which adds support for
       customer specific branding.
     * The mptsas driver to version 3.04.20rh.
     * The uIP driver to version 0.7.0.12 as a part of the updated
       iscsi-initiator-utils package.
     * The megaraid_sas driver to version 5.40-rh1.

   Network

     * The bnx2x driver firmware to version 7.0.23, which provides support
       for new Broadcom 578xx chips.
     * The bnx2x driver to version 1.70.x.
     * The bnx2i driver to version 2.7.0.3+.
     * The bnx2 driver to version 2.1.11.
     * The cnic driver to version 2.5.3+.
     * The netxen_nic driver to version 4.0.77, which adds support for VLAN
       RX HW acceleration.
     * The tg3 driver to version 3.119.
     * The ixgbe driver to upstream version 3.4.8-k.
     * The ixgbevf driver to upstream version 2.1.0-k.
     * The e1000e driver to version 1.4.4.
     * The bna driver to version 3.0.2.2, which provides support for the
       Brocade 1860 AnyIO Fabric Adapter.
     * The qlge driver to version 1.00.00.29.
     * The qlcnic driver to version 5.0.18.
     * The enic driver to version 2.1.1.24.

  Red Hat Compatible Kernel with Bug Fixes by Oracle

   This is the Red Hat compatible kernel with critical bug fixes produced by
   Oracle.

    Bug Fixes

     * Fix __put_nfs_open_context() NULL pointer panic [orabug 12687646]
     * Fix scsi hotplug and rescan race [orabug 10260172]
     * Fix filp_close() race [orabug 10335998]
     * Fix missing aio_complete() in end_io [orabug 10365195]
     * Make xenkbd.abs_pointer=1 by default [orabug 67188919]
     * Check to see if hypervisor supports memory reservation change [orabug
       7556514]
     * Enable entropy for bnx2,bnx2x,e1000e,igb,ixgb,ixgbe,ixgbevf [orabug
       10315433]
     * Add xen pv netconsole support [orabug 6993043] [bz 7258]
     * shrink_zone patch [orabug 6086839]
     * Fix aacraid not to reset during kexec [orabug 8516042]
     * Patch rds to 1.4.2-20 [orabug 9471572, 9344105]
     * Fix BUG_ONs to not fire when in a tasklet -RDS
     * Fix lockup of the tx queue - ipoib
     * Do not call set_page_dirty() with irqs off - RDS
     * Properly unmap when getting a remote access error - RDS
     * Fix locking in rds_send_drop_to() - RDS
     * Too many getattr and access calls after direct I/O [orabug 9348191]
     * Fix PVHVM guest with PoD crash under memory pressure [orabug 9107465]
     * Fix PV guest with FC HBA hang during shutdown [orabug 9764220]
     * Support 256GB+ memory for pv guest [orabug 9450615]
     * Fix overcommit memory to use percpu_counter [orabug 6124033]
     * Make configurable timeouts for kcs of ipmi [orabug 9752208]
     * Fix memory corruption - ipoib [orabug 9972346]
     * Patch removes limit on number of retries an aio can submit [orabug
       10044782]
     * Do not call loop_unplug for not configured loop device [orabug
       10314497]
     * Link detection does not work with 802.3ad bonding [orabug 12377284]

    Installation

   The Red Hat Compatible Kernel with Bug Fixes by Oracle must be manually
   installed. To install this kernel, follow these steps:

    1. Mount Oracle Linux 5.8 DVD
    2. Copy the rpms from mount_point/Server/oracle_updated to your system
    3. Install required kernel using the rpm command, e.g.
       # rpm -ihv kernel-2.6.18-308.0.0.0.1.el5.x86_64.rpm

Unbreakable Enterprise Kernel

  Introduction

   The Unbreakable Enterprise Kernel is based on the upstream kernel
   2.6.32-41 stable source tree with additional performance improvements,
   including:

     * improved IRQ balancing
     * reduced lock contention across the kernel
     * improved network I/O via receive packet steering and RDS improvements
     * improved virtual memory performance

  Driver Updates since Oracle Linux 5 Update 7

    Network Drivers updates

     * Updated igb to version 3.0.6-k
     * Updated be2net to version 4.0.160r
     * Updated bna to version 3.0.2.2
     * Updated bnx2 to version 2.1.11
     * Updated bnx2x to version 1.70.00-0
     * Updated cnic to version 2.5.7
     * Updated e1000e to version 1.4.4-k
     * Updated enic to version 2.1.1.24
     * Updated igbvf to version 2.0.0-k
     * Updated ixgbe to version 3.4.24-NAPI
     * Updated ixgbevfto version 2.1.0-k
     * Updated netxen_nic to version 4.0.76
     * Updated qlcnic to version 5.0.24
     * Updated qlge to version v1.00.00.29.00.00-01
     * Updated s2io to version 2.0.26.28
     * Updated tg3 to version 3.119

    Storage Drivers updates

     * Updated arcmsr to version 1.20.00.15.el6u2 2010/08/05
     * Updated be2iscsi to version 4.1.239.0
     * Updated bfa 2.3.2.3 to version 3.0.2.2
     * Updated bnx2fc to version 1.0.8
     * Updated bnx2i to version 2.7.0.3
     * Updated iscsi_ibft to version 0.5.0
     * Updated lpfc to version 8.3.5.45.4p
     * Updated megaraid_sas to version 00.00.05.40-rc1
     * Updated mpt2sas to version 09.101.00.00
     * Updated qla2xxx to version 8.03.07.08.32.1-k
     * Updated qla4xxx to version 5.02.14.00.32.01-c0
     * Updated scsi_debug to version 1.82

    Other

     * Updated hpwdt to version 1.3.0
     * Updated mptbase to version 3.04.19
     * Updated mptctl to version 3.04.19
     * Updated mptfc to version 3.04.19
     * Updated mptlan to version 3.04.19
     * Updated mptsas to version 3.04.19
     * Updated mptscsih to version 3.04.19
     * Updated mptspi to version 3.04.19

  Features

     * OpenFabrics Enterprise Distribution (OFED) 1.5.1

         OFED implements Remote Direct Memory Access (RDMA) and kernel bypass
         mechanisms to deliver high-efficiency computing, wire-speed
         messaging, ultra-low microsecond latencies and fast I/O for servers,
         block storage and file systems.

     * OCFS2 1.6

         The Unbreakable Enterprise Kernel includes the OCFS2 1.6 kernel
         module. New features include:

            * JBD2 support
            * Extended attributes
            * POSIX ACLs
            * Security attributes
            * Metadata checksums
            * Indexed directories
            * REFLINKs

         For more details, see the OCFS2 1.6 User's Guide

     * DIF/DIX support

         The Linux data integrity framework (DIF) enables applications or
         kernel subsystems to attach metadata to I/O operations, allowing
         devices that support DIF to verify the integrity before passing them
         further down the stack and physically committing them to disk. Data
         Integrity Extensions or DIX is a hardware feature that enables
         exchange of protection metadata between host operating system and
         HBA.

     * Tickless kernel

         The Unbreakable Enterprise Kernel is tickless. In the tickless
         kernel, timer interrupts are performed on demand rather than at a
         predetermined frequency. This allows CPUs to stay in a low power
         state when the system is idle, reducing overall power consumption

     * Task Control Groups (TCG)

         TCG can track and group processes into user-defined cgroups so that
         the operating system can treat them as whole and perform scheduling,
         accounting, and resourceallocation accordingly. For example, using
         TCG, you can associate a set of CPU cores and memory nodes to a
         group of processes that makeup an application or a group of
         applications. This enables subsetting larger systems, more fine
         grained control over CPU and memory, and isolation of applications.

     * Performance Counters for Linux (PCL)

         The performance counter subsystem keeps track of hardware and
         software events without affecting performance and enables you to do
         tracing and performance analysis. Included is a tool called perf for
         analysis.

     * SSD Detection

         The kernel block layer will detect devices that claim to be
         fast,solid state storage and tune itself accordingly. The result of
         this detection can be found in:

     /sys/block/xxx/queue/rotational

         Where xxx is the block device. Echoing a 0 or a 1 into this file
         will force the value to off or on. When assuming a device is an SSD,
         the block layer will try harder to immediately dispatch the IO to
         the device.

     * IO affinity

         IO affinity ensures processing of a completed IO is handled by the
         same CPU that initiated the IO. It can have a fairly large impact on
         performance, especially on large NUMA machines. IO affinity is
         turned on by default, but it can be controlled via the tunable in
         /sys/block/xxx/queue/rq_affinity. For example, the following will
         turn IO affinity on:

 echo 1> /sys/block/sda/queue/rq_affinity

     * Receive packet steering (RPS)

         RPS distributes the load of received packet processing across
         multiple CPUs. This solution allows protocol processing (e.g. IP and
         TCP) to be performed on packets in parallel. This removes a
         bottleneck when a single core is saturated processing network
         interrupts. To enable receive packet steering for the interface xxx,
         place a CPU mask into

     /sys/class/net/xxx/queues/rx-0/rps_cpus

         The cpu mask takes the same form as the masks for the taskset
         command. For example:

     echo 0x55>  /sys/class/net/eth0/queues/rx-0/rps_cpus

     * fallocate()

         fallocate() is a new system call which will allow applications to
         preallocate space to any file(s) in a file system. Applications can
         get a guarantee of space for particular file(s) - even if later the
         system becomes full. Using this method of allocation can
         dramatically speed up the creation of large files such as those used
         for virtual machine images.

Technology Preview Features

   The following Technology Preview features are currently not supported
   under Oracle Linux 5 and may not be functionally complete.

     * Brocade BFA Fibre-Channel/FCoE driver
     * FreeIPMI
     * TrouSerS and tpm-tools
     * eCryptfs
     * Stateless Linux
     * AIGLX
     * FireWire
     * SGPIO Support for dmraid
     * iSER Support
     * glibc new MALLOC behaviour

   These features are not suitable for production use. However, these
   features are included to provide the feature with wider exposure.

Known Issues

    1. No networking after upgrading an Oracle Linux 5 HVM guest on Oracle VM
       2.2.2

         Upgrading an existing Oracle Linux 5 Update 6 or Update 7 guest
         which is running in HVM mode on Oracle VM 2.2.2 may result in the
         network interface(s) being disabled after the reboot post-upgrade.
         To resolve this issue, ensure that the network interfaces are set to
         "paravirtual" in Oracle VM Manager.

         Alternatively, to maintain the emulated devices inside the guest,
         add xen_emul_unplug=never to the kernel boot line in
         /boot/grub/grub.conf and reboot the guest.

    2. No networking after upgrading an Oracle Linux 5 HVM with PV Drivers
       guest on Oracle VM 2.2.2 or 3.0

         Upgrading an existing Oracle Linux 5 Update 6 or Update 7 guest
         which is running in HVM with PV Drivers mode on Oracle VM 2.2.2 or 3.0 may
         result in the network interface(s) being disabled after the reboot
         post-upgrade. To resolve this issue, rename the
         /etc/sysconfig/network-scripts/ifcfg-eth0.bak file to
         /etc/sysconfig/network-scripts/ifcfg-eth0 and reboot the guest.

    3. Warnings appear in dmesg on first boot

         After an initial install of Oracle Linux 5.8, the following warning
         may appear one or more times in the output of dmesg:

 warning: process `firstboot' used the deprecated sysctl system call with 1.23.

         This warning can be safely ignored.

    4. New multipath settings requires changes to /etc/multipath.conf

         Oracle Linux 5.8 includes a new version of device-mapper-multipath.
         This new version requires manual changes to the /etc/multipath.conf
         file. In the multipath.conf, the line with prio_callout needs to be
         replaced by the keyword prio, and a simple string, not an executable
         pathname, used for the parameter to prio. Valid settings for prio
         are:

            * alua
            * ontap
            * const
            * random
            * emc
            * rdac
            * hds
            * tpg_pref
            * hp_sw
            * weighted

    5. Multipath failure causes flush of all multipath devices

         In some multipath failure cases, the multipath maps can get flushed
         when all paths fail, and multipath -l displays no information on the
         status of your multipath devices. This has been reported with 2.6.32
         UEK kernels using NetApp LUNs, but not when running 2.6.18 series
         kernels with the same storage LUNs.

    6. Error inserting cxgb3i module (13493043)

         iscsi offload via cxgb3i on a server with Chelsio T3 Network
         Controller will fail with following error if ofa kernel package is
         installed

 fatal: error inserting cxgb3i - unknown symbol t3_l2e_free

         Use following workaround steps to fix the issue:

            * Remove cxgb3i dependent module from memory if any loaded , i.e

 # rmmod libcxgbi cxgb3

            * Uninstall ofa package,

 # rpm -e ofa-2.6.32-300.10.1.el6uek-1.5.1-4.0.47.x86_64

            * Load cxgb3i module

 # modprobe cxgb3i

    7. Slow performance on 10Gb Ethernet Interfaces The default networking
       tuning parameters may be too low for some 10Gb Ethernet interface
       drivers. If you are experiencing less than expected network
       performance, change the following NIC parameters:

          * rx-usecs: 1
          * rx-frames: 0

       To:

          * rx-usecs: 10
          * rx-frames: 10

    8. dbus-daemon warning in dmesg on 32-bit systems

         On 32-bit Oracle Linux systems, you may see the following warning in
         dmesg:

 warning: `dbus-daemon' uses 32-bit capabilities (legacy support in use)

         This is only a warning and can be safely ignored.

    9. iTCO_wdt warning in dmesg

         Some server hardware may not support the Intel TCO watchdog drivers.
         The following warning may be seen in dmesg:

 iTCO_vendor_support: vendor-support=0
 iTCO_wdt: Intel TCO WatchDog Timer Driver v1.05
 iTCO_wdt: failed to reset NO_REBOOT flag, reboot disabled by hardware
 iTCO_wdt: No card detected
 intel_rng: FWH not detected

         To disable this TCO WatchDog Timer Driver and suppress this warning
         at boot time add the line "blacklist iTCO_wdt" to
         /etc/modprobe.d/blacklist-watchdog".

   10. Unbreakable Enterprise Kernel firmware must be manually installed
       prior to upgrade

         Due to a change in the way firmware is loaded between the Red Hat
         Compatible Kernel and the Oracle Unbreakable Enterprise Kernel, you
         may need to manually install the correct UEK kernel firmware package
         if you want to boot a previous kernel version after upgrading to
         Oracle Linux 5.8. For example, to install the firmware for
         kernel-uek-2.6.32-200.13.1, download the correct RPM package from
         the Unbreakable Linux Network and run the following command:

 # rpm -ivh --force kernel-uek-firmware-2.6.32-200.13.1.el5uek.noarch.rpm

   11. Memory limited for Oracle Linux 5.8 Paravirtualized Guests

         Oracle Linux 5.8 paravirtualized guests running on Oracle VM with
         the Unbreakable Enterprise Kernel have a memory limit of 220GB.
         Setting the memory beyond this value may cause the paravirtualized
         network interfaces to fail.

   12. Oracle Linux 5.8 32-bit guest in HVM with PV Drivers mode with more
       than 1 vCPU hangs on boot

         Attempting to boot a 32-bit HVM guest with PV Drives with more than
         1 virtual CPU may fail. To resolve this issue, boot the guest with a
         single virtual CPU and append tsc=reliable parameter to the kernel
         boot line in */boot/grub/grub/conf*. You can then boot the guest
         with multiple virtual CPUs.

   13. kexec/kdump may not work on some server platforms

         Certain server platforms may not support the default kdump
         parameters. To test this, enable kdump and issue:

 echo c > /proc/sysrq-trigger

         If your server hangs indefinitely, you may need to disable the
         "reset_devices" parameter for kdump. To do this, edit
         /etc/sysconfig/kdump and remove the "reset_devices" parameter from
         the KDUMP_COMMANDLINE_APPEND variable.

   14. Using yum to upgrade previous update from Unbreakable Linux Network
       (ULN)

         yum package need to be updated before upgrading previous update
         releases of Oracle Linux 5 to Oracle Linux 5 Update 8 using yum from
         ULN. Please use the following steps to upgrade:

    # yum update yum
    # yum update

   15. Default kernel after upgrade

         In certain upgrade scenarios the Unbreakable Enterprise Kernel may
         not be the default boot kernel. Update /etc/grub.conf to make the
         latest Unbreakable Enterprise Kernel as the default boot kernel.

   16. Missing kernel module ib_iser.ko

         Starting OpenFabrics Enterprise Distribution 1.4.2-5 version (ofa
         package), ib_iser kernel module is not built as part of ofa package.
         If the ofa package installed on the system tries to load ib_iser.ko,
         the following message will be displayed on the console

  ib_iser: disagrees about version of symbol ib_fmr_pool_unmap
  ib_iser: Unknown symbol ib_fmr_pool_unmap

         These messages can be ignored as ib_iser.ko is no more needed.

   17. Upgrade failure for the full install of Oracle Linux 5

         If any of the following packages are installed on the system

 kmod-cmirror
 kmod-cmirror-xen
 kmod-gfs
 kmod-gfs-xen
 kmod-gnbd
 kmod-gnbd-xen

         Upgrade of Oracle Linux 5 system may fail with the following error

 An error occured while installing packages.
 Please examine /root/install.log on your
 installed system for detailed information

         to workaround this problem, remove above packages before upgrade.
         These packages can be installed after the upgrade.

   18. Failed to stat /dev/mapper/* message during boot of paravirtualized
       guests

         Following messages during boot of paravirtualized guest can be
         ignored

   Failed to stat /dev/mapper/no
   Failed to stat /dev/mapper/block
   Failed to stat /dev/mapper/devices
   Failed to stat /dev/mapper/found

         These errors are expected as dmraid utility returns 'no block
         devices found' because an ioctl to get serial numbers on pv devices
         returns -EINVAL."

   19. Spurious udev messages during restore of a failed path (11682171)

         When failed paths are restored in a multipath configuration, you may
         see udevd-work error messages in /var/log/messages. The failed paths
         do get restored despite these messages.

   20. Default NFS v4 mount options

         The default NFS mount option has changed to NFS v4. To mount an NFS
         volume using NFS v3 (the default using the Red Hat Compatible
         Kernel), use the following mount options:

 -o vers=3,mountproto=tcp

   21. Serial console not working for a paravirtualized guest (10059184)

         Please use the following steps to configure the serial console in a
         paravirtualized guest (PV) using the Unbreakable Enterprise kernel
         (updates are in the guest):

           1. change the kernel boot parameter 'console=xvc0' to
              'console=hvc0' in the /etc/grub.conf:

     kernel /vmlinuz-2.6.32-300.10.1.el5 ro root=/dev/sd0 console=tty0 console=hvc0

           2. add an 'hvc0' entry to /etc/inittab:

     co:2345:respawn:/sbin/agetty hvc0 9600 vt100-nav

           3. add an 'hvc0' entry to /etc/securetty

         .

   22. Setting serial console in a hardware virtualized (HVM) guest

         To set the serial console a hardware virtualized (HVM) guest use the
         following settings in the guest:

            * On the kernel boot line in grub.conf, add:

          console=tty0 console=ttyS0,57600n8


            * add the following to /etc/securetty


      ttyS0


            * add the following to /etc/inittab

         co:2345:respawn:/sbin/agetty ttyS0 57600 vt100-nav


   23. Console appears to hang while booting on certain systems (10094052)

         On some hardware, the console may appear to hang during the boot
         process after starting udev. But the system does boot up properly
         and is accessible. A workaround to this problem is to add nomodeset
         as a kernel boot parameter in /etc/grub.conf:

     kernel /vmlinuz-2.6.32-300.10.1.el5uek.x86_64 ro root=/dev/sd0 nomodeset

   24. Unable to start X (10056679)

         On some hardware, startup of the X environment may fail after
         upgrading to Unbreakable Enterprise Kernel with following Error:

     Fatal server error:
     Cannot run in framebuffer mode. Please specify busIDs for all
     framebuffer devices.

         To workaround this issue reconfigure X using command "X -configure"
         and use generated configuration file to start X environment.

   25. Higher memory is required for crashkernel option

         With the Unbreakable Enterprise Kernel a higher memory setting is
         required for crashkernel option in /etc/grub.conf file. Booting with
         crashkernel=128M@16M will result in following error:

     crashkernel reservation failed - memory is in use

         Minimum value for crashkernel option is 128M@32M. Based on the
         system configuration a higher value may be required. If kdump
         service loading fails increase the second value (32M). If the system
         hangs or crashes with out of memory during dumping core increase the
         first value (128M)

   26. Default IO scheduler

         For the Unbreakable Enterprise Kernel, the default IO scheduler is
         the 'deadline' scheduler.
         For the Red Hat Compatible Kernel, the default IO scheduler is the
         'cfq' scheduler.

   27. sched_yield() settings for CFS

         For the Unbreakable Enterprise Kernel, kernel.sched_compat_yield=1
         by default.
         For the Red Hat Compatible Kernel, kernel.sched_compat_yield=0 by
         default.

   28. High IO loads on NFS using mmap may fail (11071875)

         In some instances, large IO loads on NFS that use mmap may fail and
         cause the kernel to panic with a message like:

     kernel BUG at mm/truncate.c:469!

   29. NFS: Error message displayed while mounting an NFS filesystem
       (10070721)

         The following error may be encountered while mounting an NFS
         filesystem:

     "SVC: FAILED TO REGISTER LOCKDV1 RPC SERVICE (ERRNO 97)."

         This is an informative message and can be ignored

   30. Warning message when kdump starts

         When kdump starts, you may see the following warning message:

     WARNING: No modules scsi_mod found for kernel 2.6.32-300.10.1.el5uek.x86_64, continuing anyway

         This warning can be ignored. The kdump service does get started and
         a vmcore does get generated.

   31. Unable to remove direcory during boot

         The following message during boot can be ignored as selinux does not
         allow to recreate login subdir and hence directory should not be
         removed for dovecot:

 Error :
   "rm: cannot remove `/var/run/dovecot/login': Is a directory "

   32. Warning during kernel install

         The following warnings during kernel install can be ignored:

 WARNING: No module ehci-hcd found for kernel 2.6.32-300.10.1.el5uek, continuing anyway
 WARNING: No module ohci-hcd found for kernel 2.6.32-300.10.1.el5uek, continuing anyway
 WARNING: No module uhci-hcd found for kernel 2.6.32-300.10.1.el5uek, continuing anyway

   33. Upgrade ocfs2 and oracleasm kernel modules

         ocfs2 and oracleasm kernel modules will not be automatically updated
         during upgrade of Oracle Linux 5 as package name for these modules
         contains kernel version in it. These packages need to be updated
         manulaly after the upgrade.

   34. device-mapper-multipath package for Red Hat compatible kernel

         Unbreakable Enterprise Kernel requires kpartx and
         device-mapper-multipath RPMs that are newer than those provided for
         the Red Hat compatible kernel. By default
         device-mapper-multipath-0.4.9-23.0.9.el5 and kpartx-0.4.9-23.0.9.el5
         are installed. These updated versions of kpartx and
         device-mapper-multipath are supported with the Red Hat compatible
         kernel. The original RPMs for the Red Hat compatible kernel
         (kpartx-0.4.7-46.el5 and device-mapper-multipath-0.4.7-46.el5) are
         also included on the Oracle Linux 5.8 ISO in directory
         Server/oracle_updated.

   35. Workaround to use pirut and system-config-packages to manage packages

         Pirut and system-config-packages cannot be used to manage, install,
         and uninstall software packages. Follow the steps below to resolve
         the issue

            * Mount the DVD iso of the desired update of Oracle Linux Release
              5.

 Command for mounting the DVD media inserted in /dev/cdrom
 # mount -r -o loop -t  iso9660 /dev/cdrom /mnt

 Command to mount iso image file
 # mount -o loop   /mnt

            * Create yum repository configuration file
              /etc/yum.repos.d/dvd.repo with following contents

     [dvd]
     name=OEL5DVD
     baseurl=file:///mnt/Server
     enabled=1
     gpgcheck=1
     gpgkey=file:///mnt/RPM-GPG-KEY file:///mnt/RPM-GPG-KEY-oracle


            * Clear and update the yum cache

     # yum clean all
     # yum update


            * Run pirut/system-config-packages to manage software packages

   * Conflicting packages

       The following packages can not co-exists due to file conflict

         * freeradius and freeradius2
         * postgres and postgresql84
         * samba and samba3x
         * tcsh and tcsh617
         * bind and bind97
         * php and php53

   * Unresolved dependency during update using up2date

       If updating from Oracle Linux 5 GA or RHEL 5 GA using up2date, you may
       encounter the following error:

   Unresolvable chain of dependencies:
   xen-3.0.3-64.el5    requires xen-hypervisor-abi = 3.1

       This happens because a kernel-xen package update is needed by the xen
       package, but 'kernel*' is part of the up2date pkgSkipList. To get
       around this, add 'xen;xen-devel;' to the the pkgSkipList line in
       /etc/sysconfig/rhn/up2date and then run up2date. You can update the
       xen and kernel-xen packages together later via 'up2date --force xen
       kernel-xen'.

Oracle Linux Support

     Oracle Linux offers an option to keep your operating system up to date
     with latest operating system patches using up2date. To access Linux
     updates via Unbreakable Linux Network, you must purchase a Linux support
     subscription.For more information please visit http://linux.oracle.com

     Note: Prior to using up2date, import the RPM-GPG-KEY for Oracle Linux:

     rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY