IBM Power Systems LC Server Data Collection Tool

Version: 1.00

Contents
--------
	1.0 Installing the IBM Power Systems LC Server Data Collection Tool
	1.1 Prerequisites
	2.0 Data Collection
	3.0 Version History

	
--------------------------------------------------------------------------	
1.0 Installing the IBM Power Systems LC Server Data Colection Tool

 1. Copy the plc.zip package to a Linux system that has network connectivity 
    to the BMC of the POWER LC server you need to collect data from.
 2. Unzip the plc.zip file
    unzip plc.zip
    The directory should now contain the following files:
    
    led_status.sh
    rawcmd.pl
    README.md
    bmclog.pl
    eSEL2.pl
    plc
    plc.pl
    
    Four directories containing platform specific support will also exist:
    
    P8-ppc64le
    P8-x86_64
    P9-ppc64le
    P9-x86_64

--------------------------------------------------------------------------
1.1 Prerequisites
		
The Linux system used to perform the data collection must have the following 
tool packages installed...
	- ipmitool
	- perl

Note:  sshpass was removed as a pre-requisite for this tool.
--------------------------------------------------------------------------	
2.0 Data Collection

Usage:
  plc.pl { -b bmc_address | -i } [-a admin_pw] [-h host -u user -p password]
   -b BMC hostname or IP address
   -n BMC ADMIN ID if changed from default (ADMIN)
   -a BMC ADMIN password if changed from default (ADMIN)
   -h Linux host address
   -u Linux host user ID
   -p Linux host password
   -i Interactive mode
   -d Output directory
	
From the directory where the plc files were installed run
	plc.pl -b bmc_address 

This assumes that the default password for the BMC ADMIN password is admin,
and the sysadmin password is the default superuser.
	
If the default BMC ADMIN user ID password has been changed then run
	plc.pl -b bmc -a admin_pw 
	
If the default sysadmin ID password has been changed then run
	plc.pl -b bmc -s sysadmin_pw 
	
To collect Linux host logs include the host address, ID and password
	plc.pl -b bmc -h hostaddress -u userID -p userPassword
	
When complete the resulting zip file will be in the following format
bmc-yyyy-mm-dd:hhmm.tar.gz

where bmc is the supplied bmc hostname or IP address

Errors

* If the BMC is not reachable via ping the the plc.pl script will print "Unable to ping bmchostname/IPaddress" and will exit with return code 2.
* If a "command not found" error is returned when running the plc.pl command, try running the command by prepending the command with ./ so that the command is ./plc.pl

--------------------------------------------------------------------------	
3.0 Version History

Date		   Version		Description
2018/05/11   1.00   Data privacy concerns for verbose mode runs, allow use of output directory
2015/12/01	 1.0		Collect /var/log files and add interactive mode
2015/11/01   0.6    Add collect BMC partion data (GA release) 
