********************************************************************* * IBM ServeRAID Device Drivers for SCO Operating Systems * * Version 3.50C * ********************************************************************* This README file contains instructions for installing the IBM ServeRAID device driver and Background Server component for SCO OpenServer and UnixWare operating systems. The IBM ServeRAID Device Drivers for SCO Operating Systems Diskette contains the following: o Device drivers and the background server component for SCO OpenServer 5.0.0, 5.0.2, 5.0.4, and 5.0.5. o Device drivers and the background server component for SCO UnixWare 7.0.x and 7.1.x NOTE: See the README file on the "IBM ServeRAID BIOS/Firmware Update diskette" for descriptions of the current ServeRAID diskettes and for detailed information about the changes and enhancements provided with each version. For more information about IBM ServeRAID and server products, visit http://www.pc.ibm.com/support ____________________________________________________________ CONTENTS ________ 1.0 About this Diskette 2.0 Installing the Files for SCO OpenServer ... 2.10 Adding BTLD at Boot Time ... 2.20 Adding BTLD after the Initial Installation ... 2.30 Using an IDE CD-ROM Drive to Install OpenServer Files 3.0 Installing the Files for UnixWare ... 3.10 Installing the Files while Installing UnixWare ... 3.20 Installing the Files after Installing UnixWare 4.0 Starting the Background-Server Component 5.0 Trademarks and Notices _____________________________________________________________________ 1.0 About this Diskette ________________________ To use the ServeRAID Administration and Monitoring Program with SCO, you must first install the WIN32-Based version of the Administration and Monitoring Program on a Windows NT or Windows 95 client. Then, attach the Windows NT or Windows 95 client to the same network as the OpenServer or UnixWare systems that contain the ServeRAID adapters or controllers. Finally, you must install the ServeRAID OpenServer or UnixWare device driver and background-server component. The background-server component for the OpenServer and UnixWare operating systems install automatically when you install the ServeRAID OpenServer or UnixWare device drivers. ____________________________________________________________________ 2.0 Installing the Files for SCO OpenServer ____________________________________________ Before you begin the installation, review the following information: o You must install logical drives as Bus Number 0 when using the MKDEV program, regardless of the channel that the physical drives are on. o You must install nondisk devices, such as CD-ROM and tape drives, as Bus Numbers 1, 2, or 3 relative to the channel to which they are attached. External Channel 1 connector is Bus Number 1, external Channel 2 connector is Bus Number 2, and internal Channel 3 connector is Bus Number 3. To configure the default nondisk devices during the initial installation: 1. Redefine the default tape drive in the initial bootstring. For example, to install the IPSRAID BTLD and redefine the tape drive, go to the "BOOT" prompt and type: link Stp=ips(0, 1, 2, 0) The numbers in parentheses represent the Host Adapter Number, the Bus Number, the SCSI ID, and the LUN respectively. 2. When prompted for the location of the installation CD, change the Bus Number and SCSI ID, as required. 2.10 Adding BTLD at Boot Time ------------------------------ To install the ServeRAID device driver for OpenServer, Version 5.0.X: 1. At the "BOOT" prompt, type: link 2. Press ENTER; then, when asked for the name of the package to load, type: ipsraid 3. Press ENTER. 4. After the kernel loads but before it runs, "link" prompts you to insert the IBM ServeRAID Device Drivers for SCO Operating Systems Diskette. While the installation program copies the files, one or both of the following messages might appear: MESSAGES: a. "Extracting BTLD distribution for ipsraid... /etc/uadmin getdev b ips: No such device (error 19)" b. "dynamic linker: dlvr_audit: Cannot open /dev/zero for file /lib/libprot.so.1 " You can ignore Message A, no action is required. But if Message B appears, you must press ENTER when prompted to continue the installation. 5. Keep the IBM ServeRAID Device Drivers for SCO Operating Systems Diskette readily available. You will need it to configure the device driver into the link kit. For additional information about adding a BTLD at boot time, refer to "Using Boot-Time Loadable Drivers" in the SCO OpenServer Handbook. 2.20 Adding BTLD after the Initial Installation ------------------------------------------------ 1. Start the server in system maintenance mode, and log in as root. 2. Type: installpkg 3. Press ENTER; then, select the diskette drive in which you will insert your installation diskette. 4. Insert the IBM ServeRAID Device Drivers for SCO Operating Systems Diskette, when prompted. 5. When prompted for the name of the package, type: ipsraid 6. Press ENTER; then, relink the kernel (as described in "Relinking the kernel" in the SCO OpenServer Handbook) by entering the following commands: cd /etc/conf/cf.d ./link_unix 7. After the kernel rebuilds, the following message appears: "The UNIX kernel has been rebuilt. Do you want this kernel to boot by default? " To continue, enter: "y" The system backs up the old kernel by moving /UNIX to /UNIX.OLD. 8. When the system asks for the kernel environment to be rebuilt, enter: "y" The system will respond with a successful message. 9. Use shutdown to bring down the system; then, restart the system. 2.30 Using an IDE CD-ROM Drive to Install OpenServer Files ----------------------------------------------------------- This section contains instructions for installing files for OpenServer 5.0.0, OpenServer 5.0.2, and OpenServer 5.0.4 when using an IDE CD-ROM Drive. Installing the Files for OpenServer 5.0.0 To install files for OpenServer 5.0.0 using an IDE CD-ROM drive: 1. Type the following at the "BOOT" prompt: restart ahslink="ATAPI ipsraid" Srom=wd(0,0,0,0) 2. Insert the ATAPI BTLD diskette when prompted; then, press R to replace the wd driver. The fields for the ATAPI CDROM are: Srom=wd(c,d,l,b) where: c = primary (0) or secondary (1) IDE/EIDE controller d = master (0) or slave (1) device l = LUN of device (always 0 with ATAPI or wd driver) b = BUS of device (always 0 with ATAPI or wd driver) Installing the Files for OpenServer 5.0.2 and 5.0.4 To install files for OpenServer Versions 5.0.2 or 5.0.4 using an IDE CD-ROM drive: 1. Type the following at the "BOOT" prompt: restart link=ipsraid Srom=wd(0,0,0,0) NOTE: The ATAPI BTLD (which includes the wd driver) is included in OpenServer 5.0.2 and 5.0.4. The fields for the ATAPI CDROM are: Srom=wd(c,d,l,b) where: c = primary (0) or secondary (1) IDE/EIDE controller d = master (0) or slave (1) device l = LUN of device (always 0 with ATAPI or "wd" driver) b = BUS of device (always 0 with ATAPI or "wd" driver) 2. Let the system start normally until it comes to the select Media options. o If you are using OpenServer 5.0.2, go to step 3. o If you are using OpenServer 5.0.4, go to step 4. 3. To install with OpenServer 5.0.2: a. Select Adapter type as WD. b. Select Media Type as SCSI CDROM. c. Select ID, BUS and LUN as 0. d. Go to step 5. 4. To install with OpenServer 5.0.4: a. Select Media Type as IDE CDROM DRIVE. b. Select PRIMARY ADAPTER and MASTER DEVICE. c. Go to step 5. 5. You have completed the installation. ___________________________________________________________________ 3.0 Installing the Files for UnixWare ______________________________________ The instructions for installing the ServeRAID files when using UnixWare depend on the number of IDE and SCSI disk-storage adapters and controllers installed in the system. If all of the direct-access-storage devices (DASD) in the system are attached to a single disk-storage adapter or controller (such as the ServeRAID adapter or controller), you can skip the instructions in this section and go directly to "Installing the Files while Installing UnixWare" or "Installing the Files after Installing UnixWare" section. If you are attaching devices to multiple disk-storage adapters or controllers (including IDE and SCSI controllers integrated on the system board), use the following instructions. o If you are installing UnixWare on a drive attached to a ServeRAID adapter or controller, follow the instructions in "Installing UnixWare on a ServeRAID Drive". o If you are installing UnixWare on a drive attached to a non-ServeRAID adapter or controller and you intend to store only data on the drives attached to your ServeRAID adapters and controllers, follow the instructions in "Installing UnixWare on a Non-ServeRAID Drive." INSTALLING UNIXWARE ON A SERVERAID DRIVE: Use the following instructions if you are using multiple disk-storage adapters or controllers and you are installing UnixWare on a drive attached to a ServeRAID adapter or controller. NOTE: If you are not using multiple disk-storage adapters and controllers, go to "Installing the Files while Installing UnixWare" in section 3.10. 1. Install all ServeRAID adapters that you intend to use in your system. 2. Using the ServeRAID Configuration Program, create all of your arrays and define all of your logical drives. 3. Make a list of all of the ServeRAID adapters and controllers, including the order and slot number, installed in the system. To do this: a. Turn on the server. b. When the ServeRAID Mini-Configuration prompt appears, press CTRL+I. When a system contains more than one ServeRAID adapter or controller, a selection screen appears. c. The menu lists the ServeRAID adapters and controllers in order. Select the first ServeRAID adapter or controller from the menu. d. Select ADVANCED FUNCTIONS from the Main Menu. e. Select VIEW CONTROLLER AND PCI INFORMATION from the Advanced Functions menu. f. Record the slot number for the ServeRAID adapter or controller; then, press ESC three times to return to the controller selection screen. g. Select the next adapter or controller and repeat steps 3d through step 3f until you record the slot number for each ServeRAID adapter or controller that appears on the selection screen. 4. Turn off the system; then, remove all ServeRAID adapters and controllers except the first one on your list. NOTE: If one of the ServeRAID controllers that you need to remove is on the system board, you must do one of the following: o If the CD-ROM drive that you are using to install your operating system is attached to the integrated ServeRAID controller, disconnect or remove all disk drives attached to the integrated controller. o If only disk drives are attached to the integrated controller, disconnect the SCSI cable from the ServeRAID connector on the system board. See the label inside the server cover for the location of the ServeRAID connector. 5. Remove all other non-ServeRAID IDE and SCSI disk-storage adapters and controllers. NOTE: If one of the disk-storage controllers that you need to remove is on the system board, you must do one of the following: o If the CD-ROM drive that you are using to install your operating system is attached to the integrated disk-storage controller, disconnect or remove all disk drives attached to the integrated controller. o If only disk drives are attached to the integrated controller, disconnect the cable for the integrated controller from the IDE or SCSI connector on the system board. See the label inside the server cover for the location of the IDE or SCSI controller connector. 6. Follow the instructions in "Installing the Files while Installing UnixWare" in section 3.10; then, return here and continue with step 7. 7. Power down the system. 8. Install any non-ServeRAID disk-storage adapters or controllers in the server; then, attach the drives to the disk-storage adapters and controllers. 9. Install the next ServeRAID adapter or controller from the list you created in step 3f; then, attach the drives to the ServeRAID adapter or controller. 10. Turn on the system and allow UnixWare to discover the new disk-storage adapters and controllers. 11. Power down the system. 12. Repeat steps 9, 10, and 11 until all ServeRAID adapters, ServeRAID controllers, and drives are installed. 13. You can now partition and format the logical drives attached to the additional ServeRAID adapters and controllers. See the information provided with UnixWare for more instructions. INSTALLING UNIXWARE ON A NON-SERVERAID DRIVE: Use the instructions in this section if you are using multiple disk-storage adapters or controllers, you are installing UnixWare on a drive attached to a non-ServeRAID adapter or controller, and you intend to store only data on the drives attached to your ServeRAID adapters and controllers. 1. Install all ServeRAID adapters that you intend to use in your system. 2. Using the ServeRAID Configuration Program, create all of your arrays and define all of your logical drives. 3. Make a list of all of the ServeRAID adapters and controllers, including the order and slot number, installed in the system. To do this: a. Turn on the server. b. When the ServeRAID Mini-Configuration prompt appears, press CTRL+I. When a system contains more than one ServeRAID adapter or controller, a selection screen appears. c. The menu lists the ServeRAID adapters and controllers in order. Select the first ServeRAID adapter or controller from the menu. d. Select ADVANCED FUNCTIONS from the Main Menu. e. Select VIEW CONTROLLER AND PCI INFORMATION from the Advanced Functions menu. f. Record the slot number for the ServeRAID adapter or controller; then, press ESC three times to return to the controller selection screen. g. Select the next adapter or controller and repeat steps 3d through step 3f until you record the slot number for each ServeRAID adapter or controller that appears on the selection screen. 4. Turn off the system; then, remove all ServeRAID, IDE, and SCSI disk-storage adapters and controllers except the one attached to the drive where you intend to install UnixWare. NOTE: If one of the disk-storage or ServeRAID controllers that you need to remove is on the system board, do one of the following: o If the CD-ROM drive that you are using to install your operating system is attached to the integrated controller, disconnect or remove all disk drives attached to the integrated controller. o If only disk drives are attached to the integrated controller, disconnect the SCSI or IDE cable for the integrated controller from the connector on the system board. See the label inside the server cover for the location of the SCSI and IDE cable connectors. 5. Follow the instructions in "Installing the Files while Installing UnixWare" in section 3.10; then, return here and continue with step 6. 6. Power down the system. 7. Install any non-ServeRAID disk-storage adapters or controllers in the server; then, attach the drives to the disk-storage adapters and controllers. 8. Install the first ServeRAID adapter or controller from the list you created in step 3f; then, attach the drives to the ServeRAID adapter or controller. 9. Turn on the system and allow UnixWare to discover the new disk-storage adapters and controllers. 10. Power down the system. 11. Install the next ServeRAID adapter or controller from the list you created in step 3f; then, attach the drives to the ServeRAID adapter or controller. 12. Repeat steps 9, 10, and 11 until all ServeRAID adapters, ServeRAID controllers, and drives are installed. 13. You can now partition and format the logical drives attached to the ServeRAID adapters and controllers. See the information provided with UnixWare for more instructions. 3.10 Installing the Files while Installing UnixWare ---------------------------------------------------- To install the ServeRAID files while installing UnixWare 7.0: 1. Use the instructions provided with UnixWare to begin the installation. 2. When a message appears asking if you want to install any HBA diskettes, insert the IBM ServeRAID Device Drivers for SCO Operating Systems Diskette; then, select INSTALL HBA DISKETTE. 3. Use the instructions provided in the UnixWare manual to complete the normal installation process. 3.20 Installing the Files after Installing UnixWare ---------------------------------------------------- Use the following instructions to install the ServeRAID files after you install UnixWare, or use these instructions to update a previously installed ServeRAID file with a newer version. You can use the UnixWare Pkgadd or the UnixWare SCOAdmin utility program to install the files. INSTALLING AN HBA DISKETTE FILE USING PKGADD 1. Insert the IBM ServeRAID Device Drivers for SCO Operating Systems Diskette into the diskette drive. 2. Type: pkgadd -d /dev/dsk/f0t 3. Press ENTER 4. When the message "Insert diskette into Floppy Drive 1" appears, press ENTER. 5. When the message "Installation of IBM ServeRAID SCSI IHV HBA (ips) was successful" appears, type: q 6. Press ENTER; then after the device driver installs, restart the system. INSTALLING AN HBA DISKETTE FILE USING SCOADMIN 1. Insert the IBM ServeRAID Device Drivers for SCO Operating Systems Diskette into the diskette drive. 2. Start the SCOAdmin utility program. 3. Select SOFTWARE_MANAGEMENT. 4. Select APPLICATION INSTALLER. 5. Select DISK_A from the Install From tab. 6. Click on the UPDATE VIEW button. 7. When the icon labeled IPS appears in the window, click on INSTALL. 8. After the device driver installs, restart the system. ____________________________________________________________________ 4.0 Starting the Background-Server Components ______________________________________________ To start the background-server components for SCO OpenServer and and UnixWare: 1. Make sure you are logged on as "root". a. If you are not, type: su b. When prompted, enter the "root" password. 2. Start the background-server component (daemon) running in the background. To do this, type: ipsadm & 3. Press ENTER. ____________________________________________________________________ 5.0 Trademarks and Notices ___________________________ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM Netfinity ServeRAID Microsoft, Windows, and Windows NT are trademarks or registered trademarks of Microsoft Corporation. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited. Other company, product, and service names may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.