How Do You Troubleshoot the Jira Cluster Message “Node is not using the correct shared home…”?

Problem scenario
In the Jira “Instance health checks” section you see a problem has been detected under the “Cluster” section.  It says “Node jiranode1 is not using the correct shared home…”  How do you get this error to go away?

Possible solution #1
Log into the node on the back-end.  Stop the Jira service and then start the Jira service.

Possible solution #2
Log into a working node on the back-end. 

How Do You Find the Health Status of a Jira Cluster in the Web UI?

Problem scenario
When you logged into the web UI for Jira you saw one or more error messages.  How do you find out of the error is still valid?

You want to find the web UI page in Jira that will tell you about the health of the cluster for one of the following error categories:

-Supported platforms
-Database
-File system
-Indexing
-Attachments
-Cluster
-Secondary Storage

Where do you go to view the status of detected problems or potentially detected problems?

How Do You Get a Jira Instance to Work when The Web UI is Not Working but The Listener is Active on The TCP/IP port?

Problem scenario
A Jira deployment is failing.  The web services are listening on port 8080 or whichever port you configured.  But the web UI does not load.  What should you do?

Solution
Root cause: “…JIRA is not designed to import data from a new version into an older version.” taken from Atlassian’s website.

Has the database been used in the past? 

How Do You Troubleshoot JIRA Not Working due to Not Finding a Suitable Driver?

Problem scenario
Atlassian JIRA is not working.  The web UI does not have a login page.  On the back-end in the logs, you see an error about not finding a suitable driver.  (You may get an error about a port number instead.  This problem may require a similar solution to the one proposed below for an error about a suitable driver.)  You know you have the ojdbc.jar file (or variation thereof) in the correct place. 

How Do You Configure Oracle 12 to Work with JIRA 7.x when Writing a dbconfig.xml File for JIRA?

Problem scenario
You have configured dbconfig.xml for JIRA 7.x to use Oracle 12.  But JIRA is not working correctly when you try to start it.  What should you do with your dbconfig.xml file?

Solution
Atlassian’s website, as of 8/30/18, recommends having “oracle10g”, an unsupported version, in the dbconfig.xml file.  This is despite the fact that Oracle 10 and Oracle 11 are not supported for JIRA 7.x according to Atlassian’s site here.

After Installing Jira on a RHEL Server, How Do You Access the Web UI for Jira?

Problem scenario
You installed Jira 7.x on RHEL 7.x in AWS.  You try to go to the URL to finish installing and configuring it, but the web UI does not load.  On the back-end you see that there is a service listening on port 8080 (with a sudo netstat -anlp | grep 8080 command).  You know that now AWS Security Group is blocking port 8080 from the external IP address of the server.

How Do You Install Jira on a Linux Server?

Problem scenario
How do you install Jira on any distribution of Linux (e.g., CentOS/RHEL/Fedora, Debian/Ubuntu, or SUSE)?

Prerequisite
Do you have 3 GB of RAM?  1 GB of RAM will work, but you only if you have 2 GB of virtual memory.  (With 1 GB of RAM or less and no virtual memory on the server, the installation will fail.  The catalina.out log will report an error about insufficient memory.) 

How Do You Install Jira on a Linux Server when It Is Hanging during the “Initializing the plugin system” Stage?

Problem scenario
You are trying to install Jira on Linux.  You log into the web UI to finish configuration.  The process stalls at this stage:

”    Finishing your setup

    Now sit back while we set up your JIRA instance. It will take a minute or two to complete.

    Configuring your database

    Initializing the plugin system – Don’t worry, I’m still working…”

On the back-end you may notice the server’s load average gets above 5. 

What Can Be Done to Enhance the Reliability and Performance of a Jira Server?

Problem scenario
You find that your Jira is very slow and sometimes stalls or hangs when it is being used.  The Linux back-end of the Jira server shows considerable CPU and memory constraints.  When Jira is up on the back end you use the Linux “top” command, you find that the CPU and RAM are being heavily utilized.  You want to optimize the system for improved performance. 

How Do You Get to See Settings and The Help Menu of Atlassian HipChat?

Problem Scenario
You are logged into the web UI of HipChat.  You expect to hover over either your name or the question mark icon in the upper right hand corner and see drop down options.  But this is not what happens.  When you single-click on your name or the question mark icon, you briefly get a glimpse of menu options.  You want to click on the menu options.  How do you do this?