This release note and the software it accompanies it are copyright (c) 2003, Intel Corporation, and may only be 
installed and used in accordance with the license that accompanies the software.

File name: linx_SC_2131.gz

RAID configuration and monitoring tools
=======================================

This directory contains the following tools:
-------------------------------------------

1. Storcon 
   -------
   Description: Storage Console or Storcon is the primary tool to configure 
                and monitor the Storage RAID controllers subsystem.  For the 
                usage of storcon gdth driver version 1.26 or higher is required.
   Install    : For installation instructions look below.
   Usage      : After the tool is installed, refer the tool's manual page with 
                the command "man storcon". Invoke the tool with the command 
                "storcon". If you intent to connect to a remote RAID subsystem
                using this tool, then the "srcd" daemon should be running on the
                remote system. Please look for more information below on "srcd".

2. iircfg
   ------
   Integrated RAID configuration tool is a command-line based tool with a 
   subset of Storcon's functionality to configure the RAID subsystem. 
   Install    : For installation instructions look below.
   Usage      : After the tool is installed, refer the tool's manual page with 
                the command "man iircfg". Invoke the tool with the command 
                "iircfg [commandline options]" 

3. srcd
   ----
   Storage RAID controller daemon is a remote RAID access service which via TCP/IP
   allows storcon on a remote system to connect the local system. Additionally
   srcd can send SNMP traps to configured target hosts or execute an external
   program (e.g. mail) when a Storage RAID Controller event occurs.
   Install    : For installation instructions look below.
   Usage      : After the tool is installed, refer the tool's manual page with 
                the command "man srcd". During the install of the tool, the 
                startup of the tool is integrated into the system init scripts. 
                On a Redhat system for e.g. you can start the daemon with the 
                command: "/etc/rc.d/init.d/srcd start"
   Config File: /etc/srcd.conf. Please read comments in this file for more
                configuration information


Installing the tools
====================

Note: Please perform all steps as root. The tool can be run only as root or with
superuser priviliges.

 The various tools are packaged in popular Linux package formats i.e. Redhat 
Package Manager (RPM) and Debian (DEB) formats. If these packages are supported
on your particular distribution then you can use the script "install.sh" to
installi/uninstall these tools. To do so, from the current directory invoke the 
installation script as "./install.sh". Note you might have to make the script 
executable using the following command "chmod +x ./install.sh".

 If RPM and DEB packages are not supported on your particular distribution, then
use gzipped (and optionally tarred) versions of the tools. Please follow 
instructions below.

To manually install/uninstall each of the tools:
-----------------------------------------------

Note: The letters "X", "Y" and "Z" are used to denote version numbers of the
      tool in the instructions given below.

a) RPM packages (on Redhat, SuSE, Mandrake, Turbolinux and Caldera)
   ------------
       install: rpm -Uvh packagename.rpm 
                 [e.g. rpm -ivh storcon-X.YY-Z.i386.rpm ]
       uninstall: rpm -e packagename 
                 [e.g. rpm -e storcon]
Additionally you can do :
rpm -qi packagename to display information about the installed package.

b) DEB packages ( On Debian system)
   ------------
       install: dpkg -i packagename.deb 
                 [e.g. dpkg -i storcon_X.YY-Z_i386.deb]
       uninstall: dpkg -r packagename 
                 [e.g. dpkg -r storcon]

c) Tarred-Gzipped ( On any Linux system)

	If you are unable to use RPM/DEB format to install the tools then follow
these simple steps :
	1. Change directory to the root directory.
		cd /
	2. Unpack the tarred-gzipped file at the root directory.
		tar zxvf <path-leading-to>/packagename.tar.gz
		 [e.g. tar zxvf srcd-X.YY-Z.i386.tar.gz ]
	3. Soft-link the tool executables to /usr/sbin
		ln -s /usr/iir/storcon-X.YY /usr/sbin/storcon
		ln -s /usr/iir/iircfg-X.YY /usr/sbin/iircfg
		ln -s /usr/iir/srcd-X.YY /usr/sbin/srcd
		ln -s /usr/iir/srcdconf.sh /usr/sbin/srcdconf.sh
	Note: To configure srcd, please additionally run "/usr/iir/srcdconf.sh"
	
###################################################################################
