VII. Conclusions and Future Work
7.1 Main Contributions
Muchas tareas relacionadas con la personalización de Decision Center requieren que se añadan o eliminen parámetros de configuración.
Acerca de esta tarea
Decision Center utiliza los parámetros de configuración siguientes para generar URL completos en enlaces permanentes:
v teamserver.server.port: el número de puerto
v teamserver.server.isSecure: verdadero si la conexión es segura v teamserver.server.hostname: el nombre del host.
Para crear, modificar o suprimir parámetros de configuración, utilice la página Establecer parámetros de configuración en el asistente Installation Manager. Estos parámetros se generan iniciando sesión en la consola de Decision Center por primera vez tras configurar la base de datos. Puede utilizar el asistente Parámetros de instalación para cambiar estos parámetros en cualquier momento.
La tabla siguiente ofrece una descripción de los principales parámetros de configuración disponibles en teamserver.war/WEB-INF/lib/teamserver-model- XXX.jar/ilog/rules/teamserver/preferences.properties.
Nota:
Los parámetros de la tabla incluyen el prefijo teamserver, que no está en el campo preferences.properties. Debe incluir el prefijo cuando establezca los parámetros de configuración en el Asistente de Parámetros de instalación.
Parámetro Utilizado para
teamserver.<extractorValidator>.classEspecifique una clase de validadores de extractor
de conjunto de reglas para utilizar para el nombre extractorValidator. La clase debe implementar la interfaz IlrExtractorValidator. Tras definir esta clase, especifique este nombre como el validador de clases a utilizar cuando defina un extractor de conjunto de reglas.
Parámetro Utilizado para
teamserver.build.path Define la ubicación de la memoria caché de IRL en el sistema de archivos. Calcular la vía de acceso de la siguiente manera:
v Utilice esta propiedad con el nombre del usuario que ha iniciado el servidor como root para la memoria caché
(<build.path>_<nombre_usuario>).
v Si esta propiedad no está definida, utilice la propiedad del sistema java.io.tmpdir y añada rtscache. Por ejemplo, <dir
temp>/rtscache_<nombre_usuario>).
v Si la propiedad del sistema no está definida, utilice el directorio del servidor y añada rtscache. Por ejemplo, <dir
servidor>/rtscache_<nombre_usuario>).
teamserver.brl.verbalizers Especificar la lista de entornos locales para los que se ha definido un verbalizador de BAL.
teamserver.brl.verbalizer.<entorno_local>Especifique la clase de verbalizador para el entorno local. La clase debe implementar la interfaz ilog.rules.vocabulary.verbalization. IlrVerbalizer.
Procedimiento
1. Cree un parámetro o modifique un parámetro existente. v Para crear un parámetro, pulse Nuevo.
v Para modificar un parámetro, seleccione el recuadro de selección junto al parámetro y a continuación pulse Modificar para cambiar el parámetro o pulse Suprimir para eliminarlo.
2. Pulse Aplicar para implementar los cambios. 3. Haga lo siguiente:
v Pulse Anterior si quiere realizar cambios en los valores anteriores. v Pulse Finalizar. El Registro de instalación se abre con un resumen de las
operaciones que ha realizado en el asistente Parámetros de instalación. 4. Pulse Aceptar para finalizar.
Qué hacer a continuación
Ahora tiene que iniciar sesión en la consola de Decision Center. Continúe con la sección Publicar un proyecto.
Cómo completar la configuración utilizando tareas Ant
Las tareas Ant proporcionan un método alternativo para completar o modificar la configuración. Estas tareas realizan los mismos pasos de configuración que el asistente Parámetros de instalación en la consola de Decision Center.
Configuración del entorno de tareas Ant:
Para ejecutar tareas Ant de Decision Center, antes debe configurar las variables de entorno correspondientes.
Antes de empezar
Cuando prepare la ejecución de tareas ant, asegúrese de que se cumplan las siguientes condiciones.
v Debe tener la versión 1.7.1 (o posterior) de Ant configurada en su sistema. Si Ant no está instalado, o es anterior a la versión 1.7.1, debe configurar el entorno para utilizar la versión correcta de Ant.
Para comprobar su versión actual del Ant, escriba el mandato siguiente en un indicador de mandatos de Windows Command Prompt o un shell de UNIX: ant -version
Puede descargar Ant del sitio web de Apache, o puede utilizar la distribución Ant 1.7.1 empaquetada en <dir-instalación_ODM>/shared/tools/ant, donde <dir-instalación_ODM> es el directorio de instalación de Operational Decision Manager.
v Asegúrese de que las variables de entorno necesarias para WebSphere
Application Server están correctamente configuradas. Para ello, utilice el script setupCmdLine.bato setupCmdLine.sh en el directorio <dir_instalación_WAS>/ profiles/<nombre_perfil>/bin. Este script configura un entorno completo de WebSphere Application Server, incluyendo las variables WAS_HOME,
WAS_LOGGING y WAS_CLASSPATH. Para obtener más información: – Information Center de la versión 8.0 de WebSphere Application Server – Information Center de la versión 8.5 de WebSphere Application Server
Acerca de esta tarea
La comunicación entre tareas Ant y Decision Center tiene soporte para los protocolo de comunicación HTTP o HTTPS. Para obtener más información, consulte Protocolo de comunicación de tarea Ant.
Procedimiento
Para configurar el entorno para utilizar Ant:
1. Establezca la variable de entorno ANT_HOME en <dir-instalación_ODM>/ shared/tools/ant.
2. Añada el directorio <dir-instalación_ODM>/shared/tools/ant/bin a su variable de entorno PATH.
Resultados
Las tareas Ant de Decision Center se definen en <dir-instalación>/teamserver/ bin/build.xml y las ejecutan los mandatos de la forma siguiente:
ant <nombre_tarea> <lista de parámetros>
Nota: Para ejecutar estas tareas Ant, debe utilizar la misma versión y proveedor de la Máquina virtual Java que la utilizada por el servidor de aplicaciones.
Los parámetros de las tareas Ant empiezan por -D. Utilícelos para establecer valores como los siguientes:
v -Dserver.url=<url de servidor>: Especifica el URL del servidor de aplicación de destino.
v -DdatasourceName=<nombre origen de datos>: especifica el nombre JNDI del origen de datos a utilizar para la tarea. El valor predeterminado es
Ejemplo
ant execute-schema -Dserver.url=<protocolo://host:puerto>/teamserver/ -DdatasourceName=jdbc/ilogDataSource -Dfile=my_sql_file.sql
La URL de <protocol://host:port> está definida en el archivo <Dir_instalación_ODM>/ teamserver/bin/teamserver-anttasks.properties. Si su navegador no se ejecuta en el mismo host que el servidor de aplicaciones, sustituya localhost por la
dirección del sistema. Si su aplicación web está correlacionada con un host con un puerto distinto del que se muestra, cambie el número de puerto por el número de puerto del host.
El archivo <dir-instalación_ODM>/teamserver/bin/teamserver-
anttasks.properties define el valor de algunos parámetros comunes y otros que dependen del servidor de aplicaciones. Si se definen correctamente estos
parámetros, no tendrá que incluirlos en el mandato de tarea Ant. El contenido del archivo teamserver-anttasks.properties es el siguiente:
# Default properties # --- rtsAdmin.login=rtsAdmin rtsAdmin.password=rtsAdmin protocol=http server.host=localhost server.port=9080 server.url=${protocol}://${server.host}:${server.port}/teamserver datasourceName=jdbc/ilogDataSource outputFile=output.sql languagePackPath = . languagePackOutputPath = ./generated persistenceLocale = selector = branch = override = false
Creación del esquema de base de datos:
Puede crear el esquema de base de datos en una única operación, utilizando la tarea set-extensions de Ant o elegir crearlo paso a paso.
Crear esquemas con la tarea Ant set-extensions:
Por comodidad, puede crear el esquema de base de datos utilizando la tarea Ant
set-extensions.
Acerca de esta tarea
Las extensiones para el modelo de reglas de Decision Center se almacenan en dos archivos XML.
v Descripción del modelo: este archivo suele tener la extensión de nombre de archivo .brmx.
v Inicialización de enumeraciones y jerarquías: este archivo suele tener la extensión de nombre de archivo .brdx.
Puede utilizar tareas Ant para cargar el modelo de reglas desde los dos archivos XML y construir el script SQL necesario para obtener el esquema de base de datos adecuado.
Nota: Para ejecutar estas tareas Ant, debe utilizar la misma versión y proveedor de la Máquina virtual Java que la utilizada por el servidor de aplicaciones.
Como alternativa, puede crear el esquema de base de datos paso a paso, lo que es útil si quiere buscar en el esquema SQL generado. Consulte “Creación del esquema mediante una secuencia paso a paso”.
Procedimiento
Ejecute la tara Ant set-extensions.
Este destino Ant ejecuta gen-create-schema + execute-schema + upload-extensions + upload-roles. Defina los parámetros siguientes:
-Dserver.url=<url del servidor>
-DdatasourceName=<nombre del origen de datos>
-DextensionModel=<archivo de modelo>
Archivo de descripción de modelo con extensión .brmx.
-DextensionData=<archivo de datos>
Archivo de datos de modelo con extensión .brdx.
[-DdbSchemaName=<nombre de esquema de base de datos>]
Puede utilizar este parámetro opcional para especificar el nombre del esquema de base de datos. Si no, Decision Center utiliza el nombre de usuario de la base de datos como nombre del esquema. No obstante, algunas bases de datos permiten a algunos usuarios acceder a varios esquemas, y el esquema
predeterminado no siempre refleja el nombre del usuario.
[-Droles=<lista de roles>]
Se puede utilizar este parámetro opcional para subir la lista de roles a Decision Center. Esta lista se especifica como "rol1 rol2". Por ejemplo:
ant upload-roles -Droles="rtsUser rtsConfigManager Eligibility Validator"
Creación del esquema mediante una secuencia paso a paso:
Si quiere mirar en el esquema SQL generado, puede crearlo paso a paso.
Creación del script del esquema de base de datos:
Puede crear el script de esquema de base de datos utilizando la tarea Ant
gen-create-schema.
Procedimiento
Para crear el script SQL necesario para crear o actualizar el esquema de base de datos, ejecute la tarea Ant gen-create-schema con estos parámetros:
-Dserver.url=<url del servidor>
-DdatasourceName=<nombre del origen de datos>
-DextensionModel=<archivo de modelo>
-DextensionData=<archivo de datos>
La descripción de datos del modelo (extensión .brdx).
[-DdbSchemaName=<nombre de esquema de base de datos>]
Un parámetro opcional que se puede utilizar para especificar el nombre del esquema de base de datos en el que se almacenan las tablas de Decision Center. Si no especifica el parámetro, Decision Center utiliza el nombre de usuario de la base de datos como nombre del esquema. No obstante, algunas bases de datos permiten a algunos usuarios acceder a varios esquemas, y el esquema predeterminado no siempre tiene el mismo nombre que el usuario.
[-DoutputFile=<archivo SQL>]
El nombre del archivo que almacena el script SQL generado. Si no se
proporciona este parámetro, la tarea crea un archivo llamado output.sql en el directorio definido como basedir en el archivo build.xml.
ant gen-create-schema -DextensionModel=my_model_file.brmx -DextensionData=my_data_file.brdx -DoutputFile=my_sql_file.sql
Resultados
1. La tarea se conecta con el origen de datos especificado del servidor de aplicaciones.
2. La tarea comprueba si el origen de datos hace referencia a una base de datos de Decision Center existente.
v Si la base de datos no existe, la tarea genera el script SQL para crear un esquema de base de datos nuevo en el que almacenar el modelo. v Si la base de datos existe, la tarea genera el script SQL necesario para
actualizar el esquema existente de la base de datos.
Ejecución del script del esquema de base de datos:
Ejecute el script del esquema de base de datos.
Procedimiento
Para ejecutar el script SQL que ha creado, ejecute la tarea Ant execute-schema con estos parámetros:
-Dserver.url=<url del servidor>
-DdatasourceName=<nombre del origen de datos>
[-Dfile=<archivo SQL>]
El nombre del archivo a ejecutar, que corresponde con el script que ha creado. Si no especifica este parámetro, la tarea intenta ejecutar un archivo con el nombre output.sql en el directorio definido como basedir en el archivo build.xml.
ant execute-schema -Dfile=my_sql_file.sql
Subir la extensión del esquema de base de datos:
Sube la extensión del esquema de base de datos.
Procedimiento
Para almacenar la descripción del modelo de reglas en el esquema de base de datos, ejecute la tarea Ant upload-extensions con estos parámetros:
-DdatasourceName=<nombre del origen de datos>
-DextensionModel=<archivo de modelo>
La descripción del modelo (extensión .brmx).
-DextensionData=<archivo de datos>
La descripción de datos del modelo (extensión .brdx).
ant upload-extensions -DextensionModel=my_model_file.brmx -DextensionData=my_data_file.brdx
Resultados
La descripción se almacena en la base de datos de forma que las aplicaciones de Decision Center la puedan cargar cuando se inicien. También la utiliza
gen-create-schema para obtener la descripción del modelo actual para ejecutar diff(diferencias) con el esquema nuevo.
En un clúster, debe reiniciar los servidores y cerrar todas las sesiones actuales.
Subir una lista de roles o grupos a la base de datos:
Además de crear grupos en su servidor de aplicaciones cuando configure el acceso de seguridad, debe subir grupos a la base de datos.
Antes de empezar
1. Añada todos los grupos que quiera ver en la lista disponible cuando imponga la seguridad de proyecto o establezca permisos en Decision Center.
2. Cree los grupos predeterminados para rtsUser y rtsConfigManager, y suba sus grupos personalizados.
Acerca de esta tarea
Debe subir roles y grupos solo si quiere utilizar los mecanismos de permisos y acceso para el proyecto Decision Center. Para obtener más información, consulte los temas sobre Grupos y permisos en la ayuda en línea de Decision Center.
No tiene que subir el grupo rtsAdministrator ni el grupo rtsInstaller. El grupo de administradores tiene acceso a todo y un usuario Instalador debe pertenecer a otro grupo.
Nota: Para ejecutar estas tareas Ant, debe utilizar la misma versión y proveedor de la Máquina virtual Java que la utilizada por el servidor de aplicaciones.
Procedimiento
Para almacenar en la base de datos la lista de roles o grupos a utilizar por la aplicación, ejecute la tarea Ant upload-roles con los parámetros siguientes:
-Dserver.url=<url del servidor>
-DdatasourceName=<nombre del origen de datos>
-Droles=<lista de roles>
<lista de roles> es la lista de roles o grupos a subir a Decision Center, especificada como "grupo1 grupo2".
Eliminación de un esquema de base de datos:
Ahora puede crear un script SQL para eliminar (drop) un esquema de base de datos utilizando la tarea Ant gen-drop-schema.
Acerca de esta tarea
Para eliminar un esquema de base de datos, realice dos pasos:
1. Cree el script SQL necesario para eliminar el esquema de base de datos. 2. Ejecute el script SQL que ha creado.
Procedimiento
1. Para crear el script SQL para suprimir un esquema de base de datos, ejecute la tarea Ant gen-drop-schema con uno de los parámetros siguientes:
-Dserver.url=<url del servidor>
-DdatasourceName=<nombre del origen de datos>
-DextensionModel=<archivo de modelo>
la descripción del esquema de base de datos a eliminar.
[-DdbSchemaName=<nombre de esquema de base de datos>]
Puede utilizar un parámetro opcional para especificar el nombre del esquema de base de datos. Si no especifica este parámetro, Decision Center utiliza el nombre de usuario de la base de datos como nombre del
esquema. No obstante, en algunas bases de datos, los usuarios pueden acceder a varios esquemas y el esquema predeterminado no tiene siempre el mismo nombre que el usuario.
[-DoutputFile=<archivo SQL>]
El nombre del archivo que almacena el script SQL generado. Si no especifica este parámetro, la tarea crea un archivo con el nombre
output.sqlen el directorio definido como basedir en el archivo build.xml.
ant gen-drop-schema -DextensionModel=my_model_file.brmx -DoutputFile=my_sql_file.sql
2. Para ejecutar el script SQL que ha creado, ejecute la tarea Ant execute-schema con estos parámetros:
-Dserver.url=<url del servidor>
-DdatasourceName=<nombre del origen de datos>
[-Dfile=<archivo SQL>]
El nombre del archivo a ejecutar, que corresponde con el script que ha creado. Si no especifica este parámetro, la tarea intenta ejecutar un archivo con el nombre output.sql en el directorio definido como basedir en el archivo build.xml.
ant execute-schema -Dfile=my_sql_file.sql
La tarea se conecta con el origen de datos especificado del servidor de
aplicaciones. Lee la descripción del modelo proporcionado en los parámetros, y genera el script SQL para eliminar el esquema existente. Como hay varias tablas de bases de datos enlazadas por medio de claves foráneas, dichas tablas se deben eliminar en un orden específico y la generación de scripts gestiona estas restricciones.
Ejemplo
ant gen-drop-schema -DextensionModel=my_model_file.brmx -DoutputFile=my_sql_file.sql ant execute-schema -Dfile=my_sql_file.sql
Definición y subida de archivos de mensajes:
Puede definir y subir archivos de mensajes en Decision Center utilizando la tarea Ant upload-messages.
Los archivos de mensajes contienen el texto de visualización que se asocia a las extensiones del modelo de reglas que contienen los archivos .brmx y .brdx. Por ejemplo: status=Status effectiveDate=Effective Date expirationDate=Expiration Date new=New defined=Defined
El archivo de mensajes predeterminado se proporciona en: <dir-instalación_ODM>/ teamserver/bin/defaultextensionmessages_<ENTORNO-LOCAL>.properties
Nota: El contenido de los archivos de mensajes debe cumplir el estándar ISO-LATIN-1.
Debe tener un archivo de mensajes por cada entorno local que utilice. Suba el archivo de mensajes a Decision Center ejecutando la tarea Ant upload-messages con estos parámetros:
v -Dserver.url=<URL del servidor>
v -DdatasourceName=<nombre del origen de datos> v -Dlocale=<entorno local>
v -DmessageFile=<archivo de mensaje>
ant upload-messages -Dlocale=en_US -DmessageFile=mymessages.properties
Configuración de los usuarios de la consola Business de Decision Center:
Si utiliza la modalidad incorporada de control, puede configurar los usuarios de la consola Business mediante la ejecución de una tarea Ant.
Debe mantener la lista de usuarios coherente con los usuarios definidos en el servidor de aplicaciones.
La forma predeterminada en la que se configurar los usuarios es añadirlos a la base de datos de Decision Center ejecutando el mandato Ant upload-users Ant. El mandato sube los nombres que se encuentran en una archivo XML.
Utilice el formato siguiente en los nombres:
<Users>
<User><LoginId>usuario1</LoginId></User> <User><LoginId>usuario2</LoginId></User> </Users>
Para ver un ejemplo de archivo de usuario, consulte DirInstalación/teamserver/ tutorials/fileusers.xml.