IBM Power Systems LC Server Data Collection Tool

Version: 3.0

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
		plc.pl
		eSEL2.pl
		led_status.sh
		README
		
--------------------------------------------------------------------------
1.1 Prerequisites
		
The Linux system used to perform the data collection must have the following 
tool packages installed...
	- ipmitool
	- perl
	- sshpass

--------------------------------------------------------------------------	
2.0 Data Collection

Usage:
	plc.pl { -b bmc_address | -i } [-a admin_pw] [-s sysadmin_pw] [-h host -u user -p password]
	
	-b BMC hostname or IP address
   	-a BMC ADMIN password if changed from default (admin)
    	-s BMC sysadmin password if changed from default (superuser)
	-f Collect the BMC firmware image
    	-h Linux host address
    	-u Linux host user ID
    	-p Linux host password
	-i Interactive mode
	
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 sshpass is not found on the system then the plc.pl script will print "sshpass is required and not found on this system" and will exit with return code 1.
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
2016/06/03	3.0		Add collection firmware image file
				If chassis power is on do not collect partition data
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) 
