This page last changed on Mar 15, 2010 by alui.

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

On this page:

System Requirements

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

  Atlassian Connector for Eclipse
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.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
Ensure that JIRA SOAP/RPC services are running on the JIRA server (i.e. enable the RPC plugin)
Mylyn

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 or Mylyn 3.3.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.3.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.
Subversion 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.
CVS The connector provides limited support for CVS.
Perforce
The connector does not currently support Perforce.
Although Crucible supports Perforce as a source repository, the Atlassian Connector for Eclipse does not currently support Perforce. This means that you will not be able to use the close integration between your Crucible reviews and your source directly in Eclipse. If you need it, please vote for this feature to help us prioritise the backlog.
Eclipse 3.3 (Europa) is no longer supported

Please note that, effective from version 1.3 of the Atlassian Connector for Eclipse, the connector will no longer support Eclipse 3.3 (Europa). We recommend that you upgrade your Eclipse platform to get the best benefit from Eclipse Mylyn and the Atlassian Connector for Eclipse.

Eclipse Update Sites

Add the following URL to your Eclipse update sites:

There is also a weekly update site 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.

  1. 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.
  2. Download the Atlassian connector's archived update site.
  3. In Eclipse, open 'Help, 'Install New Software', 'Add', click the 'Archive' button and select the downloaded zip file.
  4. 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 Eclipse software updates manager, as described below.

To install the connector on a clean Eclipse 3.5 (Galileo) IDE for Java Developers:

  1. Open the Eclipse software updates manager via 'Help', 'Install New Software'.
  2. Click 'Add', enter the details of the update site, as shown in the screenshot below:


  3. Click 'OK'.
  4. The 'Available Software' screen appears again. Select '--All Available Sites--' in the 'Work with' dropdown list.
  5. 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:


  6. Click 'Next' and follow the installation prompts.
  7. Restart Eclipse when prompted.

Installation 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 Connector update site:
    http://update.atlassian.com/atlassian-eclipse-plugin/e3.4

  7. Click 'OK'.

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


  9. 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.

  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 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.

Troubleshooting the Installation

Please refer to the list of installation FAQ:

RELATED TOPICS

IDE Connector Documentation


Document generated by Confluence on Mar 17, 2010 21:17