*********************************************************************
* IBM ServeRAID Device Drivers for SCO Operating Systems *
* Version 3.50 *
*********************************************************************
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.