This tutorial is broken into 2 parts and will walk you through the installation of JIRA 4.2 Standalone on a new Redhat based server.
1. Install JAVA
2. Install JIRA
UPDATE (Nov 15th 2010): I just went through this tutorial step by step and successfully completed the JIRA Installation with no other documentation or steps.
UPDATE 2 (June 1st 2011): I just went through this tutorial again with JIRA 4.3.4 and it worked beautifully and i was done in 10 minutes. I completed it on CentOS 5.5 this time. If you have problems please post a pastebin link your entire catalina.out logfile in the comments. Again, If you follow this line by line you will not have problems! Cheers
1. Install JAVA
JIRA Is an application written entirely in JAVA, and requires Javas JDK. Make sure you install JDK Update 20 if you want to use the JIRA Labels plugin. At the time of writing this, Labels has an issue with the latest version of java’s JDK which is JDK 6 Update 21. Proof: See this bug report.
Use wget to download JAVA directly to the server. I had to host the BIN’s on my server because Sun’s website uses session’s to store unique download URL’s. I could not locate a permanent links to the RPM’s on their site. If you (don’t trust me) and want to download directly from SUN, click here, then select JDK/JRE -6 “6 Update 20″:
64bit:
wget http://www.iainlbc.com/jdk-6u20-linux-x64-rpm.bin
or the 32bit version:
wget http://www.iainlbc.com/jdk-6u20-linux-i586-rpm.bin
Make the RPM Executable:
chmod +x jdk-6u21-linux-i586-rpm.bin
Install it!
./jdk-6u21-linux-i586-rpm.bin
Set JAVA_HOME:
nano ~/.bash_profile
Add the following line:
export JAVA_HOME=/usr/java/jdk1.6.0_20
Run the following command (to set the variable for your current SSH Session):
export JAVA_HOME=/usr/java/jdk1.6.0_20
Test the new variable:
echo $JAVA_HOME
2. Install JIRA
Download the JIRA Standalone TAR (.GZ) file here.
cd ~ wget http://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-enterprise-4.2-standalone.tar.gz
Unzip the downloaded file.
tar xzvf atlassian-jira-enterprise-4.1.2-standalone.tar.gz
Create JIRA Installation/Home Directory
mkdir /opt/jira
Copy Extracted files to JIRA’s Installation Directory (-R is for recursive)
cp -R atlassian-jira-enterprise-4.1.2-standalone/* /opt/jira/
Lets create a directory for JIRA to store attachments, indexes, and other stuff’s:
mkdir /opt/jira/home
Now, we need to set the JIRA HOME property:
nano /opt/jira/atlassian-jira/WEB-INF/classes/jira-application.properties
Change the existing line (or a add new)
jira.home =
to
jira.home = /opt/jira/home
Almost done, we need to open up port 8080 in your local firewall (IPTABLES), or we won’t be able to hit JIRA from our browser:
nano /etc/sysconfig/iptables
Change this line:
-A RH-Firewall-1-INPUT -j REJECT --reject with icmp-host-prohibited
To include an additional line above it for 8080 traffic, like so:
-A RH-Firewall-1-INPUT -p tcp -m tcp --dport 8080 -j ACCEPT -A RH-Firewall-1-INPUT -j REJECT --reject with icmp-host-prohibited
Restore your new IPTABLES Rules:
/sbin/iptables-restore < /etc/sysconfig/iptables
Save them!:
service iptables save
Launch JIRA:
cd /opt/jira/bin ./startup.sh
After launching, JIRA should spit out several things in command line, one should be our previously set JAVA_HOME path, if you do not see JAVA_HOME=/usr/java/jdk1.6.0_20 JIRA will not work.
Tail the logs to look for errors:
tail -f ../logs/catalina.out
Access JIRA in your browser:
http://<server-ip-address>:8080
Other:
If you cannot access JIRA (and there no complaints in the catalina.out log), you may need to open port 8080 on your physical firewall or add it to your local iptables. To see if port 8080 is in your iptables run:
/sbin/iptables -L
To change the port, you can do so easily by editing the /opt/jira/conf/server.xml file – Instructions here
If you want JIRA accessible on port 80 with the ability to host more websites than just JIRA on this server, you should use Apache as a Proxy. A tutorial on this is comming soon, for now check out JIRA’s docs on integrating apache.
If you run into any startup problems please paste your /opt/jira/logs/catalina.out log on this page, I’m happy to help.
i can't not find a jira-application.properties in my directory of jira-home.
Hi OIaf,
It should be within the JIRA HOME/atlassian-jira/WEB-INF/classes/
or if you installed using this tutorial, simply
nano /opt/jira/atlassian-jira/WEB-INF/classes/jira-application.properties
The find utility is pretty handy if you really are having trouble finding something:
sudo find / -name "jira-application.properties"
Cheers,
iain
Hello,
I have installed and configured it. On centos.It working fine but I want to know how we will connect it with external databse.Please send me detail on amar.tiwari@rf-silicon.com
Thanks and Regards
Amar Tiwari
System Engineer
(RF SILICON PVT LTD)
Hey, it's so helpful tutorial. Thanks !!
I've successfully install JIRA. but when i'm running through my web browser.
it's showing me an error like
Gadget Error
Error loading gadget: org.apache.shindig.gadgets.GadgetException: Unable to retrieve gadget xml. HTTP error 404
Any idea what to do.. i've tried to upgrade the plugins but didn't work..
Hi Ronak,
What version are you installing? A few people seem to have this error: http://jira.atlassian.com/browse/JRA-19052
Are you able to login, or do all gadgets show the error?
It would really help to see the startup logs:
- Stop Jira: /opt/jira/bin/./shutdown.sh
- Start Jira: /opt/jira/bin/./startup.sh
- Then Transfer /opt/jira/logs/catalina.out via FileZilla or SFTP, and email it to me at iainwrig@gmail.com. You could also paste it here and provide the link: http://paste2.org/new-paste
All the best,
iain
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/bin/java: No such file or directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/bin/java: No such file or directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/bin/java: No such file or directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/java: is a directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/java: is a directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/java: is a directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/java: is a directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/java: is a directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/java: is a directory
/opt/jira/bin/catalina.sh: line 310: /opt/jira/bin/java: is a directory
Hi David,
Please paste your entire catalina.out file here: http://pastebin.com/, and reply with the URL
Hi David,
Please paste your entire catalina.out file here: http://pastebin.com/, and reply with the URL
Hey iain,
This was so helpful. After futzing around all day with the instructions from Atlassian, I was lucky enough to stumble on your page. Thank God!! I installed it with almost no errors or modifications. Within 15 minutes, it was up and running. It's just a shame I didn't find it sooner or Iwould have salvaged my Saturday.
Thanks a million.
Iain,
just to let you know, I did link to it from my blog. http://afarian.com/blog
Thanks Diran! I appreciate it very much
Hi Diran!
So glad this helped you out, I thought I might have been the only one who found atlassians docs cumbersome
Thanks for taking the time to comment I very much appreciate it.
I can't seem to comment on your blog– it is asking for a login. Do i need to register? Some of your posts seem quite relevant to my interests, like the business book recommendations
Cheers!
Hi Iain.
Followed all the instructions but still can't get Jira up and running on the 64bit version of CentOS. I've included the first 5 lines of the error message below –
An error occurred whilst rendering this message. Please contact the administrators, and inform them of this bug. Details: ——- org.apache.velocity.exception.MethodInvocationException: Invocation of method 'getFragmentHtml' in class com.atlassian.jira.user.profile.PreferencesUserProfileFragment threw exception class java.lang.StringIndexOutOfBoundsException : String index out of range: -1 at org.apache.velocity.runtime.parser.node.ASTMethod.execute(ASTMethod.java:251) at org.apache.velocity.runtime.parser.node.ASTReference.execute(ASTReference.java:175) at
It just keeps going after that. Any ideas?
Hi Hemant,
Was this resolved? I replied to this via email but it looks like it never posted.
If you havent resolved this yet — please post your entire catalina.out logfile to a pastebin.com and post the URL here.
Cheers!
Hi
I followed the procedure as mentioned above.
Jira is not loading when i open it in browser.
/opt/jira/logs/catalina.out contain:
Jul 17, 2011 2:01:37 AM org.apache.catalina.core.AprLifecycleListener init
INFO: The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: /usr/java/jdk1.6.0_26/jre/lib/i386/client:/usr/java/jdk1.6.0_26/jre/lib/i386:/usr/java/jdk1.6.0_26/jre/../lib/i386:/usr/java/packages/lib/i386:/lib:/usr/lib
Jul 17, 2011 2:01:38 AM org.apache.coyote.http11.Http11Protocol init
INFO: Initializing Coyote HTTP/1.1 on http-8080
Jul 17, 2011 2:01:38 AM org.apache.catalina.startup.Catalina load
INFO: Initialization processed in 1822 ms
Jul 17, 2011 2:01:38 AM org.apache.catalina.realm.JAASRealm setContainer
INFO: Set JAAS app name Catalina
Jul 17, 2011 2:01:38 AM org.apache.catalina.core.StandardService start
INFO: Starting service Catalina
Jul 17, 2011 2:01:38 AM org.apache.catalina.core.StandardEngine start
INFO: Starting Servlet Engine: Apache Tomcat/6.0.32
Jul 17, 2011 2:05:38 AM org.apache.coyote.http11.Http11Protocol start
INFO: Starting Coyote HTTP/1.1 on http-8080
Jul 17, 2011 2:05:38 AM org.apache.catalina.startup.Catalina start
INFO: Server startup in 240732 ms
And in browser it showing:
JIRA Startup Failed
You cannot access JIRA at present. Look at the table below to identify the reasons
Description
The following plugins are required by JIRA, but have not been started:
* Gadget Directory Plugin (com.atlassian.gadgets.directory)
* Embedded Gadgets Plugin (com.atlassian.gadgets.embedded)
* Gadget Dashboard Plugin (com.atlassian.gadgets.dashboard)
* JIRA Gadgets Plugin (com.atlassian.jira.gadgets)
* Opensocial Plugin (com.atlassian.gadgets.opensocial)
Please help, My email id is deepakkumar16@gmail.com
Thanks in advance
And this is really the best tutorial for Jira on Linux, thanks for this also
i restarted Jira and its working fine now…thanks a lot for this tutorial
Please suggest me tutorial for Jira usage also, i am new to it. I have only knowledge of PSA.
i mean how to create users, groups, permissions, etc
Hi! I meet the same problem as you do. (The following plugins are required by JIRA, but have not been started:
) can you tell me how did you solve this? please help me, my email is julius1204@gmail.com
thinks a lot in advance!!
Same problem here.
But I'm using windows instead. I try to launch a local Jira by using Atlassian Plugin SDK. I followed the step-by-step documentation there. But everytime I get "JIRA has been locked" on cmd lineout and the message in the browser like above.
Does anybody has a suggestion?
Seika85
car[-dot-]arl[-dot-]85[-at-]gmail[-dot-]com
[SOLVED]
It seems the "new" Atlassian Plugin SDK v3.5.1 still does not support the "new" Java SDK 7 (v1.7.0).
Going back to AP SDK v3.4 and JDK6 solved all my problems.
For others with similar problems: Be also sure to not have any spaces in paths! Double check all this!
I needed to set a few paths in PATH, but that's described in the documentation and the comments there.
Thanks anyways.
Seika85
I've tried Plugin 3.6.2 and Java 7 and had the same problem. Downgrading to Java 6 helped, thank you a lot!
As a internet resource for corporations and know-how enthusiasts to adhere to the newest and best developments in Unified Communications, IP Telephony, Hosted Communications and VoIP.
Attempting to load JIRA from a war file archieve but can't find the start-jira.sh file after the war has been deployed. Also I don't see a bin directory under either installation directory or Jira-home directory. Any help would be greatly appreciated.
JIRA version 4.4.3, apache-tomcat 6.0.32
Thanks For Your Little bit Information . It help me a lot .
Thanks Once Again.
Hi I have installed everything but when i run jira, i get this on my logs
Using CATALINA_BASE: /opt/jira
Using CATALINA_HOME: /opt/jira
Using CATALINA_TMPDIR: /opt/jira/temp
Using JRE_HOME: /usr/java/jdk1.6.0_20
root@cingltd-vm1 [/opt/jira/bin]# tail -f ../logs/catalina.out
WARNING: Error unregistering MBeanServerDelegate
java.lang.NullPointerException
at org.apache.catalina.connector.MapperListener.destroy(MapperListener.java:171)
at org.apache.catalina.connector.Connector.stop(Connector.java:1179)
at org.apache.catalina.core.StandardService.stop(StandardService.java:593)
at org.apache.catalina.core.StandardServer.stop(StandardServer.java:744)
at org.apache.catalina.startup.Catalina.stop(Catalina.java:633)
at org.apache.catalina.startup.Catalina$CatalinaShutdownHook.run(Catalina.java:676)
29-Mar-2012 17:09:20 org.apache.coyote.http11.Http11Protocol destroy
INFO: Stopping Coyote HTTP/1.1 on http-8080