EVALÚA S.A.S.

1

GUIA DE INSTALACION HERRAMIENTA EVALUA

Contenido 1. Instalar y configurar JAVA ..........................................................................................................2

2. Instalar y configurar Postgresql y PgAdmin3 ..............................................................................5

3. Crear base de datos Herramienta Evalúa .................................................................................10

4. Instalar y configurar Apache Tomcat ........................................................................................21

5. Configurar variables del sistema o variables de entorno..........................................................28

6. Iniciar y Detener Apache Tomcat .............................................................................................32

7. Desplegar WAR Proyecto Evalúa: .............................................................................................34

8. Probar Herramienta Evalúa ......................................................................................................38

EVALÚA S.A.S.

2

Requisitos del sistema:

Windows XP

Windows 7

Windows 8

Nota: Se recomienda un mínimo de 2GB de memoria RAM. También necesitará un

mínimo de 20GB de espacio libre en disco.

Instaladores requeridos:

postgresql-9.3.6-2-windows-x64.exe (Si el servidor es de 64 bits)

postgresql-9.3.6-2-windows.exe (Si el servidor es de 32 bits)

pgadmin3-1.18.1.zip

jdk-8u40-windows-x64.exe (Si el servidor es de 64 bits)

jdk-8u40-windows-i586.exe (Si el servidor es de 32 bits)

apache-tomcat-8.0.15.zip

ROOT.tar.gz

scriptdb.sql

La carpeta INSTALACION_EVALUA entregada por Evalúa SAS, debe ser copiada

en el disco local “C:”, para poder ejecutar los comandos del manual.

Nota: La IP: 192.168.16.38 que se utilizará en el desarrollo de la guía de

instalación, es una IP de ejemplo, este valor debe ser cambiado según la IP que

asignen al Computador para la Instalación de la Herramienta Evalúa.

PROCESO DE INSTALACION

1. Instalar y configurar JAVA 1.1. Ejecutar el instalador de JAVA ubicado en la carpeta

INSTALACION_EVALUA/INSTALADORES/JAVA y según los 32 o

64 bits de su sistema operativo identifique el instalador.

1.2. Si el sistema pide autorización para realizar cambios en el equipo

“¿Desea permitir que este programa realice cambios en el equipo?,

pulse el botón “Sí” y continúe con el proceso.

EVALÚA S.A.S.

3

1.3. Pantalla inicial

Clic al botón “Next >” o “Siguiente >”

1.4. Características de Instalación

Clic al botón “Next >” o “Siguiente >”

EVALÚA S.A.S.

4

1.5. Estado del proceso

Esperar mientras el proceso termina.

1.6. Pantalla final del proceso de instalación

Cuando visualice esta pantalla, el proceso de instalación habrá

terminado satisfactoriamente.

Dar clic al botón “Close” o “Salir”

1.7. Comprobar la instalación de JAVA

1.7.1. Presionar las teclas Windows + R

1.7.2. Digitar “cmd” y dar clic en el botón “Aceptar”

1.7.3. Digitar la siguiente instrucción de Windows:

java –versión

EVALÚA S.A.S.

5

El resultado que debe obtener es el de la imagen:

2. Instalar y configurar Postgresql y PgAdmin3 2.1. Ejecutar el instalador de postgresql ubicado en la carpeta

INSTALACION_EVALUA/INSTALADORES/POSTGRES-PGADMIN y

según los bits de su sistema operativo identifique el instalador.

2.2. Si el sistema pide autorización para realizar cambios en el equipo

“¿Desea permitir que este programa realice cambios en el equipo?,

pulse el botón “Sí” y continúe con el proceso.

2.3. Pantalla inicial

Clic al botón “Next >” o “Siguiente >”

EVALÚA S.A.S.

6

2.4. Directorio de Instalación

Clic al botón “Next >” o “Siguiente >”

2.5. Directorio de datos

Clic al botón “Next >” o “Siguiente >”

EVALÚA S.A.S.

7

2.6. Contraseña

Crear contraseña para el superusuario base de datos postgres

(Guardar esta contraseña para pasos posteriores en la instalación)

Clic al botón “Next >” o “Siguiente >”

2.7. Puerto

Clic al botón “Next >” o “Siguiente >”

EVALÚA S.A.S.

8

2.8. Configuración regional

Seleccionar en el campo Configuración regional: Spanish, colombia

Clic al botón “Next >” o “Siguiente >”

2.9. Listo para instalar

EVALÚA S.A.S.

9

Clic al botón “Next >” o “Siguiente >”

2.10. Instalando

Espere mientras el proceso termina.

2.11. Terminada la instalación de PostgreSQL

Quitar la selección de Stack builder que está por defecto.

Dar clic al botón “Terminar”.

EVALÚA S.A.S.

10

2.12. Comprobar la instalación de PostgreSQL y PgAdmin3

Ir a inicio en Windows y buscar la carpeta PostgreSQL.

3. Crear base de datos Herramienta Evalúa 3.1. Abrir PgAdmin III: Inicio->Todos los programas->PostgreSQL 9.3

(x86)->pgAdmin III

EVALÚA S.A.S.

11

3.2. Bienvenido a pgAdmin III

3.3. Abrir base de datos por defecto “PostgreSQL”

Dar doble clic donde indica la imagen

EVALÚA S.A.S.

12

3.4. El sistema pide la contraseña del superusuario postgres (creada en

el paso 2.6)

Digitar la contraseña y dar clic en “OK”

3.5. Crear nuevo “Login Roles”

Dar clic derecho sobre “Login Roles” y luego dar clic a “New Login

Role…”

EVALÚA S.A.S.

13

3.6. Crear Login Role evalua

3.6.1. Pestaña Properties

Role name: evalua

3.6.2. Pestaña Definition

Password: evaluatol2015

Password: evaluatol2015

Connection Limit: -1

Nota: La clave evaluatol2015 es obligatoria para la instalación,

no se puede cambiar.

Guardar la contraseña para usarla en el punto 3.9.6.

EVALÚA S.A.S.

14

3.6.3. Pestaña Role privileges

Seleccionar todos los campos.

Luego de completar los pasos anteriores, dar clic al botón

“OK”.

3.7. Crear New Database

Dar clic derecho sobre “Databases” y luego dar clic a “New

Database…”

EVALÚA S.A.S.

15

3.8. Crear Database “evalua_tolima”

3.8.1. Pestaña Properties

Name: evalua_tolima

Owner: evalua (Rol creado en el punto 3.6)

Comment: (Cualquier comentario)

EVALÚA S.A.S.

16

3.8.2. Pestaña Definition

Encoding: UTF8

Template: Sin seleccionar

Tablespace: pg_default

Collation: Spanish_Colombia.1252

Character type: Spanish_Colombia.1252

Connection Limit: -1

3.8.3. Luego de completar los pasos anteriores, dar clic al botón

“OK”.

Con estos pasos se ha creado la base de datos en blanco,

donde se procederá a restaurar el script de la base de datos

que contiene toda la estructura de tablas, vistas, relaciones y

datos.

3.9. Restaurar script base de datos “evalua_tolima”

3.9.1. El script está ubicado en la carpeta

INSTALACION_EVALUA/INSTALADORES/SCRIPTDB

3.9.2. Ejecutar Script desde cmd

3.9.3. Presionar las teclas Windows + R

3.9.4. Digitar “cmd” y dar clic en el botón “Aceptar”

EVALÚA S.A.S.

17

3.9.5. Ir a la ubicación de instalación de PostgreSQL y pararse sobre

el directorio “bin”. Puede copiar la dirección como lo muestra

la imagen.

El comando para usar es “cd” y en la imagen se muestra un ejemplo:

cd C:\Program Files\PostgreSQL\9.3\bin

Nota: La ruta de ubicación de la carpeta “bin” varía según la ruta de

instalación de su equipo. Para Asegurar la ruta, ir al directorio como

lo muestra la imagen anterior. No olvidar el comando “cd” antes de la

ruta.

Luego de completar el comando presionar la tecla ENTER.

EVALÚA S.A.S.

18

3.9.6. Comando “psql” restaurar.

Digitar el siguiente comando:

Copie el siguiente comando y péguelo en la ventana de CMD o símbolos del

sistema y oprima la tecla ENTER.

psql.exe -d evalua_tolima -U evalua -f

C:\INSTALACION_EVALUA\INSTALADORES\SCRIPTDB\2015030scripttol

Contraseña para usuario evalua:

Nota: Esta es la contraseña creada en el punto 3.6.2.

EVALÚA S.A.S.

19

3.9.7. Esperar mientras termina de correr el SCRIPT; (puede tardar

un par de minutos) Luego de esto la base de datos estará

creada con toda su estructura de tablas y datos.

Imagen fin proceso:

3.9.8. Para validar que la base de datos esté creada, entrar con el

PgAdmin III hasta donde muestra la imagen y revisar la base

de datos.

EVALÚA S.A.S.

20

3.10. Modificar pg_hba.conf

3.10.1. Ir a la carpeta “data” de instalación de PostgreSQL

Ruta: Archivos de programa\PostgreSQL\9.3\data

Y Abrir el archivo pg_hba.conf con bloc de notas, dando clic

derecho y abrir.

EVALÚA S.A.S.

21

3.10.2. Adicionar la siguiente línea en la ubicación que muestra

la imagen:

Nota: Cambiar la IP: 192.168.16.38 por la IP asignada a su

equipo.

host all all 192.168.16.38/32 md5

Guardar y salir.

3.10.3. Reiniciar el computador para continuar con la guía.

4. Instalar y configurar Apache Tomcat 4.1. Descomprimir la carpeta “apache-tomcat-8.0.15.zip”, renombrar la

carpeta descomprimida por “tomcat” y ubicarla en el disco C:\

4.2. Modificar carpeta ROOT de Tomcat por Carpeta ROOT entregada por

Evalúa.

La carpeta ROOT de tomcat se encuentra en la siguiente ubicación:

C:\tomcat\webapps

EVALÚA S.A.S.

22

4.2.1. Cambiar el nombre de la carpeta ROOT por ROOTOriginal:

Dar clic derecho sobre la carpeta ROOT, luego clic sobre “Cambiar

nombre” y renombrarlo.

EVALÚA S.A.S.

23

4.2.2. Ir a los instaladores entregados por Evalúa y buscar en la carpeta

INSTALADORES, la carpeta ROOT-TOMCAT.

EVALÚA S.A.S.

24

Descomprimir el archivo ROOTWin.tar.gz (Con una herramienta

como Winrar puede ser descomprimido) Si da algún mensaje, dar la

opción “Sí a todo” para continuar descomprimiendo.

EVALÚA S.A.S.

25

4.2.3. Copiar la carpeta ROOT descomprimida y pegarla en

c:\tomcat\webapps asegurándonos antes de haber cambiado el

nombre de la carpeta ROOT original.

4.3. Configurar tomcat-users.xml

El archivo tomcat-users.xml se encuentra ubicado en la carpeta

C:\tomcat\conf

EVALÚA S.A.S.

26

EVALÚA S.A.S.

27

4.3.1. Con el editor de preferencia (puede ser bloc de notas), editar el

archivo tomcat-users.xml (si no muestra la extensión XML, verificar

en la columna tipo que corresponda con archivo XML)

Antes de la última línea </tomcat-users> adicionar las siguientes

líneas:

<role rolename="manager-gui"/> <role rolename="admin-gui"/> <user username="admin" password="admin2011" roles="admin-gui,manager-gui"/>

El username admin y password admin2011 pueden ser cambiados por el usuario y

password que consideren para la administración del tomcat; Guarde este ususario

y contraseña para pasos posteriores.

Guardar y salir

EVALÚA S.A.S.

28

5. Configurar variables del sistema o variables de entorno. 5.1. Abrir Mi PC o Equipo

5.2. Sin seleccionar disco de Clic derecho y luego opción “Propiedades”

EVALÚA S.A.S.

29

5.3. Dar clic a la opción “Configuración avanzada del sistema”

5.4. Ir a la pestaña “Opciones avanzadas” y dar clic a al botón “Variables de

entorno…”

EVALÚA S.A.S.

30

5.5. En las Opciones de Variables del sistema, dar clic al botón “Nueva…”

5.6. Crear JAVA_HOME

Nombre de la variable: JAVA_HOME

Valor de la variable: (Ruta de la instalación de java del jdk)

ejemplo: C:\Program Files\Java\jdk1.6.0_35

La instalación de java puede estar en Program Files o Archivos de

Programa, en alguna de las dos (2) está el jdk.

Dar clic al botón “Aceptar”

EVALÚA S.A.S.

31

5.7. Crear variable CATALINA_HOME

Nombre de la variable: CATALINA_HOME

Valor de la variable: C:\tomcat

Dar clic al botón “Aceptar”

5.8. Aceptar las variables de sistema creadas

EVALÚA S.A.S.

32

5.9. Aceptar propiedades del sistema

6. Iniciar y Detener Apache Tomcat 6.1. Ir a la carpeta “bin” del tomcat: C:\tomcat\bin

6.2. Identificar los archivos shutdown y startup

Startup.bat: Inicia el tomcat como servicio.

Shutdown.bat: Detiene el tomcat como servicio.

EVALÚA S.A.S.

33

Dar doble clic al archivo “startup.bat” y esperar que termine de iniciar, se

ve algo como lo que muestra la imagen:

Al final debe mostrar Server startup in …..

Si el firewall pide Permitir acceso, darle Clic al botón permitir.

Nota: Esta pantalla no puede ser cerrada, ya que al cerrarla bajara el

servicio del tomcat.

6.3. Probar tomcat

Abrir cualquier navegador o browser y digitar la siguiente URL:

http://localhost:8080

Si la pantalla que muestra es la misma de la imagen, tomcat ha iniciado

correctamente.

EVALÚA S.A.S.

34

7. Desplegar WAR Proyecto Evalúa: 7.1. Abrir cualquier navegador o browser y digitar la siguiente URL:

http://localhost:8080

7.2. En la parte superior izquierda dar clic a “Tomcat Manager”

7.3. El sistema pedirá usuario y contraseña creados en el punto 4.3.1.

EVALÚA S.A.S.

35

7.4. Identifique el título “Desplegar” (se encuentra bajando la página)

7.5. Luego ubicarse en el título “Archivo WAR a desplegar”

7.6. Dar clic al botón “Examinar” y buscar el WAR en los fuentes entregados

por Evalúa.

Ruta:

C:\INSTALACION_EVALUA\INSTALADORES\WAR\evalua_tolima.war

EVALÚA S.A.S.

36

7.7. Dar clic al botón “Desplegar”

7.8. Esperar a que termine el despliegue y validar en la lista de aplicaciones

el proyecto “evalua_tolima”.

EVALÚA S.A.S.

37

7.9. Configurar IP Herramienta Evalúa (Archivo parameva.properties)

7.9.1. Ir a la carpeta C:\tomcat\webapps\evalua_tolima\WEB-INF\classes

7.9.2. Editar el archivo “parameva”

7.9.3. El parámetro IPServidor, cambiar localhost por la IP que se va a

asignar al servidor de evalúa, para este caso ejemplo 192.168.16.38

EVALÚA S.A.S.

38

7.9.4. Guardar y reiniciar el tomcat, pararlo con shutdown.bat e iniciarlo con

startup.bat (Punto 6. de la guía) se encuentran en la carpeta “bin” de

tomcat.

8. Probar Herramienta Evalúa Abrir el navegador o browser y digitar la siguiente URL:

Cambiar la IP 192.168.16.38 por la IP asignada para la instalación

http://192.168.16.38:8080/evalua_tolima/evaluasa.eweb.EntEvalua