2f87d71d04
Update documentation. Include information on how to build and install using autotools. Signed-off-by: Gabriel Krisman Bertazi <krisman@linux.vnet.ibm.com> Signed-off-by: Brian King <brking@linux.vnet.ibm.com>
107 lines
5.1 KiB
Text
107 lines
5.1 KiB
Text
# (C) Copyright 2000, 2001
|
|
# International Business Machines Corporation and others.
|
|
# All Rights Reserved. This program and the accompanying
|
|
# materials are made available under the terms of the
|
|
# Common Public License v1.0 which accompanies this distribution.
|
|
|
|
This directory contains user space tools required by the ipr device
|
|
driver.
|
|
|
|
For more detailed information about ipr and iprutils, refer to the man pages
|
|
and the Linux reference guide (SA23-1327), which is available here:
|
|
|
|
http://publib16.boulder.ibm.com/pseries/en_US/infocenter/base/HW_scsi_adapters.htm
|
|
|
|
# INSTALL
|
|
Make sure your system has the following packages installed:
|
|
|
|
- pciutils-devel
|
|
- ncurses,
|
|
- ncurses-devel
|
|
- sysfsutils
|
|
|
|
Enter the root directory and type the following commands:
|
|
|
|
$ ./configure
|
|
$ make
|
|
$ make install
|
|
|
|
If the configure script is not available in your package, you can
|
|
generate it by running, on the root directory:
|
|
|
|
$ ./bootstrap.sh (requires Autoconf <= 2.69)
|
|
|
|
# TOOLS
|
|
iprdump - A user program meant to be run in the background to gather debug
|
|
information should an IOA failure occur. Ideally, this program should be
|
|
started during boot time after file systems are loaded when the ipr
|
|
SCSI driver is used. An init.d script is provided to do this.
|
|
|
|
iprupdate - IOA/disk unit microcode update utility
|
|
This tool requires no arguments and should be run after each time the device driver
|
|
is loaded. It will query each adapter/disk unit for the microcode version and update
|
|
adapters/disk units that are not currently at the minimum supported levels. An init.d
|
|
script is provided to run this at boot time.
|
|
|
|
iprinit - IOA/disk unit initialization utility
|
|
This tool requires no arguments and should be run after each time the device driver
|
|
is loaded. It will setup all ipr adapters and attached disks to run with optimal
|
|
performance and load any adapter, disk, or scsi bus configurations saved by iprconfig.
|
|
It enables U320 scsi speeds and enables tagged command queuing.
|
|
|
|
iprconfig - IOA Configuration and Recovery tool
|
|
This is an ncurses based utility used to configure ipr adapters and devices.
|
|
The basic functions of this tool are:
|
|
|
|
CONFIGURATION
|
|
1. Display hardware status. This can be used to display all ipr SCSI disks attached
|
|
to your system. Using this option it is possible to obtain information about
|
|
each device on the system.
|
|
2. Work with SCSI Bus Configuration. This allows flexibility in setting some
|
|
SCSI Bus parameters such is Max Bus Throughput and host SCSI ID.
|
|
3. Work with Driver Configuration. Currently allows adjustment to the devices drivers
|
|
log level.
|
|
4. Work with disk configuration. Allows setting per device attributes, such as
|
|
queue depth.
|
|
5. Download microcode. Allows microcode to be downloaded to adapters and SCSI disks.
|
|
|
|
RAID
|
|
6. Create a disk array. Used to create a disk array.
|
|
7. Delete a disk array. Allows you to delete existing arrays. Data stored
|
|
on the devices will not be preserved after issuing this command.
|
|
8. Add a device to a disk array. This option allows devices of similar capacity
|
|
to be included into an existing RAID 5 disk array.
|
|
9. Format Device for advanced function/Format Device for JBOD (Just a Bunch Of DASD) function.
|
|
Disk devices can either be formatted to 512 bytes/sector or 522 bytes/sector. Devices must
|
|
be formatted to 522 bytes/sector, or advanced function format, in order to be used in
|
|
a disk array or as a hot spare. Devices not in a disk array can be formatted to
|
|
512 bytes/sector so they can be used directly by the operating system.
|
|
10. Create a hot spare. Configure a disk to become a hot spare, capable
|
|
of being used by the adapter to automatically replace a failed device
|
|
|
|
|
|
RECOVERY
|
|
12. Concurrent add device. Concurrently add a SCSI disk to a running system.
|
|
13. Concurrent remove device. Concurrently remove a SCSI disk from a running system.
|
|
14. Initialize and format disk. This allows you to issue a SCSI format command
|
|
to SCSI disks. Proceed with caution when using this option.
|
|
15. Reclaim IOA cache storage. This is to be used by IBM hardware service personnel only.
|
|
Use of this function is potentially dangerous and may delete data from the non-volatile
|
|
write cache on the adapter.
|
|
16. Rebuild disk unit data. This option is generally used following concurrent
|
|
maintenance. Select this option after a failing array member device has been replaced to
|
|
reconstruct device as an active array member.
|
|
17. Work with Resources Containing Cache Battery Packs. A set of displays are used to view
|
|
the current status of the Cache Battery on resources containing battery packs and allow
|
|
maintanence actions to be performed against those resources when necessary.
|
|
18. Analyze Log. This allows you to view the error messages logged by the ipr device driver.
|
|
|
|
Changes Log:
|
|
1. Concurrent maintience commands line changes from PCI location to physical location(3/12/2012).
|
|
#iprconfig -c identify-slot "U5886.001.P915059-P1-D1 1"
|
|
#iprconfig -c remove-slot "U5886.001.P915059-P1-D1 1"
|
|
#iprconfig -c add-slot "U5886.001.P915059-P1-D1 1"
|
|
2. Work with disk enclosures
|
|
#iprconfig -c query-disk-enclosure-status
|
|
#iprconfig -c suspend-disk-enclosure sg8
|
|
#iprconfig -c resume-disk-enclosure sg8
|