Installation

The JIRA integration shares many components with other ExtraView integrations. You may install several, different integrations together, as long as each is configured appropriately. For example, you might install this software to connect to both JIRA and to Perforce. The installation instructions communicate how to make sure that each integration is pointed to the correct application.

Install Java

Download the latest Java runtime from the Oracle website and install it according to the installer and instructions provided on the website. You may download and install either the J2SE SDK or JRE.

Environment Variables

Set JAVA_HOME as an environment variable in your operating system. The value for JAVA_HOME should be the name of the folder that contains the Java runtime environment

Download and Install the Integration

The JIRA integration files are available from the ExtraView Support Download page. This is at http://www.extraview.com/site/content/extraview-download-upgrades. If you do not have a password to access downloads, please email ExtraView support at support@extraview.com.

Extract the files from the download into a folder on your server. The path to this folder is known in the documentation as INTEGRATION_HOME.

INTEGRATION_HOME/
    configuration/
    data/
    lib/
    logs/
    ExtraViewService.exe
    installIntegrationDaemonService.bat
    start_commands.txt
    start_daemon.bat
    start_daemon.sh
    uninstallIntegrationDaemonService.bat

Microsoft Windows

Edit the start_daemon.bat script with a text editor and make sure that the following lines are configured properly for your environment. For example, the following lines configure the integration daemon to run the JIRA integration as opposed to the Perforce integration:

rem set integration=p4
set integration=jira

Linux

Edit the start_daemon.sh script with a text editor and make sure that the JAVA_HOME and integration variables are configured properly for your environment. For example:

JAVA_HOME=/usr/local/extraview/java
#integration=p4
integration=jira

Next, make the start_daemon.sh script executable with the chmod command. For example:

chmod +x start_daemon.sh

Lastly, ensure that file permissions allow the Linux user executing the start_daemon.sh script to read all the files extracted and have write permission to the following directories and files:

INTEGRATION_HOME/logs/
INTEGRATION_HOME/logs/error.log
INTEGRATION_HOME/data/JIRA/
INTEGRATION_HOME/data/JIRA/state.properties

Installing Integration as a Windows Service

This section only applies if you are installing the JIRA integration on a Microsoft Windows server, and wish to run it as a service.

  1. Edit the installIntegrationDaemonService.bat file in the INTEGRATION_HOME folder
  2. Set the JAVA_DLL_HOME variable to the path of the server directory of the JVM, e.g.,
    set JAVA_DLL_HOME=C:\ExtraView\jdk1.5.0_22\jre\bin\server
  3. Set the INTEGRATION_HOME variable to the path of your INTEGRATION_HOME folder, e.g.,
    set INTEGRATION_HOME=C:\ExtraView\integrationdaemon
  4. Ensure the line set integration=jira is uncommented (i.e., remove rem) and that the line set integration=p4 is commented (i.e., add rem), e.g.,
    rem set integration=p4
    set integration=jira
  5. Save the edited batch file, and run it one time. This will create a new service in Windows called ExtraViewIntegrationDaemon. It defaults to starting automatically, but you can change its startup parameters by using the Services control panel in Windows.