Guía de instalación inicial de GlassFish

para ejecución de Web Services

(GUI-015-20100421)

U.T. - DAFP

Proyecto Sistema de Información y

Gestión del Empleo Público para el
Estado Colombiano- SIGEP
19 de Abril de 2010.

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 1 de 16
 424852937.doc

Historial de Revisiones

Versión Descripción Autor Acción Fecha

01.00 Creación del documento Eric Backstrom – Brinkman Creación 19-04-2010
Pedraza

Revisión Cargo Nombre Partes del Firma Fecha

Proyecto
Gerente Alfredo Ayala UT
Proyecto
Líder Mario Federico UT
Proyecto Herrera
Líder Calidad UT
Jefe Oficina Victoria Díaz DAFP
de Sistemas
Interventoría PWC

Aprobación Cargo Nombre Partes del Firma Fecha

Proyecto
Gerente Alfredo Ayala UT
Proyecto
Líder Mario Federico UT
Proyecto Herrera
Jefe Oficina Victoria Díaz DAFP
de Sistemas
Interventoría PWC

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 2 de 16
 424852937.doc

TABLA DE CONTENIDOS
TABLA DE CONTENIDOS 3
1 INTRODUCCIÓN Y ALCANCE 4
1.1 INTRODUCCIÓN 4
1.2 ALCANCE 4
2 GUÍA DE INSTALACIÓN DE GLASSFISH. 5
2.1 OBTENCIÓN DEL SOFTWARE 5
2.1.1 GlassFish 5
2.2 INSTALACIÓN DEL SOFTWARE 5
2.2.1 Instalación de GlassFish 5
2.2.2 Publicación de una aplicación web (war) 11
2.2.3 Consideraciones Adicionales. 15

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 3 de 16
 424852937.doc

1 INTRODUCCIÓN Y ALCANCE
1 INTRODUCCIÓN

El Departamento Administrativo de la Función Pública (DAFP), atendiendo los

requerimientos de Ley, en representación del Gobierno Nacional de Colombia y en
atención a las necesidades de información y de gestión del empleo público de las
entidades del estado, establece el proyecto Sistema de Información y Gestión del
Empleo Público – SIGEP, el cual hace parte integral de la oferta en Sistemas de
información que el Gobierno Nacional está gestionando actualmente y facilitará la
interoperabilidad entre los sistemas de información del estado, a fin de reducir la
duplicidad de información entre ellos.

2 ALCANCE

Este documento es una guía de instalación del ambiente inicial de GlassFish para la
ejecución de Web Services.

GlassFish es un servidor de aplicaciones desarrollado por Sun Microsystems que

implementa las tecnologías definidas en la plataforma Java EE y permite ejecutar
aplicaciones que siguen esta especificación 1. GlassFish será utilizado en el SIGEP para
ejecutar Web Services.

1
http://es.wikipedia.org/wiki/GlassFish

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 4 de 16
 424852937.doc

2 GUÍA DE INSTALACIÓN DE GLASSFISH.

Esta guía muestra los pasos necesarios para instalar GlassFishe. Como prerrequisitos
se debe tener instalado Java Depelopment Kit (JDK) 1.5 o 1.6 en el equipo y verificar que existe
la variable de entorno JAVA_HOME apuntando a ese JDK. La instalación debe realizarse en el
siguiente orden.

3 OBTENCIÓN DEL SOFTWARE

3.1 GlassFish

Ir al sitio https://GlassFish.dev.java.net/ y descargar la versión GlassFish 2.1.

4 INSTALACIÓN DEL SOFTWARE

4.1 Instalación de GlassFish

Para instalar GlassFish es necesario ejecutar el instalador correspondiente a la

plataforma del sistema operativo. En Linux será necesario usar el gestor de paquetes
de la distribución.

Se incluyen las pantallas de instalación de Windows, sin embargo, el resultado de la

configuración es muy similar en ambos sistemas operativos.

 Se ejecuta el instalador.

% java -Xmx256m -jar filename.jar

Acepte la licencia. El isntalador creará una carpeta 'GlassFish' con el contenido del
servidor de aplicaciones.

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 5 de 16
 424852937.doc

% cd GlassFish

 Antes de realizar la instalación, verifique los archivos C:\GlassFish\setup-

cluster.xml y C:\GlassFish\setup.xml a fin de comprobar que los parámetros
del script de instalación son los deseados. Por ejemplo, aqui pueden cambiarse
los puertos http y https por defecto.

 Si usa un sistema operativo tipo UNIX, debe asignarle permisos de ejecución a las librerias
de ant incluidas en GlassFish

% chmod -R +x lib/ant/bin
% lib/ant/bin/ant -f setup.xml

o en Windows

% lib\ant\bin\ant -f setup.xml

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 6 de 16
 424852937.doc

 Para la instalación de GlassFish con soporte para clustering, cambie el paso 4 por el
siguiente:

% lib/ant/bin/ant -f setup-cluster.xml

o en Windows

% lib\ant\bin\ant -f setup-cluster.xml

 En la carpeta C:\GlassFish\domains se crea la confiruación del dominio especificado, por

defecto domain1, en este caso es necesario reemplazar los archivos de certificados de
seguridad y contraseñas del llavero por los generados especialmente para los servicios de
agenda de conectividad.

Estos archivos son:

Keystore.jks
Keyfile
Caerts.jks
admin-keyfile

Keystore.jks Keyfile Cacerts.jks admin-keyfile

 Para el cliente de los servicios web es necesario crear un dominio adicional, en este caso,
llamado domain2.

Cambiar a directorio GlassFish/bin

ejecutar "asadmin"
ejecutar el comando create-domain

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 7 de 16
 424852937.doc

 Se especifican los puertos y contraseñas necesarias. En caso de no proporcionar alg{un

dato GlassFish establecerá estos por defecto. Pueden editarse los archivos de
configuracion para ajustar los mismos.

 Crear un pool de conexiones a base de datos llamado poolSIGEP, estop se hace en la

seccion Resources/JDBC/Connection Pools, ahi se especifica la clase oracle que
implementa el tipo java DAtasource, y el tamaño del Pool de conexiones.

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 8 de 16
 424852937.doc

 En la pestaña de propiedades adicionales "Additional Properties" se agregan todos los

valores de la Base de datos, como se muestra en la imagen siguiente:

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 9 de 16
 424852937.doc

 Entrar al administrador de Glasfish, en la direccion http://localhost:4848), e ir a la seccion

Resources/JDBC/JDBC, crear un nuevo recurso de pool de conexiones a base de datos
llamado jdbc/poolSIGEP, que apuntal pool poolSIGEP

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 10 de 16
 424852937.doc

 Repetir el proceso para cada uno de los dominios creados, por ejemplo, en el dominio 2 es
http://localhost:4849

4.2 Publicación de una aplicación web (war)

Para publicar una aplicación web (war) se deben seguir los siguientes pasos:

 Ingresar al administrador de Sun GlassFish Enterprise Server 2.1

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 11 de 16
 424852937.doc

 Ir a Web Applications y dar clic en deploy

 Elegir el tipo de proyecto, en nuestro caso .war

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 12 de 16
 424852937.doc

 Elegir el origen del proyecto según como se tenga, en archivo .war o como carpeta

 Dar un nombre a la aplicación.

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 13 de 16
 424852937.doc

 Especificar la ruta de contexto

 Los demás parámetros dejarlos por defecto

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 14 de 16
 424852937.doc

 Al finalizar dar clic en aceptar.

4.3 Consideraciones Adicionales.

Además se debe tener en cuenta:

 Copiar criptography extension a la carpeta lib/security del jre
 Copiar los llaveros de seguridad keystore a c:/keystore

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 15 de 16
 424852937.doc

 Importar el proyecto java, junto con sus librerías

 Tener la hora del computador sincronizada con la PDI. con algún servicio como
Windows time
 Copiar websaervices-tools.jar y webservices-rt.jar a c:/GlassFish/lib
 Copiar webservices-api.jar a c:/GlassFish/lib/endorsed
 Copiar ojdbc5.jar a c:/GlassFish/lib
o verificar que los anteriores archivos no están duplicados en la carpeta
build/web/WEB-INF/lib
 Verificar orden de los classloaders de GlassFish:
1. jdk/jre
2. GlassFish/lib
3. GlassFish/domains/domainX/lib/
4. El de la aplicación, WEB-INF/lib
5. Las clases que necesitamos deben estar en los puntos 1 y 2, no 3 ni
4.
 Verificar que el archivo WEB-INF/conf/webservices.properties contenga usuario,
contraseña y numero y version de tramite del servicio a probar, direccion del
tramitador
 Verificar que el archivo WEB-INF/wsdl/WebServicePDIasmx.wsdl contenga en los
tags soap: address la direccion del servicio web del tramitador.
 Verificar que el archivo WEB-INF/wsdl/WebServicePDI.asmx.wsdl_wsdl1 contiene
en los tags sc1: KeyStore y sc1:TrustStore los datos de acceso correctos a los
certificados de seguridad del tramitador y de la entidad

Fin del documento

COPYRIGHT  2007 Meta4 Spain, S.A.

No copiar ni divulgar sin autorización previa de Meta4®
Este documento es para uso exclusivo de DAFP
Página 16 de 16