Product Installation

First steps:

  • Make sure to check the System Requirements before installing the product.
  • Make sure Eclipse is not running.
  • GEF is required to be able to use the Call Graph feature.
  • Choose and download an installer. If you're on MS Windows you'll probably use the *.exe installer. In Linux, download the *.bin installer. However, the *.jar installer will work in both platforms that has Java installed.

For installation details, see the following:

Installation using installer

Launch the installer that you downloaded. 

  • In Windows, double-click the installer file.
  • In Linux, first change the permission to be able to execute the file then double-click the installer file. 
    • In graphical user mode, Right-click > Properties > Permissions and give the Owner, Execute permission. Now double-click the installer.
    • In terminal mode, 
      chmod a+x Installer_vXXX_linux_x86.bin
    • then execute
      ./Installer_vXXX_linux_x86.bin
  • Note: If you encounter problems installing, see Problems running the Installer.

The instructions below will walk you through the Install wizards. 

Note: All the installers look about the same, but the paths in the file system will be a bit different for each platform. These examples are taken from the Windows installer.


Welcome

  • Launch the installer
The first page is a Welcome page. It allows you to verify that you are indeed running the correct installer, and gives you a short overview of what is to come.
  • Click Next to move to the next page.
Welcome to Profiler

License Agreement

This is the license agreement. You should read through the agreement. 

  • If you accept it, check I accept (the top radio button). That enables the Next button. 
  • Click Next to continue.
Profiler License Agreement

Installation Directory

  • Choose the directory where you want to the product installed. You only need to install it once even if you want to use it in multiple Eclipse installations. If you need to change the default directory, you can either type it directly or use the Browse button to navigate to the directory.
  • Click Next to continue to the next page.

Installation Directory

Select Eclipse Product

  • The next screen lets you choose which versions of Eclipse you want to install the product. If you have one version installed, it will be selected by default. Please refer to the System Requirements for Eclipse versions supported.
  • If you check Show all Eclipse products, all versions will be searched (that includes 3.0, 2.0, and even WSAD, RAD, and so forth) and included in the list. If the installer can't find the Eclipse installation you want, you can navigate to it by clicking Choose Eclipse. If your installation directory is C:\Program Files\Eclipse 3.x\eclipse, select the \eclipse directory.
  • You can install into as many Eclipse installations at once as you like. They will all share a single product installation. 
  • Click Next to continue.
Select Eclipse

Warning

  • If you have Eclipse running, you will get a warning dialog. Please close Eclipse before clicking Next.


Clean Eclipse Cached Configuration Option

  • This next page gives you the option to clean cached configuration data. It is recommended to clean the configuration information to avoid any configuration conflicts.
  • Click Next to move on to the next page.
Clean Eclipse Cache

Verify Installation

  • You know you're about done once you get to the verification page. Check that everything is the way you want it (if you didn't change anything then it probably is).
  • Click Next to continue.
Verify Installation

Progress Bar

  • The installation page includes a progress bar at the bottom so you have an idea  how long the installation process will take.

Progress

Delete old installations

If you installed a previous version, you will be asked if you want to delete old installations.

To delete, select "Yes, delete the installations listed above" and click Next.
Delete old files

Installation Complete

  • Once installation completes, you will automatically switch to the final page.
  • Click Finish to complete the installation.
Installation Complete



Installation using Zip files

Please make sure you downloaded the correct zip file version for the version of Eclipse you are installing it into.

There are two ways you can install the zip file:

Option 1. Install directly into your Eclipse root directory
  1. Unzip the files into your Eclipse root directory while making sure to preserve the folder structure within the ZIP file. This will add the product features and plug-ins to your existing Eclipse features and plug-in directories.

  2. Before starting Eclipse, delete everything in your \eclipse\configuration directory except for your config.ini file. This is to avoid a common Eclipse 3.x plugin cache bug.
Option 2: Install using a link file
  1. Select a location outside of your Eclipse installation and create an "eclipse" subdirectory.  For example:  C:\Program Files\Instantiations\CodePro Profiler\eclipse. Unzip the files into the "eclipse" subdirectory. This will add "features" and "plugins" subdirectories to the "eclipse" directory.

  2. Next, create a link file (text file) that contains a single line specifying the full path to the product location. Example:  path=C:/Program Files/Instantiations/CodePro Profiler. Save the text file in your main <eclipse>\links directory with a file extension of .link. You may have to create the links subdirectory if it does not exist. Example: c:\dev\eclipse\links\com.instantiations.profiler.link

  3. Before starting Eclipse, delete everything in your \eclipse\configuration directory except for your config.ini file. This is to avoid a common Eclipse 3.x plugin cache bug.
Option 3: Install using an extension location
  1. Select a location outside of your Eclipse installation and create an "eclipse" subdirectory.  For example:  C:\Program Files\Instantiations\CodePro Profiler\eclipse. Unzip the files into the "eclipse" subdirectory. This will add "features" and "plugins" subdirectories to the "eclipse" directory.

  2. Create a .eclipseextension file and save it in your \CodePro Profiler\eclipse directory. The file should have the following content:

    name=
    CodePro Profiler
    id=com.instantiations.profiler
    version=1.1.0

  3. Before starting Eclipse, delete everything in your \eclipse\configuration directory except for your config.ini file. This is to avoid a common Eclipse 3.x plugin cache bug. Launch Eclipse and open Help > Sofware Updates > Manage Configuration. Click Add an Extension Location and browse to where you saved the .eclipseextension file. For example your \CodePro Profiler\eclipse directory. Re-start Eclipse when prompted.


You must Register and Activate the product before you can use it for the first time.