## General

### What is pugua and how the heck to do you pronounce it?

Pugua (pronounced pooh-gwah or pooh-gwaa) is the Chamorro name for the betel nut.

### What is JiraBuddy?

JiraBuddy is a Jira plug-in for Eclipse developed by PuguaSoft. It provides various features such as Jira issue summary "hover" and opening Jira tickets in the Eclipse web browser. For more information on JiraBuddy, check out the features page. JiraBuddy is free and released under the Eclipse Public License - v 1.0.

Unlike the Eclipse plugin being development by Atlassian, JiraBuddy is not meant to be a full-fledged replacement to create or update JIRA bugs in Eclipse. Rather, JiraBuddy was created to add various enhancements within Eclipse in order to make JIRA more useful and helpful to developers.

## Setup & Installation

### I'm having trouble connecting to a JIRA server with HTTPS/SSL.

Please see the next question, I'm getting a javax.net.ssl.SSLHandshakeException..., if you are getting the following Java exception:

javax.net.ssl.SSLHandshakeException:
sun.security.validator.ValidatorException: PKIX path building failed:
sun.security.provider.certpath.SunCertPathBuilderExceptoin: unable to find valid certification path to requested target

If you are getting another error or exception, please contact development [at] jirabuddy.com with a detailed descriptoin.

### I'm getting a javax.net.ssl.SSLHandshakeException error with the following dialog:

This error can occur if you are trying to connect to a JIRA server over HTTPS/SSL that is using a self-signed certificate or a certificate that was otherwise signed by a CA (certificate authority) that is not contained in the default trusted CA's by your JVM. To solve this problem, you need to add your JIRA server certificate to the your JVM certificate keystore. Java includes a command named keytool for this purpose. Here is what you need to do:
1. First, you need a copy of the JIRA server certificate. Using your web browser, save the JIRA server certificate as JiraServer.cer.
2. Next, you need to determine the JRE you are using when you run Eclipse.  From the Eclipse menu bar, click on Help > About Eclipse Platform and click on Configuration Details.  Go through the configuration details until you see the java.home=/path/to/java property.  Keep note of the entire path to the JRE.
3. In a command line/terminal session, set the JAVA_HOME environment variable to the JRE path in Eclipse:
1. Windows: set JAVA_HOME=C:\path\to\java
2. Linux: export JAVA_HOME=/path/to/java
3. OSX: export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home
4. Now, you can import the server certificate into your default trusted certificate for the JVM:
$sudo keytool -import -alias some_unique_name -file JiraServer.cert -keystore$JAVA_HOME/lib/security/cacerts
Enter keystore password:  changeit
Trust this certificate? [no]:  yes
Certificate was added to keystore

The example command is for Linux and OSX and shows the usage of sudo if the JVM default keystore requires root to update it.  Windows users would not need sudo and would replace \$JAVA_HOME with %JAVA_HOME%. The default password for the JVM certificate store is changeit.  Once the certificate is added to the keystore, you will need to restart Eclipse after which JiraBuddy should be able to connect to the JIRA server over HTTPS/SSL.

NOTE: Some of the info above was taken from CollabNet's Eclipse FAQ.