Skip to content
Oscar Javier Duque edited this page Sep 26, 2017 · 1 revision

IPT

Personalización de la herramienta IPT desarrollada por el GBIF

Historia en el SiB Colombia

Desde el año 2012 los IPT´s han sido el punto de entrada en el proceso de publicación de datos. Los primeros despligues del IPT tenian un fuerte componente de personalizaición en estilos y algunos IPT´s (CR-SiB y Biota) tuvieron modificaciones especiales en front-end y back-end de acuerdo a nuevos requerimientos funcionales. Desde principios del 2017, se definió que las personalizaciones de los IPT´s del SiB Colombia, serían únicamente en estilos y footer.

Introducción

A continuación se va a presentar lo necesario para tener una instancia del IPT corriendo en una máquina local.

Prerrequisitos

Al ser una herramienta desarrollada con Java, es necesario tener instalado JavaSE u OpenJDK. Específicamente es necesario tener instalado.

  • Java 7 o superior
  • Maven
  • Apache Tomcat 7 o superior

Instalación

A continuación se explicará la instalación en entorno de desarrollo.

Clonar el repositorio desde Github

El código del IPT tal como es publicado por GBIF se encuentra en el repositorio https://github.com/gbif/ipt

Las versiones de los diferentes releases se encuentran en los tags del repositorio, para ver como modificar una versión en específicos mirar Cómo descargar un tag específico

El código con las modificaciones del IPT se encuentran en el repositorio de GitHub en el branch master https://github.com/SIB-Colombia/ipt

git clone https://github.com/SIB-Colombia/ipt.git

Se pasa a la carpeta del ipt

cd ipt

Para poder abrir el código del IPT en Eclipse IDE, es necesario generar los archivos del proyecto de eclipse

mvn eclipse:eclipse

Teniendo en cuenta que se debe tener instalado maven, a continuación se instalan las librerías (En caso de seguir presentando fallas, se debe contactar a los desarrolladores de GBIF).

mvn install

Si se presenta error, se deben instalar las librerías sin correr las pruebas unitarias

mvn install -Dmaven.test.skip=true

Ya con esto es posible abrir el proyecto en eclipse.

Para correr el IPT en un servidor de pruebas Jetty (el cual está viene incluido en las librerías instaladas del IPT ) se debe correr el siguiente comando

mvn

Una vez el servidor Jetty suba el IPT, puede ser accedido en la URL localhots:8080

Despliegue en producción

Con el código del IPT (ya sea el descargado de los repositorios o modificado por el desarrallador), se debe generar un achivo .war donde estará contenido el codigo y las librerías necesarias para correr el IPT.

mvn package -Dmaven.test.skip=true

Esto debe generar un .war en la carpeta

Despues, en un servidor apache en el carpeta webapps, se debe poner el .war generado.

De acuerdo a la versión del servidor Tomcat, es necesario redireccionar la salida por el puerto 8080; que es el puerto por defecto del IPT; al puerto 80

iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080