Installation Jira

Admin

How to install Jira
1. Download the lastest Version of Jira from Atlassian http://downloads.atlassian.com/software/jira/downloads/atlassian-jira-enterprise-4.1.1-standalone.tar.gz

2. 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/UNIX:

---SUSE---

/usr/sbin/useradd --create-home -d /usr/local/jira --shell /bin/bash jira

---Debian---

/usr/sbin/useradd --create-home --home-dir /usr/local/jira --shell /bin/bash jira

3. Extract Jira in a folder

tar -xzf atlassian-jira-enterprise-4.1.1-standalone.tar.gz

4. Now we would like to configure Jira for installation on 2 ways, without and with databse.

4.1. On the first way we configure Jira on the standard way. Edit the jira-application.properties (Installation-Dir/atlassian-jira/WEB-INF/classes/jira-application.properties

- Add the home path of your Jira-Installation in the follow variables without ""

jira.home = "Home-Path"

For Example

jira.home = /usr/local/jira-4.1.1

4.2. The second way discribe the installation with a Postgresql Database.

4.2.1 We need to install a postgresql database if we haven't it yet.

---Sles/ Suse--- start Yast2 on and download the postgres server and postgres client

---Ubuntu/ Debian--- sudo apt-get install postgresql-8.2 postgresql-client-8.2

4.2.2 Start the postgres server

4.2.3 Create a Jira user on Postgres

sudo su - postgres

postgres:~$ createuser -P jira Enter password for new role: Enter it again: Shall the new role be a superuser? (y/n) n  Shall the new role be allowed to create databases? (y/n) y  Shall the new role be allowed to create more new roles? (y/n) n  CREATE ROLE

Now create a db with the user jira.

postgres:~$ logout jturner:~$ sudo su - jira jira:~$ createdb jira_41 CREATE DATABASE

4.2.4

In first you can follow the discription of 4.1. or you can start the included configuration script.

Installation-Dir/bin/config.sh

With this tool you can easy configure the postgres server and can test the connection to the server.

5. Start the script to start Jira

6. Now you can install jira in the browser (standard http://domain:8080)

Start Jira
Installation-Dir/bin/startup.sh

Shutdown Jira
Installation-Dir/bin/shutdown.sh

Backup your Jira
1. Login as admin in your Jira-Installation

2. Go to Administration --> Import & Export

3. Backup Data to XML

4. Add the path of the backup at "File name:"

5. Optional you can compress the backup with mark "Backup As Zip"

6. Click on "Backup"

Import a Backup from a old Version
1. Login as admin in your Jira-Installation

2. Go to Administration --> Import & Export

3. Restore Data from XML

4. Add the path of the backup at "File name:"

5. Click on "Restore"

If the follow Error-Message comes, change the variables jira.paths.set.allowed=flase to true in Home-Dir/atlassian-jira/WEB-INF/classes/jira-application.properties

Errors * Changing the attachment, index, backup or restore settings is not allowed for security reasons. You must edit jira-application.properties and explicitly set 'jira.paths.set.allowed=true'. Restart JIRA and then the path settings will be able to be changed.

6. Now you should see the success message.

7. Login with your data from the old jira and you should the all projects.

Now it should run with data from old Jira-Version.