El procedimiento de instalación de Hudson en Linux tiene un procedimiento similar al de Windows. Consiste en descargar Tomcat, descomprimirlo en una carpeta asignada y posteriormente descargar Hudson y realizar el proceso de despliegue.
Para continuar con este procedimiento debe tener un JDK instalado. Si no lo tiene vaya al sitio de descargas en http://java.sun.com/javase/downloads/index.jsp e instálelo.
Instalación de Apache Tomcat
1. Descargue Tomcat de su sitio oficial visitando http://tomcat.apache.org/ y seleccionando la descarga que prefiera, ojalá la versión más actualizada. Durante la creación de este documento utilicé la versión 6.x.
2. Seleccione el archivo a descargar. Las instrucciones de tutorial están hechas para el archivo .zip, aunque realmente no hay mucha diferencia si descarga el tar.gz
3. Seleccione una carpeta para instalar el contenedor, puede ser una de las comunes como /opt o /usr/local y realizar la instalación con privilegios de root. En mi caso y por facilidad seleccione una de mi carpeta home: /home/czuluaga/tutorialhudson.
4. De acuerdo a la carpeta seleccionada puede requerir el usuario root o usar el comando sudo para algunas operaciones. Asumiendo que ya tiene permisos de escritura sobre la carpeta y que descargó los programas en el escritorio (/home/<usuario>/Desktop o /home/<usuario>/Escritorio) siga los pasos indicados:
- Copie el archivo descargado en la carpeta.
- Descomprima el archivo con el comando unzip <archivo> (o el equivalente para el tar.gz tar xzf <archivo>).
- Ingrese al directorio bin de la carpeta creada en la descompresión. En mi caso /home/czuluaga/tutorialhudson/apache-tomcat-5.5.28/bin.
- Asigne permisos de ejecución a todos los archivos .sh con el comando chmod +x *.sh.
5. Este proceso también lo puede hacer gráficamente a través del navegador de archivos, incluso la asignación de permisos de ejecución y el resultado no cambia:
6. Antes de iniciar el contenedor debe tener creadas las variables de entorno $JAVA_HOME y $CATALINA_HOME. Si no las tiene creadas edite el archivo /etc/profile si está trabajando con root o /home/<usuario>/.profile si está trabajando con otro usuario y agregue las líneas:
export JAVA_HOME=<ubicación del JDK>
export CATALINA_HOME=<carpeta de instalación de Tomcat>
Por ejemplo:
export JAVA_HOME=/usr/lib/jvm/java-6-sun-1.6.0.16
export CATALINA_HOME=/home/czuluaga/tutorialhudson/apache-tomcat-5.5.28
7. Si no sabe donde está ubicado su jre puede ubicarlo siguiendo los enlaces simbólicos creados para los comandos java o javac: Ejecute whereis java y siga los enlaces hasta que encuentre la carpeta de instalación como muestra la figura:
La ubicación de su JDK es /usr/lib/jvm/java-6-sun-1.6.0.16.
8. Para que el cambio sea tomado inmediatamente ejecute el archivo profile con el comando sh /home/czuluaga/.profile. Para verificar que la variable de entorno se haya creado definitivamente reinicie el sistema operativo.
9. Con las variables de entorno puede ejecutar alguno de los siguienes comandos para iniciar el contenedor:
$CATALINA_HOME/bin/catalina.sh run para que vea el log del contenedor en la misma ventana.
$CATALINA_HOME/bin/catalina.sh start para iniciar el contenedor en otra ventana. El log lo puede ver en $CATALINA_HOME/logs/catalina.out.
El listado de comandos que puede ejecutar lo muestra el mismo comando $CATALINA_HOME/bin/catalina.sh:
Usage: catalina.sh ( commands ... )
commands:
debug Start Catalina in a debugger
debug -security Debug Catalina with a security manager
jpda start Start Catalina under JPDA debugger
run Start Catalina in the current window
run -security Start in the current window with security manager
start Start Catalina in a separate window
start -security Start in a separate window with security manager
stop Stop Catalina
stop -force Stop Catalina (followed by kill -KILL)
version What version of tomcat are you running?
10. Si inició el contenedor con start el log lo puede ver con el comando tail de la siguiente forma:
tail -f $CATALINA_HOME/logs/catalina.out
Instalación de Hudson
1. Descargue Hudson de su página oficial en http://hudson-ci.org/.
2. Copie el war descargado en la carpeta de aplicaciones de Tomcat ubicada en $CATALINA_HOME\webapps y reinicie Tomcat ejecutando en el mismo orden los archivos $CATALINA_HOME\bin\catalina.sh stop y $CATALINA_HOME\bin\catalina.sh start.
3. Puede verificar la salida del contenedor en el archivo $CATALINA_HOME/logs/catalina.out con el comando tail -fn100 catalina.out. El 100 es para que muestre las últimas 100 líneas en las que podemos ver que el contenedor inició la ejecución de Hudson.
4. Visite la dirección http://localhost:8080/hudson y verá la página de inicio de Hudson o un mensaje indicando que la aplicación está arrancando. Si sale la segunda pantalla espere unos segundos y refresque la página (aunque esta debería refrescarse sola).
5. Listo, si pudo ver Hudson funcionando, el proceso de instalación fue exitoso.