******************************************************************** * IBM ServeRAID Command Line Programs * * Version 3.50C * * ****************************************************************** This README file contains instructions for installing and starting the IBM ServeRAID IPSSEND and IPSMON command-line interface programs. IPSSEND and IPSMON are advanced command-line programs that you can use to manage your ServeRAID adapters and controllers. These utility programs are provided on the IBM ServeRAID Command Line Programs Diskette. **** Important Information **** This diskette is a DOS bootable diskette; the user can use the DOS version of the IPSSEND program after booting. 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 the IPSSEND and IPSMON Programs 2.0 Installing IPSSEND and IPSMON ... 2.10 Installing IPSSEND and IPSMON for OS/2, Windows NT, or Netware ... 2.20 Installing IPSSEND and IPSMON for SCO OpenServer ... 2.30 Installing IPSSEND and IPSMON for SCO UnixWare 3.0 Instructions for Starting IPSSEND and IPSMON ... 3.10 Starting the IPSSEND Program ... 3.20 Using the IPSSEND Program ... 3.30 Starting the IPSMON Program ... 3.40 Using the IPSMON Program 4.0 Using IPSSEND and IPSMON 5.0 Trademarks and Notices ____________________________________________________________________ 1.0 About the IPSSEND and IPSMON Programs __________________________________________ 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 IPSMON program to monitor a ServeRAID adapter or controller for defunct drives, predictive failure analysis (PFA) warnings, rebuild operations, synchronizations, and logical-drive migrations. This program can log a message to the monitor, to a file, or to both the monitor and a file whenever activities occur. You can use the IPSSEND and IPSMON programs with the following operating systems: o IBM OS/2 Warp Server and OS/2 LAN Server o Novell NetWare 3.12, 4.1X, and 5.0 o Microsoft Windows NT o SCO OpenServer 5.0.X o SCO UnixWare 7.0 You also can use the IPSSEND program with DOS, but DOS requires the ASPI Manager. ____________________________________________________________________ 2.0 Installing IPSSEND and IPSMON for OS/2, Windows NT, OR Netware ___________________________________________________________________ To install these programs for OS/2, Windows NT, or NetWare: 1. Start the server. 2. After the operating system loads, insert the IBM ServeRAID Command Line Programs Diskette into the diskette drive. 3. If you are using NetWare, go to step 5. If you are using Windows NT 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 NOTES: a. The c represents the drive where OS/2 or Windows NT is installed. b. If you installed the Administration and Monitoring Program files, you already created this directory. 4. Press ENTER. 5. Copy the IPSSEND.EXE (IPSSEND.NLM if you are using Netware) file to your hard disk drive by typing one of the following at the command prompt: o For OS/2, type: copy a:\os2\ipssend.exe c:\ipsadm o For Windows NT, type: copy a:\nt\ipssend.exe c:\ipsadm o For NetWare, type: copy a:\netware\ipssend.nlm c:\nwserver NOTES: a. The a represents the drive assignment for the diskette drive that contains the ServeRAID diskette. b. The c represents the drive where OS/2, Windows NT, or NetWare is installed. c. These instructions assume that you installed NetWare in the NWSERVER directory. 6. Press ENTER; then, copy the IPSMON.EXE file to your hard disk drive by typing one of the following at the command prompt: o For OS/2, type: copy a:\os2\ipsmon.exe c:\ipsadm o For Windows NT, type: copy a:\nt\ipsmon.exe c:\ipsadm o For NetWare, type: copy a:\netware\ipsmon.nlm c:\nwserver NOTES: a. The a represents the drive assignment for the diskette drive that contains the ServeRAID diskette. b. The c represents the drive where OS/2, Windows NT, or NetWare is installed. c. These instructions assume that you installed NetWare in the NWSERVER directory. 7. Press ENTER; then, refer to section 3.0 for information to start and use the IPSSEND and IPSMON programs. 2.20 Installing IPSSEND and IPSMON for OpenServer --------------------------------------------------- To install these programs for OpenServer 5.0.X: 1. Insert the IBM ServeRAID Command Line Programs Diskette into the diskette drive. 2. Copy the program files from the IBM ServeRAID Command Line Programs Diskette by typing the following: doscp -r a:/openserv/ipssend /usr/bin/ipssend 3. Press ENTER; then, type: doscp -r a:/openserv/ipsmon /usr/bin/ipsmon 4. Press ENTER; then, change the access permissions by typing the following: chmod 700 /usr/bin/ipssend 5. Press ENTER; then, type: chmod 700 /usr/bin/ipsmon 6. Press ENTER; then, refer to section 3.0 for information to start and use the IPSSEND and IPSMON programs. 2.30 Installing IPSSEND and IPSMON for Unixware ------------------------------------------------- To install these programs for SCO UnixWare 7.0: 1. Insert the IBM ServeRAID Command Line Programs Diskette into the diskette drive. 2. Mount the diskette by typing the following at the console: mount -f dosfs /dev/fd0135ds18/Disk_A Note: If you have more than one diskette drive, you may need to replace '/dev/fd0135ds18' with the specific name of the diskette drive that you want to use. If you currently have something mounted on /Disk_A, you will need to create a new directory and substitute its name for /Disk_A in these instructions. 3. Press ENTER; then copy the program files from the IBM ServeRAID Command Line Programs Diskette by typing the following: cp /Disk_A/unixware/ipssend /usr/bin/ipssend 4. Press ENTER; then type: cp /Disk_A/unixware/ipsmon /usr/bin/ipsmon 5. Press ENTER; then, change the access permissions by typing the following: chmod 700 /usr/bin/ipssend 6. Press ENTER; then, type: chmod 700 /usr/bin/ipsmon 7. Press ENTER; then, refer to section 3.0 for information to start and use the IPSSEND and IPSMON programs. ____________________________________________________________________ 3.0 Instructions for Starting and Using IPSSEND and IPSMON ___________________________________________________________ This section provides the information needed to start and use the IPSSEND and IPSMON programs. 3.10 Starting the IPSSEND Program ------------------------------------------ You run the IPSSEND program from the operating system command line. To start the IPSSEND program: o If you are using OS/2 or Windows NT: 1. Type: c:\ipsadm\ipssend 2. Press ENTER. NOTE: The c represents the drive where OS/2 or Windows NT is installed. o If you are using NetWare: 1. From the console, type: load c:\nwserver\ipssend 2. Press ENTER. o If you are using DOS: 1. Insert the bootable IPSSEND diskette into diskette drive A; then, type: a:\ipssend 2. Press ENTER. o If you are using OpenServer or UnixWare: 1. Type: /usr/bin/ipssend 2. Press ENTER. 3.20 Using the IPSSEND Program --------------------------------------- When you run the IPSSEND program with no command-line parameters, a list of available functions and their specific parameters are provided. All functions require a minimum set of parameters to execute the command. If you run the IPSSEND program with a specific function but without its required parameters, specific help for that function will appear on the monitor. 3.30 Starting the IPSMON Program ------------------------------------------ You can run the IPSMON program from the operating system command line. To start the IPSMON program: o If you are using OS/2 or Windows NT: 1. Type: c:\ipsadm\ipsmon 2. Press ENTER. NOTE: The c represents the drive where OS/2 or Windows NT is installed. o If you are using Novell NetWare: 1. From the console, type: load c:\nwserver\ipsmon 2. Press ENTER. o If you are using SCO OpenServer or UnixWare: 1. Type: /usr/bin/ipsmon 2. Press ENTER. 3.40 Using the IPSMON Program -------------------------------------- When you start this monitoring program, it immediately begins polling all ServeRAID adapters and controllers for specific conditions. If a condition being monitored is found, this program logs a message to the monitor, to a file, or to both the monitor and a file. The IPSMON program uses command-line parameters to determine where to log the messages. If you need help, you can type the "IPSMON -?" command for a list of valid parameters. If you start this program without any command-line parameters, the IPSMON program will log the messages to the IPSMON.LOG file, and the messages will not appear on the monitor. The valid parameters for IPSMON are: o -F:FILENAME Use the -f parameter to specify the name of the file in which to record messages. The default file name is IPSMON.LOG. o -S Use the -s parameter to display messages on the standard output (usually the monitor). o -? Use the -? parameter to obtain a current list of valid parameters. After you start the IPSMON program, the program will continuously poll the ServeRAID adapters and controllers until you take one of the following actions: o If you are using Windows NT or OS/2, press CTRL+C to stop the program. o If you are using NetWare, type: "unload c:\nwserver\ipsmon" at the system console to stop the program. o If you are using OpenServer or UnixWare, press the DEL key to stop the program. During operation, the program will log various messages. Each message will contain an alert code and a location specifier. o The alert code begins with the message type and number. For example, INF, WRN, or CRT, followed by the message number. o After the alert code comes the location specifier: A specifies the adapter or controller number SID specifies the SCSI ID (if required) C specifies the channel number (if required) For example, a message of CRTxxx:A2C3SID04 signifies that a Critical condition (CRTxxx) was found on Adapter 2 (A2), Channel 3 (C3), SCSI ID 4 (SID04). The IPSMON program can log the following messages, based on the required condition. INFORMATION MESSAGES: INF000:A1C-SID-- no errors detected INF001:A1C-SID-- rebuild started INF002:A1C-SID-- rebuild completed INF003:A1C-SID-- synchronization started INF004:A1C-SID-- synchronization completed INF005:A1C-SID-- migration started INF006:A1C-SID-- migration completed INF005:A1C-SID-- FlashCopy started INF006:A1C-SID-- FlashCopy completed WARNING MESSAGES: WRN001:A2C3SID12 PFA Error detected CRITICAL MESSAGES: CRT001:A3C2SID04 dead drive detected CRT002:A1C-SID-- not responding to commands o -f:filename o -s Use the -f parameter to specify the name of the file to record messages. The default filename is IPSMON.LOG. Use the -s parameter to display messages on the standard output (usually the monitor). ___________________________________________________________________ 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 OS/2 ServeRAID Microsoft, Windows, and Windows NT are trademarks or registered trademarks of Microsoft Corporation. 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.