NAME
----
Agent data collection tool

SYNOPSIS
--------
oa_data_collector.sh [ -sap [-e pcc]]

DESCRIPTION
-----------

oa_data_collector  is a tool which is designed to collect some basic 
configuration data for an OM managed nodes. This script is only a 
reporting tool. The system which is checked  will not be changed.  All the 
output files are collected in the directory : $OvDataDir/tmp/oa_data/. 
There is also a .gz file of the same directory created with timestamp added. 
The files are in text format. 

Options
-s option to collect system information
-a option to collect agent related info
-p option to run the prerequisite tool dependencies
-e pcc option to exclude performance collection component

Note : By default the script is run with -asp options

FILES
-----

File location on nodes: $OvInstallDir/support/oa_data_collector
	
- Main perl file oa_data_collector.pl
- A shell script oa_data_collector.sh
- The perl module agt_data.pm
- Platdef.pm - OV variables definition file.
- The cfg files : agent.cfg and sys_env_check.cfg
- The prerequisite check binaries.

DATA COLLECTED
--------------

System related information :
- Process listing on the node
- System uptime
- System current environment
- System date
- Mounted Filesystem list
- Environmental variables of the current shell
- List hardware configuration
- Hostname
- Name resolution order
- List of OS patches
- System locale
- System info
- Interprocess communication data
- Show routing table
- Report number of free disk blocks
- Name Service Switch configuration
- Network Interface info
- Show the state of all sockets
- Kernel Parameters
- hosts file configuration
- networks file configuration

Agent / OM product related information :
- Agent and lcore Installation inventory  - ovdeploy -inv -inclbdl 
- Agent process status - ovc -status
- Coreid : ovcoreid
- Agent registration files
- /var/opt/OV/conf/ctrl/*.xml
- Installed policies
- ovpolicy -list -level 4 # Where 4 equals policy type, policy name, status,
  policy version, policy_ID, category, owner, attributes.
- Certificates
- ovcert -list # List installed certificates
  ovcert -certinfo $(ovcoreid) # Show certificate information for local 
  certificate ovcert -certinfo CA_$(ovconfget sec.core.auth MANAGER_ID)
  # Show certificate information for certificate authority (CA).  Note there 
  may be multiple CA certificates.
- OM agent configuration : ovconfget and ovconfget -ovrg server
- Error logs
  /var/opt/OV/log/System.txt*
  /var/opt/OV/log/public/System.txt*
  /var/opt/OV/log/coda.txt*
  /var/opt/OV/tmp/OpC/trace 
- opcsystst -a # Display the hostname, uname,all configured network interfaces,
  local BBC port configuration,mgmt server,resolve and display the IP addresses
  for all displayed node names and resolve and display the node names for all 
  displayed IP addresses.  Finally Display all registered BBC processes.
- coda (Embedded performance component)
- ovcodautil -ping
- ovcodautil -support
- Queue files and queue checks
- Execute the stacktrace tool 
- /opt/OV/contrib/OpC/stacktrace_agt # If exists corefile capture for further 
  examination in HP
- Agent and Lcore Binaries checksum
- Ovclusterinfo cmd output : ovclusterinfo -a
- ovbbccb -reg
- bbcutil -ping

Note : The output of the commands and the actual commands executed when the 
       tool is run is logged in the log files in text format.Customer can 
       edit the log files to remove any unsharable data and recreate the tar
       before sending the data to the lab.


EXAMPLES
--------
      
Check system environment:
	oa_data_collector.sh -s

Check Agent/OV product information:
	oa_data_collector.sh -a 

Run pre-requisite tool :
	oa_data_collector.sh -p

Run the tool with default options ( -sap)
        oa_data_collector.sh