Install Jira Agile Project Management On Ubuntu 20.04

In this tutorial, you’ll learn that how to install Jira Agile Project Management on Ubuntu 20.04. JIRA is a project management tool that can be used in the Customer & Support services for tracking, generating & to see the status of the tickets. It is commercial product & available as a trial version for limited time. The main functions of JIRA are Bugs & defect managing, advance reports, search & filtering, custom workflows, dashboards, advance security & administration. Simply follow the below steps to install JIRA on Ubuntu 20.04.

Step 1: Update Your System

First of all update your system to have the latest updates installed.

sudo apt update && sudo apt upgrade -y

Once updated, reboot your system.

sudo reboot

Step 2: Install & Configure MariaDB Database Server

As JIRA uses MariaDB to store it’s data, so we’ve to install & configure it for JIRA. Fire the below command to install the MariaDB Server.

sudo apt install mariadb-server -y

After installing the server type mysql to login to MariaDB.

sudo mysql

Now, create a new database for JIRA by hitting the below commands.

CREATE DATABASE osradardb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
 CREATE USER 'osradaruser'@'localhost' IDENTIFIED BY 'password';
 GRANT ALL ON osradardb.* TO 'osradaruser'@'localhost' WITH GRANT OPTION;
 FLUSH PRIVILEGES;
 EXIT;

Now, edit the /etc/mysql/mariadb.conf.d/50-server.cnf file by typing

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

And then add the below data under [mysqld] section:

default-storage-engine= INNODB
 character_set_server = utf8mb4
 innodb_default_row_format = DYNAMIC
 innodb_large_prefix = ON
 innodb_file_format = Barracuda
 innodb_log_file_size = 2G
 sql_mode = NO_AUTO_VALUE_ON_ZERO

Then save & close the file and exit.

Finally restart MariaDB services.

sudo systemctl restart mariadb.service

Step 3: Install JIRA On Ubuntu 20.04

Fetch the latest version of JIRA with the help of wget command.

wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.14.0-x64.bin

Set the proper permissions for downloaded file by typing.

sudo chmod a+x atlassian-jira-software-8.14.0-x64.bin

And then hit the below command to install the JIRA software.

sudo ./atlassian-jira-software-8.14.0-x64.bin

You’ll see the similar output:

sabi@Ubuntu20:~$ sudo ./atlassian-jira-software-8.14.0-x64.bin
 Unpacking JRE …
 Starting Installer …
 This will install Jira Software 8.14.0 on your computer.
 OK [o, Enter], Cancel [c]
 o
 Click Next to continue, or Cancel to exit Setup.
 

Presss “Enter” to continue the installation.

Choose the appropriate installation or upgrade option.
 Please choose one of the following:
 Express Install (use default settings) [1], Custom Install (recommended for advanced users) [2, Enter], Upgrade an existing Jira installation [3]
 2

Choose the custom option by entering 2.

Select the folder where you would like Jira Software to be installed.
 Where should Jira Software be installed?
 [/opt/atlassian/jira]

Default location for Jira Software data
[/var/atlassian/application-data/jira]

Now, select the path where you want to install JIRA & press Enter.

Configure which ports Jira Software will use.
 Jira requires two TCP ports that are not being used by any other
 applications on this machine. The HTTP port is where you will access Jira
 through your browser. The Control port is used to startup and shutdown Jira.
 Use default ports (HTTP: 8080, Control: 8005) - Recommended [1, Enter], Set custom value for HTTP and Control ports [2]
 1

Now, type 1 to use default ports or select 2 to enter custom ports.

Jira can be run in the background.
 You may choose to run Jira as a service, which means it will start
 automatically whenever the computer restarts.
 Install Jira as Service?
 Yes [y, Enter], No [n]
 y

Next, press “Y” & hit “Enter” to install JIRA as a service.

Install as service: Yes 
 Install [i, Enter], Exit [e]
 i

Finally select i & press Enter to initialize the installation process.

Extracting files …

Please wait a few moments while Jira Software is configured.

Please wait a few moments while Jira Software starts up.
 Launching Jira Software …
 Installation of Jira Software 8.14.0 is complete
 Your installation of Jira Software 8.14.0 is now ready and can be accessed
 via your browser.
 Jira Software 8.14.0 can be accessed at http://localhost:8080
 Finishing installation …

Now, select “Y” & press “Enter” to start the JIRA. Upon successfull installation, you’ll see the following output:

Installation of Jira Software 8.14.0 is complete
Your installation of Jira Software 8.14.0 is now ready and can be accessed
via your browser.
Jira Software 8.14.0 can be accessed at http://localhost:8080
Finishing installation …

Step 4: Configure JIRA On Ubuntu 20.04

To configure JIRA, you’ll need to download the MySQL JDBC driver & then copy it to the Jira folder. You can do so by hitting the below command.

wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-8.0.18.zip

Now, unzip the above downloaded file by typing

sudo unzip mysql-connector-java-8.0.18.zip

And then copy the MySQL connector by typing

sudo cp mysql-connector-java-8.0.18/mysql-connector-java-8.0.18.jar /opt/atlassian/jira/lib

Now, stop & start the Jira services by hitting

sudo /etc/init.d/jira stop
sudo /etc/init.d/jira start

Step 5: Configure Proxy For JIRA On Ubuntu 20.04

Edit the /opt/atlassian/jira/conf/server.xml file to configure proxy for JIRA by typing

sudo nano /opt/atlassian/jira/conf/server.xml

And look for the given lines.

<Connector port="8080" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^`"<>"
maxThreads="150" minSpareThreads="25" connectionTimeout="20000" enableLookups="false"
                    maxHttpHeaderSize="8192" protocol="HTTP/1.1" useBodyEncodingForURI="true" redirectPacceptCount="100" disableUploadTimeout="true" bindOnInit="false"/>

Then replace the above lines with the below lines.

<Connector port="8080" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^`"<>"
maxThreads="150" minSpareThreads="25" connectionTimeout="20000" enableLookups="false"
maxHttpHeaderSize="8192" protocol="HTTP/1.1" useBodyEncodingForURI="true" redirectPort="8443"
acceptCount="100" disableUploadTimeout="true" bindOnInit="false" scheme="http"
proxyName="jira.example.com" proxyPort="80"/>

And hit below commands to apply the changes.

sudo /etc/init.d/jira stop
sudo /etc/init.d/jira start

Step 6: Configure Nginx As Reverse Proxy for JIRA

Now, configure the Nginx as a reverse proxy for JIRA. First install nginx by

sudo apt install nginx -y

And then edit the config file to add new virtualhost.

sudo nano /etc/nginx/sites-available/jira.conf

Paste the below content into it.

server {
     listen 8080;
     server_name localhost;
     location / {
         proxy_set_header X-Forwarded-Host $host;
         proxy_set_header X-Forwarded-Server $host;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_pass http://localhost:8080;
         client_max_body_size 10M;
     }
 }

Save & exit the file and then link it.

sudo ln -s /etc/nginx/sites-available/jira.conf /etc/nginx/sites-enabled

Verify the nginx syntax.

sudo nginx -t

If everything ok you’ll see the success message.

Step 7: Access JIRA On Ubuntu 20.04

Go to jira.example.com or localhost:8080 to access JIRA on web interface. I’ll show you here on my localhost.

Choose the option “i’will set it up myself” & press “Next”.

Click “My own Database” & then fill up the details & press “Next.

Here fill up your appliction data & press “Next”.

Give trial key and proceed.

Enter admin account credentials & press “Next“.

You’ll see the JIRA dashboard upon success.

So, this is how you can install JIRA Project Management System On Ubuntu 20.04.