******************************************************************** * IBM ServeRAID Supplemental Diskette * * Version 2.41 * ******************************************************************** IPSSEND is a utility that provides a command-line interface for performing various tasks on a IBM PC ServeRAID Adapter. These tasks include viewing the current configuration, rebuilding a dead drive, initializing and/or synchronizing logical drives, plus many more. IPSMON is a utility that monitors IBM PC ServeRAID Adapters for dead drives, Predictive Failure Analysis warnings (PFA's), rebuilds, synchronizations, and logical drive migrations. If any of these occur, a message is logged to the display and/or a file. IPSSEND and IPSMON Installation Instructions -------------------------------------------------------------------------- IPSSEND is available for Windows NT**, IBM OS/2*, Novell NetWare**, SCO OpenServer**, and DOS (requires the ASPI Manager). IPSMON is available for all of the above except for DOS. To install the utilities on Windows NT: 1. Insert the diskette into the primary floppy drive. 2. Make a directory on your hard drive. Type 'MD \IPSADM' 3. Copy the files from the floppy drive onto your hard drive. Type 'COPY A:\NT\IPSSEND.EXE \IPSADM' Type 'COPY A:\NT\IPSMON.EXE \IPSADM' 4. Change into the directory you created. Type 'CD \IPSADM' 5. Run the utility. Type 'IPSSEND' Type 'IPSMON' To install the utilities on IBM OS/2: 1. Insert the diskette into the primary floppy drive. 2. Make a directory on your hard drive. Type 'MD \IPSADM' 3. Copy the files from the floppy drive onto your hard drive. Type 'COPY A:\OS2\IPSSEND.EXE \IPSADM' Type 'COPY A:\OS2\IPSMON.EXE \IPSADM' 4. Change into the directory you created. Type 'CD \IPSADM' 5. Run the utility. Type 'IPSSEND' Type 'IPSMON' To install the utilities on Novell NetWare: 1. Insert the diskette into the primary floppy drive. 2. Copy the files from the floppy drive onto your hard drive. Type 'COPY A:\NETWARE\IPSSEND.NLM C:\NWSERVER' Type 'COPY A:\NETWARE\IPSMON.NLM C:\NWSERVER' 3. Start your NetWare server. 3. Run the utility. Type 'LOAD C:\NWSERVER\IPSSEND.NLM' Type 'LOAD C:\NWSERVER\IPSMON.NLM' To install the utilities on SCO OpenServer 1. Insert the diskette into the primary floppy drive. 2. Make a directory on your hard drive. Type 'mkdir /ipsadm' 3. Change into the directory you created. Type 'cd /ipsadm' 4. Copy the files from the floppy drive onto your hard drive. Type 'doscp -r a:/OPENSERV/IPSSEND ./ipssend' Type 'doscp -r a:/OPENSERV/IPSMON ./ipsmon' 5. Change the access permissions to allow 'execute'. Type 'chmod 700 ./ipssend' Type 'chmod 700 ./ipsmon' 6. Run the utility. Type './ipssend' Type './ipsmon' To install the utilities on DOS: 1. Create a bootable diskette that loads the ServeRAID ASPI Device Driver. 2. Copy the IPSSEND utility from the floppy diskette onto the bootable diskette. 3. Insert the bootable diskette and restart the system. 4. Run the utility. Type 'IPSSEND' IPSSEND Usage Instructions -------------------------------------------------------------------------- The IPSSEND utility runs from an operating system command line. Simply type 'IPSSEND' and press 'Enter' while in the proper directory to run the utility. [For Novell NetWare, from the console type 'LOAD IPSSEND'.] When you run the utility 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 utility with a specific function, but without its required parameters, specific help for that function is displayed. Following is a list of the available functions and the appropriate parameters: ERASEEVENT This command clears all entries that have been logged in the designated event table. See GETEVENT help for information on the contents of the Device Event Table and the Adapter Soft and Hard Event Logs. IPSSEND ERASEEVENT Adapter # --> Number of adapter (1 to 8) Options --> DEVICE for Device Event Table SOFT for Adapter Soft Event Log HARD for Adapter Hard Event Log GETCONFIG This command displays information about the ServeRAID Adapter configuration. This includes information on the adapter (firmware version, initiator ID and rebuild rate), logical drives (status, raid level, and size), and physical devices (type, SCSI ID and PFA error). IPSSEND GETCONFIG Adapter # --> Number of adapter (1 to 8) Options --> AD for Adapter Information LD for Logical Drive Information PD for Physical Device Information AL (default) for All Information GETEVENT This command displays information concerning various unexpected events. The Soft and Hard Event Log is used for IBM development and debugging purposes. The Device Event Table contains event counters for each attached physical device. These counters include PARITY (an unexpected event while transferring data on the SCSI bus; usually indicating a problem with the SCSI cable/connectors/terminators), SOFT (a 'check condition' event detected by the SCSI device), HARD (an unexpected event detected by the SCSI adapter; most likely caused by the adapter), and MISC (an event detected by the adapter; most likely caused by the device). This table also alerts PFA (Predictive Failure Analysis); the device has signaled to the adapter that it may fail in the near future. IPSSEND GETEVENT Adapter # --> Number of adapter (1 to 8) Options --> DEVICE for Device Event Table SOFT for Adapter Soft Event Log HARD for Adapter Hard Event Log GETSTATUS This command displays the status of the current or most recent rebuild, synchronize, or logical drive migration. Information includes logical drive in progress (or most recently completed), remaining size, and percentage completed. IPSSEND GETSTATUS Adapter # --> Number of adapter (1 to 8) INIT This command initializes the first half-megabyte of a logical drive. This will erase the partition tables on that drive. All data on the logical drive will be lost. IPSSEND INIT NOPROMPT Adapter # --> Number of adapter (1 to 8) Logical Drive # --> Number of Logical Drive (0 to 7) NOPROMPT --> Optional parameter to override user-prompt INITSYNC This command is used to initialize and synchronize a logical drive at the same time. This command will only work on RAID level 1 and 5 logical drives. The entire logical drive will be erased with this command. All data on the logical drive will be lost. IPSSEND INITSYNC Adapter # --> Number of adapter (1 to 8) Logical Drive # --> Number of Logical Drive (0 to 7) NOPROMPT --> Optional parameter to override user-prompt REBUILD This command starts a rebuild to the designated device. This operation is valid for disk arrays containing one or more logical drives in the critical (CRT) state. Progress is indicated during the rebuild, but can also be accessed using the GETSTATUS command. IPSSEND REBUILD Adapter # --> Number of adapter (1 to 8) DDDCh # --> Channel of DDD Device (1 to 3) DDDBay # --> Bay of DDD Device (1 to 16) NewCh # --> Channel of New Device (1 to 3) NewBay # --> Bay of New Device (1 to 16) RESTORE This command is used to load a configuration from a file on a floppy diskette or on a hard disk drive. The configuration must be a valid configuration file from the BACKUP option on the ServeRAID DOS Configuration Diskette. This operation will overwrite any existing configuration in the ServeRAID adapter. IPSSEND RESTORE Adapter # --> Number of adapter (1 to 8) Filename --> Path and filename of the configuration file NOPROMPT --> Optional parameter to override user-prompt SETSTATE This command redefines the state of a physical device from its current state to the designated state. Extreme caution must be taken when executing this command! For example, redefining a defunct (DDD) device to online (ONL) without going through a rebuild is extremely dangerous. IPSSEND SETSTATE Adapter # --> Number of adapter (1 to 8) Channel # --> Channel of Device (1 to 3) Bay # --> Bay of Device (1 to 16) New State --> EMP (Empty) RDY (Ready) HSP (Hot Spare) SHS (Standby Hot Spare) DDD (Defunct Disk Drive) DHS (Defunct Hot Spare) RBL (Rebuild) SBY (Standby) ONL (Online) SYNCH This command synchronizes the parity on redundant logical drives. If the parity information is inconsistent, it will automatically be repaired. IPSSEND SYNCH Adapter # --> Number of adapter (1 to 8) Scope --> DRIVE for a single Logical Drive Scope ID --> Number of Logical Drive (0 to 7) UNBLOCK This command allows access to a blocked logical drive. RAID level 0 logical drives become blocked when they are in an array containing RAID level 1 or 5 logical drives and the array has been rebuilt. The RAID level 0 logical drives can not be rebuilt; therefore, the data is corrupt and should not be accessed. After issuing an UNBLOCK command, data should be recreated or restored. IPSSEND UNBLOCK Adapter # --> Number of adapter (1 to 8) Logical Drive # --> Number of Logical Drive (0 to 7) IPSMON Usage Instructions -------------------------------------------------------------------------- The IPSMON utility runs from an operating system command line. Simply type 'IPSMON' and press 'Enter' while in the proper directory to run the utility. [For Novell NetWare, from the console type 'LOAD IPSMON'.] When executed, this utility immediately begins polling all ServeRAID adapters for specific conditions. On receiving any of these conditions, a message is recorded to a file and/or displayed on the screen. IPSMON accepts command-line parameters to determine where to record the messages. Use 'IPSMON -?' for help on the valid parameters. Starting the utility without any command-line parameters will log the messages to a file named IPSMON.LOG and will not display the messages to the display. Here are the valid parameters for IPSMON: -f:filename Use the -f parameter to specify the name of the file to record messages. The default filename is IPSMON.LOG. -s Use the -s parameter to display messages on the standard output (usually the display). After starting IPSMON, the utility will continue polling the adapters until pressing -C. During operation, varying messages will be recorded. The message format is as follows. Each message contains an alert code. This code begins with the type and number of the message - INF, WRN, or CRT, followed by the number. After that is the location specifier - A specifies the adapter number, C specifies the channel number (if appropriate for the message), and B specifies the bay number (if appropriate for the message). The following messages will be recorded 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 TRADEMARKS AND SERVICE MARKS -------------------------------------------------------------------------- The following terms, denoted by an asterisk (*) in this README, are trademarks or registered trademarks of the IBM Corporation in the United States or other countries: ------------------------------------------ IBM ------------------------------------------ OS/2 ------------------------------------------ NetFinity ------------------------------------------ The following terms, denoted by a double asterisk (**) in this README, are trademarks of other companies as follows: Trademark: Owner: -------------------------------------------------------------- NetWare Novell, Inc. -------------------------------------------------------------- OpenServer The Santa Cruz Operation, Inc. -------------------------------------------------------------- SCO The Santa Cruz Operation, Inc. -------------------------------------------------------------- Microsoft Windows and Windows NT are trademarks or registered trademarks of the Microsoft Corporation. -------------------------------------------------------------- UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited. --------------------------------------------------------------