********************************************************************* * IBM ServeRAID Command-Line Programs * * README.TXT * * Version 4.70 * ********************************************************************* CONTENTS ________ 1.0 Overview 2.0 Installation and setup instructions 2.1 Installing IPSSEND for Windows NT 4.0, Windows 2000, OS/2, or NetWare 2.2 Installing IPSSEND for OpenServer 5.0.x 2.3 Installing IPSSEND for UnixWare 2.4 Installing IPSSEND for Linux 3.0 Starting IPSSEND 4.0 Using IPSSEND 5.0 Web Site and Support Phone Number 6.0 Trademarks and Notices 7.0 Disclaimer 1.0 Overview _____________ NOTE: This README provides information needed to install and configure an IBM ServeRAID-4H Ultra160 SCSI controller, IBM ServeRAID-4M Ultra160 SCSI controller, IBM ServeRAID-4Mx Ultra160 SCSI controller, IBM ServeRAID-4L Ultra160 SCSI controller, and IBM ServeRAID-4Lx Ultra160 SCSI controller (hereafter referred to as IBM ServeRAID-4 Ultra160 SCSI controllers). This README file contains instructions for installing and starting the IBM ServeRAID IPSSEND command-line program. IPSSEND is an advanced command-line program that you can use to manage your ServeRAID adapters and controllers. This utility program is provided on the "IBM ServeRAID Support" CD and the "IBM ServeRAID Command-Line Programs" diskette. You can use the IPSSEND program to view the configuration of a ServeRAID adapter or controller, rebuild a defunct drive, initialize logical drives, synchronize logical drives, and perform other functions. You can use the IPSSEND program with the following operating systems: o Microsoft Windows NT and Windows 2000 o IBM OS/2 Warp Server o Novell NetWare 4.X and 5.X o SCO OpenServer 5.0.X o SCO UnixWare 7.0 o Red Hat Linux 6.2 and 7.0 The "IBM ServeRAID Command-Line Programs" diskette is a DOS startable (bootable) diskette; you can use the IPSSEND program after starting the diskette. 2.0 Installation and setup instructions ________________________________________ 2.1 Installing IPSSEND for Windows NT 4.0, Windows 2000, OS/2, or NetWare ____________________________________________________________ 1. Start the server. 2. If you are using NetWare, go to step 4. If you are using Windows or OS/2, create an IPSADM directory on your hard disk drive. To do this, go to the operating system command prompt and type: md c:\ipsadm where c is the drive where Windows NT, Windows 2000, or OS/2 is installed. 3. Press Enter. 4. If you are installing from the "IBM ServeRAID Support" CD: * For Windows NT, type: copy d:\programs\winnt\cmdline\nt4_0\ipssend.exe c:\ipsadm * For Windows 2000, type: copy d:\programs\winnt\cmdline\Win2k\ipssend.exe c:\ipsadm * For OS/2, type: copy d:\programs\os2\cmdline\ipssend.exe c:\ipsadm * For NetWare, type: copy d:\programs\netware\cmdline\ipssend.nlm c:\nwserver If you are installing from the "IBM ServeRAID Command- Line Programs" diskette (the OS/2 version of IPSSEND is not available on the diskette): * For Windows NT, type: copy a:\nt\ipssend.exe c:\ipsadm * For Windows 2000, type: copy a:\Win2k\ipssend.exe c:\ipsadm * For NetWare, type: copy a:\netware\ipssend.nlm c:\nwserver where a is the diskette drive c:\ipsadm is the directory you created in step 2. c:\nwserver is the directory where NetWare is installed. d is the CD-ROM drive. 5. Press Enter. 2.2 Installing IPSSEND for OpenServer 5.0.x ____________________________________________ 1. Insert the "IBM ServeRAID Command-Line Programs" diskette into the diskette drive. 2. Mount the diskette drive by typing the following at the console: mount -f DOS -o lower /dev/fd0135ds18 /mnt NOTE: If you have more than one diskette drive, you might need to replace '/dev/fd0135ds18' with the specific name of the diskette drive that you want to use. If you currently have another device mounted on /mnt, you must create a new directory and substitute its name for /mnt in these instructions. 3. Press Enter; then copy the program files from the "IBM ServeRAID Command-Line Programs" diskette by typing the following: zcat /mnt/openserv/ipssend > /usr/bin/ipssend 4. Press Enter; then, unmount the diskette drive by typing the following: umount /mnt where /mnt is the location you mounted in step 2. 5. Press Enter; then, remove the diskette from the diskette drive. 6. Change the access permissions by typing the following: chmod 700 /usr/bin/ipssend 7. Press Enter. 2.3 Installing IPSSEND for UnixWare ____________________________________ 1. Insert the "IBM ServeRAID Command-Line Programs" diskette into the diskette drive. 2. Mount the diskette drive by typing the following at the console: mount -F dosfs /dev/fd0135ds18 /Disk_A NOTE: If you have more than one diskette drive, you might need to replace '/dev/fd0135ds18' with the specific name of the diskette drive that you want to use. If you currently have another device mounted on /Disk_A, you must create a new directory and substitute its name for /Disk_A in these instructions. 3. Press Enter. 4. Type the following and press Enter: cp /Disk_A/unixware/ipssend.z /tmp/ipssend.Z 5. Type the following and press Enter: zcat /tmp/ipssend > /usr/bin/ipssend 6. Type the following and press Enter: rm -f /tmp/ipssend.Z 7. Unmount the diskette drive by typing: umount /Disk_A where /Disk_A is the location you mounted in step 2. 8. Press Enter; then, remove the diskette from the diskette drive. 9. Change the access permissions by typing the following: chmod 700 /usr/bin/ipssend 10. Press Enter. 2.4 Installing IPSSEND for Linux _________________________________ NOTE: You must have "SCSI Generic" support compiled into your kernel for IPSSEND to work properly under Linux. Refer to the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 1. Insert the "IBM ServeRAID Command-Line Programs" diskette into the diskette drive. 2. Mount the diskette drive by typing the following at the console: mount -t msdos /dev/fd0 /mnt NOTE: If you have more than one diskette drive, you might need to replace '/dev/fd0' with the specific name of the diskette drive that you want to use. If you currently have another device mounted on /mnt, you must create a new directory and substitute its name for /mnt in these instructions. 3. Press Enter. 4. Type the following and press Enter: gunzip -c /mnt/linux/ipssend > /usr/bin/ipssend 5. Unmount the diskette drive by typing the following: umount /mnt where /mnt is the location you mounted in step 2. 6. Press Enter; then, remove the diskette from the diskette drive. 7. Change the access permissions by typing the following: chmod 700 /usr/bin/ipssend 8. Press Enter. 3.0 Starting IPSSEND _____________________ Run the IPSSEND program from the operating system command line. To start the IPSSEND program: o If you are using Windows NT, Windows 2000, or OS/2: 1. Type: c:\ipsadm\ipssend where c:\ipsadm is the directory where IPSSEND is installed. 2. Press Enter. o If you are using NetWare: 1. From the console, type: load c:\nwserver\ipssend where c:\nwserver is the directory where NetWare is installed. 2. Press Enter. o If you are using OpenServer, UnixWare, or Linux: 1. Type: /usr/bin/ipssend where /usr/bin is the directory where IPSSEND is installed. 2. Press Enter. o If you are using DOS: 1. Insert the "IBM ServeRAID Command-Line Programs" diskette into the diskette drive; then, type: a:\ipssend where a is the diskette drive. 2. Press Enter. 4.0 Using IPSSEND __________________ When you run the IPSSEND program with no command-line parameters, a list of available commands and their specific parameters are provided. All commands require a minimum set of parameters to execute the command. If you run the IPSSEND program with a specific command, but without its required parameters, specific help for that command will be displayed. 5.0 Web Sites and Support Phone Number _______________________________________ o You can download new and updated files for the IBM ServeRAID and Clustering products from the IBM Support Web site: http://www.ibm.com/pc/support/ o With the original purchase of an IBM hardware product, you have access to extensive support coverage. During the IBM hardware product warranty period, you may call the IBM Personal Computer HelpCenter (1-800-772-2227 in the U.S.) for hardware product assistance covered under the terms of the IBM hardware warranty. 6.0 Trademarks and Notices ___________________________ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: Active PCI OS/2 Warp HelpCenter PC Server IBM Predictive Failure Analysis Netfinity ServeRAID Netfinity Manager ServerGuide OS/2 UNIX is a registered trademark in the United States and other countries and is licensed exclusively through The Open Group. Microsoft, Windows, and Windows NT are trademarks or registered trademarks of Microsoft Corporation. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others. 7.0 Disclaimer _______________ 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 Corporation.