Java Performance Advisor Tool (JPA) Overview :

		The JPA Tool provide recommendations to improve the performance of Java/WAS Processes running on the AIX machine. 
		The recommendations are based on the Java Importance on Machine, Machine usage (Test/Production) and the users' expertise. 
		Detailed usage and command line options can be viewed in the help message ('-h' option).


Setup :

	JPA will be packed in ".zip" format. To install the JPA,run
		$unzip JPA.zip
	
	This will install the JPA in the current working directory. Give execute permission to all files.
		$chmod +x *

	Note:

	Only root user can run this tool.

Steps to run JPA :

       1. Select the java pid which need to be tuned. To list the java process running in the system , run
          	$ps -eaf | grep java
          
          Note: Running the tool without any option generates the list of Java/WAS process running in the machine.
          
       2. Run the jpa tool against the required process by specifying the pid with appropriate settings as listed below.
		 	$jpa.pl [[-e Beginner|Intermediate|Expert] [-u Test|Production] [-i Primary|Secondary] [-o OutputFile] pid]


Usage format:

	jpa.pl [[-e Beginner|Intermediate|Expert] [-u Test|Production] [-i Primary|Secondary] [-o OutputFile] pid]
	
	-e Beginner|Intermediate|Expert
            Beginner
                  Either the person running this tool is unfamiliar with this environment and the workloads running on it or is just starting to perform AIX administration. The recommendations that the tool will make will be conservative and will only recommend the lowest risk options, while flagging the more aggressive options as possibilities.
            Intermediate
                  The person that is running this tool is knowledgeable about the environment and being an AIX administrator. Recommendations will be more aggressive then the administrators in the Beginner category.
			Expert
                  The person running the tool is very knowledgeable about the environment and being an AIX administrator. All recommendations that the tool will make will be verified by the administrator before the setting is changed. Thus, the tool will be the most aggressive on making recommendations and expect the administrator to make judgment calls on each and every recommendation.
	-u Test|Production
            Test
                  This partition is primarily a test partition, thus the performance recommendations can be more aggressive without affecting a production environment.
			Production
                  This partition is being used for production use, thus down-time is not an option. Our recommendations will be less aggressive on a Production environment.
	-i Primary|Secondary
			Primary
                  The job has paramount importance compared to the other jobs on the system. We should make recommendations that could affect other jobs running on the system, if it improves the speed.
            Secondary
                  Although this job is important, there are other jobs that have a higher priority. Any recommendations made should have a small chance of affecting other jobs on the system.
	-o OutputFile
            The output result file.
	
	pid   -   PID of the process which need to be tuned. if no pid is supplied,all JVMs will be shown along with their PIDs.
	
	-h help
    
    -v version


View results :
 
	By default, the jpa writes output to "jpa_output.xml" under the present working directory. It can also be changed to desired name using "-o" options as given in the usage string. The output can be viewed in from a browser. 
	To view the output in a different machine add the output file to the jpa.zip and copy the jpa.zip file to the target machine and open the output file in the browser.		
