LibraryPrintFeedback

Installation Guide

Version 2.0

July 2011

Copyright © 2011 FuseSource Corporation, a Progress Software company. All rights reserved.

Legal Notices

Updated: 15 Nov 2011

Table of Contents

1. Prerequisites
2. Supported Platforms
3. Installing Fuse IDE
4. Licensing Fuse IDE
5. Upgrade Fuse IDE
6. Removing Fuse IDE
A. Configuring Fuse IDE to Use Maven Proxies

List of Figures

3.1. Fuse IDE installation details
3.2. Fuse IDE installation details
5.1. Software update dialog

List of Tables

A.1. Maven proxy configuration elements

List of Examples

A.1. Minimum Maven configuration file
A.2. Maven configuration for a proxy

Chapter 1. Prerequisites

Fuse IDE requires a Java 6 JDK.

You can download Java 6 from http://www.oracle.com/technetwork/java/javase/downloads/index.html.

Fuse IDE works with the following versions of Eclipse:

[Important]Forcing Eclipse to use the JDK

By default Eclipse uses your system's PATH setting to determine which Java VM to use. If you have multiple Java VM's installed on your system, this can result in Eclipse choosing an unsupported VM.

We recommend explicitly configuring your Eclipse installation to use the VM from a Java 6 JDK. You configure the VM used by Eclipse by adding the following two lines to your eclipse.ini file:

-vm 
JDKInstallDir/bin/javaw.exe

Chapter 2. Supported Platforms

Fuse IDE is supported on the following operating systems:

  • Windows XP SP3

  • OS X 10.5 or greater

  • Linux

    [Warning]Warning

    The icons on the context menus do not appear on Ubuntu 9.10. To resolve this issue run:

    gconftool-2 --type boolean --set /desktop/gnome/interface/menus_have_icons true

Fuse IDE can deploy routes into the following containers:

The routes generated using Fuse IDE will work with Apache Camel 2.7.1-fuse-00-27 and newer.

Chapter 3. Installing Fuse IDE

Fuse IDE is installed from the FuseSource Eclipse update site. You will need to add the update site to your list of available software sites before installing.

Before you can install Fuse IDE you need to add the update site to the list of available software sites. To add the update site:

  1. Select Help|Install New Software....

    The Install wizard opens.

  2. Enter http://repo.fusesource.com/ide/ in the Work with: field.

  3. Click Add....

    The Add Repository dialog opens.

  4. Enter a name for the new site in the Name: field.

  5. Click OK.

    The Add Repository editor closes.

The name of the new software repository appears before the URL entered in the Work with: field. Fuse IDE will appear in the table at the bottom of the editor.

To install Fuse IDE:

  1. Select Help|Install New Software....

    The Install wizard opens.

  2. Enter the name of the FuseSource software site into the Work with: field.

    [Tip]Tip

    You can use the drop down list to select the software site.

    As shown in Figure Figure 3.1, Fuse IDE for Camel will appear in the table at the bottom of the editor.

    Figure 3.1. Fuse IDE installation details

    eclipse install new software wizard with IDE listed

  3. Place a check in the box next to Fuse IDE.

  4. Click Next>.

    The Install Details page, shown in Figure 3.2, opens and lists Fuse IDE.

    Figure 3.2. Fuse IDE installation details

    eclipse install new software wizard with IDE listed

  5. Click Next>.

    The Review License page opens.

  6. Read the license agreements.

  7. Select I accept the terms of the license agreement.

  8. Click Finish.

    The software installs.

  9. If you are warned about installing unsigned packages, accept the FuseSource certificates and continue the installation.

  10. When asked to restart Eclipse click Restart Now.

    Eclipse will shutdown and then restart. When it restarts, Fuse IDE will be available.

Chapter 4. Licensing Fuse IDE

Fuse IDE can be downloaded for free and taken for a test drive. However, some of the advanced features are unavailable without a FuseSource subscription.

Features that require a subscription include:

[Tip]Tip

To obtain a trial license fill out the form at http://fusesource.com/contact.

In most cases, Fuse IDE can download your licence and install the license in a single step.

However, if your firewall or proxy settings do not allow Eclipse to connect to the FuseSource Web site and download the license, you can download the license from a Web browser and install it manually.

To register your version of Fuse IDE:

  1. Select Window|Preferences from the Eclipse menu.

    The Eclipse Preferences editor opens.

  2. Select Fuse IDE|Subscription.

    The Fuse IDE Subscription preference panel appears.

  3. In the Name field, enter the name associated with your FuseSource subscription.

  4. In the Password field, enter the password for your FuseSource subscription.

  5. Click Download Subscription License to add the license to Fuse IDE.

If your license is successfully downloaded, the expiration date will appear in the Expiration Date field.

To manually download your license and register Fuse IDE;

  1. In a Web browser, open http://fusesource.com/account.

  2. Enter your username and password.

  3. Click Login.

    You will be taken to your FuseSource account page.

  4. Scroll down to the Subscriber section of the page.

    You should see a link entitled Download Subscriber License.

  5. Click the Download Subscriber License link.

    A file called license.key is downloaded to you computer. This file contains the license needed to register Fuse IDE.

  6. Start Eclipse.

  7. Select Window|Preferences from the Eclipse menu.

    The Eclipse Preferences editor opens.

  8. Select Fuse IDE|Subscription.

    The Fuse IDE Subscription preference panel appears.

  9. Click Install License File.

    A file explorer will open.

  10. Locate and select the downloaded license.key file.

  11. Click Open.

A dialog window telling you the license has been installed appears and the Expiration Date field on the Fuse IDE Subscription preference panel will display your the expiration date of your license.

Chapter 5. Upgrade Fuse IDE

Once Fuse IDE is installed you can check for updates and install them using the standard Eclipse update mechanism.

To check for updates to Fuse IDE:

  1. Select Help|Check for Updates.

    If there are updates a dialog similar to Figure 5.1 will open.

    Figure 5.1. Software update dialog

    software updates are available

  2. Ensure that Fuse IDE is checked.

  3. Click Next>.

    The Update Details page opens.

  4. Ensure that Fuse IDE is listed.

  5. Click Next>.

    The Review Licenses page opens.

  6. Read the license agreement.

  7. Select I accept the terms of the license agreement.

  8. Click Finish.

    The software installs.

  9. If you are warned about installing unsigned packages, accept the FuseSource certificates and continue the installation.

  10. When asked to restart Eclipse click Restart Now.

    Eclipse will shutdown and then restart. When it restarts, the new version Fuse IDE will be available.

[Warning]Warning

On occasion the update will fail. To recover you will need to uninstall Fuse IDE, as described in Removing Fuse IDE, and then reinstall Fuse IDE , as described in Installing Fuse IDE.

Chapter 6. Removing Fuse IDE

Fuse IDE can be removed using the standard Eclipse method for uninstalling features.

To remove Fuse IDE:

  1. Open the About Eclipse dialog.

  2. Click Installation Details.

    The Eclipse Installation Details dialog opens.

  3. Select the Installed Software tab.

  4. Select Fuse IDE from the list of installed software.

  5. Click Uninstall....

    The Uninstall Details dialog opens with Fuse IDE listed.

  6. Click Finish.

    Fuse IDE will be removed.

  7. Click Restart Now to restart Eclipse.

Appendix A. Configuring Fuse IDE to Use Maven Proxies

If you access Maven repositories using proxies, you will need to ensure that Fuse IDE is configured to use the correct proxies. Fuse IDE can use the same Maven configuration as your command-line installation or Fuse IDE can use an alternate Maven configuration.

By default, Fuse IDE's Maven integration looks for its configuration in userHome/.m2/settings.xml. For example on Windows XP the default location would be c:\Documents and Settings\jdoe\.m2\settings.xml. On OS X the default location would be /Users/jdoe/.m2/settings.xml.

To configure Fuse IDE to use a Maven proxy:

  1. Add the proxy settings to your Maven configuration file.

  2. Configure Fuse IDE's Maven tooling to use the configuration file containing the proxy settings.

Maven stores user configuration information in an XML file. By default, Maven and the Fuse IDE Maven tooling look for the file in the user's .m2/settings.xml file. The Fuse IDE Maven tooling can be configured to use a different Maven configuration file if needed.

Because this is a user specific configuration file, this file is not created when Maven or the Fuse IDE Maven tooling is installed. If it does not exist, you will need to create it. Example A.1 shows the minimum required entries for a Maven configuration file.

Example A.1. Minimum Maven configuration file

<settings xmlns="http://maven.apache.org/SETTINGS/1.1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">
  ...
</settings>

To configure Maven to use a proxy you add a proxies element to the settings file. The proxies element is a container for one or more proxy elements that configure individual proxy instances.

The proxy element uses the children described in Table A.1 to provide the information for a proxy.

Table A.1. Maven proxy configuration elements

ElementDescription
activeSpecifies if the proxy is active.
protocolSpecifies the protocol used by the proxy.
hostSpecifies the proxy's host address.
portSpecifies the port on which the proxy listens.
usernameSpecifies the username, if required, to access the proxy.
passwordSpecifies the password, if required, to access the proxy.
nonProxyHostsSpecifies a | separated list of hosts for which the proxy can be bypassed. The addresses can include wild cards.

Example A.2 shows a sample proxy configuration.

Example A.2. Maven configuration for a proxy

<settings ... >
  ...
  <proxies>
    <proxy>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy.sample.fusesource.com</host>
      <port>8080</port>
      <username>proxyuser</username>
      <password>somepassword</password>
      <nonProxyHosts>www.google.com|*.fusesource.com</nonProxyHosts>
    </proxy>
    ...
  </proxies>
  ...
</settings>

Complete documentation for the Maven configuration file can be found at http://maven.apache.org/guides/mini/guide-configuring-maven.html.

To specify the Maven configuration file and reload your user configuration:

  1. Select Windows|Preferences.

    The Eclipse Preferences editor opens.

  2. Select Maven|User Settings.

  3. Enter the full path to your Maven configuration file in the User Settings: field.

    [Tip]Tip

    The Browse button will open a file browser to help you locate the file.

  4. Click Update Settings to load the new configuration from the configuration file.

  5. Click OK to close the Preferences editor.