Rally's Eclipse Plugin Installation & User Guide

For developers and testers using the Eclipse framework for application development, the Rally connector for Eclipse provides access to Rally artifacts from within the Eclipse interface.

The artifacts (Rally stories, tasks, and defects) can be viewed or updated, along with viewing and sharing the context of those artifacts through the Mylyn framework, providing a one-stop access to information in Rally without having to leave the Eclipse IDE.

Mylyn (http://www.eclipse.org/mylyn ) is the task-focused UI for Eclipse that reduces information overload and makes multi-tasking easy. It does this by making tasks a first-class part of Eclipse.

Once your tasks are integrated, Mylyn monitors your work activity to identify information relevant to the task-at-hand, and uses this task context to focus the Eclipse UI on the interesting information, hide the uninteresting, and automatically find what is related.

This install guide includes:

Software requirements

The following are the software requirements to use the Rally connector for Eclipse:

  • Eclipse 3.4 or higher.
  • Mylyn (3.12 or higher) installed in Eclipse.

Known Limitations: IDP-initiated SSO isn't supported in Eclipse


  1. Launch Eclipse.
  2. Be sure Mylyn (3.12 or higher) is installed within Eclipse.
  3. Inside Eclipse, click the menu option Help → Install New Software...
  4. Enter the following URL into the Work with: field, and click Add... to create a new task repository:
    • http://www.rallydev.com/integrations/eclipse/update/latest/
    • Note: This address only works inside of Eclipse. If placed into a browser, the URL will not direct you to a page.
  5. Enter a name for the task repository (such as Rally), confirm the URL above is entered in the location field, then click OK.
  6. A new item will appear in the Install Software window named Rally Mylyn Connector.
  7. Check the box next to the Rally Mylyn Connector and click Next .
  8. Click Next again to confirm the installation.
  9. Accept the license agreement and click Finish to complete the installation.
  10. Restart Eclipse for the installation to take effect.

Create a Rally task repository

  1. Launch Eclipse.
  2. Inside Eclipse, click the menu option Windows → Show View → Other.
  3. Inside the Mylyn folder, select both Task Repositories and Task List, then click OK to show these views.
  4. From the Task Repositories window, right-click on Tasks (under Local ) and select Add Task Repository....
  5. Select Rally, then click Next .
  6. Setup password recovery at this point if so desired.
  7. In the Add Task Repository... window, enter information into the corresponding fields:
    • Server:,
    • Login Method:,
    • User ID: (your full rally Username even if using "Rally Single Sign-On"),
    • Password: (if Login Method is not "Rally Single Sign-On").
  8. Click Validate Settings to confirm your settings are valid.
    • If Rally Single Sign-On was selected above for the Login Method:, then an SSO login window will appear. Enter your SSO credentials.
  9. Click Finish to add Rally to the Task Repositories list.
  10. If you are prompted to create a query, then do so.

Create a query

  1. On the Task Repositories tab, right-click on the Rally repository you created and select New Query.
  2. Select Tasks & Stories, or Defects.
  3. Select the owner to filter.
  4. Select the workspace, project, iteration, and owner to display after the query is run.
  5. Click Finish to create the Query.

View the Rally Dashboard

  1. On the Eclipse toolbar, click Open Rally Dashboard.
  2. On the Rally Dashboard tab, select the task repository you would like to query.
  3. On the Rally Dashboard tab, select the query you would like to run.
  4. Results will display on the Rally dashboard.

To create an Open Rally Dashboard button on the Eclipse toolbar:

  1. To add a command icon for the plugin, choose Window → Customize Perspective.
  2. From the Command Groups Availability tab, select the Rally checkbox.
  3. The icon displays at the top of your environment in the toolbar.


When working with Support, you may need to provide a log file for the Eclipse plugin in order to help isolate the root cause.  The log files are located in Tasktop application folder.

If you are using Eclipse, this is in <path to workspace>\.metadata\.log

  • Windows Vista and above:
    • C:\Users\\AppData\Roaming\Tasktop\workspace\.metadata\.log
  • Windows XP:
    • C:\Documents and Settings\\Application Data\Tasktop\workspace\.metadata\.log
  • Mac:
    • /Users/Your-User-Name/Documents/workspace/.metadata/.log
  • Linux:
    • /home//.tasktop/workspace/.metadata/.log


Need more help? The Rally Community is your one-stop shop for self-service and support. To submit feedback or cases to Rally Support, find answers, and collaborate with others, please join us at rallycommunity.rallydev.com.
© 2015 Rally Software Development Corp | Legal