Oracle Linux 5.9 Release Notes Updated January 2013 ------------------------------------------------------------------------ Introduction This document covers the following topics regarding Oracle Linux 5.9. * Changes from the upstream release * New packages added in this release * Packages added by Oracle * Kernel and Driver Updates o Red Hat Compatible Kernel o Red Hat Compatible Kernel with Bug Fixes by Oracle + Bug Fixes + Installation o Unbreakable Enterprise Kernel + Introduction + Notable Changes + Driver Updates + Notable Bug Fixes + Technology Previews + Compatibility + Known Issues * Technology Preview Features for Oracle Linux 5 * Known Issues for Oracle Linux 5.9 * Configuring Updates for Oracle Linux 5 Update 9 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 * audit * autofs * basesystem * booty * bug-buddy * clustermon * cmirror-kmod * conga * coreutils * crash * cyrus-imapd * device-mapper-multipath * e2fsprogs * eclipse * efax * redhat-release-5Server * eruby * evolution * filesystem * firefox * firstboot * freeipmi * fuse * gdm * gfs-kmod * gnbd-kmod * gnome-desktop * gnome-session * gpm * grub * gstreamer * gzip * httpd * hypervkvpd * initscripts * iotop * iptables * iptraf * irqbalance * iscsi-initiator-utils * java-1.6.0-openjdk * java-1.7.0-openjdk * jpackage-utils * jsch * kdbg * kdeadmin * kdeartwork * kdebase * kdelibs * kexec-tools * kudzu * kvm * libitm * libtevent * libvirt * libwvstreams * libxml2 * libxslt * lsscsi * lvm2 * mcelog * memtest86+ * microcode_ctl * mkbootdisk * mkinitrd * net-snmp * nmap * numactl * openldap24-libs * openoffice.org * pango * perl-XML-Simple * piranha * pirut * procmail * psacct * python-virtinst * qt4 * quota * redhat-artwork * redhat-lsb * redhat-rpm-config * rhgb * rhpl * rhpxl * rpm * setroubleshoot * sgml-common * sgpio * sos * squirrelmail * stunnel * sysstat * 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 * thunderbird * tog-pegasus * tux * udev * unzip * up2date * util-linux * w3m * wireshark * xorg-x11-drv-evdev * xorg-x11-server * xulrunner * yum * yum-rhn-plugin The following packages have been removed: * Cluster_Administration * Deployment_Guide * Global_File_System * Virtualization * redhat-logos ---Replaced by oracle-logos * redhat-release-notes-5Server ---Replaced by enterprise-release-notes-5Server * rhn-setup * rhn-setup-gnome * rhn-client-tools ---Replaced by up2date * rhnsd ---Replaced by up2date * rhn-check * s390utils * crash-spu-commands * libspe2 * compat-gcc-295 * iprutils * libehca * libica * librtas * openssl-ibmca * ppc64-utils * python-rhsm * subscription-manager * subscription-manager-migration-data * virt-who * yaboot 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.9) which were not in the previous update release (5.8) * ant17 * hypervkvpd * libitm * java-1.7.0-openjdk * php53-odbc64 * rsyslog5 * scl-utils Packages added by Oracle The following packages have been added to the release: * aic94xx-firmware * atmel-firmware * bfa-firmware * crash-6.0.4-2.0.3.el5 * device-mapper-multipath-0.4.9-56.0.3.el5 * enterprise-release * enterprise-release-notes-5Server * ipw2100-firmware * ipw2200-firmware * ivtv-firmware * iwl1000-firmware * iwl3945-firmware * iwl4965-firmware * iwl5000-firmware * iwl5150-firmware * iwl6000-firmware * iwl6050-firmware * kernel-uek * kexec-tools-2.0.3-3.0.4.el5 * latencytop * libertas-usb8388-firmware * netxen-firmware * ocfs2 (1.4) * ocfs2-tools * oracle-linux * oracle-logos * oracle-validated-1.0.0-31.el5 * oracle-validated-1.1.0-17.el5 * oracleasm * oracleasm-support * oraclelinux-release * ql2xxx-firmware * reflink * rt61pci-firmware * rt73usb-firmware * up2date * zd1211-firmware Kernel and Driver Updates Oracle Linux 5.9 ships with the following kernel packages * Unbreakable Enterprise kernel [kernel-uek-2.6.39-300.26.1.el5uek] o Installed and booted by default * Red Hat compatible Kernel [kernel-2.6.18-348.el5]. o Installed by default * Red Hat compatible Kernel with bug fixes added by Oracle [kernel-2.6.18-348.0.0.0.1.el5] o This kernel is available on x86 and x86-64, can only be installed manually (see below for details) Note:Oracle Linux 5.9 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 modified 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 mptfusion driver has been updated to version 3.04.20, which adds the following device ID: SAS1068_820XELP * The qla2xxx driver for Qlogic Fibre-Channel HBAs has been updated to version 8.04.00.05.05.09-k * The qla4xxx driver has been updated to version 5.02.04.05.05.09-d0 * the lpfc driver for Emulex Fibre-Channel Host Bus Adapters has been updated to version 8.2.0.128.3p * The be2iscsi driver for ServerEngines BladeEngine 2 Open iSCSI devices has been updated to version 4.2.163.0r * The bnx2i driver for Broadcom NetXtreme II iSCSI has been updated to version 2.7.2.2 * The Brocade BFA FC SCSI driver (bfa driver) driver was updated to version 3.0.23.0 * The bfa firmware was updated to version 3.0.23.0 * The mpt2sas driver was updated to version 13.101.00.00, which adds NUMA I/O support, Fast Load Support, and support for customer specific branding * The megaraid_sas driver has been updated to version 00.00.06.15-rh * The iscsiuio driver for the Broadcom NetXtreme II BCM5706/5708/5709 series PCI/PCI-X Gigabit Ethernet Network Interface card and for the Broadcom NetXtremem IIBCM57710/57711/57712/57800/57810/57840 series PCI-E 10 Gigabit Ethernet Network Interface Card has been updated to version 0.7.4.3, which includes VLAN and routing support Network * The ib_qib device driver is an updated version of Qlogic's ib_path InfiniBand Host Channel Adapter (HCA) device driver and has been added to the Red Hat Compatible Kernel * The Solarflare driver (sfc) has been updated to version 3.1 * The bnx2x firmware has been updated to version 7.2.51 to include support for the Broadcom 577xx chips * The bnx2x driver has been updated to version 1.72.51-0+ to include support for the Broadcom 578xx chips * The bnx2 driver has been updated to version 2.2.1+ * The cnic driver and firmware have been updated to add FCoE parity error recovery, statistic support and FCoE capabilities advertisement * The cxgb3 driver for the Chelsio T3 family of network devices has been updated * The cxgb4 driver for the Chelsio T4 family of network devices has been updated * The cxgb4 firmware has been updated to upstream version 1.4.23.0 * The iw_cxgb3 driver has been updated to the latest upstream version * The iw_cxgb4 driver has been updated to the latest upstream version * The cxgb4i, cxgb3i and libcxgbi driver have been updated * The netxen_nic driver has been updated to version 4.0.79 * The tg3 driver for Broadcom Tigon3 Ethernet devices has been updated to version 3.123 * The ixgbe driver for Intel 10 Gigabit PCI Express network devices has been updated to the latest upstream version * The ixgbevf driver has been updated to the latest upstream version * The igbvf driver has been updated to upstream version 2.0.1-k-1 * The igb driver for Intel Gigabit Ethernet Adapters has been updates to the latest upstream version * The e1000e driver for Intel 82563/6/7, 82571/2/3/4/7/8/9, and 82583 PCI-E family of controllers has been updated to the latest upstream version * The BNA driver and firmware have been updated to version 3.0.23.0 * The qlge driver has been updated to version 1.00.00.30 * The qlcnic driver for HP NC-Series Qlogic 10 Gigabit Server Adapters has been updated to version 5.0.29 * The be2net driver for Server Engines BladeEngine2 10Gbps network devices has been updated to version 4.2.116r * The enic driver for Cisco 10G Ethernet devices has been updated to version 2.1.1.33 Miscellaneous * The mlx4 ib and net drivers have been updated to the latest upstream version. Additionally, support for EEH error recovery has been added to the mlx4 driver. * The mlx4_en driver has been updated to version 1.5.3 * The mlx4_core driver has been updated to version 1.0-ofed1.5.4 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.9 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 Release 2 is Oracle's second major release of its heavily tested and optimized operating system kernel for Oracle Linux 5 and Oracle Linux 6. It is based on the mainline Linux 3.0 version 3.0.36. It contains a large number of improvements and new features that have been incorporated into mainline Linux since the first version of the Unbreakable Enterprise Kernel. Please see the initial Oracle Unbreakable Enterprise Kernel Release 2 Release Notes for a detailed description of these changes. The 2.6.39-300 release is a quarterly driver update release which also includes bug and security fixes. Note: the actual version number displayed by the kernel and on the RPM packages is 2.6.39. This was done to avoid potential breakage of certain low-level utilities of the Oracle Linux distribution (also known as the "plumbing") that potentially can't cope with the new 3.x version scheme. Regular Linux applications are usually not aware or affected by Linux kernel version numbers. Notable changes * The code base has been aligned with mainline Linux 3.0.36 * Support for the SGI UV 2 architecture has been added * Support for family 15H model 2 "Abu Dhabi" AMD processors has been added * NBD, the network block device driver has been updated and enabled (CONFIG_BLK_DEV_NBD=m) Driver Updates The Unbreakable Enterprise Kernel supports a wide range of hardware and devices. In close cooperation with hardware and storage vendors, several device drivers have been updated by Oracle. Storage drivers * Broadcom bnx2i 2.7.2.2 * Broadcom bnx2fc 1.0.11 * Emulex be2iscsi 4.4.58.0o * Emulex lpfc 8.3.5.82.2p * LSI mpt2sas 14.100.00.00 * Qlogic qla2xxx driver to 8.04.00.08.39.0-k * VMware PVSCSI driver to 1.0.2.0-k Network drivers * Broadcom bnx2 2.2.3 * Broadcom bnx2x 1.72.50-0 * Broadcom cnic 2.5.12 * Broadcom tg3 3.124 * Cisco enic 2.1.1.39 * Emulex be2net 4.4.31.0o * Intel e1000 8.0.35-NAPI * Intel e1000e 2.0.0.1-NAPI * Intel e100 3.5.24-k2-NAPI * Intel igb 3.4.8 * Intel igbvf 2.0.4 * Intel ixgb 1.0.135-k2-NAPI * Intel ixgbe 3.10.16 * Intel ixgbevf 2.1.0-k * Oracle hxge 1.3.4 * QLogic netxen_nic 4.0.78 * QLogic qlcnic 5.0.28.1 * Realtek 8139cp * Realtek 8139too * Realtek r8169 2.3LK-NAPI Notable bug fixes * The OCFS2 file system was updated to incorporate a large number of bug fixes * Xen: The BIOS SMP MP table search was disabled. This resolves a crashing bug that was observed on HP Proliant BL680c G5 and DL380 G6 systems * Fixed system UUID mismatch between dmidecode output and sysfs value displayed in /sys/devices/virtual/dmi/id/product_uuid * Fixed regression against UEKR1 (2.6.32): Don't warn on mlock ulimits on shm_hugetlb * MTRR: Fixed a type overflow in range_to_mtrr function, resulting in "BADgran_size" errors on systems with lots of RAM Technology Preview Following features included in the Unbreakable Enterprise Kernel Release 2 are still under development, but are already made available for testing/evaluation purposes. * Kernel module signing facility: Applies cryptographic signature checking to modules on module load, checking the signature against a ring of public keys compiled into the kernel. GPG is used to do the cryptographic work and determines the format of the signature and key data. * Transcendent memory: Transcendent Memory (tmem for short) provides a new approach for improving the utilization of physical memory in a virtualized environment by claiming underutilized memory in a system and making it available where it is most needed. From the perspective of an operating system, tmem is fast pseudo-RAM of indeterminate and varying size that is useful primarily when real RAM is in short supply. To learn more about this technology and its use cases, see the Transcendent Memory project page on oss.oracle.com: http://oss.oracle.com/projects/tmem/ Compatibility Oracle Linux maintains user-space compatibility with Red Hat Enterprise Linux, which is independent of the kernel version running underneath the operating system. Existing applications will continue to run unmodified on Unbreakable Enterprise Kernel Release 2 and no re-certifications are needed for RHEL certified applications. The Oracle Linux team works closely with 3rd party hardware and software vendors to minimize impact on interoperability during releases but in order to introduce new drivers there are instances where changes must be made. In this release, there are changes to the kernel ABI which requires 3rd party kernel modules on the system be recompiled. Before installing this update, please verify the support status of this release with your application vendor(s). Known issues * Nouveau kernel driver is not compatible with NVIDIA graphics driver: After upgrading to UEKR2, the NVIDIA driver upgrade script doesn't properly blacklist the Nouveau kernel driver. To properly blacklist the driver, append rdblacklist=nouveau nouveau.modeset=0 to the kernel boot parameters in /boot/grub/grub.conf. * ACPI: One some systems you may see ACPI-related error messages in dmesg similar to these: ACPI Error: CDW1 Namespace lookup failure, AE_NOT_FOUND ACPI Error: Method parse/execution failed ACPI Error: Field CDW3 at 96 exceeds Buffer NULL size 64 (bits)]]> These are not fatal and are caused by bugs in the BIOS. Try contacting your system vendor for a BIOS update. (Oracle BUG 13100702) * ASM: calling the oracleasm init script /etc/init.d/oracleasm with the parameter scandisks may lead to error messages about missing devices similar to the following: oracleasm-read-label: Unable to open device "/dev/xvdc1": No such file or directory However, the device actually exists. This error message can be ignored, it is triggered by a timing issue. The init script should only be used to start and stop the oracleasm service, all other options like scandisks or listdisk or createdisk are deprecated. For these and other administrative tasks, use the regular binary in /usr/sbin/oracleasm instead. (Oracle BUG 13639337) * Btrfs: Running btrfs filesystem balance converts a non-RAID/concat file system setup to RAID0 after adding a new device. (Oracle BUG 13715389) * Btrfs: Converting an existing ext2/3/4 root file system to Btrfs does not carry over the associated security contexts that are stored as part of a file's extended attributes. With SELinux enabled and set to enforcing mode, you may experience a lot of "permission denied" errors after reboot, rendering the system unbootable. To avoid this problem, make sure to enforce an automatic file system relabeling run at bootup time. You can trigger this by creating an empty file named autorelabel (e.g. by using touch) in the file system's root directory before rebooting the system after the initial conversion. This will instruct SELinux to recreate the security attributes for all files on the file system. In case you forgot to do this and rebooting fails, you can either temporarily disable SELinux completely by adding selinux=0 to the kernel boot parameters, or you can just disable the enforcing of the SELinux policy by adding enforcing=0. (Oracle BUG 13806043) * CPU microcode update failures on PVM/PVHVM guests: When running Oracle Linux with the Unbreakable Enterprise Kernel Release 2, you might see error messages in dmesg or /var/log/messages similar to this one: microcode: CPU0 update to revision 0x6b failed. This warning can be ignored, as the microcode for virtual CPUs as presented to the guest does not need to be updated. (Oracle BUG 12576264 and 13782843) * IO scheduler: The Unbreakable Enterprise Kernel uses the 'deadline' scheduler as the default IO scheduler. For the Red Hat Compatible Kernel, the default IO scheduler is the 'cfq' scheduler. * libfprint: The following message might appear in dmesg or /var/log/messages: WARNING! power/level is deprecated; use power/control instead. The USB subsystem in UEKR2 deprecated the "power/level" sysfs attribute in favor of the "power/control" attribute. The "libfprint" finger printing library would trigger this warning via udev rules that try to use the old attribute first. However, the setting of the appropriate power level still succeeds - the warning can be safely ignored. (Oracle BUG 13523418) * sched_yield() settings for CFS: For the Unbreakable Enterprise Kernel, kernel.sched_compat_yield=1 is set by default. For the Red Hat Compatible Kernel, kernel.sched_compat_yield=0 is used by default. * Virtualization: When booting Unbreakable Enterprise Kernel Release 2 as a 32bit PVHVM guest, the following kernel message can be safely ignored: register_vcpu_info failed: err=-38 (Oracle BUG 13713774) Technology Preview Features for Oracle Linux 5 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 for Oracle Linux 5.9 1. Red Hat compatible Kernel with Oracle bug fixes will be updated to standard Red Hat compatible kernel during ISO upgrade The Oracle Linux ISO has the patched Red Hat compatible kernel but it is not in the iso repodata, therefore if the ISO is used to upgrade, the kernel will be updated to the Red Hat compatible version of the latest release (the non-patched). This is expected behavior. 2. Red Hat compatible Kernel will be updated to standard Red Hat compatible kernel with Oracle bug fixes during ULN upgrade If a 5.8 system running the Red Hat compatible kernel registers to the 5.9 ULN channel, the kernel will be updated to the Red Hat compatible with Oracle bug fixes version of the latest release. This is expected behavior. 3. Error: "qemudStaretup:1728: Unable to create cgroup for driver: No such device or address" Use the following steps to workaround this error: mkdir /dev/cgroup mount -t cgroup none /dev/cgroup -o cpu, memory, devices 4. Differences in multipath -ll output between 5.7 UEK and Base Kernel In some multipath failure cases, the mpath maps can get flushed when all paths fail, and multipath -l displays no information on the status of the multipath devices. This has been reported with 2.6.39 UEK kernels using NetApp LUNs, but not when running 2.6.18 series kernels with the same storage LUNs. 5. Unable to mount btrfs on Oracle Linux 5, error: mount /dev/sda /mnt mount: you must specify the filesystem type To correct, add "-t btrfs" to the mount statement or add btrfs in /etc/filesystems 6. On Oracle Linux 5, the "cp" command did not support reflinks on btrfs Support for reflink was added to btrfs-prog and can be enabled using "--reflink" as an option on "cp" 7. YUM command error occurs after system is removed from ULN After removing a system from the list in ULN and running 'yum update' on the server console, the following error is displayed: AttributeError: 'module' object has no attribute 'RhnServerException' To work around this issue remove /etc/sysconfig/rhn/systemid and run 'yum update' again 8. dmsg error: "rtc_cmos: probe of rtc_cmos failed with error -16. Error: Driver 'pcspkr' is already registered, aborting...kudzu[1373] general protection ip:8056c78 sp:bfed96b0 error:0 in kudzu[8048000+26000]" This is a known issue that is seen with Oracle Linux 5 32-bit para-virtualized guests created using virt-install" 9. UDEVD to be updated to use oom_score_adj to disable OOM on 2.6.39-UEK2 This change will set com_score_adj, if available otherwise if this fails, it will fall back to the old com_adj 10. Installation completes successfully but grub.conf file is empty and system will not successfully boot. This occurs when trying to instal the bootloader to a cciss device. To correct this, edit the drive order by moving /dev/cciss/c0d0 ahead of /dev/sda 11. Missing openIB drivers (sdp/ulp) for Infiniband in UEK (R1/R2) When attempting to load the openIB service the error "Loading OpenIB kernel modules:FATAL: Module ib_sdp not found" is displayed. This is an artifact of the ib_sdp driver from OpenIB not being included in the UEK. If you are using OpenIB, you should use the Red Hat compatible kernel. 12. Service TUX failed to start on Oracle Linux systems running the UEK When attempting to start tux service (service tux start) the system reports multiple errors for "No such file or directory" and ends with "TUX not implemented in this kernel" TUX is not shipped as part of the UEK and this is expected behavior. 13. After running yum update there are multiple errors in the yumupdate.log indicating a failure to read modules kvm.ko, kvm-amd.ko, ksm.ko, kvm-intel,ko with the message "no such file or directory" The error messages are generated due to bad symbolic links in the Red Hat compatible kernel and are considered harmless. 14. HVM with PV Drivers Upgrade Issue: Cannot Update Bootloader configuration When upgrading a VM using the HVM with PV Drivers Domain type on Oracle Enterprise Linux 5.9 from previous versions using the ISO media, the option to upgrade the boot loader configuration may not be available. This is due to a difference in the way the kernel detects the disk devices that prevents it from detecting the existing configuration. There are two ways to work around the problem: - Use yum to upgrade the systems to 5.9 instead of an ISO - Choose the "create new bootloader" option After the upgrade, old kernel entries that refer to removed kernel packages may remain in the grub.conf configuration file. Make sure to boot to the 5.9 kernel and remove the invalid entries. 15. 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. 16. 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. 17. Warnings appear in dmesg on first boot After an initial install of Oracle Linux 5.9, 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. 18. New multipath settings requires changes to /etc/multipath.conf Oracle Linux 5.9 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 19. 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.39 UEK kernels using NetApp LUNs, but not when running 2.6.18 series kernels with the same storage LUNs. 20. 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 21. 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 22. 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. 23. 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". 24. 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.9. For example, to install the firmware for kernel-uek-2.6.39-300.10.1, download the correct RPM package from the Unbreakable Linux Network and run the following command: # rpm -ivh --force kernel-uek-firmware-2.6.39-300.10.1.el5uek.noarch.rpm 25. Memory limited for Oracle Linux 5.9 Paravirtualized Guests Oracle Linux 5.9 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. 26. Oracle Linux 5.9 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. 27. 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. 28. 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 29. 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. 30. 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. 31. 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 occurred 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. 32. 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." 33. 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. 34. 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 35. 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 . 36. 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 37. 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 38. 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. 39. 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) 40. 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! 41. 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 42. Unable to remove directory during boot The following message during boot can be ignored as SELinux does not allow to recreate the login subdirectory and hence directory should not be removed for dovecot: Error : "rm: cannot remove `/var/run/dovecot/login': Is a directory " 43. 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 manually after the upgrade. 44. 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-56.0.3.el5 and kpartx-0.4.9-56.0.3.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-54.el5 and device-mapper-multipath-0.4.7-54.el5) are also included on the Oracle Linux 5.9 ISO in directory Server/oracle_updated. 45. 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 46. Conflicting packages The following packages can not co-exists due to file conflict * ant and ant17 * freeradius and freeradius2 * postgres and postgresql84 * samba and samba3x * tcsh and tcsh617 * bind and bind97 * php and php53 * unixODBC and unixODBC64 * rsyslog and rsyslog5 47. 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 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'. 48. /ETC/MULTIPATH/WWIDS is missing after multipath-root install on OL5.9 When installing onto a multipath root disk, the file /etc/multipath/wwids is not automatically generated at boot time, because the root disk (which is itself on multipath) is still in read-only mode at the time multipath services start up. This will result in a warning message displayed to the console at boot time: Cannot open file [/etc/multipath/wwids] readonly: No such file or directory This message is a warning that can be ignored safely; it does not affect the runtime operation of multipathd or device-mapper-multipath. To squelch this warning message, after the system has booted, it is possible to generate the missing wwids file with this command (executed as root): multipath -l A future errata update should include a complete fix for this issue. Configuring Updates for Oracle Linux 5 Update 9 Unbreakable Linux Network Oracle Linux offers an option to keep your operating system up to date with latest operating system patches using up2date or yum. To register with ULN, use the following command: # up2date --register To access Linux updates via Unbreakable Linux Network, you must purchase a Linux support subscription. For more information please visit http://linux.oracle.com . During ULN registration the server will be automatically registered with two channels: the latest channel for the base repository as well as the latest channel for the Unbreakable Enterprise Kernel Release 2. If you have upgraded from a previous release and do not wish for the UEKR2 to be installed, you will need to manually unsubscribe the server from this channel. The Unbreakable Linux Network includes Oracle-specific software packages, for example Oracle's ASMlib userspace package and the Oracle Instant Client. To enable access to these packages, login to the Unbreakable Linux Network and subscribe to the "Oracle Software" channel. Note: Prior to using up2date, import the RPM-GPG-KEY for Oracle Linux: # rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY Public Yum Oracle now provides all errata and updates for Oracle Linux via the public yum service. This service does not require a Linux support subscription, but only includes updates to the base distribution and does not include Oracle-specific software. To enable updates via public-yum, please visit http://public-yum.oracle.com and follow the instructions on that website. By default, all new installs of Oracle Linux 5 Update 9 are automatically configured to use the public-yum update service. No modification is required to use this service. The public-yum service is automatically disabled when a server is registered with the Unbreakable Linux Network. Installation Media Note: Oracle Linux 5 Update 9 now contains two distinct repository sources on the installation media. To configure yum to use the installation media as a yum source, create the following file /etc/yum.repos.d/Media.repo with content similar to the following: [ol5_base_media] name=Oracle Linux 5 Update 9 Base Media baseurl=file:///media/Server gpgcheck=0 enabled=1 [ol5_uek_media] name=Oracle Linux 5 Update 9 UEK Media baseurl=file:///media/UEK2 gpgcheck=0 enabled=1 You may need to adjust the /baseurl/ parameter to match where you mount the ISO media on your server.