How To Install Jira On Ubuntu 22.04 LTS
In this short tutorail we will learn how to install Jira Software version 9.11.1 on Ubuntu 22.04 LTS operating system.
Introduction
In the fast-paced world of project management, efficiency, collaboration, and organization are paramount. Jira Software, developed by Atlassian, has emerged as a powerful tool that addresses these needs, offering a comprehensive solution for teams to plan, track, and manage their projects effectively. This article will delve into the key features, benefits, and best practices associated with Jira Software.
Key Features
- Agile Project Management: Jira Software is renowned for its robust support of Agile methodologies, including Scrum and Kanban. Teams can easily create and manage backlogs, plan sprints, and track the progress of tasks through visual boards. The flexibility offered by Jira allows teams to adapt to changing requirements seamlessly.
- Customizable Workflows: Jira enables users to define custom workflows tailored to their specific project needs. This feature ensures that teams can reflect their unique processes and workflows, providing a high degree of adaptability across different projects and industries.
- Real-time Collaboration: The collaboration capabilities of Jira Software are unparalleled. Teams can communicate within the platform, attach relevant documents, and receive instant updates on project progress. This real-time collaboration fosters effective communication, reducing the chances of miscommunication and ensuring everyone is on the same page.
- Extensive Integrations: Jira integrates seamlessly with a wide array of third-party tools and applications, enhancing its functionality. Popular integrations include Confluence for documentation, Bitbucket for version control, and Slack for team communication. This versatility allows teams to create a tailored ecosystem that aligns with their unique requirements.
How To Install Jira Sotware on Ubuntu 22.04 LTS
To install Jira on Ubuntu 22.04, we need MySQL database running on the system. For more detail the installation steps, here are the steps to install Jira on Ubuntu 22.04 :
- Update Ubuntu System
- Install MySQL Server and Create a New Database
- Installing Jira
- Installing MySQL Connector
- Configuring Jira
Prerequisites
- Before we proceed to the install Jira on Ubuntu 22.04, there are several prerequisites that must be met, namely:
- Updated Ubuntu 20.04 Server.
- Non-root user with sudo access.
- Sufficient disk space to accommodate files and installation
- Good network connection to download source files
1. Update Ubuntu System
It is recommended to update our system before we are going to install or add new package to the system. To update Ubuntu system we will use following command lines :
$ sudo apt update
Output :
ramansah@bckinfo:~$ sudo apt update [sudo] password for ramansah: Hit:1 http://id.archive.ubuntu.com/ubuntu jammy InRelease Get:2 http://id.archive.ubuntu.com/ubuntu jammy-updates InRelease [119 kB] Hit:3 http://id.archive.ubuntu.com/ubuntu jammy-backports InRelease Get:4 http://security.ubuntu.com/ubuntu jammy-security InRelease [110 kB] Get:5 http://id.archive.ubuntu.com/ubuntu jammy-updates/main amd64 Packages [1.377 kB] Get:6 http://id.archive.ubuntu.com/ubuntu jammy-updates/main i386 Packages [570 kB] Fetched 2.176 kB in 2s (1.263 kB/s) Reading package lists... Done Building dependency tree... Done Reading state information... Done All packages are up to date.
2. Install MySQL Server and Create a New Database
Jira requires a database to store its data. In this example we will use MySQL server as database engine. To install MySQL Server on Ubuntu Linux operating system, we have discussed it on How To Install MySQL 8 Database on Ubuntu 20.04 LTS Server article.
Creating New Database for Jira
After MySQL Server installation was completed done, then we will create a new database for Jira Software. For this purpose we will use following command line :
$ sudo su - ~# mysql mysql> CREATE DATABASE jiradb01; mysql> CREATE USER jira@localhost IDENTIFIED BY 'JiraTest01'; mysql> GRANT ALL ON jiradb01.* TO jira@localhost WITH GRANT OPTION; mysql> FLUSH PRIVILEGES;
Output :
ramansah@bckinfo:~$ sudo su - root@bckinfo:~# mysql Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 8 Server version: 8.0.36-0ubuntu0.22.04.1 (Ubuntu) Copyright (c) 2000, 2024, Oracle and/or its affiliates. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. mysql> CREATE DATABASE jiradb01; Query OK, 1 row affected (0,01 sec) mysql> CREATE USER jira@localhost IDENTIFIED BY 'JiraTest01'; Query OK, 0 rows affected (0,03 sec) mysql> GRANT ALL ON jiradb01.* TO jira@localhost WITH GRANT OPTION; Query OK, 0 rows affected (0,01 sec) mysql> FLUSH PRIVILEGES; Query OK, 0 rows affected (0,01 sec) mysql>
3. Installing Jira
On this stage, we will download Jira software source and install it on premise. For this tutorial purpose we will use source from Jira official website and supply it with temporary license. We will use Linux Installer version 9.11.1.
3.1. Download Jira Source
To download Jira source we need wget application package installed on the system.
# wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-9.11.1-x64.bin -O atlassian-jira-software.bin
Output :
root@bckinfo:~# wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-9.11.1-x64.bin -O atlassian-jira-software.bin --2024-02-20 10:41:24-- https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-9.11.1-x64.bin Resolving www.atlassian.com (www.atlassian.com)... 108.138.141.65, 108.138.141.81, 108.138.141.66, ... Connecting to www.atlassian.com (www.atlassian.com)|108.138.141.65|:443... connected. HTTP request sent, awaiting response... 301 Moved Permanently Location: https://product-downloads.atlassian.com/software/jira/downloads/atlassian-jira-software-9.11.1-x64.bin [following] --2024-02-20 10:41:24-- https://product-downloads.atlassian.com/software/jira/downloads/atlassian-jira-software-9.11.1-x64.bin Resolving product-downloads.atlassian.com (product-downloads.atlassian.com)... 18.67.172.148, 2600:9000:25fb:ae00:1f:ab86:b4a:17e1, 2600:9000:25fb:b200:1f:ab86:b4a:17e1, ... Connecting to product-downloads.atlassian.com (product-downloads.atlassian.com)|18.67.172.148|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 570611166 (544M) [application/octet-stream] Saving to: ‘atlassian-jira-software.bin’ atlassian-jira-software.bin 100%[========================================================>] 544,18M 11,1MB/s in 58s 2024-02-20 10:42:23 (9,36 MB/s) - ‘atlassian-jira-software.bin’ saved [570611166/570611166]
3.2. Change File Permision
After the file was downloaded, then we will make it to be executable file by submitting command line :
root@bckinfo:~# ls -ltr *.bin -rw-r--r-- 1 root root 570611166 Sep 19 15:28 atlassian-jira-software.bin root@bckinfo:~# chmod +x atlassian-jira-software.bin root@bckinfo:~# ls -ltr total 557248 -rwxr-xr-x 1 root root 570611166 Sep 19 15:28 atlassian-jira-software.bin drwx------ 5 root root 4096 Feb 19 16:20 snap
3.3. Execute Installation File
Then execute source file as shown below :
# ./atlassian-jira-software.bin
Output :
root@bckinfo:~# ./atlassian-jira-software.bin Unpacking JRE ... Starting Installer ... WARNING: A terminally deprecated method in java.lang.System has been called WARNING: System::setSecurityManager has been called by com.install4j.runtime.installer.frontend.headless.AbstractHeadlessScreenExecutor (file:/root/atlassian-jira-software.bin.7980.dir/i4jruntime.jar) WARNING: Please consider reporting this to the maintainers of com.install4j.runtime.installer.frontend.headless.AbstractHeadlessScreenExecutor WARNING: System::setSecurityManager will be removed in a future release java.lang.NoSuchFieldException: override at java.base/java.lang.Class.getDeclaredField(Unknown Source) at com.install4j.runtime.util.internal.ReflectionUtil.setUnsafeAccessible(ReflectionUtil.java:46) at com.install4j.runtime.util.internal.ReflectionUtil.setAccessible(ReflectionUtil.java:19) at com.install4j.runtime.util.ToolTipHelpLabel.initTooltipManager(ToolTipHelpLabel.java:21) at com.install4j.runtime.util.ToolTipHelpLabel.registerWithToolTipManager(ToolTipHelpLabel.java:61) at com.install4j.runtime.util.ToolTipHelpLabel.<init>(ToolTipHelpLabel.java:38) at com.install4j.runtime.beans.formcomponents.UpdateAlertComponent.createCenterComponent(UpdateAlertComponent.java:109) at com.install4j.runtime.installer.frontend.FormPanel.addFormComponent(FormPanel.java:508) at com.install4j.runtime.installer.frontend.FormPanel.buildPanel(FormPanel.java:382) at com.install4j.runtime.installer.frontend.FormPanel.setupComponent(FormPanel.java:310) at com.install4j.runtime.installer.frontend.FormPanel.init(FormPanel.java:65) at com.install4j.runtime.installer.frontend.FormPanel.<init>(FormPanel.java:55) at com.install4j.runtime.installer.frontend.headless.ConsoleScreenExecutor.handleScreen(ConsoleScreenExecutor.java:44) at com.install4j.runtime.installer.frontend.headless.AbstractHeadlessScreenExecutor.execute(AbstractHeadlessScreenExecutor.java:96) at com.install4j.runtime.installer.controller.Controller$1.run(Controller.java:155) at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source) at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source) at java.desktop/java.awt.EventQueue$4.run(Unknown Source) at java.desktop/java.awt.EventQueue$4.run(Unknown Source) at java.base/java.security.AccessController.doPrivileged(Unknown Source) at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(Unknown Source) at java.desktop/java.awt.EventQueue.dispatchEvent(Unknown Source) at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source) at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source) at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source) at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source) at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source) at java.desktop/java.awt.EventDispatchThread.run(Unknown Source) This will install Jira Software 9.11.1 on your computer. OK [o, Enter], Cancel [c] Click Next to continue, or Cancel to exit Setup. 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 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] 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] 2 HTTP Port Number [8080] Control Port Number [8005] 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] Details on where Jira Software will be installed and the settings that will be used. Installation Directory: /opt/atlassian/jira Home Directory: /var/atlassian/application-data/jira HTTP Port: 8080 RMI Port: 8005 Install as service: Yes Install [i, Enter], Exit [e] Extracting files ... /opt/atlassian/jira/bin/tcnative-1.dll The file already exists. Would you like Setup to overwrite it? Yes [y], Yes to All [ya], No [n], No to All [na] y Please wait a few moments while Jira Software is configured. Installation of Jira Software 9.11.1 is complete Start Jira Software 9.11.1 now? Yes [y, Enter], No [n] Please wait a few moments while Jira Software starts up. Launching Jira Software ... Installation of Jira Software 9.11.1 is complete Your installation of Jira Software 9.11.1 is now ready and can be accessed via your browser. Jira Software 9.11.1 can be accessed at http://localhost:8080 Finishing installation ...
4. Installing MySQL Connector
At this step, we will install MySQL Connector as a bridge between MySQL Server database engine with Jira software which was developed with Java. For this purpose we will submit following command lines :
# wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-j-8.1.0.tar.gz
Output :
root@bckinfo:~# wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-j-8.1.0.tar.gz --2024-02-20 10:50:07-- https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-j-8.1.0.tar.gz Resolving dev.mysql.com (dev.mysql.com)... 23.9.195.117, 2600:1417:5c00:381::2e31, 2600:1417:5c00:389::2e31 Connecting to dev.mysql.com (dev.mysql.com)|23.9.195.117|:443... connected. HTTP request sent, awaiting response... 302 Moved Temporarily Location: https://cdn.mysql.com//Downloads/Connector-J/mysql-connector-j-8.1.0.tar.gz [following] --2024-02-20 10:50:08-- https://cdn.mysql.com//Downloads/Connector-J/mysql-connector-j-8.1.0.tar.gz Resolving cdn.mysql.com (cdn.mysql.com)... 23.9.197.198, 2600:1417:5c00:389::1d68, 2600:1417:5c00:390::1d68 Connecting to cdn.mysql.com (cdn.mysql.com)|23.9.197.198|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 4241696 (4,0M) [application/x-tar-gz] Saving to: ‘mysql-connector-j-8.1.0.tar.gz’ mysql-connector-j-8.1.0.tar.gz 100%[========================================================>] 4,04M 8,54MB/s in 0,5s 2024-02-20 10:50:09 (8,54 MB/s) - ‘mysql-connector-j-8.1.0.tar.gz’ saved [4241696/4241696]
The source file then extract it by using command line :
# tar -xzvf mysql-connector-j-8.1.0.tar.gz
Then we will copy the .jar file to the Jira library directory :
# cp mysql-connector-j-8.1.0/mysql-connector-j-8.1.0.jar /opt/atlassian/jira/lib
Output :
root@bckinfo:~# cp mysql-connector-j-8.1.0/mysql-connector-j-8.1.0.jar /opt/atlassian/jira/lib
After all are set, then we will stop and start Jira service. This is done to repfresh Jira Software. For this purpose we will use the following command line :
# /etc/init.d/jira stop # /etc/init.d/jira start
Output :
root@bckinfo:~# /etc/init.d/jira stop executing using dedicated user `sMMMMMMMMMMMMMM+ MMMMMMMMMMMMMM :sdMMMMMMMMMMM MMMMMM `sMMMMMMMMMMMMMM+ MMMMMM MMMMMMMMMMMMMM +MMMMM :sMMMMMMMMMMM MMMMM MMMMMM `UOJ `sMMMMMMMMMMMMM+ MMMMMM MMMMMMMMMMMMMM +MMMMM :sdMMMMMMMMMM MMMMM MMMMMM `UOJ MMMMMM +MMMMM MMMMM `UOJ Atlassian Jira Version : 9.11.1 If you encounter issues starting or stopping Jira, please see the Troubleshooting guide at https://docs.atlassian.com/jira/jadm-docs-0911/Troubleshooting+installation Server startup logs are located in /opt/atlassian/jira/logs/catalina.out Using CATALINA_BASE: /opt/atlassian/jira Using CATALINA_HOME: /opt/atlassian/jira Using CATALINA_TMPDIR: /opt/atlassian/jira/temp Using JRE_HOME: /opt/atlassian/jira/jre/ Using CLASSPATH: /opt/atlassian/jira/bin/bootstrap.jar:/opt/atlassian/jira/bin/tomcat-juli.jar Using CATALINA_OPTS: Using CATALINA_PID: /opt/atlassian/jira/work/catalina.pid NOTE: Picked up JDK_JAVA_OPTIONS: --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.io=ALL-UNNAMED --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/java.util.concurrent=ALL-UNNAMED --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED specified to --add-exportsL-UNNAMED Tomcat stopped.
root@bckinfo:~# root@bckinfo:~# /etc/init.d/jira start To run Jira in the foreground, start the server with start-jira.sh -fg executing using dedicated user: jira `sMMMMMMMMMMMMMM+ MMMMMMMMMMMMMM :sdMMMMMMMMMMM MMMMMM `sMMMMMMMMMMMMMM+ MMMMMM MMMMMMMMMMMMMM +MMMMM :sMMMMMMMMMMM MMMMM MMMMMM `UOJ `sMMMMMMMMMMMMM+ MMMMMM MMMMMMMMMMMMMM +MMMMM :sdMMMMMMMMMM MMMMM MMMMMM `UOJ MMMMMM +MMMMM MMMMM `UOJ Atlassian Jira Version : 9.11.1 If you encounter issues starting or stopping Jira, please see the Troubleshooting guide at https://docs.atlassian.com/jira/jadm-docs-0911/Troubleshooting+installation Server startup logs are located in /opt/atlassian/jira/logs/catalina.out Using CATALINA_BASE: /opt/atlassian/jira Using CATALINA_HOME: /opt/atlassian/jira Using CATALINA_TMPDIR: /opt/atlassian/jira/temp Using JRE_HOME: /opt/atlassian/jira/jre/ Using CLASSPATH: /opt/atlassian/jira/bin/bootstrap.jar:/opt/atlassian/jira/bin/tomcat-juli.jar Using CATALINA_OPTS: Using CATALINA_PID: /opt/atlassian/jira/work/catalina.pid Tomcat started.
5. Configuring Jira
In this stage, the Jira sotware has been installed on the system and the services are already running well. The next step is to configure Jira software as our requirements. For this purpose we will use Jira initial web which was hosted on URL http://<server_name_or_ip_address>:8080
. For this tutorial purpose we will use the http://bckinfo:8080
.
5.1 Jira Setup
The setup will be prompted with two options as shown below. We will choose ‘I’ll set it up myself’.
5.2 Database Setup
As we noticed, we have created a new database for Jira. At this step, we will submit the following parameters as asked below.
5.3 Application Setup
At this step, we will be asekd to submit the application title and base URL.
5.4 Entering Lincense Key
At this step, we will be asked to submit the lincese key. For this tutorial purpose we will be using trial license. To get the license key we will be redirected to My Attalasian official website. We will create an new trial license as shown below.
After submitting the license key, click on Next to proceed and follow all other steps to finish the configuration.
5.5 Set up Administrator Account
The next step is submitting Administrator account. Just follow the required field to be fulfilled.
So fare we have installed Jira software ont Ubuntu 22.04 LTS operating system.
Conclusion
Jira Software stands as a cornerstone in modern project management, providing teams with the tools they need to collaborate effectively, adapt to changes, and deliver successful outcomes. By embracing its features, benefits, and best practices, organizations can unlock the full potential of Jira and propel their projects to new heights of success. On this short tutorial we have learnt how to install Jira on Ubuntu 22.04 LTS. I hope this tutorial will be useful.
The detail information about Jira software is avialable on official Atlasian Jira web site.