Al ser un proyecto MAVEN, no requiere un IDE en específico, sin embargo esta es la configuración usada:

• JDK 7 o mayor
• IDE:Eclipse Luna
• Marketplace:
  • Spring Tools
• Maven 3.0 o mayor

El proyecto requiere de maven 3 para su configuración, si está instalando Maven a través de los repositorios de las distribuciones linux, asegurese que la versión es igual o mayor a la 3, en caso de que no, puede descargarlo de maven.apache.org/download.cgi, e instalarlo simplemente descomprimiendo el archivo descargado.

Si existe alguna otra instalación de Maven, asegúrese de modificar el path de ejecución del sistema para que utilice la instalación que descargó del sitio maven, para verificar la versión utilice el comando mvn –version .

Git es el sistema de control de versiones, para descargar el proyecto siga los siguientes pasos

1. Cree una llave rsa pública y envíela al administrador del sistema Git para que la registre como permitida. Una guía la encuentra en help.github.com/articles/generating-ssh-keys/
2. Ubíquese en el directorio donde desea descargar el proyecto y clónelo utilizando el siguiente comando: git clone http://nukak.cnsc.net/SIMO/simo.git, esto creará un subdirectorio SIMO con las fuentes del proyecto, incluyendo un proyecto preconfigurado para eclipse.
3. Cuando realice cambios al proyecto, utilice los comandos git commit y git push para actualizar los cambios en GIT

El IDE de desarrollo recomendado es Eclipse Luna for Java EE developers o una versión superior, se recomienda instalar la versión que se descarga de eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/lunasr1

Adicionalmente se recomienda instalar el conjunto de herramientas de desarrollo de Spring, para ello, una vez instalado Eclipse, ejecutelo y acceda a Eclipse MarketPlace en el menú Help, allí busque el plugin Spring Tool Suite e instale la versión 4.4 o una más reciente que sea adecuada para su versión de Eclipse

Adicionalmente, si queremos controlar el proyecto maven desde Eclipse, debemos tener el plugin Maven Integration for Eclipse, aunque es muy posible que este plugin ya venga instalado con Eclipse por defecto, si no es así, instale el plugin desde Eclipse MarketPlace de manera similar al anterior

El motor de base de datos a utilizar en el proyecto es PostgreSQL versión 9 o mayor. Esta versión es fácilmente instalable, utilizando los repositorios de las distribuciones Linux o descargando los instaladores directamente del sitio www.postgresql.org/.

Se recomienda crear una base de datos y un usuario de postgres específicos para el proyecto, el código contenido en el repositorio está configurado para utilizar un usuario con nombre sigeca, con password idéntico y dueño de una base de datos también llamada sigeca. Para crear estos artefactos puede ejecutar los siguientes comandos desde el usuario postgres del sistema operativo (En Linux).

createuser -P sigeca Este comando creará el usuario sigeca y preguntará por su password

createdb sigeca -O sigeca

Este comando creará la base de datos sigeca y le asignará como dueño el usuario sigeca recién creado.

Recuerde que para poder acceder a esta base de datos desde el servidor que ejecuta el código del proyecto se recomienda otorgar permisos de acceso por red en el archivo pg_hba.conf a la dirección ip del computador que ejecuta el servidor Tomcat con la aplicación.

Si desea utilizar otros parámetros de configuración, debe alterar el archivo src/main/resources/application.properties para reflejar la configuración deseada.

Para compilar el proyecto desde Eclipse, seleccione la raíz del proyecto, de click derecho y aplique la opción Maven Update Project, esta opción actualizará las dependencias Maven del proyecto y luego lanzará un proceso de construcción que debe concluir con la compilación exitosa del proyecto.

Es posible que encuentre algunos errores en archivos XSL o Javascript, estos errores pueden ser ignorados puesto que son utilitarios del Framework de interfaz gráfica DOJO y no deben afectar la ejecución de la aplicación.

El proyecto está construido con base en el framework Spring Boot, este framework, permite el desarrollo rápido de aplicaciones sin necesidad de realizar actividades de despliegue en servidores de aplicaciones o contenedores Web.

Esto se debe a que el framework contiene un servidor Apache Tomcat embebido y liviano que es levantado cada vez que se ejecuta la aplicación. Para ejecutar entonces la aplicación utilice el comando

mvn spring-boot:run

Este comando se encarga de realizar todas las configuraciones necesarias, levantar el servidor y desplegar en este la aplicación, tenga en cuenta que el servidor embebido se ejecuta por defecto en el puerto 8080 por tanto debe tener cuidado con que no haya otro servidor Apache Tomcat ejecutándose o algún otro programa ocupando este puerto.

Por último, el proyecto esta configurado para que autogenere las tablas necesarias en base de datos, de esta forma es posible mantener actualizada la base de datos a partir del código, si bien Hibernate intentará actualizar las tablas inteligentemente, no es posible garantizar que el proceso este libre de errores completamente, en tal caso debe eliminar la base de datos y volverla a crear o corregir los errores manualmente.

Por último, este comando es posible ejecutarlo desde Eclipse, si instaló las herramientas Spring para Eclipse (Spring Tool Suite), puede utilizar el menú run as –> Spring Boot App, que se puede acceder haciendo click derecho sobre algún artefacto del proyecto o desde la raíz.