---
title: "Installing Atlassian Jira (Java application) on a virtual server"
canonical_url: "https://www.zone.lv/help/kb/12318/"
post_type: "ht_kb"
published: "2024-04-17T12:14:47+00:00"
modified: "2024-04-19T05:38:43+00:00"
language: "en"
author: "martin"
taxonomies:
  ht_kb_category:
    - name: "Technical"
      url: "https://www.zone.lv/help/kb-categories/technical-en/"
  ht_kb_tag:
    - name: "Atlassian"
      url: "https://www.zone.lv/help/kb-tags/atlassian-en/"
    - name: "java"
      url: "https://www.zone.lv/help/kb-tags/java-en/"
    - name: "Jira"
      url: "https://www.zone.lv/help/kb-tags/jira-en/"
---

# Installing Atlassian Jira (Java application) on a virtual server

![](https://www.zone.lv/static/sites/5/Jira-Software@2x-blue-300x39.png)

 Attention! **Zone does not provide official support for Jira installation**. **Use it at your own risk!**

This guide is intended for advanced users and assumes a good knowledge of SSH.

[Jira](https://www.atlassian.com/software/jira) is a development project management software created by Atlassian. The guide below is a tutorial for installing Jira Server on a Zone virtual server. It is a *proof of concept* to demonstrate the technical capability of the Zone web hosting platform to serve Java applications.

### 1. Create a subdomain for Jira

The easiest way to install Jira on a subdomain is to display its web interface to the user from the Jira Java server through a web server proxy. For example, you could create a subdomain called **jira.mydomain.com**

When adding the subdomain, set the mod\_proxy destination port to **8080**.

### 2. Create a MariaDB database and user.

NOTE! Make sure that when you create the database, its ‘Collation’ is **utf8\_bin**!

Create the MariaDB database and user for Jira in the My Zone control panel and give the newly created user all rights to the Jira database. Remember the MariaDB password or save it in your password manager.

### 3. Log in to the virtual server using SSH.

[Instructions for establishing an SSH connection](https://www.zone.lv/help/en/kb/establishing-an-ssh-connection/).

### 4. Install Java

From the address <https://java.com/en/download/manual.jsp>, right click on **Linux x64** and “Copy link address”, use this address to download the Java package using wget.

(PS! This is an example and installs the old version!).

```
cd ~/.zse/opt/oracle/java/
wget -O java.tar.gz https://javadl.oracle.com/webapps/download/AutoDL?BundleId=240718_5b13a193868b4bf28bcb45c792fce896
tar -zxf java.tar.gz
ln -sf jre1.8.0_231/bin bin
ln -sf jre1.8.0_231/lib lib
rm -f java.tar.gz
```

### 5. Install Jira

Jira can be downloaded from <https://www.atlassian.com/software/jira/download>. Select **TAR.GZ Archive** from the drop-down menu, tick the checkbox, right-click Submit and copy the URL (“Copy link address”). Download Jira using wget.

Run it manually:

```
mkdir -p ~/atlassian/application-data/jira
cd ~/atlassian/
wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.6.1.tar.gz
tar -xzf atlassian-jira-software-8.6.1.tar.gz
ln -sf atlassian-jira-software-8.6.1-standalone ~/atlassian/jira
rm -f atlassian-jira-software-8.6.1.tar.gz
```

### 6. Install MySQL connector

Since the latest MySQL Connector does not work properly, download version 5.1.44 of the MySQL Connector.

Run it manually:

```
cd ~/atlassian/
wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.44.tar.gz
tar -xzf mysql-connector-java-5.1.44.tar.gz
ln -sf ../../mysql-connector-java-5.1.44/mysql-connector-java-5.1.44-bin.jar ~/atlassian/jira/lib/
rm -f mysql-connector-java-5.1.44.tar.gz
```

### 7. Make the necessary configuration file changes

```
sed -i 's|#JIRA_HOME=""|JIRA_HOME="${HOME}/atlassian/application-data/jira"|' ~/atlassian/jira/bin/setenv.sh
sed -i "s|<Server port=\"8005\".*shutdown|<Server port=\"8005\" address=\"$(vs-loopback-ip -4)\" shutdown|" ~/atlassian/jira/conf/server. xml
sed -i "s|<Connector port=\"8080\".*relaxedPathChars|<Connector port=\"8080\" address=\"$(vs-loopback-ip -4)\" relaxedPathChars|" ~/atlassian/jira/conf/server.xml
sed -i "s|localhost|$(vs-loopback-ip -4)|g" ~/atlassian/jira/conf/server.xml
```

 NOTE! You need to modify the following line before running!

Instead of **jira.mydomain.com**, put the correct subdomain address where Jira will be

 . ```
sed -i 's|<Connector port="8080".*address|<Connector port="8080" ProxyName="jira.sinudomeen.ee" ProxyPort="443" scheme="https" address|' ~/atlassian/jira/conf/server.xml
```

### 8. Add PM2 work

PM2 is used to make the application run automatically after the server has been initialized.

Create a file called **~/atlassian/jira.config.js** and put it there:

```
module.exports = {
    apps : [{
        name : "jira",
        script : process.env.HOME + "/atlassian/jira/bin/start-jira.sh",
        args: "-fg",
        max_memory_restart : "3G"
    }]
}
```

Go to My Zone control panel under `Web Server` -&gt; `PM2 and Node.js` and select `Add New Application`.

Put the name of the application in `Jira`.

In the script or PM2 .JSON field enter: `atlassian/jira.config.js`

Maximum memory usage: 1MiB

Click Add.

Trace the Jira log file on the server:

```
tail -f ~/atlassian/application-data/jira/log/atlassian-jira.log
```

When the log file starts running, the created subdomain should display an image and further configuration is done via the web.

### 9. Configuring the database

Open **https://jira.mydomain.com** in your browser and select **I’ll set it up myself** -&gt; **Next**.

Database Connection -&gt; **My Own Database**.

Database Type -&gt; **MariaDB 10.6.**

Fill in the remaining fields with the MariaDB database data you created earlier.

The hostname can be found in the My Zone MariaDB configuration page.

The port is **3306**.

Select **Test Connection** and **Next**.

Setting up the database will now take a few minutes.

After the configuration you can change the Base URL to https and delete the port: **https://jira.mydomain.com/**

### 10. Generate a licence

The next step is to request a license. Select “generate a Jira trial license” right click and “Open link in new tab”.

Log in as Atlassian user. If there is no user, create a user.

Select **Jira Software (Server)** license and **Generate License**. When asked if you want to install the license immediately on the server, select **Yes.**

If for some reason the automatic license installation does not work, you will need to manually copy the license and paste the generated license into the license window in the second tab.

### 11. Configuring Jira

Create an administrator user.

Log in to the Jira administration with the administrator user.

Configure **Outgoing mail**. Add a new SMTP mail server with Host as `localhost` and port `25`. SMTP username and password are not required.

![](https://www.zone.lv/static/sites/5/jira-mail-server.png)

Enjoy your use of Jira!

### More information and debugging

You can manually start and stop JIRA without PM2 using the following commands (make sure that PM2 has not started the server first):

```
~/atlassian/jira/bin/start-jira.sh
~/atlassian/jira/bin/stop-jira.sh
```

If PM2 is configured, then start and stop should be done through PM2.

Commands: `pm2 list` to display and `pm2 restart jira` to restart the Jira server.

If the Java server does not start for some reason, it is worth looking at the following log files:

```
cat ~/.pm2/logs/jira-out.log
cat ~/atlassian/jira/logs/catalina.out
```

Error message: **MariaDB 10.6 is not supported**. This warning can be ignored.

 If any of the links in this guide do not work, please report it in the “Was this article helpful?” section below. form.

 . ### Upgrading Jira

 Before upgrading, make a copy of the Jira database and `~/atlassian/application-data` directory!

The upgrade procedure is relatively simple. Since we made a link when installing, all you need to do to upgrade is change the link to the new version and copy the config file:

1. Download the new version of Jira and unzip it.
2. Stop Jira server
3. Change link to new version
4. Overwrite `conf/server.xml`
5. Start Jira server

```
cd ~/atlassian/
wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.6.1.tar.gz
tar -xzf atlassian-jira-software-8.6.1.tar.gz
pm2 stop jira
ln -nfs atlassian-jira-software-8.6.1-standalone jira
ln -sf . ./../mysql-connector-java-5.1.44/mysql-connector-java-5.1.44-bin.jar ~/atlassian/jira/lib/
cp atlassian-jira-software-8.6.0-standalone/conf/server.xml atlassian-jira-software-8.6.1-standalone/conf/server.xml pm2 start jira
```