********************************************************************
* IBM ServeRAID Command Line Programs *
* Version 3.50 *
* ******************************************************************
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:
<Date and Time> INF000:A1C-SID-- no errors detected
<Date and Time> INF001:A1C-SID-- rebuild started
<Date and Time> INF002:A1C-SID-- rebuild completed
<Date and Time> INF003:A1C-SID-- synchronization started
<Date and Time> INF004:A1C-SID-- synchronization completed
<Date and Time> INF005:A1C-SID-- migration started
<Date and Time> INF006:A1C-SID-- migration completed
<Date and Time> INF005:A1C-SID-- FlashCopy started
<Date and Time> INF006:A1C-SID-- FlashCopy completed
WARNING MESSAGES:
<Date and Time> WRN001:A2C3SID12 PFA Error detected
CRITICAL MESSAGES:
<Date and Time> CRT001:A3C2SID04 dead drive detected
<Date and Time> 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.