instalación servicios web

Instalación
Servicios Web
Gestión Deportiva
INSTALACIÓN - SERVICIOS WEB - 2
Los Servicios Web para la gestión deportiva de GPASoft, permiten a cualquier aplicación intercambiar
información con el software de GPASoft.
La comunicación se basa en el uso del protocolo de transferencia HTTP en conjunción con el lenguaje de
marcas XML.
GPASoft, define una serie de peticiones, en dicho lenguaje de marcas, con las que será posible interrogar al
Servidor de Información utilizando como medio de transporte de las peticiones/respuestas y el protocolo
HTTP.
Siguiendo el esquema de la figura, el funcionamiento es el siguiente:
1. Un cliente n accede a la Web alojada en “Servidor Web” y solicita información sobre el
estado de una pista, el estado de sus recibos, una inscripción a actividades, etc.
2. “Servidor Web” genera la petición XML adecuada y la envía a “Servidor de Información”
utilizando el protocolo HTTP.
3. “Servidor de Información” recopila la información del software de GPASoft y genera una
respuesta XML que envía a “Servidor Web” mediante el mismo protocolo de transporte.
4. “Servidor Web” incorpora esta información en la página que entregará al cliente final.
Para securizar la transferencia de datos a través de la red se crea un túnel SSL entre el
Servidor Web y el Servidor de Información.
La creación de dicho túnel corre a cargo de la aplicación Stunnel de código abierto. Esta
aplicación se ejecutará como un servicio de Windows del mismo modo que el Servidor de
Información y recogerá las peticiones encriptadas por el Servidor Web para entregarlas en
forma legible al Servidor de Información.
En este documento se detallan los procesos de instalación de cada uno de los componentes.
INSTALACIÓN - SERVICIOS WEB - 3
Índice
Configurador del Servidor de Información ..........................................................................................................4
Instalación .......................................................................................................................................................4
Configuración mínima .....................................................................................................................................4
Servidor de Información......................................................................................................................................5
Instalación .......................................................................................................................................................5
Túnel SSL (Stunnel)............................................................................................................................................8
Instalación .......................................................................................................................................................8
INSTALACIÓN - SERVICIOS WEB - 4
Configurador del Servidor de Información
Este programa permite configurar el servicio para su funcionamiento así como los detalles en cuanto a pistas
visibles, horas de reserva, restricciones, …
Permite detener el proceso de forma remota. Esto será necesario para realizar operaciones como reindexar
o actualizar en los programas vinculados al Servidor de Información.
Esta aplicación deberá estar instalada, como mínimo, en la misma máquina en la que se vaya a instalar el
Servidor de Información (habitualmente el servidor del club) siendo recomendable su instalación en las
máquinas de aquellos usuarios con permiso para realizar las operaciones mencionadas anteriormente.
Instalación
1. Descargar el programa de instalación wcfgsweb.exe de http://www.gpasport.com. Es necesario estar
validado.
2. Ejecutar el instalador y seguir los pasos indicando la ruta para la instalación del programa y la ruta
para los datos (se recomienda el uso de nomenclatura UNC).
Configuración mínima (ArchivoConfiguración General)
•
•
•
•
•
•
•
•
•
•
•
Dirección IP
Nombre o IP de la máquina en la que se instalará el Servidor de Información, por ejemplo: server.
Usuario:
Usuario con permisos para iniciar el servicio Servidor de Información. Habitualmente el servidor del
dominio: Dominio\Administrador.
Puerto:
Puerto de escucha para el Servidor de Información. Habitualmente 8088.
Password:
Palabra clave utilizada para las conexiones con la Web.
Simbolo :
El símbolo que aparece en el Panel de Control de Pistas, para indicar que la reserva se ha realizado
por la Web.
Cuota Matrícula/Prorrata:
Datos internos para peticiones especiales. Habitualmente en blanco.
Cuota Penalización:
Si existe la posibilidad de anular la reserva, es la cuota que se le carga al socio por anularla.
Edad Mínima:
Edad mínima para reservar por la web.
Correo cliente:
Dirección de correo (del cliente) a la que el programa enviará un email cuando el servicio se
detenga a causa de cualquier incidencia.
Correo soporte :
Dirección de correo (GPA) a la que el programa enviará un email cuando el servicio se detenga a
causa de cualquier incidencia
INSTALACIÓN - SERVICIOS WEB - 5
Servidor de Información
Instalación
1. Descargar el programa de instalación wservweb.exe de http://www.gpasport.com. Se requiere un
usuario validado.
2. Ejecutar el fichero descargado y seguir los pasos teniendo en cuenta que tanto la ruta del programa
como la de los datos debe ser C:\GPAPROG\WSERVWEB\ tal como aparece en las figuras
adjuntas.
3. Una vez instalado ir a la ruta de datos del programa C:\GPAPROG\WSERVWEB\DATOS i editar el
fichero de configuración WSERVWEB.ini. Este fichero deberá contener la ruta a la carpeta datos del
Configurador instalado en el capítulo anterior. Es imprescindible finalizar la ruta con una barra “\”.
Como siempre es recomendable la nomenclatura UNC, por ejemplo:
[GENERAL]
config=\\server\gpadato\wcfgsweb\datos\
4. Instalar el programa como servicio de Windows.
a. Abrir una línea de comandos
b. Ubicarse en la ruta de instalación del programa
INSTALACIÓN - SERVICIOS WEB - 6
c. Instalar el servicio mediente el comando simplectr i “dominio\usuario” “password”.
i. El usuario debe tener permiso para acceder a la red local y en particular al recurso
compartido donde estén ubicados los datos de wsocios y wpistas. Es posible utilizar
el usuario administrador del dominio o cualquier usuario con los derechos
mencionados.
5. Comprobar que el servicio se ha instalado y está iniciado.
INSTALACIÓN - SERVICIOS WEB - 7
INSTALACIÓN - SERVICIOS WEB - 8
Túnel SSL (Stunnel)
Instalación
1. Descargar stunnel.zip de http://www.gpasport.com. Requiere un usuario validado.
2. Descomprimir el contenido del ZIP dentro de una carpeta de nombre stunnel en la ruta
C:\GPAPROG. El resultado debe ser el siguiente:
3. Instalar el programa como servicio.
a. Abrir una línea de comandos.
b. Acceder a la ruta de instalación del programa.
c. Ejecutar el comando stunnelxxxxx.exe –install
d. Aparecerá una ventana indicando que el servicio se ha instalado correctamente.
4. Comprobar que el servicio está instalado e iniciado.
INSTALACIÓN - SERVICIOS WEB - 9