IDE Connector Documentation

Index
Downloads (PDF, HTML & XML formats)

Skip to end of metadata
Go to start of metadata

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

On this page:

System Requirements

The following platforms are supported for the Atlassian Connector for Eclipse. Please see Supported Platforms - Atlassian Connector for Eclipse for further details.

Atlassian Products

 

JIRA (1)

(tick) 4.4.x, 4.3.x, 4.2.x, 4.3.x, 4.2.x, 4.1.x, 4.0.x, 3.13.x

FishEye (1)

(tick) 2.2.x, 2.1.x, 2.0.x

Crucible (1)

(tick) 2.2.x, 2.1.x, 2.0.x

Bamboo (1)

(tick) 3.1.x, 3.0.x, 2.6.x, 2.5.x, 2.4.x, 2.3.x, 2.2.4

Eclipse IDE

 

Eclipse IDE (2)

(tick) 3.7.x, 3.6.x

Mylyn

 

Mylyn

(tick) 3.6.x

Operating Systems

 

Microsoft Windows (including 64-bit)

(tick) XP/2003/Vista/7

Linux (x86/GTK)

(tick) Ubuntu 10.04
i.e. latest version

Apple Mac OS X

(tick) 10.5+

Notes

  • Eclipse: If you are installing Eclipse from scratch on Windows, please do not use the Windows unzip utility. The archive may extract with errors that are not immediately apparent, that can cause problems with the Atlassian Connector. We recommend that you use WinRAR or 7-Zip instead.
  • JIRA: Ensure that JIRA SOAP/RPC services are running on the JIRA server (i.e. enable the RPC plugin).
  • Mylyn: 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.6, please upgrade to Mylyn 3.6.
  • Subversive/Subclipse (only Connector 2.3 and earlier): 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. The last version of the Connector containing Crucible and Fisheye support is 2.3.0.

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:

Installing a Previous Version

Atlassian does not support older releases of the plugin.

Add the following URL to your Eclipse update sites:

The last version of the connector containing Crucible support is 2.3.0:

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 (only Connector 2.3 and earlier), 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 (the same file for Eclipse 3.6 and 3.7). Use old archived update site for Eclipse 3.5
  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.

(info) 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 (only Connector 2.3 and earlier).

Installation via the Eclipse Marketplace for Eclipse 3.6 (Helios) and 3.7 (Indigo)

If the Eclipse Marketplace Client is available in your Eclipse IDE (Eclipse 3.6 and 3.7), you can also install the Atlassian Connector for Eclipse via this client. Simply launch the Eclipse Marketplace Client ('Help' -> 'Eclipse Marketplace'), search for 'Atlassian' and follow the prompts to install.

Screenshot: Installing the Atlassian Connector for Eclipse via the Eclipse Marketplace Client

Installation for Eclipse 3.6 (Helios) and 3.7 (Indigo)

If you are using Eclipse 3.6 or 3.7, you can install the connector via the Eclipse software updates manager, as described below.

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

  1. Open the Eclipse software updates manager via 'Help', 'Install New Software'.
  2. Click 'Add'. The 'Add Site' window will display.
  3. Enter the details of the update site (see Eclipse Update Sites section above) and click 'OK'.
  4. The 'Available Software' screen will appear again. Select '-All Available Sites-' in the 'Work with' dropdown list.
  5. Select both 'Atlassian Connector' categories. Also select either 'Subclipse' or 'Subversive' (only Connector 2.3 and earlier), 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.

Troubleshooting the Installation

Please refer to the list of installation FAQ:

RELATED TOPICS

IDE Connector Documentation

    1. Jun 22, 2010

      Thank you. Updated.

      Kind Regards,
      Andrew

  1. Jun 30, 2010

    Anonymous

    Could you also provide zipped update site for Helios (3.6)?

    1. Jul 01, 2010

      Hi,
      The same zipped update site works with Eclipse 3.5 and Eclipse 3.6. Just use http://update.atlassian.com/atlassian-eclipse-plugin/e3.5-site-all.zip

      Cheers,
      Wojtek

  2. Jul 06, 2010

    Anonymous

    I'm constrained to using ganymede (Eclipse 3.4). From what your notes indicate above I should stcik to v2.1.0 of the connector, however, doing an update in eclipse wants to bring in v2.2.0. Should I go ahead and do it?

    1. Jul 07, 2010

      Connector 2.2 will not work with Eclipse 3.4 (at least in some places - like JIRA select project wizard page). It may work in other places (like Bamboo, FishEye or Crucible) but try it out at your own risk.

      Older releases are available at update sites with the following URL pattern: http://update.atlassian.com/atlassian-eclipse-plugin/<x.y.z>/e3.4/ (e.g. http://update.atlassian.com/atlassian-eclipse-plugin/2.1.0/e3.4/ for Connector v2.1.0).

      Cheers,
      Wojtek

      Updated: actually I checked that we now sometimes depend on Eclipse 3.5+ API.

  3. Aug 13, 2010

    How do I get the complete source for the Connector 2.2 and all dependent jars (eclipse 3.5)?

    I have svn setup with https://studio.atlassian.com/svn/PLE/trunk but I'm not sure which revision to synch to and if it will get me all dependencies.

    Ivan

    1. Sep 03, 2010

      Hi Ivan,

      Please take a look at https://studio.atlassian.com/wiki/display/PLE/Setting+up+development+environment+for+Atlassian+Connector+for+Eclipse.

      You can find there instruction how to build development environment for Atlassian Connector for Eclipse.

      If you have a question please post a comment there.

      Best,

      Jacek

  4. Nov 18, 2010

    Anonymous

    Hello, I have a problem with installation for Eclipse 3.6.

    On "Review Licenses" screen button Next is disabled.

    I had reviewed all licenses texts and check on "I accept the terms...." button. But it still disabled. Could you help please.

    1. Nov 19, 2010

      Anonymous

      Please ignore this messge

      1. Oct 08, 2011

        Anonymous

        I have the same problem, Next is disabled. What is the solution?

        1. Oct 10, 2011

          Have you checked 'accept license' radio button? Is 'Finish' enabled? If yes then just press it and it will start the installation.

  5. Dec 16, 2010

    Tyring to install atlassian connector from the market place for helios and stuck at 27% for 2hrs. The progress indicator says it is installing software: Fetching org.eclipse.mylyn.commons.soap_3.4.0.v20100608-01...xml/plugins/org.eclipse.mylyn.commons.soap_3.4.0.v20100608-0100-e3x.jar.pack.gz

    Just wondering if the install really takes a long time or something with the install is messed up.

    Cheers,
    Harold

    1. Dec 16, 2010

      Solution was to install the Mylyn Commons first then it all worked.

  6. Mar 03, 2011

    Anonymous

    I install the Connector3.0 successful, but on the "Add task repository" can't see the "'Crucible'" item, only "JIRA" and "'Bamboo'", who can help me on it?

    1. Mar 03, 2011

      Hi,

      Connector 3.0 does not support Crucible anymore. The last version with Crucible support is 2.3.

      Cheers,
      Jacek

      1. Mar 03, 2011

        Anonymous

        I was expecting to see Crucible/FishEye too, since it's in a screenshot in this page and in plugin documentation in several other places.

        1. Mar 04, 2011

          You are right. We will change the screenshot.
          We will also review documentation once again.

          Thanks,
          Jacek

        2. Mar 07, 2011

          I have fixed plugin documentation in several places.

      2. Mar 03, 2011

        Anonymous

        Is Crucible support planned for future releases?

        1. Mar 04, 2011

          At this time we do not plan to restore Crucible integration.

          1. Aug 01, 2011

            Can you explain why Crucible integration was removed and there are no plans to restore it? Thanks.

  7. Mar 28, 2011

    Anonymous

    What version(s) of Crucible are supported by Connector 2.3.0 ?

    1. Mar 29, 2011

      According to the list at the top of the page it works fine till 2.2.x (2.2.3 is the latest). Nevertheless it may work OK with some newer versions up to 2.3.6 but of course there is no guarantee.

  8. Apr 07, 2011

    Anonymous

    Eclipse does not easily give you the version number.  When starting it displays the name such as 'Ganymede'.  If you choose Help/About it also doesn't tell you the version number.  Please add to the install guide how to get the version number, or use the same names that Eclipse uses for the version.

    1. Apr 11, 2011

      Hi,

      Most of Eclipse distros in fact hide the version number. If you cannot see the version string in Help | About (e.g. SDK distros show there the version), click Installation Details and look for the version of "Eclipse Platform" or "org.eclipse.platform" in the text box with all listed plugins.
      Alternatively follow http://stackoverflow.com/questions/2313660/eclipse-version.

      I'll adjust the documentation here to include the names of Eclipse releases in our update site list.

  9. Apr 26, 2011

    Anonymous

    I don't see any mention of JIRA 4.2.x being supported by this connector -- is it supported?

    1. Apr 27, 2011

      Yes. JIRA 4.2.x is supported as well as 4.3.x.

  10. Jul 06, 2011

    Anonymous

    http://blogs.atlassian.com/devtools/2011/02/atlassian-ide-connector-30.html

    Atlassian IDE Connector has zero value without crucible support for me. Absolutely useless. The only feature I used was creating crucible review from eclipse IDE.

    1. Nov 02, 2011

      Anonymous

      Me too.

      Our department just bought 50 licences. Just to find out it doesn't work with newer eclipse versions anymore because these guys dropped the support for it.

      WTF ?!!

      Can anyone suggest an alternative to crucible ? No eclipse integration means we have to switch to another product.

  11. Jul 18, 2011

    Anonymous

    I don't see any mention of Mylyn 3.6 and Eclipse 3.7 ? Will they be soon supported ?

    1. Jul 18, 2011

      They are supported.

      We are switching our continuous integration infrastructure to make it compatible with newest Eclipse and Mylyn. When it is done and all tests pass we will update compatibility information on the page.

      Cheers,
      Jacek

  12. Jul 29, 2011

    Anonymous

    I just installed Indigo and added the weekly update site.  I get this error when I try to install the Atlassian connector:  What am I missing?

    Cannot complete the install because one or more required items could not be found.
      Software being installed: Atlassian Connector for Eclipse (Required) 3.0.1.I20110729-0900 (com.atlassian.connector.eclipse.feature.group 3.0.1.I20110729-0900)
      Missing requirement: Mylyn Connector: JIRA (Compatibility) 3.4.0 (org.eclipse.mylyn.jira_feature.feature.group 3.4.0) requires 'com.atlassian.connector.eclipse.jira.feature.group 3.0.1.qualifier' but it could not be found
      Cannot satisfy dependency:
        From: Atlassian Connector for Eclipse (Required) 3.0.1.I20110729-0900 (com.atlassian.connector.eclipse.feature.group 3.0.1.I20110729-0900)
        To: com.atlassian.connector.eclipse.jira.feature.group [3.0.1.I20110729-0900]
      Cannot satisfy dependency:
        From: Atlassian JIRA Connector (Recommended) 3.0.1.I20110729-0900 (com.atlassian.connector.eclipse.jira.feature.group 3.0.1.I20110729-0900)
        To: org.eclipse.mylyn.jira_feature.feature.group 3.4.0

    1. Jul 29, 2011

      Hy Anonymous,

      Same error here (sad)

      1. Jul 29, 2011

        Resolved

        Try this:

        1. Install Mylyn in a normal way
        2. Restart Eclipse Indigo
        3. Open Planning Perspective
        4. Open Task Repositories View
        5. Right click, and select Add Task Repository
        6. In the opened dialog, click Install More Connectors...
        7. Select Atlassian JIRA
        8. Click Finish and after installation complete, restart Eclipse again.
        9. Use the Atlassian Connector
        10. Pay a beer (wink)

    2. Aug 11, 2011

      The simpler solution which also costs no beer is to explicitly mark JIRA Connector on the 'items to install' list. If you can't find it then uncheck 'group by category' checkbox.

  13. Dec 21, 2011

    Anonymous

    I would like to install the eclipse plug-in on a standalone system (not connected to the network).  Is there a zip file I could download and copy to a thumb drive

    1. Dec 21, 2011

      See "Offline Installation" section on this very page above.

  14. Dec 27, 2011

    FYI: I can install the Eclipse Connector, but when I go to do so, Eclipse complains "Warning: You are installing software that contains unsigned content. The authenticity or validity of this software cannot be established. Do you still want to continue with the installation?"

    Could you please sign your jar files?