Visual Performance Analyzer

Operating systems: Windows® XP with SP2 or above, Windows 2000 professional with SP4, Windows 2000 server with SP4; IBM® AIX® 5.3 TL5 or above; Linux® RHEL 5.1 and SUSE 10.1 (x86 and ppc) with kernel 2.6.

Hardware:

• Intel® processor-based desktop or ThinkPad: Intel Pentium® 4 2.0 GHz or Pentium M 1.5 GHz CPU; 512 MB memory
• IBM Power PC® processor-based workstation or server; 512 MB memory
• The default JVM (Java™ Virtual Machine) heap memory size for running VPA is 1024 MB. (In order to change the default memory size, edit the launcher script vpa.ini and change the parameter -vmargs -Xmx1024m to a bigger number.
• Disk space for VPA installation: 80 MB (for the Eclipse update site version), 150 MB (for the RCP version), or 300 MB (for the version bundled with IES); additional disk space required for storing cached database files.

Software:

• IBM JRE 5.0 (with IBM J9)
• IBM DB2 Express Edition 9.1 or above (if you want to use DB2 as the back-end database engine)

Windows

VPA RCP (Rich Client Platform)

The installation instructions for Windows assume that VPA will be installed in the c:\vpa-rcp directory; however, you can install VPA in any directory you want. Please substitute your installation directory for c:\vpa-rcp in the commands that follow.

1. Make a "vpa-rcp" directory, as follows: mkdir c:\vpa-rcp
2. Download the Windows version of VPA RCP to the directory.
3. Change to the directory and decompress, as follows:

   cd /d c:\vpa-rcp
   unzip vpa-rcp-6.4.1-Win32.zip
   

VPA bundled with IES (IBM Eclipse SDK)

The installation instructions for Windows assume that VPA will be installed in the c:\vpa-ies directory; however, you can install VPA in any directory you want. Please substitute your installation directory for c:\vpa-ies in the commands that follow.

1. Download the Windows version of VPA IES.
2. Unzip the zip file to c:\vpa-ies.
3. Run eclipse.exe to launch Eclipse.

VPA Update Site

The installation instructions for Windows assume that VPA will be installed in the c:\vpa-update-site directory; however, you can install VPA in any directory you want. Please substitute your installation directory for c:\vpa-update-site in the commands that follow.

Prerequisites: IBM JRE 1.5.x, Eclipse SDK 3.4.x, GEF 3.4.x, and CDT 5.0.x.
Optional: Parallel Tools Platform (PTP) 2.1 (if you want to install Remote Data Collection)

1. Download the Windows version of VPA update site.
2. Unzip the zip file to c:\vpa-update-site.
3. Lanch Eclipse.
4. Select Help > Software Updates > Find and Install....
5. Choose Search for new features to install and click on the Next button.
6. Click on New Local Site, select c:\vpa-update-site, and click on the OK button.
7. Click on the Finish button.
8. Select the VPA plug-ins to be installed.
9. Restart Eclipse.

Linux and AIX

VPA RCP (Rich Client Platform)

These installation instructions assume that VPA will be installed in the /opt/vpa directory; however, you can install VPA in any directory you want. Please substitute your installation directory for /opt/vpa in the commands that follow.

1. Make a VPA directory, as follows: mkdir /opt/vpa
2. Download the Linux or AIX version of VPA to the directory.
3. Change to the directory, as follows: cd /opt/vpa
4. Decompress the file, as follows:
   • On AIX:

     unzip vpa-rcp-6.4.1-aix.zip
     chmod -R +x /opt/vpa/vpa-rcp
     

   • On Linux:

     tar -zxvf  vpa-rcp-6.4.1-linux-x86.tgz
     

5. In order to run VPA, please enter the following:
   cd /opt/vpa/vpa-rcp
   ./vpa or ./vpa.sh

VPA bundled with IES (IBM Eclipse SDK)

These installation instructions assume that VPA will be installed in the /opt/vpa directory; however, you can install VPA in any directory you want. Please substitute your installation directory for /opt/vpa in the commands that follow.

1. Make a VPA directory, as follows: mkdir /opt/vpa
2. Download the Linux or AIX version of VPA to the directory.
3. Change to the directory, as follows: cd /opt/vpa
4. Decompress the file, as follows:
   • On AIX: unzip vpa-ies-6.4.1-aix-ppc.zip
     chmod -R +x /opt/vpa/vpa-ies
   • On Linux: tar -zxvf vpa-ies-6.4.1-linux-x86.tgz
5. In order to run Eclipse, please enter the following:
   cd /opt/vpa/vpa-ies
   ./eclipse or ./vpa.sh

Note: In order to decompress vpa-ies-6.4.1-aix-ppc.zip on AIX, you must run unzip, which can be downloaded from IBM AIX Toolbox.

After you download unzip-x.xx-x.aix5.1.ppc.rpm, please upload it to AIX and install it with the following: rpm -ivh unzip-x.xx-x.aix5.1.ppc.rpm

For further information, installation tips, and news, please refer to the ReadMe file for AIX Toolbox for Linux Applications.

VPA Update Site

These installation instructions assume that VPA will be installed in the /opt/vpa directory and Eclipse is installed in the /opt/eclipse directory; however, you can install VPA in any directory you want. Please substitute your installation directory for /opt/vpa in the commands that follow.

Prerequisites: IBM JRE 1.5.x, Eclipse SDK 3.4.x, GEF 3.4.3.x, and CDT 5.0.x.
Optional: Parallel Tools Platform (PTP) 2.1 (if you want to install Remote Data Collection)

1. Make a VPA directory, as follows: mkdir /opt/vpa
2. Download the Windows version of VPA update site.
3. Change to the directory, as follows: cd /opt/vpa
4. Decompress the file, as follows:
   • On AIX: gunzip vpa-update-site-6.4.1-aix-ppc.tgz
     tar -xvf vpa-update-site-6.4.1-aix-ppc.tar
   • On Linux: rpm -ivh vpa-update-site-6.4.1-linux-noarch.rpm
5. Lanch Eclipse.
6. Select Help > Software Updates > Find and Install....
7. Choose Search for new features to install and click on the Next button.
8. Click New Local Site, select /opt/vpa/vpa-update-site, and click on the OK button.
9. Click on the Finish button.
10. Select the VPA plug-ins to be installed.
11. Restart Eclipse.

Note: If you use Code Analyzer on AIX, you must do the following before runing Eclipse:
export LIBPATH=/opt/vpa/plugins/com.ibm.vpa.ca.fdprpro.aix_2.2.2/os/aix

For usage instructions, please see the VPA User Guide.