Tree [25bac9] master /
 History



File Date Author Commit
 debug 2006-05-22 brking brking [72d6e0] Format timeout updates. Update RAID support tab...
 init.d 2015-07-14 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [4cf7f4] iprutils: Add option to enable/disable initd sc...
 spec 2016-01-19 Brian King Brian King [22ce7f] iprutils: Version 2.4.10
 systemd 2015-07-14 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [84fbaf] iprutils: Add option to enable/disable systemd ...
 LICENSE 2004-03-08 bjking1 bjking1 [9e8c92] Added license
 Makefile.am 2015-11-23 Heitor Ricardo Alves de Siqueira Heitor Ricardo Alves de Siqueira [a2d09a] iprutils: Implement ipr dump formatting tool
 README 2015-02-06 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [2f87d7] This updates documentation on how to build ipru...
 bootstrap.sh 2015-02-25 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [dd5895] iprutils: Add support for Autotools build system.
 configure.ac 2016-01-19 Brian King Brian King [22ce7f] iprutils: Version 2.4.10
 ipr.msg 2010-11-12 Kleber Sacilotto de Souza Kleber Sacilotto de Souza [1bfcbc] Merge branch 'live_dump' into 2.3.1
 iprconfig-bash-completion.sh 2015-05-07 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [f44ed3] iprutils: Add smart bash completion to iprconfi...
 iprconfig.8 2015-11-23 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [34a722] iprutils: Implement SSD Fuel Gauge.
 iprconfig.c 2016-01-11 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [bc0fb7] iprutils: Add Device Statistics menu.
 iprconfig.h 2016-01-13 Brian King Brian King [29f90f] iprutils: Device statistics menu selection fixup
 iprdbg.c 2014-02-07 Wen Xiong Wen Xiong [f6ee8e] Subject: iprutils: compilation fails on Ubuntu
 iprdump.8 2014-11-18 Daniel Kreling Daniel Kreling [86c5cb] iprutils: clarifying man page for iprdump utility
 iprdump.c 2015-03-13 Daniel Kreling Daniel Kreling [8c080d] iprutils: fixing daemons being stopped
 iprdumpfmt.8 2015-11-23 Heitor Ricardo Alves de Siqueira Heitor Ricardo Alves de Siqueira [a2d09a] iprutils: Implement ipr dump formatting tool
 iprdumpfmt.c 2015-12-02 Brian King Brian King [b460c0] iprdumpfmt: Remove unnecessary definitions
 iprinit.8 2005-02-25 brking brking [f3eff6] Makefile cleanup. Updated man pages
 iprinit.c 2016-01-27 Brian King Brian King [25bac9] iprinit: Don't log errors if ipr driver not loaded
 iprlib.c 2016-01-12 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [840126] iprutils: Configure sync cache using GUI.
 iprlib.h 2015-11-26 Heitor Ricardo Alves de Siqueira Heitor Ricardo Alves de Siqueira [0b693b] iprutils: Unbind device before JBOD -> AF forma...
 iprsos 2015-07-22 Daniel Kreling Daniel Kreling [f934c5] iprutils: changing iprsos to display at stdout
 iprsos.8 2015-07-22 Daniel Kreling Daniel Kreling [f934c5] iprutils: changing iprsos to display at stdout
 iprupdate.8 2005-02-25 brking brking [f3eff6] Makefile cleanup. Updated man pages
 iprupdate.c 2015-07-29 Gabriel Krisman Bertazi Gabriel Krisman Bertazi [9e0763] iprutils: Create common interface for get_*_fw_...
 iprutils.py 2015-05-06 Daniel Kreling Daniel Kreling [f4b65a] iprutils: adding sosreport python plugin

Read Me

# (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