IBM Management Processor Command Line Utility 1.01


CONTENTS
--------
1.0  Overview
2.0  Change History
3.0  Installation instructions for Linux/IA32
4.0  Usage instructions
5.0  Common problems and their solutions
6.0  Web Sites and Support Phone Number
7.0  Trademarks and Notices
8.0  Disclaimer


1.0  Overview
-------------
     This tarfile contains the supporting files to run the MP command line utility
     in a Linux environment (referred to as mpcli from now on).
     
     The following packages are pre-requisites and must be installed prior to proceeding:
     
     1) IBM Advanced System Management Device Driver for Linux. (Package name : ibmasm)
     
     Supported Linux distribution(s):
     
     1) Red Hat, versions 6.2 and 7.1
     2) SuSE,    versions 7.1 and 7.2
     

2.0  Change History
-------------------

     
     2.1  IBM Management Processor Command Line Utility, version 1.00
          
          Initial Release.
     
     2.2  IBM Management Processor Command Line Utility, version 1.01
          
          Subsequent release with bug fixes.


3.0  Installation instructions for Linux/IA32
----------------------------------------------

     Prior to proceeding, please ensure that the pre-requisite packages 
     mentioned in Section 1.0 have already been installed.
     
     If this is an upgrade, please remove the previously installation as follows :
        rpm -e mpcli
     

     3.1
     
        Untar the Management Processor Command Line Utility file by 
        typing the following.
      
          tar -xvf mpcli.tar
        
        Please note that the tar file name may be different from the one 
        used in this example.
     
        This step produces the following two files :
     
        1. mpcli/readme.txt file              (that you are currently reading)
        2. mpcli/mpcli-x.x-xx.i386.rpm file    (x.x-xx are version numbers of the rpm)

        
     3.2
        
        Change the directory to the newly created mpcli as follows :
        
          cd mpcli
        
        Install the rpm file as follows :
        
          rpm -ivh mpcli-x.x-xx.i386.rpm
     
     
4.0  Usage instructions
-----------------------

     A sample bash script is provided to execute the utility.
     To execute the Command Line Utility using this script, 
     type the following commands :
      
       cd /opt/IBMmpcli/bin
       ./MPCLI.bsh
     

5.0  Common problems and their solutions
---------------------------------------

     *   You must be either the "root" user, or a member of the 
         "root" group in order to execute the MPCLI.

     *   If you get a "command not found" error, please make sure that you
         are typing commands in the correct case. The commands are case sensitive.
         
     *   If you have trouble executing the above , ensure that the 
         script file (MPCLI.bsh) has execute permissions. You can add execute 
         permissions by typing chmod +x MPCLI.bsh.
         
     *   If you do not have "root" permissions, you may not be able to erase,
         install the rpm package.
                 
     *   More information on supported commands can be obtained by typing help-cmd or
         help-cli in the MPCLI interface. 
         
   5.1 Errata / Known Problems
   ---------------------------

     *   -ipaddress will accept incomplete dotted decimal notation IP addresses.  For
         example,  setip -ipaddress 2  will result in an IP Address of 0.0.0.2 being assigned.
     
     *   When interpreting an input line, the beginning of the line is compared to see if it
         matches an MPCLI global command.  For example,
         logonlocalxyz
         will be interpreted as the logonlocal command.
         
     *   Generic error message given when an invalid option is specified to a command
         without any parameters.  Instead of recognizing an option is invalid, if no
         parameters are specified, then the generic error message will be displayed.
         

6.0  WEB Sites and Support Phone Number
---------------------------------------

     6.1  IBM Support Web Site:
          http://www.pc.ibm.com/support

     6.2  IBM Marketing eServer xSeries Web Site:
          http://www.pc.ibm.com/us/eserver/xseries

     6.3  IBM JAVA Developer Kit Site:
          http://www.ibm.com/java




7.0  Trademarks and Notices
---------------------------

     The following terms are trademarks of the Red Hat Corporation in the
     United States or other countries or both:

          Red Hat



8.0  Disclaimer
---------------
     8.1  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.

     8.2  Note to Government Users

          Documentation related to restricted rights -- Use, duplication
          or disclosure is subject to restrictions set forth in GSA ADP
          Schedule Contract with IBM Corporation.