Home
ESB
Monitor
Registry
SOAP Client
SOA Model
Support
Downloads
About

Building Membrane Monitor

This document describes how to build Membrane Monitor from source. If you don't need to edit the source code, there are binary distributions available for download.

Note: This document refers to the Helios release of the Eclipse IDE. Menu items, buttons and labels may differ from your installation, but the overall process should be the same.

To set up the Membrane Monitor building environment, you’ll need to:

  1. Download and install the current Eclipse release for RCP developers.
  2. Download and install the Subversion Eclipse plugin.
  3. Check out the Membrane projects from the repository.
  4. Check your Eclipse preferences.
  5. Set the MEMBRANE_HOME environment variable.
  6. Run Membrane Monitor in Eclipse.

1. Download and install the current Eclipse release for RCP developers

  1. Download the latest release of "Eclipse for RCP and RAP Developers" from http://www.eclipse.org/downloads/.
  2. Extract the eclipse-rcp-xxx-xxx.zip file into any directory.
  3. Start Eclipse by double clicking eclipse.exe.
  4. In the following dialog, select your working directory (workspace).
  5. Click on the arrow labeled Workbench.

2. Download and install the Subversion Eclipse plugin

  1. Click on Help and Install new software….
  2. In the dropdown menu select "-All available sites-".
  3. Once the plugin list is loaded, filter it for "Subversive".
  4. Check all Items from the list.
  5. Click on Next, accept the Terms of Licence, click on Finish.
  6. When the installation is finished, restart Eclipse.
  7. After the restart, Eclipse will ask you to install a Subversive Connector.
  8. In the Subversive Connector Discovery dialog, check the latest versions of "SVN Kit" and "Native JavaHL".
  9. Click on Next, accept the Terms of Licence, click on Finish.
  10. When the installation is finished, restart Eclipse.

3. Check out the Membrane projects from the repository

  1. Click on Window, open Perspective, and Other…
  2. Open the SVN Repositories perspective.
  3. Right-click, then select New, and Repository Location.
  4. Type "https://predic8.com/svn/membrane/monitor/" in the URL field.
  5. Use anonymous access: Leave username and password blank.
  6. Click OK and wait for the repository to load.
  7. Expand trunk and select the following four projects:

    com.predic8.membrane.core
    com.predic8.membrane.core.tests
    com.predic8.membrane.plugin.membrane
    com.predic8.rcp.membrane

  8. Right-click, then select Check out.

4. Check your Eclipse preferences

Membrane is compiled with an Java v1.5 compiler.

  1. Click on Window, Preferences
  2. Expand Java, and click on installed JREs.
  3. Make sure a v1.5 or higher JDK is installed.

5. Set the MEMBRANE_HOME environment variable.

Setting environment variables depends on your operating system, but is found in the System application in the Control Panel of most Windows Versions.

  1. Set the MEMBRANE_HOME environment variable to:

    {WORKSPACE}\com.predic8.membrane.core

    where {WORKSPACE} refers to your working directory.
  2. Restart Eclipse.

6. Run Membrane Monitor in Eclipse

  1. Click on Window, and Open Perspective to open the Java perspective.
  2. Expand the com.predic8.rcp.membrane project in the Package Explorer.
  3. Double-click on the membrane_monitor_xxx.product file that correspondents to your operating system.

    Membrane Project in the Package Explorer
    Figure 1: Membrane Project in the Package Explorer

  4. In the Overview page, click on the Synchronize link.
  5. Click on the Launch as an Eclipse Application link.

    Run Membrane Monitor in Eclipse
    Figure 2: Run Membrane Monitor in Eclipse

7. Troubleshooting