# Frequently Asked Questions

# General

How to use this plugin?

1. modify/double check that your project.xml has issue tracking url in the following format :

    <issueTrackingUrl>[JIRA URL]/BrowseProject.jspa?id=[JIRA PROJECT ID]</issueTrackingUrl>

Example :

    <issueTrackingUrl>http://jira.codehaus.org/secure/BrowseProject.jspa?id=10450</issueTrackingUrl>

2. Determine the credentials to log into the webserver, if any. The plugin supports basic authentication (and SSL). Add the credentials to the project.properties, as maven.jira.webUser and maven.jira.webPassword

3. Determine the JIRA account to login to the JIRA installation. Add the credentials to the project.properties, as maven.jira.jiraUser and maven.jira.jiraPassword

4. log out of jira (if you are using Remember me feature) and test your setup by going to url like this one:

    [JIRA URL]/secure/IssueNavigator.jspa?view=rss&pid=[JIRA PROJECT ID]&sorter/field=issuekey&sorter/order=DESC&sorter/field=status&sorter/order=DESC&tempMax=1000&reset=true

Example :

    http://jira.codehaus.org/secure/IssueNavigator.jspa?view=rss&pid=10450&sorter/field=issuekey&sorter/order=DESC&sorter/field=status&sorter/order=DESC&tempMax=1000&reset=true

5. add this to your project.xml in reports section

    <report>maven-jira-plugin</report>

6. run maven site (or just maven maven-jira-plugin:report xdoc) and you should have jira.html in your ${basedir}/target/docs directory

My JIRA installation runs SSL with a self signed/home brewn certificate. I get an error message that the certificate is untrusted. How do I proceed?

Add the server certificate to your JAVA. You can get the certificate by exporting it from your browser. With IE you click on the certificate info, go to the details TAB and export as .DER by clicking on 'Copy to File...'. Using SUN's keytool you can import the certificate in your 'truststore'. It is located in $JAVA_HOME/jre/lib/security/cacerts Import it using

    keytool -import -file <servercert>.cer -keystore cacerts