Install and setup a standalone version of Framesoc using the update site

Summary

This page describes how to install a standalone version of Framesoc using the update site. The procedure described has been tested under Eclipse Luna (4.4).

Requirements

• Java JRE 7
• [optional] MySQL server (optional, since Framesoc uses by default SQLite, which is an embedded DBMS)

Install

• Download Eclipse (version 4.4 or higher) and extract the corresponding archive (http://www.eclipse.org/downloads/)
• Install Framesoc features:
  • From the Eclipse main menu: Help > Install New Software...
  • Type the following address in the text field Work with:
    • http://soctrace-inria.github.io/updatesite/
  • Select the feature(s) you want to install
  • Press Next and follow the wizard (accept the license and finish the installation).
  • At the end of the installation, Eclipse will ask for restart.

Setup

• After the restart following a fresh installation, a configuration wizard will automatically pop up to perform the initial configuration.
• If no wizard is shown (because, for example, you already had a soctrace.conf configuration file in your Eclipse installation directory), do the following:
  • Launch the Framesoc perspective: Windows > Open Perspective > Other... > Framesoc
  • Launch the wizard:
    • Menu Framesoc > Preferences
    • Select the Database tab
    • Press the Launch DBMS Configuration button

Java Heap Issue

In order to be able to use Framesoc you might need to increase the maximum amount of memory available for the JVM, setting it to at least 4096 MB for best performance. To do this, you need to:

• Open the eclipse.ini file in the root directory of your eclipse installation

• Look for a line containing the -Xmx variable, like the following:

  -Xmx####m (#### is the current value of maximal memory in MB)

• Replace #### with at least 4096, in order to get the following line:

  -Xmx4096m