This page last changed on May 26, 2009 by smaddox.

Below are the system requirements and installation instructions for the Atlassian Eclipse Connector.

On this page:

System Requirements

Version Matrix

The Atlassian Eclipse Connector is compatible with the following software versions:

  Atlassian Eclipse Connector 1.0 or later
Bamboo 1.x
2.x recommended
Crucible 1.6 or later
We recommend that you upgrade to the latest version of Crucible 1.6.x or 2.x for best results. However, please note that the new features of Crucible 2.0 are not reflected in the connector, such as iterative reviews, read/unread support, etc. Existing Crucible 1.6.x functionality will work when you connect to a Crucible 2.0 server.
Eclipse 3.3 (Europa) or later
3.4 (Ganymede) recommended
FishEye 1.6 or later
We recommend that you upgrade to the latest version of FishEye 1.6.x or 2.x for best results.
JIRA 3.4 or later
3.7 or later recommended
The connector will work with JIRA 4.0. However, please note that the new features of JIRA 4.0 are not reflected in the connector, such as JQL. Existing JIRA 3.x functionality will work when you connect to a JIRA 4.0 server.

Other Dependencies
  1. The Atlassian Eclipse Connector makes use of Mylyn's task-focused interface. Mylyn is shipped with the more recent versions of Eclipse.

    • If you do not already have Mylyn, it will be installed automatically when you install one of the Atlassian Eclipse Connector's features.
    • If you already have Mylyn installed, please check your version of Mylyn. The Atlassian Eclipse Connector requires Mylyn 3.1.x.
      • If your version of Mylyn is earlier than 3.1, please upgrade to Mylyn 3.1.x.
      • The connector does not support Mylyn 3.2.x, due to the changes in the Mylyn API in that version. If you have Mylyn 3.2, please downgrade to Mylyn 3.1.x.
        Unfortunately, this means that you cannot use the Mylyn weekly releases. You can use only the following Mylyn update sites:
        download.eclipse.org/tools/mylyn/update/e3.4
        download.eclipse.org/tools/mylyn/update/e3.3
        download.eclipse.org/tools/mylyn/update/extras
    • The Mylyn documentation includes a quick start guide.
  2. The Atlassian Eclipse Connector now includes the JIRA Mylyn connector, which was previously available as a JIRA-only connector.
  3. The connector's Crucible review functionality integrates with Subversion using Subclipse for source control and file retrieval.

    Limited Support for Subversive and CVS
    Currently the Atlassian Eclipse Connector provides full support for Crucible code reviews and FishEye repositories only where you version your project under SVN using Subclipse. However, we provide limited support for Subversive with SVN, and for CVS. See Limited Support for Specific SCMs. We intend to add support for other SCMs via the connector's integration with Crucible, so that the connector will support the SCMs which Crucible supports.

Installation in Short

  1. Add one of the following URLs to your Eclipse update sites, depending on your version of Eclipse:
  2. Install all components of the 'Atlassian Eclipse Connector'.

Installation in Detail for Eclipse 3.4 (Ganymede)

The steps below show the full installation procedure in Eclipse 3.4 (Ganymede):

  1. If you already have Mylyn installed:
    • Check your version of Mylyn as described under dependencies above.
    • Open the Eclipse software updates manager via 'Help', 'Software Updates', 'Installed Software' and click 'Update' to get the latest Mylyn updates.
    • Restart Eclipse.

  2. Open the Eclipse software updates manager via 'Help', 'Software Updates', 'Available Software'.

  3. Click the 'Manage Sites' button.

  4. Scroll down to find the 'Mylyn Extras' update site some where near the bottom, enable it and click 'OK'.

  5. Back on the 'Available Software' tab, click the 'Add Site' button.

  6. The 'Add Site' dialogue box will appear, as shown in the screenshot below:


    Enter the URL of the Atlassian Eclipse Connector update site:
    http://update.atlassian.com/atlassian-eclipse-plugin/e3.4

  7. Click 'OK'.

  8. The 'Atlassian Eclipse Connector' will appear in the list of available software, as shown in the screenshot below:


  9. Select all the features for the connector:
    • Bamboo Integration — Allows you to view and manage your Bamboo builds within your Eclipse IDE.
    • Crucible Integration — Allows you to view and manage your Crucible code reviews within your Eclipse IDE.
    • Subclipse Integration — Provides fine-grained integration between Subclipse and Crucible reviews within your Eclipse IDE.
    • The installation process will automatically provide the connector's JIRA integration, allowing you to view and manage your JIRA issues within your Eclipse IDE.

  10. Click the 'Install' button, then click 'Finish' when asked to confirm the installation.

  11. If prompted, accept the license agreement and click the 'Next' button.

  12. Restart Eclipse when prompted.

  13. The Atlassian Eclipse Connector has now been installed. Your next step is to add your Bamboo, Crucible and JIRA task repositories in Eclipse. See Configuring the Eclipse Connector.

Installation for Eclipse 3.5 (Galileo) M7

To install the connector on a clean Eclipse 3.5 M7 'IDE for Java Developers':

  1. Open the Eclipse software updates manager via 'Help', 'Install New Software'.
  2. Click 'Add' and add the update site.
  3. Select 'all available sites' in the editable combo labelled 'work with'.
  4. Select both Atlassian connector categories as well as the Subclipse category.
  5. Click 'Next' and follow the installation prompts.

Installation for Eclipse 3.3 (Europa)

We have not yet included detailed instructions for installation under Eclipse 3.3 (Europa). The screenshot below shows the selection of required dependencies:

Troubleshooting the Installation

Installation Error - Cannot Find a Solution Satisfying the Following Requirements

Symptoms

During installation you may receive an error message similar to this:

Cannot complete the request. See the details.
Cannot find a solution satisfying the following requirements Match[requiredCapability: org.eclipse.equinox.p2.iu/org.eclipse.swt/[3.4.0.v3448f,3.4.0.v3448f]].

Or this:

Cannot complete the request. See the details.
Cannot find a solution satisfying the following requirements org.eclipse.pde.feature.jar [3.4.0.v20080603-7T7U-E_EkMNrNKb39WcMC].

Cause

This is most likely an error from P2 (Eclipse's update mechanism in Eclipse 3.4 and higher). The problem seems to be that the Mylyn update site is not enabled in your copy of Eclipse. There is a bug in Eclipse that these sites may not be automatically enabled even though we specify that we require them for installation.

If any of the installed features have unsatisfied dependencies or if features were previously installed from the extras or incubator update site, P2 may fail with an error similar to the one above.

Resolution

Follow these steps to enable the required sites:

  1. In Eclipse, open 'Help', 'Software Updates'.
  2. Click the 'Available Software' tab.
  3. Click 'Manage Sites'.
  4. Look for either the 'Mylyn Extras' update site or a URL that looks like this:
    http://download.eclipse.org/tools/mylyn/update/extras
  5. Make sure that the site or URL is checked.
  6. Look for either the 'Mylyn For Eclipse 3.4' update site or a URL that looks like this:
    http://download.eclipse.org/tools/mylyn/update/e3.4
  7. Make sure that the site or URL is checked.
  8. Try to install the Atlassian Eclipse Connector again.
More Information

Error while Collecting Items to be Installed

Symptoms

During installation, after the license agreement screen, you may receive an error message similar to this:

An error occurred while collecting items to be installed
No repository found containing: com.atlassian.connector.commons/osgi.bundle/0.5.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.bamboo.core/osgi.bundle/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.bamboo/org.eclipse.update.feature/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.bamboo.ui/osgi.bundle/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.core/osgi.bundle/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.crucible.core/osgi.bundle/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.crucible/org.eclipse.update.feature/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.crucible.ui/osgi.bundle/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse/org.eclipse.update.feature/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.subclipse/org.eclipse.update.feature/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.subclipse.ui/osgi.bundle/1.0.0.I20090320-BETA
No repository found containing: com.atlassian.connector.eclipse.ui/osgi.bundle/1.0.0.I20090320-BETA
No repository found containing: com.thoughtworks.xstream/osgi.bundle/1.3.0.v20090224-1640
No repository found containing: org.apache.commons.io/osgi.bundle/1.3.2.v20080604-1500
No repository found containing: org.jdom_jaxen/osgi.bundle/1.0.0.20081203-1100
No repository found containing: org.joda.time/osgi.bundle/1.6.0.v20081202-0100

Cause

P2 (Eclipse's update mechanism in Eclipse 3.4 and higher) has cached some incorrect information about the update site where the Atlassian Eclipse Connector plugins reside.

Resolution

Follow these steps to clear the cached information:

  1. Remove the Atlassian update site:
    http://update.atlassian.com/atlassian-eclipse-plugin/e3.4
  2. Restart Eclipse
  3. Add the Atlassian update site again:
    http://update.atlassian.com/atlassian-eclipse-plugin/e3.4
  4. Try to install the Atlassian Eclipse Connector again.
More Information

See issue PLE-393 in our bug tracker.

Full List of Installation FAQ

Above we have listed some common problems and their solutions in full. If your problem is not described above, please take a look at the list of installation FAQ, in case additional FAQs have been added since this document was written:

RELATED TOPICS

IDE Connector Documentation


Document generated by Confluence on May 26, 2009 21:04