Install Guide
| 
PDF |
JIRA is distributed in two different formats.
-
Standalone - Bundled with an application server and database, the standalone version runs out
of the box, once you have installed Java.
-
WAR/EAR - Deployable as a WAR or EAR inside any J2EE application server or servlet container
(for which you need Java, a new or existing application
server and database).
|
1. Installing JIRA Standalone
| |
| | |
Installing JIRA Standalone is very simple:
- Unzip the downloaded file (Notes: avoid WinXP unzip! Solaris users will need
to use GNU tar to handle the long filenames.)
- Run the startup script:
- On Windows, run bin/startup.bat (try bin/catalina.bat run if that immediately
exits), or
- On Unix/Linux, run bin/startup.sh. Logs will be written to logs/catalina.out.
- Point a web browser at http://localhost:8080, where you should see the
setup wizard.
If something goes wrong, please verify that Java is installed correctly. If the
problem persists, please contact us - we're happy to help.
Assuming everything works, where to from here?
|
2. Installing JIRA as a 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:
-
Download and unzip JIRA (but not with XP's
unzipper) if you have not already done so.
- Follow the instructions in the readme.txt file, located in the root directory of the unpacked
JIRA distribution. This refers to the server-specific install guides.
- Access JIRA using your web browser and run through the brief setup wizard.
|
Avoid Windows XP's 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.
