Installing JIRA WAR-EAR

Installing JIRA WAR/EAR

The distribution ZIP file contains an Ant build script to create a deployable EAR or WAR for your particular application server (and any necessary library directories).

The basic set of steps to install JIRA WAR/EAR is as follows:

1. 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. Follow the instructions in the readme.txt file, located in the root directory of the unpacked JIRA distribution. This refers to the server-specific installation guides:
   • Tomcat 6.0.x
   • Tomcat 5.5.x
   • JBoss 4
   • Weblogic 8.1 and 9.x
   • Websphere 6
3. Set your JIRA home directory as described in Setting your JIRA Home Directory.
4. 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. Access JIRA using your web browser and run through the brief Setup Wizard.
6. For production use, please check that your application server is allocated sufficient memory. Java applications claim up to only 64Mb by default, and this usually isn't enough for JIRA. See Increasing JIRA memory for more information.

次のステップ

• Read the JIRA WAR-EAR Configuration Overview. This contains important configuration information, regardless of your application server.
• Refer to the relevant guide for your application server below. If your application server is not listed below, you may be able to find information in the documentation for older versions of JIRA. If you do not have an application server set up yet, we strongly recommend that you use one of the supported application servers below.
  • Tomcat 6.0.x
  • Tomcat 5.5.x
  • JBoss 4
  • Weblogic 9.2
  • Websphere 6.x