OSEE/Workspace Setup

This guide describes how to set up an Eclipse workspace to develop OSEE.

Downloading and Configuring Eclipse

Install Eclipse

Download and install the Eclipse Classic Download available at the bottom of this page.

Install Plugins

Eclipse has a number of dependencies on third-party plugins. Some of these can be installed in an automatic fashion through Eclipse, while others have to be installed manually.

Eclipse Update Sites

Open the Install utility (Help > Install New Software...).

• Install the Lowagie iText plugin:
  • Enter http://download.eclipse.org/releases/ganymede/site.xml in the Work with: field and press Enter.
  • Enter "lowagie" as the filter text.
  • Select the Lowagie iText Feature.
  • Press Next and follow the instructions on screen to install the plugin and restart Eclipse.
• SVN Connectors:
  • Work with: http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/
  • Leave the filter blank.
  • Select SVNKit 1.3.0 Implementation (Optional).
  • Install and restart.
• SVN PDE Build:
  • Work with: http://download.eclipse.org/technology/subversive/0.7/pde-update-site/
  • Select featureName under SVN PDE Build Extension. Install and restart.
• Install GEF:
  • Go to http://www.eclipse.org/gef/downloads/ and download the All-In-One Update Site.
  • In Eclipse, go to Help > Install New Software... > Add...
    • Click Archive... and select the .zip file retrieved from the GEF download page.
    • Select:
      • Graphical Editing Framework Draw2d SDK
      • Graphical Editing Framework GEF SDK
      • Graphical Editing Framework GEF Zest Visualization Toolkit
    • Install and restart.

Manually Installed Plugins

These plugins must manually be installed to the Eclipse folder or the Eclipse plugin folder.

• Install BIRT:
  • From http://download.eclipse.org/birt/downloads/
  • Click the yellow framework button to download the BIRT report Framework
  • Extract the zip file and use local install from the Update Manager
  • Select the feature "BIRT Chart Framework"
• Download org.eclipse.nebula.widgets.calendarcombo_1.0.0.jar from http://www.eclipse.org/nebula/downloads.php
  • Manually install org.eclipse.nebula.widgets.calendarcombo into your <workspace-path>/sandbox/plugins folder
• Manually install derby.driver plugin project into your <workspace-path>/sandbox/plugins folder

Windows-specific Configuration

• Install the CVS executable: http://ftp.gnu.org/non-gnu/cvs/binary/stable/x86-woe/
• Get Subversion Binaries: http://subversion.tigris.org/getting.html
• Put SVN and CVS in the path:
  • On Windows:
    • Go to Control Panel > System > Advanced > Environment Variables and scroll down to Path in the second combo box.
    • Click Edit.
    • Add the paths to the SVN bin directory and the CVS install directory. Paths are semicolon-delimited.
• Configure SVN's proxy settings:
  • In Explorer, open the %APPDATA%\Subversion folder.
  • Edit the servers file in Wordpad.
  • At the bottom, under [global], enter your proxy host and port. For example:

[global]
http-proxy-host = www-my-proxy.mydomain.com
http-proxy-port = 99999

SVN Checkout

Download and import the OSEE Team Project Set file into your workspace.

In Eclipse, open the SVN Repository perspective and check out https://dev.eclipse.org/svnroot/technology/org.eclipse.osee/trunk/. The username and password can be left blank for anonymous read-only access.

Configure a Development Runtime

Using an SVN client such as Subversive, check out into your Eclipse workspace all the projects from https://dev.eclipse.org/svnroot/technology/org.eclipse.osee/trunk/. When configuring this SVN repository leave the user name and password blank in order to get anonymous, read-only access.

1. Follow the PostgreSQL installation instructions.
2. Use the configuration /org.eclipse.osee.support.config/launchConfig/OSEE Demo Application Server [localhost].launch to run an OSEE application server
3. Use the configuration /org.eclipse.osee.ats.config.demo/MasterTestSuite_DemoDbInit.launch to initialize an OSEE database
4. Use the configuration /org.eclipse.osee.ats.config.demo/MasterTestSuite_DemoDbPopulate.launch to populate the database for demonstration purposes
5. Use the configuration /org.eclipse.osee.support.config/launchConfig/OSEE Demo product [localhost].launch to run a local OSEE client