Buscar en este sitio

General

Recursos
Pasarela Salto Systems‎ > ‎Servidor‎ > ‎

Instalación

Contenidos

  1. 1 Instalación
  2. 2 Log
  3. 3 Actualización
  4. 4 Configuración
  5. 5 Instalación de la licencia

Instalación

Se descomprimirá el archivo ZIP de distribución directamente sobre el disco principal y obtendremos el directorio '\vigia-middleware' (Supondremos a partir de ahora 'c:\vigia-middleware').

Dentro de este directorio obtendremos la siguiente estructura:
c:\vigia-middleware
c:\vigia-middleware\bin
c:\vigia-middleware\bin\configuration
c:\vigia-middleware\bin\load

Una vez hayamos instalado la aplicación como un servicio aparecerá también el directorio 'c:\vigia-middleware\log'.

Para continuar la instalación nos situaremos en el directorio 'c:\vigia-middleware\bin' y ejecutaremos el comando 'service install'.

Advertencia

  • En Windows 7 la consola mediante la cual ejecutaremos los comandos deberá haberse ejecutado como Administrador.
  • De no ser así careceremos de los permisos necesarios para instalar, desinstalar, iniciar o parar el servicio.

Después de ejecutar este comando la aplicación estará registrada como un servicio.

Para iniciar el servicio (desde cualquier directorio) utilizaremos el comando 'net start vigiamiddleware'.

Para detener el servicio, el comando será (desde cualquier directorio) 'net stop vigiamiddleware' y para desinstalarlo 'service uninstall' (este último comando deberá ser invocado desde el directorio 'c:\vigia-middleware\bin').

Estando en el directorio 'c:\vigia-middleware\bin' también podemos utilizar el comando 'RUN.BAT',  mediante el cual podemos lanzar el middleware sin tenerlo instalado como un servicio. En este modo los mensajes del sistema de log aparecerán en la propia consola y además dispondremos de la consola del engine Equinox/OSGI con la cual realizar diagnósticos.

Naturalmente, nunca hay que ejecutar simultáneamente el middleware en modo servicio y en modo diagnóstico.

Si ejecutamos el comando 'c:\vigia-middleware\bin\vigiamiddlewarew.exe' dispondremos de un icono en la barra de herramientas del explorador de Windows, el cual nos permitirá gestionar y configurar el servicio (los usuarios del producto Apache-Tomcat para Windows reconocerán esta utilidad).

Log

Una vez instalado el servicio y lanzado el middleware, se generarán una serie de ficheros de log, los cuales se describen a continuación:

log\vigiamiddleware

Este fichero es generado por el ejecutable vigiamiddleware.exe, que es el encargado de lanzar el servicio. Toda la información mostrada aquí tiene que ver con el proceso de lanzamiento del servicio.

log\stdout_YYYYMMDD.log

Este archivo contendrá toda la información que se envía a la salida estándar del sistema. Básicamente se mostrará aquí la información proporcionada por el lanzador del Equinox (implementación OSGI de eclipse) y del proceso que se encarga de vigilar los bundles en 'bin/load' para su instalación/desinstalación/actualización.

log\stderr_YYYYMMDD.log

Este archivo contendrá toda la información que se envía a la salida de error del sistema. Los mismos procesos anteriores son los que podrán enviar mensajes aquí. El que este archivo contenga información es una mala noticia ya que con toda seguridad el framework que contiene la aplicación tiene dificultades.

log\log.txt

Log general del Middleware. Contendrá toda la información generada en el día en curso por los procesos del middleware. El estudio de la abundante información que este fichero contendrá permitirá diagnosticar su funcionamiento.

log\log.YYYMMDD.txt

El log general del Middleware ('log\log.txt') será archivado por días con la finalidad de poder investigar transacciones ocurridas en el pasado.


Lo configuración inicial del log general permite almacenar un historial de 30 días. Realizando ajustes en el fichero ‘c:\vigia-middleware\bin\logback.xml’ se podrá cambiar esta característica y otras.

Actualización

El middleware está compuesto por un Framework OSGI y un conjunto de Bundles (que son los componentes del middleware).

Es posible sustituir cualquiera de los bundles que componen el sistema en caliente. Durante la sustitución, el sistema detendrá los procesos que tengan alguna dependencia del bundle reemplazado. Una vez reemplazado el bundle todos los procesos dependientes se reactivarán inmediatamente

También se pueden incorporar nuevas funcionalidades en caliente, en este caso sin producir ningún impacto en el funcionamiento de Middleware (por ejemplo instalar una nueva fuente de datos) . En el directorio 'c:\vigia-middleware\bin\load' están los bundles que el Framework OSGI habrá activado y mediante la manipulación de estos ficheros se podrán realizar las actualizaciones.

Las operaciones posibles son:
  • Si se sustituye un archivo de un bundle, éste se actualizará en el framework.
  • Si se elimina un archivo de un bundle, éste se eliminará del framework.
  • Si se incorpora un archivo de un bundle, éste se incorporará en el framework.
Es imprescindible que el middleware esté iniciado para poder realizar estas operaciones, ya que si las hacemos con éste detenido no serán efectivas e incluso pueden generar una inconsistencia en un intento de actualización que se realice posteriormente.


Aunque este sistema está diseñado para obtener la ventaja de actualizarse en caliente, hay que tener en cuenta que una operación incorrecta puede dejar el sistema fuera de servicio por lo que sólo el personal cualificado deberá realizar estas operaciones.


Configuración

Una vez iniciado el servicio podremos acceder a él mediante un cliente Telnet utilizando el puerto estándar para este servicio (puerto 23) y nos incorporaremos al sistema con el usuario y password por defecto (admin/admin).

Una vez obtenida la sesión podremos obtener ayuda de los comandos disponibles mediante el comando HELP.


login: admin

password:

Bienvenido.

admin> help


HELP [APP_NAME [CMD_NAME] ]

HELP

Muestra la lista de aplicaciones disponibles en el sistema.

HELP APP_NAME

Muestra la ayuda de la aplicacion APP_NAME y a continuacion la lista de

comandos que dispone.

HELP APP_NAME CMD_NAME

Muestra la ayuda del comando CMD_NAME de la aplicacion APP_NAME y a

continuacion la lista de parametros soportados.


Las aplicaciones disponibles en este momento son:

FILE                Proporciona los comandos necesarios para poder administrar

                   los ficheros de configuracion del dispositivo.

KEYCACHE            Gestiona la actualizacion cache de autorizaciones para las

                   llaves.

ODBC                Gestiona el origen de datos ODBC para la cache.

OPERATIONS          Gestiona el servidor de operaciones.

ORACLE              Gestiona el origen de datos ORACLE para la cache.

PARAMETER           Proporciona los comandos necesarios para poder administrar

                   los parametros de configuracion del dispositivo.

SHIPCLIENT          Gestiona el cliente de SALTO.

SHIPSERVER          Gestiona el servidor SHIP.

SHIPTOOLS           Permite verificar el sevidor SALTO

SYSTEM              Proporciona los comandos necesarios para poder administrar

                   el sistema.

admin>


Todas las configuraciones del middleware se realizarán mediante este conjunto de comandos.


Instalación de la licencia

El middleware necesita tener instalada la correspondiente licencia de uso, la cual activará los servicios adquiridos.

Por defecto el middleware proporciona una licencia de demostración pensada para la evaluación del sistema en entornos laboratorio.

La licencia consiste en un bundle, el cual se instalará por tanto como se ha definido en el capítulo Actualización (sólo debe instalarse una licencia, en caso contrario los resultados serian imprevistos) .

Mediante el comando 'KEYCACHE LICENCE' se podrá obtener los datos de la licencia activa.

Sign in|Report Abuse|Print Page|Remove Access|Powered By Google Sites