General

Recursos

Instalación

Instalación

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

Dentro del este directorio obtendremos la siguiente estructura:
c:\scada-middleware
c:\scada-middleware\bin
c:\scada-middleware\bin\configuration
c:\scada-middleware\bin\install

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

Para continuar la instalación nos situaremos en el directorio 'c:\scada-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 scadamiddleware'.

Para detener el servicio el comando será (desde cualquier directorio) '
net stop scadamiddleware' y para desinstalarlo 'service uninstall' (éste último comando deberá ser invocado desde el directorio 'c:\scada-middleware\bin').

Estando en el directorio '
c:\scada-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 de 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
:\scada-middleware\bin\scadamiddlewarew.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\scadamiddleware

Este fichero es generado por el ejecutable scadamiddleware.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:\scada-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 reactivaran 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 nuevo tipo de pasarela). En el directorio 'c:\scada-middleware\bin\install' 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:

DERBYSERVER         Gestiona el servidor Derby.
FILE                Proporciona los comandos necesarios para poder administrar
                    los ficheros de configuracion del dispositivo.
GATEWAY             Gestiona las pasarelas Modbus.
ORACLE              Gestiona el elmacenamiento del SCADA en Oracle.
PARAMETER           Proporciona los comandos necesarios para poder administrar
                    los parametros de configuracion del dispositivo.
SCADA               Gestiona el modelo de datos.
SERIAL              Proporciona informacion sobre los puertos serie.
SYSTEM              Proporciona los comandos necesarios para poder administrar
                    el sistema.

admin>


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