Installation of JIRA on Ubuntu Linux

Developed by Atlassian, JIRA is a proprietary and comprehensive software tool mainly used for project management, issue tracking, and bug fixing. JIRA comes with an intuitive dashboard that helps you track issues.

These issues could be software defects or bugs, new features or requirements to mention just a few. It also ships with workflows that enable you to track work progress and pinpoint where a problem is.

Jira Linux Installation Prerequisites

Before we get started with the installation, ensure you have the following:

· An instance of Ubuntu 18.04 / Debian 10

· Have MySQL database installed on your instance. JIRA requires a database to install all the files so MySQL will come in handy.

Step 1: Create a database for JIRA

JIRA software requires a database for its installation, therefore the first step will be to create a database in the MySQL database engine.

Login to MySQL as a root user

  • # mysql -u root -p

    Create a database for JIRA

  • CREATE DATABASE jira_db;

    Next, create a user for JIRA

  • Next, create a user for JIRA

    Grant all privileges to the JIRA user in order to access the JIRA database.

  • GRANT ALL PRIVILEGES ON jira_db.* TO 'jira_user'@'localhost' IDENTIFIED by 'Your_Password';

    To wrap it up flush the privileges

  • # mysql -u root -p

    Create a database for JIRA

  • FLUSH PRIVILEGES;
  • Step 2: Download JIRA & assign necessary permissions

    Having created the database for JIRA, our next step will be to download JIRA's binary file. Download the file using the wget command as shown.

  • # wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-7.8.2-x64.bin

    CNext, assign execute permissions to the binary file

  • # chmod a+x atlassian-jira-software-7.8.2-x64.bin

    WIth execute permissions assigned, run the binary file:

  • / atlassian-jira-software-7.8.2-x64.bin

    When running the binary file, you will be prompted to answer a couple of questions as highlighted below.

    Ensure you make the selections as highlighted below.

  • If the installation goes well as expected, you will get the output highlighted in. You can proceed and access JIRA on the web interface via port 8080. But first, let's open some ports on the UFW firewall to give access to external users to access JIRA.

    Step 3: Open JIRA ports

    To successfully access and configure JIRA on the web console, we need to open a few ports on the UFW firewall that will enable us to access JIRA.

    If UFW is not installed on your system, run the command

  • # apt install ufw

    Now, you can proceed and open ports 8080, 8181 and 8005

    # ufw allow 8181

    # ufw allow 8005

    # ufw allow 8080

    Then enable the firewall for the rules to come into effect

  • # ufw enable

    To confirm that the rules exist. run the command:

  • # ufw status

  • Step 4: Accessing JIRA

    All is now set to access JIRA and proceed with the web setup. Fire up your browser and browse your server's IP as shown:

  • http://server-IP:8080

    The first page presents two options as shown. Click on 'I'll set it up myself' and click on the 'Next' button.

    On the next Window, click on 'My own database’ and for the Database type value, click and select 'MySQL'. You will get a notification that JIRA requires you to download a MySQL driver and thereafter restart JIRA after installing it.

    To download the MySQL driver, use the wget command to download it from MySQL's official site.

  • wget https://dev.mysql.com/get/archives/mysql-connector-java-5.1/mysql-connector-java-5.1.36.zip

    Once downloaded, unzip the zipped file

    # unzip mysql-connector-java-5.1.36.zip

    Next, navigate into the mysql-connector-java directory and copy the jar file to the path /opt/atlassian/jira/lib

  • # cp mysql-connector-java-5.1.36-bin.jar /opt/atlassian/Jira/lib

    Next, restart JIRA using the commands:

  • # /etc/init.d/jira stop

  • # /etc/init.d/jira start

    Now head back to your browser and fill out all the details and click on 'Test connection' button at the bottom.

    The notification below is a confirmation that the test was successful.

    Click Next and fill out the 'Application title', 'Mode' and click the 'Next' button.

    Next, you will be required to enter the license key of JIRA. Click on the link as shown which will redirect you to Atlassian site from where you will be able to generate the license key.

    Follow the instructions to generate the key and paste the key in the text field and click 'Next'.

    In the next Window, set up the Administrators account as shown and click 'Next'.

    Choose whether to set up email notification or not and click the 'Finish' button.

    Finally, the wizard will prompt you to select your language. Do so and click Next.

    And voila! there goes the JIRA dashboard!

  • Conclusion

    JIRA can be a great source of information, or to know the status of the running project. As the whole team working on it and would agree on the points mention in it. It keeps on giving reminders or updating with the running state of the project. So if you are new to JIRA and are working in Software Development or Testing and not aware of how to install and use JIRA effectively, then we hope have at the end of this tutorial you are now able to install JIRA without any problem. If you still find any problem, then feel free to contact us right here.