JIRA es un ussue tracker, es decir una herramienta que te permite realizar un seguimiento de incidencias en el desarrollo de software.

1. Instalación de la versión Standalone

Para instalar JIRA en ubuntu, primero debes instalar el jdk

scx7@suki:~$ sudo apt-get install sun-java6-jdk

También hay que instalar tomcat, para lo cual es mejor si nos descargamos los binarios, yo me descargué  apache-tomcat-6.0.18, lo descomprimimos en cualquier parte, yo lo puse en mi home folder.

Luego seteamos las variables globales JAVA_HOME Y JRE_HOME, hay varias formas, una de ellas es escribiendo en el archivo .bashrc (debes estar en tu directorio home).

scx7@suki:~$ gedit ./.bashrc

y al final del archivo escribimos la dirección de las variables:

export JAVA_HOME=/usr/lib/jvm/java-6-sun-1.6.0.10
export JRE_HOME=/usr/lib/jvm/java-6-sun-1.6.0.10/jre
export CATALINA_HOME=/home/scx7/apache-tomcat-6.0.18

Ahora procedemos a descargar JIRA, la versión para linux, yo descargué el Professional – Standalone, lo descomprimimos en cualquier carpeta, yo igualmente lo guardé en el home  y lo renombré a “jira”.

Si deseas puedes cambiar el puerto de jira, para que funcione en otro distinto al de :8080, que viene por defecto, esto se hace modificando el archivo server.xml

scx7@suki:~$ gedit ./jira/conf/server.xml

y en donde dice <Connector port=”8080″, le cambias el número de puerto por otro, yo le puse 9080.

Ahora sólo tienes que iniciar jira:

scx7@suki:~$ sudo -E ./jira/bin/startup.sh

Nota: Se utiliza -E para preservar el environment, sino te va a salir error, que las variables JAVA_HOME ni JRE_HOME han sido definidas. Si te pasa esto, simplemente escribe:

scx7@suki:~$ export JAVA_HOME=/usr/lib/jvm/java-6-sun-1.6.0.10

y vuelve a ejecutar el startup.sh, pero con sudo -E

Y por fin ya podréis entrar a JIRA: http://localhost:9080/secure/Dashboard.jspa

2. Instalación de la versión WAR/EAR

Sin embargo la versión Standalone de jira se conecta automáticamente a una base de datos HSQLDB, lo cual estaría bien para propósitos de evaluación, pero hay que tener en cuenta que los datos se podrían corromper, si vas a usarla en serio hay que instalar la versión JIRA WAR/EAR. Luego descomprimir y renombrar, yo lo puse en el home con el nombre jirawar.

También hay que instalar una base de datos, recomiendo postgres, pues con mysql a veces da error con el tomcat, para instalarlo basta con escribir:

scx7@suki:~$ sudo aptitude install postgresql-8.3 postgresql-client-8.3 pgadmin3

establecemos la contraseña:

scx7@suki:~$ sudo passwd postgres

Si quieres más detalles de la instalación de postgres aca un tutorial.
Creamos una base de datos para jira (la cual nombré jira), así como un usuario para esa tabla.

Descargas el driver JDBC3.

Antes que nada primero vamos a configurar jira para que se conecte con postgres, para lo cual modificamos cierto archivo:

scx7@suki:~$ gedit ./jirawar/edit-webapp/WEB-INF/classes/entityengine.xml

—

<datasource name="defaultDS" field-type-name="postgres72"
      schema-name="public"

—
Nota: Debe estar public en minúsculas, si está en mayúsculas cambiale.
luego mandamos a compilar jira:

scx7@suki:~/jirawar$ sudo ./build.sh

Una vez compilado jira, tenemos que parar tomcat para luego actualizar, porque hay algunas librerías que se requieren para correr jira, por lo que tienes que descargar estos archivos y copiarlos a la carpeta lib de tomcat.

scx7@suki:~$ sudo -E ./apache-tomcat-6.0.18/bin/shutdown.sh

Ahora vamos a configurar tomcat porque jira necesita establecerse, sólo hay crear una carpeta llamada Catalina dentro de la carpeta conf de tomcat, y dentro de esta una llamada localhost, por lo que quedaría así:

apache-tomcat-6.0.18/conf/Catalina/localhost

y en esta carpeta pegamos el archivo que debemos copiar de jirawar/dist-tomcat/tomcat-6/jira.xml

Ahora debemos modificar el archivo que acabamos de copiar el jira.xml, para conectarnos a postgres:
—

<Context path="/jira" docBase="/home/scx7/jirawar/dist-tomcat/tomcat-6/atlassian-jira-3.13.4.war" debug="0">
    <Resource name="jdbc/JiraDS" auth="Container" type="javax.sql.DataSource"
            username="nombreDeUsuario"
            password="tuContraseña"
            driverClassName="org.postgresql.Driver"
            url="jdbc:postgresql://localhost:5432/jira" />
    <Resource name="UserTransaction" auth="Container" type="javax.transaction.UserTransaction"
    factory="org.objectweb.jotm.UserTransactionFactory" jotm.timeout="60"/>
    <Manager pathname=""/>
</Context>

—
Nota: el jdbc:postgresql://localhost:5432/jira es el string de conexión, donde jira es el nombre de la base de datos que hemos creado.

Ahora debemos poner el driver JDBC3 que descargamos en el directorio lib en la carpeta del tomcat.

Para no tener problemas luego con caracteres internacionalizados, vamos a agregar [useBodyEncodingForURI="true"] al archivo server.xml

scx7@suki:~/apache-tomcat-6.0.18/conf$ gedit server.xml

—

 <Connector port="9080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" useBodyEncodingForURI="true" />

—
Antes de terminar, para tampoco tener problemas con el límite en el tiempo de conexión es recomendable crear un archivo .sh:

scx7@suki:~/apache-tomcat-6.0.18/bin$ gedit setenv.sh

escribimos lo siguiente y guardamos:

export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true"

Ahora sí, finalmente sólo tienes que iniciar tomcat:

scx7@suki:~$ sudo -E ./apache-tomcat-6.0.18/bin/startup.sh

Y entrar en: http://localhost:9080/jira/ para la instalación por wizards

Enjoy

Fuentes:

http://www.atlassian.com/software/jira/docs/latest/servers/tomcat60.html
http://www.atlassian.com/software/jira/docs/latest/databases/postgres.html
http://confluence.atlassian.com/display/JIRACOM/Install+JIRA+on+Debian+or+Ubuntu