Patch-ID# 119873-01 Keywords: itu1.3 sunwos86r sd driver boot interface Synopsis: SunOS 5.9_x86: ITU for sd patch 119443-01 Date: May/26/2005 Install Requirements: None Solaris Release: 9_x86 SunOS Release: 5.9_x86 Unbundled Product: Unbundled Release: Xref: The corresponding non-ITU patch is 119443 Topic: Relevant Architectures: i386 BugId's fixed with this patch: 6249580 Changes incorporated in this version: 6249580 Patches accumulated and obsoleted by this patch: Patches which conflict with this patch: Patches required with this patch: Obsoleted by: Files included with this patch: README.119873-01 (this file) itu.sd.119443-01 (Solaris ITU Diskette image file) Problem Description: 6249580 x86 needs to support large LUNs Patch Installation Instructions: -------------------------------- See "Special Installation Instructions" below. Special Installation Instructions: ---------------------------------- This patch contains Solaris ITU Diskette image files(s), and the instructions to create Diskettes from these image file(s). Note - You must use the dd command to copy the uncompressed images to diskettes. (You can find a DOS version of the dd command at ftp.uu.net:/vendor/sun/solaris/x86/dd.exe or by selecting the local link dd.exe). For each ITU Diskette: 1. Insert a blank diskette into your machine's diskette drive. If you are using DOS, type the following to format the diskette: format A: If you are using the Solaris(TM) operating environment, type the following to format the diskette: fdformat -Ud 2. Next, if you are using DOS, type: dd filename A: If you are using the Solaris(TM) operating environment, type the following commands to see if Volume Management is running: volcheck ls -l /vol/dev/aliases/floppy0 * If you see a message similar to this: lrwxrwxrwx 1 root 34 Jan 21 17:28 /vol/dev/aliases/floppy0 -> /vol/dev/rdiskette0/unnamed_floppy type: dd if= of=/vol/dev/aliases/floppy0 bs=36k eject floppy0 is the name of the Solaris ITU Diskette image file that comes with this patch. * If you see this message: /vol/dev/aliases/floppy0 not found type: dd if= of=/dev/rdiskette bs=36k 3. Label diskette(s) made from Solaris ITU Diskette image file(s) with the file name used to create it. INSTALLING SOLARIS USING ITU DISKETTE(S) ---------------------------------------- You can use Solaris ITU diskettes in one of three ways: * OS Installation from CD-ROM with ITU Floppy Diskette on a machine with new hardware * OS Installation from Network Server with ITU Floppy Diskette on a machine with new hardware * To add new drivers to support new hardware on an already installed and booted system OS Installation from CD-ROM with ITU Floppy Diskette ---------------------------------------------------- Here are the steps to use drivers on the Solaris Driver ITU diskette to install Solaris (Intel Platform Edition) on a machine with new hardware. To install the ITU while installing the Solaris 9 OS from CD-ROM: 1. Power on your machine. 2. Insert Installation Disc 1 of your Solaris 9 OS. The first screen is the Solaris Device Configuration Assistant. 3. Press ESC to interrupt autoboot. 4. Insert the ITU floppy diskette. 5. Press to add a device driver. The Bus Enumeration screen appears. The system determines the types of bus and gathers hardware-configuration information. 6. Press ENTER to continue. Note - This key may be labeled as RETURN on your keyboard. The Install Supplemental Drivers screen appears. 7. Press to continue. The Select Solaris System Version screen appears. An entry for "Solaris 9" appears in the list. 8. Select Solaris 9 OS in the list by pressing the SPACE bar. 9. Press to continue. The system now processes the ITU. At this point, the system is compensating for the missing entry for the device driver. 10. Press to finish. The Identified Device Drivers screen appears. 11. Press to continue. The Solaris Device Configuration Assistant appears again. 12. Press to continue. The Bus Enumeration screen appears again. 13. Press ENTER to continue. The system searches for and identifies the installed devices. 14. Press to continue. The system starts to load the device drivers. The Suninstall Window appears and you now move into the regular Solaris OS installation process. Note - If you need to use the ITU floppy diskette for another OS installation, you can now remove the diskette. However, you will need the ITU floppy diskette for this same server again at Step 16, near the end of Installation Disc 1. 15. Proceed through the screens until near the end of the Installation Disc 1. Note - This process will take approximately 20 to 25 minutes. 16. In the Solaris Install Console window, the system asks if you have additional Update diskettes to install. If you removed the ITU floppy diskette (see Note in Step 14 above), insert the diskette again. 17. Press the ENTER key. At this point, the system is installing the ITU for the Solaris OS. Installation messages scroll past in the Solaris Install Console window. 18. Once the installation is completed, the system asks again if you have additional Update diskettes to install. 19. Press 'N' on the keyboard. 20. Press the ENTER key. You now continue with the next Installation Disc for installing the Solaris OS, as you would for a normal installation. OS Installation from Network Server with ITU Floppy Diskette ------------------------------------------------------------ To install the ITU while installing the Solaris 9 OS from a network server, whose OS image has not been updated: 1. Power on your machine 2. As the BIOS messages display on the screen, press to select Network Boot. Note - On a tip line, the alternate key stroke for is: , followed by SHIFT+2. The system asks you to select a type of installation. 3. Select the OS image to install. Depending on your network-server settings, this may involve a number of steps. Once you have selected the OS image, the first screen is the Solaris Device Configuration Assistant. 4. Press ESC to interrupt autoboot. 5. Insert the ITU floppy diskette. 6. Press to add a device driver. The Install Supplemental Drivers screen appears. 7. Press to continue. The Select Solaris System Version screen appears. An entry for "Solaris 9" appears in the list. 8. Select Solaris 9 OS in the list by pressing the SPACE bar. 9. Press to continue. The system now processes the ITU. At this point, the system is compensating for the missing entry for the device driver. 10. Press to finish. The Identified Device Drivers screen appears. 11. Press to finish. The Solaris Device Configuration Assistant appears again. 12. Press to continue. The system scans for devices. The Bus Enumeration screen appears. 13. Press ENTER to continue. Note - This key may be labeled as RETURN on your keyboard. The system searches for and identifies the installed devices. The Identified Device Drivers screen appears. 14. Press to continue. The Boot Solaris window appears; the default boot device is 'NET'. 15. Press to continue. The system starts to load the device drivers. The Suninstall Window appears and you now move into the regular Solaris OS installation process. Note - If you need to use the ITU floppy diskette for another OS installation, you can now remove the diskette. However, you will need the ITU floppy diskette for this same server again at Step 17, near the end of Installation Disc 1. 16. Proceed through the screens until near the end of the installation. Note - This process will take approximately 40 to 45 minutes. 17. In the Solaris Install Console window, the system asks if you have additional Update diskettes to install. If you removed the ITU floppy diskette (see Note in Step 15 above), insert the diskette again. 18. Press the ENTER key. At this point, the system is installing the ITU for the Solaris OS. Installation messages scroll past in the Solaris Install Console window. 19. Once the installation is completed, the system asks again if you have additional Update diskettes to install. 20. Press 'N' on the keyboard. 21. Press the ENTER key. 22. Reboot the server. As part of the OS installation, you were asked how you want to reboot the server once the installation is completed: auto reboot or manual reboot. - If you selected the option "Auto Reboot", the server reboots automatically. - If you selected the option "Manual Reboot", you now need to run the reboot command. In the Sun Install Console window, type: reboot. 23. After the server has rebooted, enter a root password for the server. The installation is now complete. Using the Boot Command with an ITU Diskette on a 64-bit System -------------------------------------------------------------- There are times when it is necessary to use the boot command to specify options while booting a system. On a 64-bit capable X86 system using this command may result in a 64-bit kernel being used unless you force it to load the 32-bit kernel. With 64-bit kernel loaded, the ITU will not function properly since it only contains 32-bit drivers. During installation 32-bit kernel will be loaded as the default, but the boot command could override the default kernel type. Note that on X86 system boot can be abbreviated to the letter b. Here are several example boot commands which will force loading of the 32-bit kernel. Please use them to make sure 32-bit kernel is loaded on 64-bit capable system, if an ITU driver is needed: 1) Boot in verbose mode: boot kernel/unix -v 2) Boot in single user mode: boot kernel/unix -s 3) Boot with kmdb loaded: boot kernel/unix -k 4) Boot with kmdb into single user mode: boot kernel/unix -k -s Adding an ITU diskette to an Existing Solaris System ---------------------------------------------------- Before adding new or updated drivers, the newly supported hardware devices should be installed and configured according to the instructions in the corresponding Device Reference Page, if any. See Device Reference Manual for Solaris (Intel Platform Edition). When the Solaris Intel Platform Edition software is already installed, the simplest way to add new or updated drivers is to install the Driver ITU diskettes as patches on your system. Follow these steps: 1. Become root. 2. Type the following command to see if the Volume Management software is running on the machine you are updating: # ps -ef | grep vold For more information about managing diskettes and drives, see the System Administration Guide. 3. If Volume Management is running, temporarily stop it by typing the following command at the system prompt: # /etc/init.d/volmgt stop 4. Insert the Solaris Driver ITU diskette into the diskette drive. 5. Mount the Solaris Driver ITU diskette at the /mnt mount point: # mount -F pcfs /dev/diskette /mnt Note - You must mount the Solaris Driver ITU diskette at this point in the file structure to update your system successfully. 6. Execute the install script on the diskette, using the appropriate Solaris release directory (currently sol_28 for Solaris 2.8, sol_29 for Solaris 9, sol_210 for Solaris 10, and so on). For example: # /mnt/DU/sol_29/i86pc/Tools/install.sh -i The install.sh script searches for all new or updated drivers on the diskette. When a new or updated driver is found, the following prompt is displayed: Unconditionally installing ITUs Install patch driver-name? [y] 7. If the driver is the one you want to install, at the prompt, type y for yes or press Enter. If the driver is not the one you want to install, type n for no. If you specify yes, the install.sh script installs the driver you indicated as well as bootmod and bootbin patches . 8. When you're done and the install.sh script exits, unmount the diskette: # cd / # umount /mnt 9. Remove the Solaris Driver ITU diskette from the diskette drive. 10.Reboot your machine. # touch /reconfigure # reboot 11. If you haven't already, turn off your system, add the new hardware, and turn on your system again. 12. When the autoboot sequence prompt is displayed, quickly press Escape. The autoboot sequence is interrupted. The Solaris Device Configuration Assistant screen is displayed. 13. Press F2_Continue. The message "Enumerating buses ..." is displayed. The Scanning Devices screen is then displayed. System devices are scanned. When scanning is complete, the Identified Devices screen is displayed. 14. Press F2_Continue. The message "Loading driver com.bef ..." is displayed. The Boot Solaris screen is then displayed. 15. On the Boot Solaris screen, select the device controller attached to the device that contains your install medium, in this case the main system disk. The /etc/bootrc script is displayed. 16. At the prompt, type: b -r Your machine boots. You can now use your new hardware. KNOWN PROBLEMS AND LIMITATIONS When applying this patch to a system where a disk has already been formatted and only part of the disk was available (bug 5042195) the existing Solaris label *MUST* be cleared in order for the disk to be fully utilized. If this is not done then the existing label will be used and that disk configuration from that label will continue to limit the amount of disk space that can be used for that disk. BE SURE TO BACKUP ANY DATA YOU WISH TO RETAIN BEFORE PROCEEDING FURTHER! For an unpatched system it is best to boot into single user mode with the ITU loaded. See examples above for how to do that. To clear the entire disk you can use this command (fill in the '?' spots with the values for the disk you are dealing with. If unsure, run 'format' to see what disks you have in your system and their paths: dd if=/dev/zero of=/dev/rdsk/c?t?d?p0 bs=1024k count=10 The example above will wipe out the entire fdisk table and the first 10MB of data on the disk. For a disk with multiple fdisk partitions you may wish to preserve the other fdisk partitions and only wipe out the Solaris partition. This can be done by only clearing the Solaris partition, in a fashion similar to how you can clear the fdisk information. First use fdisk, or the fdisk command within format, to determine which partition is your Solaris partition. The fdisk partitions are numbered 1 to 4, so simply count from the top down on the display of partitions to determine which one is the Solaris fdisk partition. You can then clear that partition with a command like this (in this example the Solaris partition is number 2): dd if=/dev/zero of=/dev/rdsk/c?t?d?p2 count=????? Note that you should use the number for the length of the fdisk partition for the argument to count. This will take longer than just wiping out the fdisk table as in the first example, because it writes the entire partition one block at a time, but that is needed to destroy all the backup labels so they will not be used. CAVEAT After installing Solaris using this ITU you may wish to install 117172-17. This is a Kernel Update that delivers an older version of /kernel/drv/sd and it will overwrite the version from this ITU. So first you should do a patchrm of 119443-01 (the patch delivered in this ITU). You can then install 117172-17 with patchadd, followed by 119443-01. If this is not done you can end up with the older version of /kernel/drv/sd and the full size of your hard disk(s) may not be available to you. Special Install Instructions: -------------------------------------- None. README -- Last modified date: Thursday, May 26, 2005