******************************************************************** * IBM ServeRAID Command Line Programs * * Version 3.01 * * ****************************************************************** 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. 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 ... 2.40 Installing IPSSEND and IPSMON for DOS 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 and 4.1X 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 UnixWare 7.0: 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:/unixware/ipssend /usr/bin/ipssend 3. Press ENTER; then, type: doscp -r a:/unixware/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.40 Installing IPSSEND with DOS ---------------------------------- To install IPSSEND for DOS: 1. Create a startable diskette. To do this, insert a blank diskette in diskette drive A; then, type: format a: /s 2. Press ENTER. 3. Copy the IPSSEND.EXE file from the DOS directory on the IBM ServeRAID Command Line Programs Diskette to the startable diskette. 4. Install the ASPI device driver on the startable diskette. To do this, insert the IBM ServeRAID Device Driver Diskette; then, type: a:\dos\uinstall 5. Press ENTER. Specify Source Drive a:\ and Target Path a:\ and follow the installation instructions that appear on the screen. 6. Leaving the startable diskette in the diskette drive, restart the system; 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 can 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 ipssend 2. Press ENTER. o If you are using DOS: 1. Insert the bootable IPSSEND diskette that you created 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. You run the IPSSEND program from the operating system command line. To start the IPSSEND program: o If you are using DOS, OS/2, or Windows NT: a. From within the directory that contains the IPSSEND program, type: IPSSEND b. Press Enter. o If you are using Novell NetWare: a. From the console, type: LOAD IPSSEND b. Press Enter. o If you are using SCO OpenServer: a. Type: ./ipssend b. 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 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. o If you are using NetWare, type: "unload ipsmon" at the system console. o If you are using OpenServer or UnixWare, press the DEL key to cancel 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 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). After you start the IPSMON program, the program will continuously poll the ServeRAID adapters and controllers until you cancel its operation. o For Windows NT and OS2 Press Ctrl>-C to cancel the program. o For Netware type in "unload ipsmon" at the system console prompt to cancel the program. o For SCO OpenServer press the delete key to cancel 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 B specifies the Bay number (if required) C specifies the Channel number (if required) The IPSMON program can log the following messages, based on the required condition: Information Messages: INF000:A1C-B-- no errors detected INF001:A1C-B-- rebuild started INF002:A1C-B-- rebuild completed INF003:A1C-B-- synchronization started INF004:A1C-B-- synchronization completed INF005:A1C-B-- migration started INF006:A1C-B-- migration completed Warning Messages: WRN001:A2C3B12 PFA Error detected Critical Messages: CRT001:A3C2B04 dead drive detected CRT002:A1C-B-- not responding to ioctl commands ___________________________________________________________________ 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.