IBM Systems IBM ToolsCenter Bootable Media Creator Readme Version 9.66.06 Contents Chapter 1. About IBM ToolsCenter Bootable Media Creator Chapter 2. Information resources 2.1 Documentation 2.2 Web resources Chapter 3. Known limitations, problems, and workarounds 3.1 Limitations and problems 3.2 Workarounds Chapter 4. Notices Chapter 1. About IBM ToolsCenter Bootable Media Creator You can use IBM?ToolsCenter Bootable Media Creator to create bootable media that is suitable for applying firmware updates, running preboot diagnostics, and deploying Windows operating systems on supported systems. IBM System x?and BladeCenter?tools each have their own bootable CD. Using IBM ToolsCenter Bootable Media Creator, you can create a single bootable image on supported media (such as CD, DVD, ISO image, USB flash drive, or set of PXE files) that bundles multiple IBM System x and BladeCenter tools and updates from UpdateXpress System Packs, which contain Windows and Linux firmware and device driver updates. You can also create an IBM ServerGuide Setup and Installation CD for deploying Windows operating systems and updates on supported systems. Important: Devices drivers are not included on the bootable image and must be updated separately. IBM ToolsCenter Bootable Media Creator can acquire the latest bootable environment, UpdateXpress System Pack, individual updates, and IBM Preboot Dynamic System Analysis from the local system or download these tools and IBM ServerGuide from the IBM website. An Internet connection is required to download tools and updates from the IBM website. You can use an HTTP proxy when connecting to the Web. If you use an HTTP proxy, the HTTP server must support Secure Sockets Layer (SSL). You can run only one instance of IBM ToolsCenter Bootable Media Creator on a system at a time, whether it is started from the graphical or command-line interface. This includes instances of IBM ToolsCenter Bootable Media Creator that are bundled in other tools, such as UpdateXpress System Pack Installer. Beginning with IBM ToolsCenter Bootable Media Creator 9.30, Bootable Media Creator filters the update packages included in the bootable media based on the purpose of the media and the machine types you have selected. * For deployment media containing IBM ServerGuide, which is a Windows-based tool, the Windows PE update packages for the machine types you have selected are added to the media. * For diagnostic or update media, which use Linux-based tools, only the Linux update packages for your selected machine types are included. Previous versions of the tool included all available update packages, resulting in significantly larger media. Prerequisites: You must have administrator or root-equivalent operating-system privileges to use IBM ToolsCenter Bootable Media Creator. Chapter 2. Information resources You can find additional information about IBM ToolsCenter Bootable Media Creator in the product documentation and on the World Wide Web. 2.1 Documentation The following documentation resource provides additional information about IBM ToolsCenter Bootable Media Creator. Information centers and topic collections * IBM ToolsCenter for System x and BladeCenter information center http://publib.boulder.ibm.com/infocenter/toolsctr/v1r0/index.jsp The IBM ToolsCenter for System x and BladeCenter information center provides integrated information for multiple IBM Systems x and BladeCenter tools, including IBM ToolsCenter Bootable Media Creator. * IBM ToolsCenter Bootable Media Creator publib.boulder.ibm.com/infocenter/toolsctr/v1r0/topic/bomc/bomc_main.html The IBM ToolsCenter Bootable Media Creator topic collection provides information about how to download and use IBM ToolsCenter Bootable Media Creator, including creating and using bootable media to update, diagnose, and deploy IBM systems, troubleshooting and support, and a command reference. This information is updated periodically and contains the most up-to-date documentation available for IBM ToolsCenter Bootable Media Creator. Publications * Installation and User's Guide This publication provides information about how to download and use IBM ToolsCenter Bootable Media Creator, including creating and using bootable media to update, diagnose, and deploy IBM systems, troubleshooting and support, and a command reference. * Readme This publication provides downloading information, workarounds, and limitations for IBM ToolsCenter Bootable Media Creator. 2.2 Web resources These Web sites provide additional resources for the IBM System x and IBM BladeCenter products. Websites * IBM ToolsCenter for System x and BladeCenter www.ibm.com/systems/support/supportsite.wss/docdisplay?lndocid=TOOL-CENTER&brandind=5000016 View this website to download tools that support IBM System x and IBM BladeCenter products. * IBM ToolsCenter Bootable Media Creator www.ibm.com/systems/support/supportsite.wss/docdisplay?lndocid=TOOL-BOMC&brandind=5000016 View this website to download the IBM ToolsCenter Bootable Media Creator tool and documentation. * Support for IBM BladeCenter www-304.ibm.com/systems/support/supportsite.wss/brandmain?brandind=5000020 View this website to find information about online technical support, downloads and drivers, and RETAIN?tips, and to provide feedback about IBM BladeCenter products. * Support for IBM System x http://www-947.ibm.com/support/entry/portal/Overview?brandind=Hardware~Systems~System_x View this website to find information about online technical support, downloads and drivers, and RETAIN tips, and to provide feedback about IBM System x products. * IBM ServerProven? www.ibm.com/servers/eserver/serverproven/compat/us/ View this website to learn about hardware compatibility of IBM System x and IBM BladeCenter systems with IBM applications and middleware. Forums * IBM System x Forum www.ibm.com/developerworks/forums/forum.jspa?forumID=740 View this website on ibm.com?to learn about various forums that are available to discuss technology-related and product-related issues pertaining to IBM System x hardware and software products. This website includes a link for obtaining the forum using a Rich Site Summary (RSS) feed. * IBM BladeCenter Forum www.ibm.com/developerworks/forums/forum.jspa?forumID=819 View this website on ibm.com to learn about various forums that are available to discuss technology-related and product-related issues pertaining to IBM BladeCenter hardware and software products. This website includes a link for accessing the forum using a Rich Site Summary (RSS) feed. Chapter 3. Known limitations, problems, and workarounds This section describes limitations, problems, and workarounds that are applicable to IBM ToolsCenter Bootable Media Creator. 3.1 Limitations and problems The following limitations and problems are applicable to IBM ToolsCenter Bootable Media Creator. BoMC does not support ServeRAID C100. If ServeRAID C100 is enabled, BoMC can not boot. To avoid this problem, complete the following steps: 1. Enter into UEFI settings 2. Open the "Device and I/O Ports" setting 3. If the ServeRAID C100 is enabled, change the "onboard SATA ports as" into RAID or IDE. 4. If the ServeRAID C100 is not enabled, change the "onboard SATA ports as" into IDE. 5. Save settings, then the system will work normal when reboot from BoMC 6.After update by BoCM, enable C100 again. PXE boot may fail in Secure Boot Mode on an IBM System x3850 X6 If an IBM System x3850 X6 is set to be in Secure EFI boot mode, the system may fail to boot from PXE. BoMC version 9.50 and later releases only support the latest Customized Linux Kernel Beginning with BoMC 9.50, the latest customized Linux kernel uses grub as the boot loader. For BoMC 9.50 and later releases, BoMC only supports customized Linux kernel with v1.41. There is no compatible support for the previous version. If users create media from a local repository and specify the option "--toolzip" or "-t", BoMC reports the following warning message: The bootable environment is not the supported version. It may cause failure to create media. Are you sure you want to continue? (y or n) BoMC does not support Mellanox firmware updates BoMC does not support updating Mellanox firmware. Only tftp server running on Linux OS is supported when creating PXE directory with BoMC. If you are creating a PXE directory with BoMC, only a tftp server running on a supported version of Linux OS can be used. BoMC does not support /dev/sda for the --unattended option BoMC does not support the use of /dev/sda for the --unattended option for the usb protocol. OpenSSL on ESXi4.1, ESXi5.0, and ESXi5.1 can only support TLS level 1.0 OpenSSL on ESXi4.1, ESXi5.0, and ESXi5.1 can only support TLS level 1.0. If you set the IMM TLS min level to 1.1 or 1.2, TC will fail to get and set the IMM configuration through the ESXi system. BoMC does not check the arguments specified for the ¨Cvlan-id and ¨Cvlan-ip commands BoMC only calls the ¨Cvlan-id and ¨Cvlan-ip commands to do the configuration. If there is any usage error causing the configuration to fail, BoMC will not check the arguments specified with these commands. Greeting artwork does not show when booting a UEFI platform. When loading the bootable environment on a non-Unified Extensible Firmware Interface (UEFI) platform, the greeting artwork is displayed with the "Starting IBM ToolsCenter Customized Media (version)" message. When loading the bootable environment on a UEFI platform (for example., HS22, x3650 M2, x3550 M2, andiDataPlex dx360 M2), only the message is displayed. You must have access to the Internet to acquire updates and bootable environment. IBM ToolsCenter Bootable Media Creator can acquire updates and the bootable environment from IBM. Access to the Internet is required to acquire those files. You might need to disable the firewall to access the website. IBM ToolsCenter Bootable Media Creator uses port 443 for HTTPS and port 80 for HTTP. For Serial over LAN (SOL) support, the serial console argument must be specified before the tty1 console argument. When you specify a serial console argument (ttyS0 or ttyS1) and the tty1 console argument using the --kernel-args option, you must specify the serial console first, for example: --kernel-args="vga=0x317 root=/dev/ram0 ramdisk_size=100000 media_boot=yes console=ttyS1,19200 console=tty1" You cannot assign multiple static IP addresses You can assign a custom static IP address to only one NIC in a system. Options are provided to specify IP addresses sequentially beginning with the default value of 192.168.0.100 or sequentially beginning with a static IP address that you specify. See the kernel-args parameter for more information. iDataPlex dx360 M2 (machine type 7321) system might fail to boot from ToolsCenter USB key This problem can occur when a SATA drive is attached to the onboard storage controller and is configured as an IDE interface in Compatibility mode in the system BIOS. This is a current limitation. iDataPlex dx360 M2 (machine type 7321) system might fail to boot from ToolsCenter USB key the second time When using the bootable USB key created by IBM Bootable Media Creator to boot the iDataPlex dx360 M2 (machine type 7321), if you exit from the ToolsCenter program, reboot the system immediately, and attempt to boot from the same USB key again. The system might fail to boot from USB key, with the message: Boot Fail. Press Enter to Continue, and revert back to the boot device selection menu. UXSP packages may not be available for newly-released servers When you are using creating update media for newly-released IBM systems, the creation will fail if no UXSP package is available for these systems on the IBM website. In this case, select Acquire latest individual updates to acquire any available updates that have not yet been included in a UXSP. Some functions might not work properly when loading a configuration generated by a different distribution of the Bootable Media Creator Some functions of the Bootable Media Creator might not work properly when loading a configuration created using the Bootable Media Creator for Linux using Bootable Media Creator for Windows, or vice versa. Listing all available update packages for tools from the IBM website can take more than 15 minutes Additional update packages for tools may be required to perform the selected tasks such as updating, diagnostics and deployment on some IBM systems. If you specify acquiring packages for multiple machine types from the IBM website when creating bootable media, it can take more than 15 minutes to list all the available update packages. If you select more machine types and tools, it can take even longer to list the available packages. IBM eServer xSeries 336, 346 and 236 systems fail to boot from USB key This problem can occur when booting these systems from the created bootable USB key. They might fail to boot with the error message: Could not find kernel image. To fix the problem, try defragmenting the USB key using the Windows defragment tool, then try booting from the key again. If the symptoms persist, perform a full format of the USB key, then rebuild the image using the Bootable Media Creator. CD-RW bootable media fails to deploy Windows operating systems This problem can occur when deploying Windows operating systems from CD-RW bootable media. The deployment can fail with the error message: There was an error copying files. To avoid this problem, use CD-R or DVD-R(W) media. Deployment media creation fails when the path to the working directory is long When creating an IBM ServerGuide Setup and Installation CD using the Microsoft Windows Automated Installation Kit for Windows 7 (AIK 2.0) or the Microsoft OEM Pre-installation Kit 2.0, the path to the specified workingdir must be less than 76 characters. No operating systems are selectable in ServerGuide You cannot continue past the operating system selection screen in ServerGuide without selecting an operating system. This condition occurs when the ServerGuide bootable image was created for a different architecture than the one on the target system. You must use the arch parameter to specify the architecture to be supported when creating a ServerGuide image. CD Media will not eject when using USB CD-ROM on System x3850 X5/x3950 X5 (machine types 7145, 7146) This problem can occur when booting these systems from the created bootable CD media using a USB CD-ROM. The media might fail to eject automatically when exiting ToolsCenter, even when using the default configuration setting. If the problem persists, power the system off, then power the system back on and manually eject the media during the early portion of the boot process. Linux platforms require libcurl v7.15 or higher for image creation phase To perform acquisition and connection tests in an IPv6 environment on supported Linux platforms, you must ensure that the libcurl file transfer utility is version 7.15 or higher. Mixed IP address standards not supported Bootable Media Creator 9.30 supports both IPv4 and IPv6 addressing. However, for file transfers by FTP or TFTP, all of the addresses you use must be either IPv4 or IPv6. Mixing IPv4 and IPv6 addresses is not supported for this function. Some systems cannot recognize some USB keys Some IBM systems do not recognize SanDisk SDCZ36 4 and 8 Gb USB keys. If you experience difficulty using one of these keys, try a different type of USB key. No hints for memtest when creating bootable media with both DSA and UXSPI for Serial Over LAN When using bootable media that includes both DSA and UXSPI for a Serial Over LAN deployment, no hints for the user to input memtest are displayed on the Serial Over LAN console. To avoid this problem, create separate images for DSA and UXSPI. Using CTRL+C to halt execution of UXSPI in TUI mode halts further input When running UXSPI in a bootable environment in TUI mode, using CTRL+C to stop execution prevents further input. The tool returns to the Home menu, but the screen will be corrupted and further input will fail. CD creation might fail when there are more than 15 SCSI controllers in the system Creation of a CD might fail if more than 15 SCSI controllers are enabled on the burning system. This is caused by a limitation of the cdrecord utility used by Bootable Media Creator to burn the CD. To avoid this problem, disable some of the SCSI storage devices to decrease the number of SCSI controllers recognized by the cdrecord utility. 64-bit Linux requires compat-libstdc++ To run 32-bit binaries and utilities, including Bootable Media Creator, 64-bit Linux operating systems require the compatibility library compat-libstdc++. You can use the following command to determine whether this library is installed: rpm -qa | grep compat-libstdc++-296 Updating pDSA in a bootable environment requires >1GB of memory Updating pDSA in a bootable environment using USXPI might fail if the target system does not have more than 1GB of memory. To avoid this problem, the target system should have at least 2GB of memory. PXE boot may fail if the network connection is slow A slow or busy network connection can cause PXE boot to fail. If your PXE boot fails due to a slow network connection, retry the process. System x3755 with iBMC cannot boot from USB The System x3755 with iBMC cannot boot from a BoMC-created USB image. To work around this issue, use a different method to deliver the BoMC boot image. 3.2 Workarounds The following workarounds are applicable to IBM ToolsCenter Bootable Media Creator. BoMC fails to connect with the SOL console on Angelshark Root Cause: COM2 on Angelshark does not support the hardware flow control, which causes the SOL function to fail. Workaround: Use AMM directly not SOL. Action Plan: Based on the IMM2 team's feedback, support for hardware flow control for COM2 is planned for Angelshark in 3Q/LFC. The keyboard does not work when confirming to exit ToolsCenter program. After booting a system with bootable media created using IBM ToolsCenter Bootable Media Creator, when you select to exit the ToolsCenter program, you will be prompted to confirm the exit action. The keyboard cannot be used to confirm the exit action; however, you can use the mouse. Workaround: Use the mouse to confirm the exit action, or create the media to run in TUI mode. cygwin1.dll conflict IBM ToolsCenter Bootable Media Creator ships the cygwin1.dll (version 1.5.24, renamed to cygwinz.dll), which is required by the mkisofs.exe and cdrecord.exe utilities. The cygwin DLL does not support multiple versions running a the same time. You must exit all other applications that depend on cygwin1.dll before running IBM ToolsCenter Bootable Media Creator on a Windows System. IBM ToolsCenter Bootable Media Creator might fail to burn CD or DVD if it runs on RHEL3 with an IDE CD-ROM or IDE DVD-ROM Add hdx=ide-scsi to the boot loader configuration file (for example, /etc/lilo.conf for LILO or /boot/grub /menu.lst for GRUB), where hdx is either hda, hdb, hdc or hdd, depending on where your CD or DVD drive is located. USB flash drives that are used by Linux are not recognized by Windows To enable Windows to recognize the USB flash drive so that it can be used by IBM ToolsCenter Bootable Media Creator on a Windows system, format the USB flash drive on a Linux system to FAT32 file format using the the mkdosfs utility (for example, mkdosfs -I -F 32 /dev/sdb). Failure when burning created ISO files to CD/DVD, or created CD/DVD fails to boot If you are unable to burn created ISO files to CD/DVD media, or if the CD/DVD you have created fails to boot, please try using alternative media writing software, or using a different brand and type of media. BladeCenter HS22 fails to boot from SanDisk 4GB bootable USB key When using the SanDisk 4GB bootable USB key created by IBM Bootable Media Creator to boot HS22 (machine type 7870), the system might boot directly into the OS environment installed in the Hard Disk Drive but not boot into the USB key. Workaround: Update the uEFI firmware or use a Lexar USB key or a bootable CD. Emulex 10GB CNA firmware updates are not supported from Updates bootable media Emulex 10GB CNA firmware updates such as elx_fw_nic_cna-f2.101.411.2_linux_32-64 are not supported from Updates bootable media created by Bootable Media Creator. Workaround: Install these updates offline using the bootable iso file from: http://www.ibm.com/systems/support/supportsite.wss/docdisplay?lndocid=MIGR-5083288&brandind=5000008. USB key automatically mounts in noexec mode on SLES 10 sp4 As a security measure, USB keys can be mounted in noexec mode, which prevents executable files on the key from running. This will prevent you from using the BoMC binary, even after using chmod to change permissions. Workaround: Copy the binary to the hard drive of the system, use chmod to give it proper permissions, and execute from the hard drive. Chapter 4. Notices Use this information to understand the legal notices for this documentation. This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation MW9A/050 5600 Cottle Road San Jose, CA 95193 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy, the photographs and color illustrations may not appear. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml. Adobe and the Adobe logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. Intel is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.