This page last changed on Jun 08, 2009 by rosie@atlassian.com.

These instructions will help you install JIRA on Pramati Server 3.5 SP5 and above.

The instructions detail deploying atlassian-jira-2.6.war from the Administration Console of the Pramati Server 3.5 SP5.

On this page:

1. Install JIRA

Download and unzip JIRA (but not with XP's unzipper nor the default tar utility on Solaris). Ensure that you download the WAR/EAR version, not the Standalone version that is recommended on the Downloads page.

Avoid the Windows XP built-in unzip tool! The built-in unzip tool in Windows XP is broken — it silently fails to extract files with long names (see JRA-2153 ). Other users have also reported problems using WinRAR. Please use another tool like WinZIP to unpack JIRA.
Avoid the Solaris default tar utility! On Solaris, please use GNU tar to unpack JIRA in order to handle long filenames. Do not use the Solaris default tar utility.

A new directory containing JIRA will be created, hereafter referred to as $JIRA_INSTALL.

If you are using Linux/UNIX: A dedicated user should be created to run JIRA, as JIRA runs as the user it is invoked under and therefore can potentially be abused. Here is an example of how to create a dedicated user to run JIRA in Linux:
$ sudo /usr/sbin/useradd --create-home --home-dir /usr/local/jira --shell /bin/bash jira


2. Install Pramati Server 3.5 SP5

  1. Execute rundefaultserver.bat from [pramati_install_dir]/server/bin folder. This batch file launches a browser and opens the Pramati Server administration console. Login to the console as the root user.
  2. Click on Configure Resources. Create a JDBC Connection Factory and a datasource (jdbc/JiraDS).
  3. Increase the Content Size for Denial of Service to at least 15MB in Admin Console -> Configure -> Global Properties -> Denial Service.

3. Set JIRA Home

To specify the location of your JIRA Home Directory (note that you need to do this before you build JIRA):

You can specify any location on a disk for your JIRA home directory. Please be sure to specify an absolute path.

Please note that you cannot use the same JIRA home directory for multiple instances of JIRA. We recommend that you do not specify your JIRA home directory inside your installation directory, to prevent information from being accidentally lost during major operations (e.g. backing up and restoring instances).

4. Set mail.mime.decodeparameters

The following system property must be set in order for the JIRA mail handler to work correctly with emails from RFC 2231-compliant mail clients:

mail.mime.decodeparameters=true

System properties are set in different ways depending on your application server.

5. Deploy JIRA

  1. Click on Applications -> Web Applications. Click on the Deploy button, browse to the location of the WAR and deploy atlassian-jira-2.6.war.

It is also recommended to use the Jikes compiler with the Pramati Server. To configure Jikes, please change the following tag in deploy-config.xml present in [pramati_install_dir]/server/nodes/default/config/ folder and re-start the server for the changes to take effect:

<compilation>
  <out-of-process-compilation enabled="true">
    <external-compiler use="jikes" path="C:\jikes-1.18\bin\jikes.exe" />
    <!--options>
    <property name="initial-heap-size-megabytes" value="120" />
    <property name="maximum-heap-size-megabytes" value="200" />
  </options-->
</out-of-process-compilation>
<compilation>
It is also possible to deploy from the server shell or using Pramati Server's deploytool. Please refer to Pramati's deployment guide for information about the different modes for deployment.

6. Access JIRA

The application should be accessible through the URL: http://localhost:8181/atlassian-jira-2.6. Run the Setup Wizard.

User-contributed notes

Have experiences to share with Pramati and JIRA? We welcome your thoughts. Please see the user-contributed Pramati notes.

Document generated by Confluence on Oct 06, 2009 00:31