This page last changed on Aug 09, 2009 by smaddox.
Below are the system requirements and installation instructions for the Atlassian Connector for Eclipse.
On this page:
System Requirements
Version Matrix
The Atlassian Connector for Eclipse is compatible with the following software versions:
|
Atlassian Connector for Eclipse — version 1.1.x |
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)
3.4 (Ganymede)
3.5 (Galileo) |
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
JIRA 4.0 is still in beta and so is not supported.
We will try to work with you if you use the connector on JIRA 4 Beta, but JIRA 4.0 Beta itself is not supported. Please note that the new features of JIRA 4.0 are not reflected in the connector, such as JQL. Existing JIRA 3.x functionality should work when you connect to a JIRA 4.0 server. |
Other Dependencies
The Atlassian Connector for Eclipse makes use of Mylyn's task-focused interface. Mylyn is shipped with the more recent versions of Eclipse. The Atlassian Connector for Eclipse requires Mylyn 3.2.x.
- If you do not already have Mylyn, it will be installed automatically when you install one of the Atlassian Connector's features.
- If you already have Mylyn installed, please check your version of Mylyn. If your version of Mylyn is earlier than 3.2, please upgrade to Mylyn 3.2.x.
- The Atlassian Connector for Eclipse now includes the JIRA Mylyn connector, which was previously available as a JIRA-only connector.
- The Mylyn documentation includes a quick start guide.
- For Crucible reviews and FishEye source repository viewing, the connector integrates with Subversion using Subclipse or Subversive for source control and file retrieval.
 | Note: Install either Subclipse or Subversive integration option, not both When selecting components of the Atlassian Connector for Eclipse, please select either Subclipse or Subversive, not both. (Installation details are below.) Installing one or the other of these two integration options will allow you to make full use of the Atlassian Connector's integration with Crucible for code reviews and FishEye for source repository viewing, when versioning your project under SVN. |
Eclipse Update Sites
Add one of the following URLs to your Eclipse update sites, depending on your version of Eclipse:
There are also weekly update sites available, for those who are keen to get the latest version of the connector. Builds are executed every Sunday at approximately 2am:
Offline Installation
If you cannot use our update site (e.g. due to firewall issues) or just prefer local installation, we offer a zipped version of the entire update site, including the Mylyn dependencies. This installation supports Eclipse 3.4 and 3.5 only.
- First install the Subclipse or Subversive plugin for Eclipse, if you version your project under SVN and if you do not already have one of these plugins installed in your IDE. This will allow you to take advantage of the connector's Crucible and FishEye integration.
- Download the Atlassian connector's archived update site.
- In Eclipse, open 'Help, 'Install New Software', 'Add', click the 'Archive' button and select the downloaded zip file.
- Continue with the installation steps as described for the regular update site — see instructions below.
Please note: In the zipped update site we do not include Subclipse or Subversive. You will need to install them separately before installing Atlassian Connector, if you want to take advantage of the connector's Crucible and FishEye integration.
Installation for Eclipse 3.5 (Galileo)
If you are using Eclipse 3.5 (Galileo), you can install the connector via the Mylyn Connector Discovery wizard or via the Eclipse software updates manager. Both methods are described below.
Installation via Mylyn Connector Discovery Wizard
Mylyn 3.2 introduced the new Connector Discovery wizard that provides simple installation for Mylyn extensions.
The Mylyn Connector Discovery wizard is available in Eclipse 3.5 only.
To install the Atlassian Connector for Eclipse via the Mylyn Connector Discovery wizard:
- Ensure that you have already installed Mylyn 3.2.x. (If you are using an Eclipse package from the Eclipse download site, Mylyn 3.2 is already included in any package except the Classic download.)
- In Eclipse Mylyn, open the 'Task Repositories' view. (In Eclipse, click 'Windows', 'Show View', 'Other' and select the 'Task Repositories' view from the 'Tasks' category.)
- Click the 'Add Task Repository' icon.
- The 'Add Task Repository' screen appears. Click the 'Install More Connectors' button.
- The 'Mylyn Connector Discovery' screen appears, as shown below.
- Select the Atlassian Connector and click 'Finish' to install it.
Screenshot: The Mylyn Connector Discovery wizard

Installation via Eclipse 3.5 Software Updates Manager
To install the connector on a clean Eclipse 3.5 (Galileo) IDE for Java Developers:
- Open the Eclipse software updates manager via 'Help', 'Install New Software'.
- Click 'Add', enter the details of the update site, as shown in the screenshot below:

- Click 'OK'.
- The 'Available Software' screen appears again. Select '-
All Available Sites-' in the 'Work with' dropdown list.
- Select both 'Atlassian Connector' categories. Also select either 'Subclipse' or 'Subversive', depending on which of the two you are using, as shown in the screenshot below:

- Click 'Next' and follow the installation prompts.
- Restart Eclipse when prompted.
Installation for Eclipse 3.4 (Ganymede)
The steps below show the full installation procedure in Eclipse 3.4 (Ganymede):
- 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.
- Open the Eclipse software updates manager via 'Help', 'Software Updates', 'Available Software'.
- Click the 'Manage Sites' button.
- Scroll down to find the 'Mylyn Extras' update site some where near the bottom, enable it and click 'OK'.
- Back on the 'Available Software' tab, click the 'Add Site' button.
- The 'Add Site' dialogue box will appear, as shown in the screenshot below:

Enter the URL of the Atlassian Connector update site:
http://update.atlassian.com/atlassian-eclipse-plugin/e3.4
- Click 'OK'.
- The 'Atlassian Connector for Eclipse' will appear in the list of available software, as shown in the screenshot below:

- Select the required features for the connector:
- Atlassian Connector for Eclipse — Required. This is the core of the Atlassian Connector.
- Bamboo Integration — Allows you to view and manage your Bamboo builds within your Eclipse IDE.
- Crucible and FishEye Integration — Allows you to view and manage your Crucible code reviews within your Eclipse IDE, and to move easily to a FishEye view of your repository.
- CVS Integration — Select this integration option if you version your project under CVS.
- Subclipse Integration — Select this integration option if you version your project under SVN with Subclipse.
- Subversive Integration — Select this integration option if you version your project under SVN with Subversive.
- The installation process will automatically provide the connector's JIRA integration, allowing you to view and manage your JIRA issues within your Eclipse IDE.
- Click the 'Install' button, then click 'Finish' when asked to confirm the installation.
- If prompted, accept the license agreement and click the 'Next' button.
- Restart Eclipse when prompted.
- The Atlassian Connector for Eclipse 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.3 (Europa)
We have not 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 one of these:
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]].
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].
Cannot complete the install because one or more required items could not be found.
Software being installed: Atlassian Connector for Eclipse (recommended) 1.1.0.v20090624 (com.atlassian.connector.eclipse.feature.group 1.1.0.v20090624)
Missing requirement: Atlassian Connector for Eclipse (recommended) 1.1.0.v20090624 (com.atlassian.connector.eclipse.feature.group 1.1.0.v20090624) requires 'org.eclipse.mylyn.jira_feature.feature.group [3.2.0.I20090529,3.3.0)' but it could not be found
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:
- In Eclipse, open 'Help', 'Software Updates'.
- Click the 'Available Software' tab.
- Click 'Manage Sites'.
- Look for either the 'Mylyn Extras' update site or a URL that looks like this:
http://download.eclipse.org/tools/mylyn/update/extras
- Make sure that the site or URL is checked.
- 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
- Make sure that the site or URL is checked.
- Now you should update all installed features to the latest version. Click the 'Installed Software' tab.
- Click 'Update'.
- Restart if prompted.
- Try to install the Atlassian Connector for Eclipse 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 plugins reside for the Atlassian Connector for Eclipse.
Resolution
Follow these steps to clear the cached information:
- Remove the Atlassian update site:
http://update.atlassian.com/atlassian-eclipse-plugin/e3.4
- Add the Atlassian update site again:
http://update.atlassian.com/atlassian-eclipse-plugin/e3.4
- Try to install the Atlassian Connector for Eclipse 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
|