MANUAL

PREPARACIÓN DEL ENTORNO DE TRABAJO

PARA EJECUCIÓN DEL SISTEMA

CASO: UBUNTU 16.04 LTS (LINUX)

Elaborado por:

ULISES VARGAS DE SOUSA

C.I.: 19.163.676
 INSTALACIÓN DE UBUNTU

El Sistema Operativo Ubuntu se puede instalar junto con el Sistema

Operativo Windows, mediante una partición. Es lo que se conoce como ​dual boot​,
que es la posibilidad de iniciar con ambos sistemas. Para ello debe reservarse
espacio del disco duro utilizando ​Administración de Discos ​en Windows. A
continuación se muestra el paso a paso:

1. Entrar en ​Panel de Control ​hacer click sobre ​Sistema y Seguridad ​y dentro

de ​Herramientas Administrativas ​hacer click en ​Crear y formatear
particiones del Disco Duro. ​SHORTCUT: Teclear ​diskmgmt.msc ​en el
menú de búsqueda de inicio en Windows. Al hacer clic en ​Administración de
discos ​debe aparecer esta ventana:

1
2. Hacer click derecho en la unidad que se desee “reducir”. Debe tomarse en
cuenta que para la instalación de Ubuntu se requiere al menos 20 GB de
espacio en disco. La unidad debe reducirse para dejarse un espacio no
asignado que es donde se instalará Ubuntu. Este menú debe aparecer:

3. Se desplegará esta ventana. Automáticamente el sistema calculará cuánto

espacio disponible puede reducir, y a partir de ese espacio se debe reducir
utilizando “Tamaño del espacio que desea reducir en MB”

2
4. El siguiente paso es configurar la unidad que contendrá la imagen de Ubuntu
para instalarse. Para ello el programa Rufus es útil, no requiere ser instalado
en Windows. Debe haberse descargado previamente desde ​la página oficial
de Ubuntu la imagen de CD correspondiente (32 o 64 bits). Mediante una
unidad USB crearemos un disco booteable para la instalación de Ubuntu.
Como tipo de partición se selecciona ​MBR para BIOS o UEFI y se selecciona
la imagen previamente descargada. Esta es la ventana del programa Rufus:

3
5. Lo siguiente es configurar el orden de arranque del equipo, para que el
mismo inicie desde la unidad USB. Dependiendo del equipo, generalmente es
la tecla F11. En la mayoría de laptops debe tomarse en cuenta que las teclas
del F1 al F12 se activan pulsando simultáneamente la tecla Fn.
6. El siguiente menú se desplegará. Permite probar Ubuntu sin instalar (Live
CD) o Instalarlo directamente. El proceso de instalación es automático y toma
alrededor de 4 minutos (sin las descargas adicionales):

4
7. Se selecciona español como idioma de instalación. Para ahorrar más tiempo
se pueden seleccionar descargas adicionales y evitar tener que hacerlo ya en
el sistema instalado. Se selecciona ​Instalar Ubuntu junto a Windows​,
evitando tener que crear particiones. El sistema automáticamente reconocerá
la partición libre y se instalará en ella. El siguiente menú debe aparecer:

8. Se reinicia el sistema retirando la unidad USB, y aparecerá el siguiente menú,

el cual permite seleccionar con cual sistema iniciar:

5
6
 INSTALACIÓN DE JAVA Y MAVEN EN UBUNTU

Para la ejecución de los sistemas desarrollados con JHipster es necesario

contar con el Java Development Kit (JDK) y Apache Maven, en Ubuntu. A diferencia
de Windows, Ubuntu y todos los sistemas basados en Debian (Linux) no suelen
poseer instaladores. Para poder instalar cualquier programa o dependencia es
necesario hacer uso del terminal de Ubuntu. Para ello se pulsa simultáneamente la
combinación de teclas ​Ctrl + Alt + T.

Ubuntu cuenta con un servidor de descargas, que permite ubicar el paquete a

ser descargado de forma automática, a menos que el paquete se quiera descargar
desde una fuente no autorizada, en cuyo caso debe contarse con una clave privada.
En la mayoría de los casos, el servidor ubica el paquete. A continuación el paso a
paso de cómo instalar Java y Maven en Ubuntu utilizando la terminal del mismo.

1. Descargar Java 8: ​El primer paso es teclear la siguiente combinación: ​sudo

add-apt-repository ppa:webupd8team/java. ​Es indicarle al repositorio de
paquetes el paquete, valga la redundancia, a ser descargado.
2. Instalar la última versión estable de Java 8: ​Ahora, ya con el paquete
descargado, se procede a instalarlo en el sistema utilizando la siguiente
combinación: ​sudo apt update; sudo apt-get install oracle-java8-installer.
3. Verificar versión instalada: ​Con la combinación que muestra la siguiente
imagen se puede verificar que en efecto ya se tiene instalado Java en el
sistema:

5. Dirigirse a la carpeta /opt: ​En Ubuntu, para dirigirse desde el terminal hacia
una carpeta o directorio específico se utiliza el comando ​cd​. En este caso
Apache Maven debe instalarse no en home, sino en el directorio opt. Para
ello se utiliza la siguiente combinación: ​cd /opt.

7
6. Descargar Apache Maven: ​Apache Maven no está dentro de los repositorios
de Ubuntu. Aún así, se puede descargar utilizando el poderoso comando
wget. ​Para esto, se utilizará el siguiente comando: ​sudo wget
http://www-eu.apache.org/dist/maven/maven-3/3.3.9/binaries/apache-ma
ven-3.3.9-bin.tar.gz. ​Esto descargará desde la web oficial la versión 3.3.9 de
Apache. Si se desea una versión superior se modifica el número de la misma.
7. Extraer el paquete descargado: ​El paquete descargado está comprimido,
es un .tar (similar a .rar en Windows). Para descomprimirlo se ejecuta el
siguiente comando: ​sudo tar -xvzf apache-maven-3.3.9-bin.tar.gz
8. Renombrar el directorio contenedor: ​Se procede a renombrar el directorio
o carpeta contenedora con el siguiente comando: sudo mv
apache-maven-3.3.9 maven. ​No solo cambiará el nombre del directorio a
maven sino que lo moverá hacia el mismo.
9. Instalar Maven: ​Comando: ​sudo apt-get install maven
10. Ajustando variables de entorno: ​Al igual que en Windows, deben ajustarse
las variables de entorno para que reconozca la versión de Java/Maven. La
única diferencia es que esto se realiza en Ubuntu fácilmente por la terminal.
Primero debe teclearse el siguiente comando, con el fin de crear un archivo
llamado mavenenv.sh ​dentro del directorio /etc/profile.d/: ​sudo nano
/etc/profile.d/mavenenv.sh. ​Esto abrirá el editor de archivos “nano” desde la
consola. Lo segundo es añadir las siguientes líneas al archivo:
export M2_HOME=/opt/maven
export PATH=${M2_HOME}/bin:${PATH}
Luego se teclea ctrl + X para cerrar y guardar los cambios, lo cual pedirá
confirmación.
11. Cargando las variables de entorno: ​El siguiente paso es para cargar las
variables de entorno dentro del sistema, el mismo se realiza una única vez:
sudo source /etc/profile.d/mavenenv.sh
12. Verificar versión instalada: ​El último paso es verificar la versión de Maven
instalada en el sistema, con el comando que muestra la siguiente imagen:

8
 INSTALACIÓN DE GIT
Con el fin de poder clonar los repositorios de Setech en el sistema, es
necesario instalar GIT, el mismo se instala fácilmente mediante el siguiente
comando a través de la terminal: ​sudo apt-get install git. ​Cabe señalar que todos
los comandos de git, como por ejemplo ​git clone ​(para clonar el repositorio) deben
antecederse de la palabra ​sudo.

INSTALACIÓN DE NODE.JS Y NPM

Este paso solo es necesario para evitar un conflicto de dependencias que

puede surgir durante la instalación de JHipster. De todas formas es importante tener
Node.js y NPM instalados para cualquier desarrollo a futuro donde se utilice
Javascript del lado del servidor. Para ello fácilmente se ejecutan los siguientes
comandos en orden que instalarán la última versión estable de Node.js:

1. sudo apt-get update && sudo apt-get -y upgrade

2. curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
3. sudo apt-get install -y nodejs

Por último se comprueba la versión de Node.js y NPM instaladas en el

sistema, como muestra la siguiente imagen:

9
 INSTALAR BOWER, YEOMAN Y JHIPSTER

1. sudo npm install -g yo

2. sudo chown -R $(whoami) ~/.npm
3. npm config set prefix ~/npm
4. export PATH="$PATH:$HOME/npm/bin"
5. npm install -g bower
6. npm install -g generator-jhipster

INSTALAR INTELLIJIDEA

IntelliJIdea es un editor de código bastante versátil y eficiente para desarrollar

en Java. El mismo se instala fácilmente a través del terminal, utilizando Ubuntu
Make, el cual es una línea de comando que permite descargar las últimas versiones
de las herramientas para escribir código junto a sus dependencias. Para esto, se
escriben en orden los siguientes comandos:

1. sudo add-apt-repository ppa:ubuntu-desktop/ubuntu-make

2. sudo apt-get update
3. sudo apt-get install ubuntu-make
4. umake ide idea (para instalar la versión Community de IntelliJIdea)
5. umake ide idea-ultimate (para instalar la versión Ultimate de
IntelliJIdea).*

*​Para los desarrollos actuales en Setech se estará utilizando la versión Ultimate. (La
licencia es el servidor: http://idea.imsxm.com/)

INSTALAR POSTGRESQL Y PGADMIN3

PostgreSQL es el manejador de base de datos ​open-source ​más confiable y

seguro del momento. El mismo cuenta con un gestor gráfico llamado PGAdmin. Se
utilizará la versión 3 por ser la más ligera. Para la instalación de ambos debe de
colocarse en orden los siguientes comandos:

1. sudo apt-get install postgresql postgresql-contrib

2. sudo apt-get install pgadmin3

10
 A continuación se configura la clave de usuario de Postgres a través de la
terminal de Ubuntu mediante los siguientes comandos:

1. sudo -u postgres psql postgres

2. \password postgres
3. (se ingresa el password deseado 2 veces) ​(para los desarrollos SETECH
usaremos 321321)
4. \q

CLONAR REPOSITORIO

El siguiente paso es clonar el repositorio, toda vez que se haya otorgado el

acceso al mismo. Para ello, desde la terminal se escribe el siguiente comando:
sudo git clone (url del repositorio). ​Solicitará el password de Bitbucket, cabe
recordar que el mismo (como todos los password en la terminal Ubuntu) no se
visualiza en pantalla pero si se reciben. ​Si se desea copiar y pegar la url del
repositorio, en la terminal de Ubuntu los comandos son ​Ctrl + Shift + C ​para copiar
y ​Ctrl + Shift + V ​para pegar.

CREAR DB EN POSTGRES

Debe crearse una Base de Datos en Postgres, a través de PGAdmin3, para

que el sistema corra las entidades en ella. Para esto, se abre PGAdmin3 utilizando
“Buscar en el equipo”​, el primer ícono de la barra lateral de Ubuntu. Y cuando
aparezca el logo de PGAdmin cliquear en ​“Lanzar”​. Cuando el logo de PGAdmin
esté en la barra lateral dar clic derecho y seleccionar ​“Mantener en el lanzador”​.

El primer paso es crear un Servidor en Postgres. El nombre del servidor será

localhost ​y el puerto será ​5432​, como muestra la siguiente imagen:

11
 Lo segundo es crear la Base de Datos como tal, para ello se debe hacer clic
derecho en ​Databases ​y seleccionar ​New Database. ​Justo allí se procederá a
colocarle un nombre a la DB, por ejemplo “siges”, como muestra la siguiente
imagen:

CONFIGURAR LA DB EN EL PROYECTO

Lo siguiente es configurar la Base de Datos con las mismas variables locales.

Para ello se debe abrir IntelliJIdea y dirigirse a la siguiente dirección del proyecto:

(proyecto) > src > main > resources > config > application-dev.yml

12
 Toda vez allí, se deben colocar en ​name ​el nombre de la base de datos
creada, en ​username ​postgres, y en ​password ​la contraseña asignada a postgres.
También, en url colocar al final el nombre de la base de datos creada, tal cual como
muestra la imagen a continuación:

EJECUTAR EL SISTEMA

Debe realizarse una corrida inicial del sistema, antes de ejecutar los scripts
iniciales en Base de Datos. Para ello, en una terminal nueva dirigirse al directorio del
proyecto utilizando el comando ​cd. ​Toda vez allí, ejecutar el comando ​mvn

El sistema comenzará a ejecutarse y al final de la terminal dirá en qué puerto

se está ejecutando el sistema, como muestra la siguiente imagen:

13
 Al dirigirnos al puerto 8181 a través del navegador (localhost:8181)
observamos la aplicación corriendo como muestra la imagen a continuación
(inicialmente la aplicación pedirá usuario, admin y contraseña, admin):

14
 SCRIPTS INICIALES DEL SISTEMA

Dentro del sistema existen scripts que contienen la información de las

entidades (tablas) del sistema, como proveedores, patologías, etc., los mismos se
encuentran en la carpeta ​db_scripts ​y deben ejecutarse en el siguiente orden:

1. InfoInicial_db.sql*
2. proveedores_db.sql
3. servicioitems_db.sql

*​Colocar extensión .sql a cada archivo para abrirlos con Postgres.

Primero se debe ubicar en la base de datos deseada y darle clic en el icono

SQL en la parte superior, como muestra la siguiente imagen:

Luego, se debe dar clic en el icono de carpeta para buscar los scripts y por
ultimo ​Execute query que es el icono de inicio en la parte superior. Cada script
debe ejecutarse en el orden señalado anteriormente uno por uno. La siguientes
imágenes muestran cómo abrir y ejecutar los scripts:

15
16
 EJECUCIÓN DEL SISTEMA DESPUÉS DE LOS SCRIPTS

Después de esto se ejecuta el sistema de nuevo de la misma forma señalada

líneas arriba. Con esto, ya se encuentran pobladas las entidades (tablas) para la
creación de siniestros.

17