CA Agile Central's Eclipse Plugin Installation & User Guide

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

The artifacts (CA Agile Central 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 CA Agile Central without having to leave the Eclipse IDE.

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 CA Agile Central 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:
      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 CA Agile Central), 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 CA Agile Central Mylyn Connector.
  7. Check the box next to the CA Agile Central 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 CA Agile Central 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 CA Agile Central, 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 CA Agile Central Username even if using CA Agile Central Single Sign-On),
    • Password: (if Login Method is not CA Agile Central Single Sign-On).
  8. Click Validate Settings to confirm your settings are valid.
    • If CA Agile Central 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 CA Agile Central 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 CA Agile Central 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 CA Agile Central Dashboard

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

To create an Open CA Agile Central 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 CA Agile Central 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 CA Agile Central Community is your one-stop shop for self-service and support. To submit feedback or cases to CA Agile Central Support, find answers, and collaborate with others, please join us at