MINISTERIO DE AGRICULTURA, GANADERA ACUACULTURA Y

PESCA MAGAP

PROGRAMA DEL BUEN VIVIR RURAL

Manual de Instalacin

Sistema de Planificacin, Seguimiento y Evaluacin

RURAL PLAN

2016

Manual de Instalacin RURALPLAN Pgina 1 de 23

 Contenido
1. OBJETIVOS ........................................................................................................................ 3
2. GUA TCNICA................................................................................................................... 3
3. GUA DE INSTALACIN ...................................................................................................... 8
4.1 PASOS PARA LA INSTALACION ........................................................................................... 9
4.1.1 Lectura del CD ............................................................................................................... 9
4.1.1.1 Carpeta 01.Instaladores ........................................................................................... 9
4.1.1.2 Carpeta 02.Diseo .................................................................................................... 9
4.1.1.3 Carpeta 03.bd .......................................................................................................... 9
4.1.1.4 Carpeta 04.fuentes .................................................................................................. 9
4.1.1.5 Carpeta 05.Reportes ................................................................................................ 9
4.1.2 Aplicacin WEB.............................................................................................................. 9
4.1.3 Instalar Netbeans ........................................................................................................ 10
4.1.4 Configurar GlassFish .................................................................................................... 15
4.1.5 Iniciar Proyecto desde el IDE ........................................................................................ 15
4.1.6 Restablecer Base de Datos ........................................................................................... 16
4.1.7 Configurar las fuentes de datos en Glassfish................................................................. 18
4.1.8 Editar El conjunto de conexiones. ................................................................................. 20
4.1.9 Desplegar la aplicacin .EAR mediante la consola de administracin de glassfish. ........ 21
4.1.10 Cargar reportes al JasperReport Server ..................................................................... 22
4.1.11 RECOMENDACIONES ................................................................................................. 23

Pgina 2 de 23
MANUAL DE INSTALACION RURALPLAN
1. OBJETIVOS
El propsito de este documento es elaborar una gua tcnica de la Instalacin del Sistema
RURALPLAN.

2. GUA TCNICA

2.1 ARQUITECTURA DE LA SOLUCIN

GRFICO 1: Diagrama Conceptual

En el Grfico 1 se muestra el diagrama conceptual, donde se observa la arquitectura

propuesta, y que se basa en la interaccin entre capas, utilizando el estndar JEE.

En la capa cliente o de presentacin, se tiene la interfaz de la aplicacin, el cual

muestra al usuario las pginas web.

A continuacin se tiene la capa intermedia, la cual posee el contenedor WEB, en el

cual estn las pginas web en formato xhtml, y que utilizan recursos como imgenes,
js, css.

Las pginas web, xhtml, utilizan internamente el framework PrimeFaces, que ofrecen
un conjunto de componentes o controles JSF, para dotarlos con comportamiento
AJAX, y que son utilizados en la interfaz web.

Pgina 3 de 23
MANUAL DE INSTALACION RURALPLAN
 Tambin el aplicativo web de planificacin, monitoreo y evaluacin, utiliza los
controles PrimeFaces.

A continuacin se tiene el contenedor EJB, donde estn los ManagedBean que se

utilizan para el manejo de la funcionalidad o lgica de la pgina web.

Los controladores manejan la lgica del negocio a travs de los objetos o

componente EJB.

El componente EJB, es la que maneja la lgica del negocio, con objetos session
facade. Seguido se tiene, la persistencia de objetos, que acceden a los datos, para el
cual utiliza la tecnologa Eclipse Link o JPA para el mapeo de las clases hacia los
datos.

Tambin en esta capa, se maneja las configuraciones de los JDBC y pool de

conexiones.

Por ltimo se tiene la capa EIS que interacta con la capa intermedia, y donde se
tienen los sistemas de informacin Empresarial, en el cual se encuentran ERPs,
Aplicaciones Heredadas o Legacys, y los Sistemas de Bases de Datos Relacionales,
donde est el modelo de datos, que utilizan la tecnologa JPA, para el mapeo de
clases a las tablas de la base de datos. En este punto se maneja la comunicacin o
acceso a la base de datos, utilizando el patrn de diseo DAO.

DAO implementa el mecanismo de acceso requerido para trabajar con la fuente de

datos. Esta fuente puede ser una Base de Datos Relacional, un servicio externo, un
LDAP y un servicio de negocio. Es decir que DAO acta como un adaptador entre el
componente y la fuente de datos.

Pgina 4 de 23
MANUAL DE INSTALACION RURALPLAN
 GRFICO 2: Diagrama Fsico
Parte 1

Manual de Instalacin RURALPLAN Pgina 5 de 23

 GRFICO 2: Diagrama Fsico
Parte 2

Pgina 6 de 23
MANUAL DE INSTALACION RURALPLAN
 En el Grfico 2 se muestra el diagrama fsico, donde se observa la arquitectura
propuesta para la solucin informtica.

La interaccin empieza con los equipos, que consumen los servicios WEB de ingreso
de informacin. Donde los puntos son almacenados en lnea constantemente, en la
Base de Datos del servidor de las organizaciones. As los puntos, se reflejan
inmediatamente en la solucin informtica WEB de Monitoreo, a travs de la opcin de
Monitoreo de Rutas o Recorridos.

A esta interaccin del usuario con el front end de la aplicacin, se le conoce como
capa de presentacin.

Seguidamente se tiene la Capa de Negocio, la cual expone componentes y/o servicios

web que implementan la lgica del negocio, y que son publicados en un Servidor Web.
El servidor WEB procesa constantemente, las solicitudes o peticiones WEB
provenientes del usuario final.

Cualquier peticin WEB, interactuar con la base de datos del sistema de Informacin
Gerencial, el cual posee la estructura y los datos respectivos y utilizados por el
sistema.

La tecnologa utilizada es la siguiente:

Base de Datos Open Source, Postgress vs 9.3

En la infraestructura del cliente, se utilizar un servidor WEB, en el cual expone los
servicios WEB o pginas web dinmicas. Se utilizar servidor WEB GlassFish
Server vs 3.1.2 con JPA vs 2.0 y JDBC Postgress.
Para ms informacin de las caractersticas tcnicas, se describen en el punto 5.2.1
referente a Requerimiento Tecnolgico Configuracin.

Manual de Instalacin RURALPLAN Pgina 7 de 23

 3. GUA DE INSTALACIN

3.1 REQUISITOS DEL SISTEMA

3.1.1 Hardware
Hardware - Servidores Fsicos, Workstation
No. Disco Sistema
Funcin Velocidad Memoria
Procesadores Duro Operativo
SERVIDOR DE
APLICACIONES WEB WINDOWS,
CORE 3 DUO 3.00 GHZ 500 GB 4 GB
para alojamiento de los LINUX
servicios WEB

SERVIDOR DE BASE WINDOWS,

CORE 3 DUO 3.00 GHZ 500 GB 4 GB
DE DATOS LINUX

3.1.2 Software

Software Tecnologas, aplicaciones y patrones en uso

Funcin Nombre Descripcin
Servidor de Base de POSTGRESQL vs Sistema gestor de base de datos relacional para el
Datos 9.2 almacenamiento de datos del sistema mvil.
Driver de para conexin Driver JDBC para Driver para la comunicacin entre cliente-servidor de base de
a base de datos conexin entre java datos.
y PostgreSQL
Servidor Web de Servidor web de aplicaciones, para alojamiento de WEB
GlassFish Server
Aplicaciones SERVICES o pginas WEB dinmicas JSF
4.1.1
Tecnologa Servidor Java JSF y Tecnologa utilizada para procesamiento de la informacin en el
PrimeFaces lado del servidor.
Marco de trabajo, que contienen el conjunto de clases, libreras
base, utilizadas para la programacin y procesamiento de la
Java Eclipse Link
Framework informacin, utilizada en el sistema.
JPA 2.0
Se usa EclipseLink (JPA) para la persistencia de la capa de
datos
Protocolos de HTTP: Protocolo para acceso a las aplicaciones va navegador
HTTP
comunicacin web, con peticiones va POST o GET
TCP/IP
soportados TCP/IP Protocolo para la transmisin de datos por la red.
Repositorio de Es un servidor de informes independiente e integrable.
Reportes JasperReports Proporciona informes y anlisis que se pueden incrustaren una
ServerVs 6.1 web o aplicacin mvil, as como funcionar como un centro de
informacin central.
Editor de Reportes Es un diseador de informes open source para JasperReports y
iRepot 5.6 JasperReports Server.

Manual de Instalacin RURALPLAN Pgina 8 de 23

 4.1 PASOS PARA LA INSTALACION

4.1.1 Lectura del CD

El primer paso que debemos seguir es leer el CD de instalacin del RURALPLAN,

donde tenemos las siguientes carpetas:

01.Instaladores
02.Diseo
03.bd
04.Fuentes
05.Reportes
06. Manuales

4.1.1.1 Carpeta 01.Instaladores

Contiene los instaladores necesarios para poder ejecutar el proyecto, dentro de los
mismos tenemos:

IDE Net Beans jdk-8u45-nb-8_4

Base de Datos Postgres postgresql-9.3.1-1
Jasper Report Server jasperreports-server-cp-6.1.1-windows-x64-installer
iReport iReport-5.6-windows-installer

4.1.1.2 Carpeta 02.Diseo

Contiene el diagrama Fsico y Conceptual de la Base de Datos.

4.1.1.3 Carpeta 03.bd

Contiene el BackUp de la base de datos que se debe restaurar para usar el Sistema
RURALPLAN

4.1.1.4 Carpeta 04.fuentes

Contiene el cdigo fuente de la aplicacin web.

4.1.1.5 Carpeta 05.Reportes

Contiene cinco carpetas con los archivos fuentes de los reportes y un archivo .zip,
para poder subirlo al JasperReport Server.

4.1.2 Aplicacin WEB

Antes de proceder con la Instalacin de la aplicacin primero se debe realizar las

siguientes configuraciones.

Verificar si se est ejecutando el servicio de glassfish, si no lo est iniciarlo con

el siguiente comando asadmin start-domain domain1, desde la consola cmd.

Pgina 9 de 23
MANUAL DE INSTALACION RURALPLAN
 Una vez iniciado el servidor, podemos acceder a la consola a travs del
navegador, concretamente a travs del puerto por defecto 4848
(localhost:4848).
Verificar que el servidor de base de datos(Postgres) se encuentre ejecutando
Verificar que tengamos instalado java y la versin mnima 1.8 o superior, para
esto abrimos la consola y ejecutamos el siguiente comando java -version

Una vez instaladas, proceder a copiar toda la carpeta 04.Fuentes y pegarla en la

carpeta raz / del servidor donde va a ser alojado.

A continuacin podemos apreciar el contenido del directorio.

4.1.3 Instalar Netbeans

Instalar la versin del Netbeans 81 que esta en la carpeta 01. Instaladores.

Cuando se ejecuta el instalador solicitar el path, ubicar en la raz c:\

Se ejecuta las siguientes pantalla:

Presionar el botn siguiente:

Pgina 10 de 23
MANUAL DE INSTALACION RURALPLAN
 2. Se tiene acceso a otra ventana, en la cual se debe desactivar la casilla
perteneciente a la caracterstica que no se quiere instalar, presionar el botn aceptar.

3-Luego aparecer la pantalla de aceptacin de acuerdo de licencia, se debe aceptar

dicho acuerdo y posteriormente dar clic en el botn "Siguiente" de la ventana principal,
como se describe en la pantalla siguiente:

4. En este la pantalla siguiente preguntar si deseamos instalar "JUnit", una

herramienta para hacer pruebas controladas a nuestras aplicaciones JAVA. En esta
ocasin seleccionaremos la opcin "No instalar JUnit" y dar click en "Siguiente":

Pgina 11 de 23
MANUAL DE INSTALACION RURALPLAN
 5. En la ventana siguiente mostrar la ruta de instalacin del IDE, la cual se puede
modificar dando clic en el botn "Examinar..." y escogiendo la carpeta que desea, pero
en este caso dejar la ruta que est por defecto "C:\Program Files (x86)\NetBeans 8.1".
Igualmente, se puede ver el JDK que usar NetBeans, en este caso saldr el que se
instalado "C:\Program Files (x86)\Java\jdk8.1"; sin embargo, es posible que salga otro
en el caso dado que se haya instalado uno anteriormente, si es as, se debe escoger
el que se instalado de ltimo, para ello se cuenta con la lista desplegable donde se
mostrarn los JDK disponibles o podemos tambin usar el botn "Examinar..."
respectivo, para ubicar el que necesitamos.

Luego, dar clic en el botn "Siguiente":

Pgina 12 de 23
MANUAL DE INSTALACION RURALPLAN
 6. En esta ventana se presentar el mismo caso del punto anterior, slo que aqu ser
con el servidor de aplicaciones "GlassFish", se har entonces lo correspondiente (en
este caso cambiar el la ruta a c:\), y damos clic en el botn "Siguiente":

7. En el siguiente paso, se mostrar la ruta de instalacin para "Apache Tomcat",

como se sabe se puede cambiar dando clic en el botn "Examinar...", pero en esta
ocasin dejamos la que est ya sealada "C:\Program Files (x86)\Apache Software
Foundation\Apache Tomcat 7.0.41" y damos clic en "Siguiente", como se indica en la
siguiente pantalla:

Pgina 13 de 23
MANUAL DE INSTALACION RURALPLAN
 8. Dar clic en el botn "Instalar" para que se lleve a cabo todo el proceso de instalacin
de NetBeans IDE en el PC; pero antes, si no se quiere que el instalador busque
actualizaciones mientras se realice el montaje del IDE, desactivaremos la casilla
"Check for Updates", como se indica en la siguiente pantalla:

9. Luego aparecer una ventana en la cual se tiene la posibilidad de desactivar y/o

activar la casilla "Apoye al proyecto NetBeans proporcionando datos de uso de manera
annima", esto ya quedar a la eleccin, pues esta opcin como se indica en la
ventana, es que se enviarn a la base de datos de estadsticas en el servidor
"netbeans.org" los datos de las herramientas y/o funcionalidades que ms se use, con
el fin de que el grupo que desarrolla este proyecto se enfoque en mejorar y corregir
posibles fallos de las opciones ms utilizadas por los usuarios de este IDE.

Por ltimo se da clic en el botn "Terminar":

10. Finalmente, se ver acceso directo de NetBeans IDE en el escritorio del PC, ya
slo bastar con dar doble clic sobre el mismo y se tendr listo para su de netbeans.

Icono de ejecucin del netbeans

Pgina 14 de 23
MANUAL DE INSTALACION RURALPLAN
 4.1.4 Configurar GlassFish

Para la configuracin de Glashfish, se procede a realizar los siguientes pasos:

1. Ingresamos a Netbeans y vamos al men Tools y submen Server, donde muestra

la ventana Servidores:

2. Hacer clic en el botn , donde muestra la ventana Add Server

Instance:

3. Hacemos clic en el botn , para seleccionar el PATH donde ser instalado

y configurado el servidor GlassFish. Aceptamos los trminos de licenciamiento
y hacer clic en el botn , seleccionar la
versin GlassFish_Server_4.1.1 y automticamente se descarga e instala GlassFish
Server

4.1.5 Iniciar Proyecto desde el IDE

Pgina 15 de 23
MANUAL DE INSTALACION RURALPLAN
 Para cargar el proyecto (fuentes) se debe seguir los siguientes pasos:

1. Hacer clic en el botn Abrir Proyectos , ubicarse dentro de la carpeta

04.fuentes que fue copiada en la raz del servidor y muestra la siguiente ventana:

2. Seleccionar y proceder abrir el proyecto:

sis_psep

3. Una vez cargados los proyectos, proceder hacer CLEAN AND BUILD y luego
DEPLOY en cada proyecto.

4.1.6 Restablecer Base de Datos

Proceder abrir el Administrador de Base de Datos en Postgres pgAdmin III, y crear

una base de datos con el nombre sis_psep

1. Escoger la opcin de New database, como se muestra en la siguiente pantalla:

Pgina 16 de 23
MANUAL DE INSTALACION RURALPLAN
 2. Aparecer la pantalla para ingresar el nombre sis_psep y posteriormente presionar
el botn OK, como se indica en la siguiente pantalla:

3. Una vez creada la base de datos, escoger la opcin de restore como se indica en la
siguiente pantalla:

4. Se ubica en el nombre de la base de datos sis_psep y restaurar el backup que se

encuentra en la carpeta 03.bd, como se indica en la siguiente pantalla:

Pgina 17 de 23
MANUAL DE INSTALACION RURALPLAN
 5. Se instalar la base de datos, como se indica en la siguiente pantalla:

4.1.7 Configurar las fuentes de datos en Glassfish

Antes del primer despliegue de la aplicacin deber arrancar GlassFish para la

configuracin de las distintas fuentes de datos.

1. En primer lugar se tiene que aadir el driver de Postgress a Glassfish. Se tiene que
aadir dicho driver, al directorio \Glassfish\domain\domain1\lib\ext

Pgina 18 de 23
MANUAL DE INSTALACION RURALPLAN
 2. Una vez arrancado el servidor proceder a crear el datasource. Para ello entrar en la
consola de administracin y en el men de la izquierda y acceder al apartado
Resources > JDBC > Connection pools, como se indica en la siguiente pantalla:

3. Se crea un nuevo datasource desde el botn 'New', se presentar la siguiente

pantalla:

4. A continuacin indicar el nombre del datasource, y los valores que se ve a continuacin

en caso de que nuestra conexin sea orientada a Postgress, en la opcin de Pool Name
escribir la conexion " post-gre-sql_sis_psep_postgresPool", como se indica en la pantalla
siguiente:

Pgina 19 de 23
MANUAL DE INSTALACION RURALPLAN
 5. Pulsar en Next. En la siguiente pantalla indica una serie de propiedades
adicionales para el datasource. Segn la versin de GlassFish que se instale, las
propiedades adicionales que permite configurar pueden variar.

Indicar como por ejemplo el puerto de acceso, el nombre de la base de datos, el

nombre del datasource, y el user y password para la conexin a dicha fuente de datos,
como se indica en la siguiente pantalla:
Presionar el botn Finish para terminar.

4.1.8 Editar El conjunto de conexiones.

Para conectarse va JNDI al datasource har falta especificar el nombre del recurso
JDBC asociado al mismo.

1. Para ello acceder al men de la izquierda a la opcin Resources > JDBC > JDBC
Resources. Crear uno nuevo con el botn New..., como se indica en la siguiente
pantalla:

Pgina 20 de 23
MANUAL DE INSTALACION RURALPLAN
 2. Crear uno nuevo con el botn New (Nuevo en espaol)

3. Llenar los datos para nuestro JDNI. Es importante asociar el nombre JNDI al
datasource creado anteriormente, como se indica en la siguiente pantalla:

4.1.9 Desplegar la aplicacin .EAR mediante la consola de administracin de

glassfish.

Para desplegar la aplicacin realizar los siguientes pasos:

1. Desde el panel de administracin de Glassfish, entrar en la opcin

Applications/Enterprise Applications. Pulsar en la opcin 'Deploy' para lanzar una
nueva aplicacin, como se indica en la siguiente pantalla:

Pgina 21 de 23
MANUAL DE INSTALACION RURALPLAN
 2. En la siguiente pantalla se tiene que seleccionar el archivo .ear de nuestra
aplicacin, se puede configurar en ste una serie de opciones sobre la aplicacin
lanzada, por ejemplo, si se quiere que este en estado habilitada. Como esta en la
pantalla siguiente:

3. A continuacin pulsar la opcin 'OK' y comienza el proceso. En caso de causar

algn error, Glassfish avisa debidamente, si todo ha esta bien, se puede ver la
aplicacin lanzada en nuestro servidor.

Para desmontar nuestra aplicacin del servidor, es tan sencillo como acceder al mismo
men y usar la opcin 'Undeploy'.

4.1.10 Cargar reportes al JasperReport Server

1. Previa a la carga de reportes, se debe verificar si se encuentra instalado y

ejecutando el servicio de JasperReport Server. Para verificar digitar
http://localhost:8081/jasperserver/login.html en cualquier navegador.
El usuario y contrasea por defecto es: jasperadmin, se presentar la siguiente
pantalla:

2. Una vez verificado que se encuentre ejecutando JasperReprot Server, proceder a

copiar el archivo exportSisPsep2016.zip (o el nombre del archivo que se entregue) que
se encuentra en la carpeta 05.Reportes, a la carpeta del servidor /jasperreports-
server-cp-4.5.0\buildomatic.

Pgina 22 de 23
MANUAL DE INSTALACION RURALPLAN
 3. A continuacin ejecutar el siguiente comando js-import -input-
exportSisPsep2016.zip desde la venta de comandos, que permitir descomprimir el
archivo en el servidor del jasperserver.

4.1.11 RECOMENDACIONES

El equipo donde se instale la aplicacin, tenga las caractersticas de hardware

solicitadas.
Para la ejecucin del sistema deben estar levantados los servicios del servidor
de aplicaciones Glassfish, servidor de reportes jasperserver y la base de datos
Postgres.
Para el ingreso de la informacin al sistema se tiene que tener lista la
informacin del Plan de Planificacin, seguimiento y evaluacin.

Pgina 23 de 23
MANUAL DE INSTALACION RURALPLAN