Task Repositories

What if I’m not using a Task Repository?

Mylyn does not require the use a of a task repository and can be used entirely with the Local Tasks repository that it comes bundled with. However, if working with a team, a shared Task Repository provides the key infrastructure needed to let your team work in a Task-Focused way via Mylyn’s collaborative facilities.

Those not currently using another supported Task Repository should consider the repositories currently supported by Mylyn as well as those supported by the third party Mylyn extensions.

What if Mylyn doesn’t support my task/bug/issue/ticket repository?

To see support for your repository faster, do a search of the open repository connector requests and vote for the corresponding bug if your tracker is there, or create a new bug.

Generic Repository Connector, allows creating Queries to the web-based issue tracking repositories and get list of issues from the web UI into the Task List.

It is also possible to link a local task with the web page in web-based repository via the Mylyn Web integration.

To create a task from any web-based repository:

Why were my repository credentials reset?

If you upgrade Eclipse or your Java VM, you will need to reset your credentials in the Task Repositories view because these are stored in the secure Eclipse workbench keyring. Also see bug 149607. If you are migrating from Eclipse 3.2 to 3.3 note that you will need to use a different update site, which is listed here: http://eclipse.org/mylyn/dl.php

Why are my updated repository attributes not showing up?

Your server’s repository attributes can change frequently, for example, there can be a new "milestone" or "version" added to the Bugzilla repository with each release. When the Preferences → Mylyn → Task List → Synchronization setting is enabled, every 10th synchronization will update the attributes from the repository. If you do not have this setting enabled, your can force the update via the Update Attributes action on the task repositories’ context menu in the Task Repositories view. Note that you will need to reopen a task editor to see the updated attributes. If you instead update via the button on the Attributes section of the Task Editor the attribute settings will be reloaded without needing to reopen.

bugs.eclipse.org users: Note that the attributes listing on eclipse.org is mirrored, and the mirrors are only updated 24 hours. As such, you may need to wait up to 24 hours for the new attributes to show up.

Authentication Troubleshooting

You must ensure repository credentials are filled out correctly. Refer to the diagram below:

right

  1. Enter the repository URL (i.e. https://bugs.eclipse.org/bugs) and an optional label
  2. Credentials
  3. Http Authentication (optional)
  4. Proxy Server Configuration (optional)
  5. Validate Settings

Certificate authentication

Mylyn supports authentication with certificates from a Java keystore. The path and password to the keystore need to be specified in system properties. These can be set in the eclipse.ini in your eclipse install directory:

-vmargs
…
-Djavax.net.ssl.keyStore=/path/to/.eclipsekeystore
-Djavax.net.ssl.keyStorePassword=123456

If your keystore does not have the default type (JKS) you can specify a different type:

-Djavax.net.ssl.keyStoreType=PKCS12

Creating a keystore

If you do not have a client certificate you can create one and have it signed by a CA:

keytool -genkey -keyalg DSA -keysize 1024

Use this command to create a new certificate signing request:

keytool -certreq > client.csr

Submit the client.csr file to your CA for signing. The CA’s certificate as well as your signed certificate that is returned by the CA need to be imported into the keystore:

keytool -importcert -alias ca -file ca.crt
keytool -importcert -file client.crt

See this page for links to the keytool documentation.

NTLM authentication

For NTLM authentication to work a special format for the username needs to be used where DOMAIN needs to be replaced by the Windows login domain:

DOMAIN\username 

The built-in NTLM support of the JDK which is used by Eclipse does not work with Mylyn since it uses the HttpClient library to access repositories. Limitations in regard to NTLM authentication are documented in the NTLM FAQ and also discussion on bug 201911.

If NTLM authentication fails the NTLM Authorization Proxy Server has been reported to work with Mylyn.

Network Troubleshooting

Performance Problems with HTTPS

The built-in SSL support of the JDK will to a name lookup for each new connection. In case your network setup cannot resolve the host name (e.g. no proper name server), this lookup will time out, delaying the whole job. If setting up a name server is not an option, a work around would be to edit your local hosts file, and add the server IP there (and, if possible, add your computer's IP to the server's hosts file).

Error "Received fatal alert: bad_record_mac" when using https

The SSL handshake can fail with some servers and result in an exception when connecting. If you are experiencing a bad_record_mac error set the following system property in the eclipse.ini: -Dorg.eclipse.mylyn.https.protocols=SSLv3

For task hyperlinks in textual editors (e.g. Java editor) and other text viewers (e.g. History view comments) you must associate the project that contains the resource to the task repository.

Project association can also come from 3rd party metadata trough the contrubuted extension point. Subclipse and Maven integration for Eclipse plugins contributing it. See few more details here.

Note that to view a hyperlink you must hold down the Ctrl key when hovering over the reference to the task. References to tasks are connector specific and the common reference is found on the top left of the task editor and other conventions tend to follow those used in the web UI (e.g. “bug 123” for Bugzilla, “ABC-123” for JIRA).