Chapter 1.  Overview

1.1.  IC2D Overview

IC2D is a set of tools based on the SWT (Eclipse) technology which allows to monitor and benchmark Java ProActive applications.

It includes the following views:

  • Graphical Monitoring View - A graphical environment for remote monitoring and steering of distributed and grid applications. It provides a graphical visualisation for hosts, Java Virtual Machines, and active objects, including the topology and the volume of communications.

  • Timers Chart View - TimIt plug-in provides a complete solution to benchmark applications' performance. It is able to produce a large variety of statistics, advanced timers with hierarchical capabilities. This powerful feature also provides a graphical representation of multiple events along a timeline.

  • Reports View - CharIt plug-in provides a visual comparative timer view based on pie charts.

1.2.  IC2D Installation

1.2.1.  User Installation

You can download the archive file (a standard zip file) containing IC2D from the Activeeon download page. You will be asked to accept the license agreement and provide a few details including your email address. Within a few minutes you will receive an email containing a password and an URL where you will be able to download the latest release of IC2D.

Uncompress the archive using your favorite ZIP program such as Winzip under Windows or using the tar command under most Linux/Unix systems. Uncompressing the archive creates an IC2D directory and all the files contained in the archive go into this directory and its subdirectories.

Run IC2D from the installation folder to start monitoring. For information on using IC2D read Chapter 2, IC2D: Interactive Control and Debugging of Distribution.

1.2.2.  Developer Installation

IC2D requieres a JVM 1.6 or higher to be compiled.

If you want to develop IC2D or plugins for IC2D the installation steps are the following:

  1. Download and unpack the RCP/Plug-in Developers version of Eclipse.

  2. Install Subversion or your favorite SVN client.

  3. Download ProActive for development through the anonymous or authenticated SVN. The SVN and Eclipse configuration information can be found on the INRIA gForge website.

  4. Go to the compile directory of your ProActive installation directory and compile ProActive by running:

    ./build deploy
  5. Go to the compile directory of your IC2D installation directory and copy the necessary ProActive libraries by running:

    ./build ic2d.libCopy
    [Note] Note

    This command might fail if your ProActive directory does not correspond to the one defined in compile/common.xml.

    <property name="programming.dir" value="${basedir}/../ProActive/" />

    If you are facing this issue, edit this file writing the right location of your ProActive directory (${basedir} corresponds to the root of the IC2D directory).

  6. From the IC2D project, import the IC2D plugin by going to File --> Import.

    Browse for the IC2D src directory.

    The directory is src in the IC2D installation directory.

    Once the plugins loaded, click on the Finish button and Eclipse should look like this:

  7. Install the Business Intelligence and Reporting Tools used by TimIt for profiling. To install go to Help -> Install New Software....

    In the Work with text box, select your eclipse version. Then, you should see the list of available software. Select Birt Intelligence, Reporting and Charting and click on Finish0.

  8. Once the Birt installation finished, go to ic2d.product and click on Synchronize and then click on Launch Application. Don't worry if the launch fails, we will fix that in the next step.

  9. Open the Run Dialog, click on ic2d.product, click on Plugins tab, select all the workspace plugins and click on the Add Required Plug-ins button. then, click on Apply, and then click on Run.

You should have a running IC2D application. Feel free to test it and improve the code.