La interfaz de administración de HATS puede utilizarse para gestionar conexiones y llevar a cabo la determinación de problemas para aplicaciones Web de HATS. En este capítulo se describe cómo utilizar estas funciones de gestión. Si desea obtener más información relacionada con las aplicaciones de cliente enriquecido de HATS, consulte Administración de aplicaciones de cliente enriquecido de HATS.
Puede incluir los archivos de soporte de la consola administrativa de HATS con el conjunto de aplicaciones de HATS contenidas dentro de un archivo Enterprise Archive (.ear) desplegado en WebSphere Application Server. El archivo .ear desplegado proporciona un entorno de ejecución, en el que la consola administrativa de HATS le permite gestionar las aplicaciones de HATS. Si incluye los archivos de la consola administrativa de HATS en varios proyectos, se puede iniciar más de una consola administrativa utilizando distintos nombres de aplicación; no obstante, cada consola administrativa proporciona las mismas vistas y funciones.
En lugar de incluir los archivos de soporte de la consola administrativa de HATS en cada archivo .ear, puede crear un archivo .ear que sólo contenga archivos de la consola administrativa de HATS. Al desplegar este archivo .ear, puede iniciar la consola administrativa de HATS y cambiar el ámbito de gestión para gestionar remotamente las aplicaciones de HATS en varios archivos .ear (así como los portlets de IBM® estándar de HATS) con una instancia de la consola administrativa. La aplicación de la consola administrativa de HATS desplegada le ofrece un único punto de administración para todas las aplicaciones de HATS. Al crear un nuevo proyecto de HATS, especifique si se deben incluir los archivos de la consola administrativa de HATS en el proyecto. Si crea un proyecto de la consola administrativa de HATS, ya no necesitará añadir los archivos de soporte de administración a los demás proyectos que cree.
Para crear un proyecto de la consola administrativa de HATS en HATS Toolkit, seleccione Archivo > Nuevo > Proyecto > HATS > Proyecto de administración de HATS. Debe especificar un nombre de proyecto de Enterprise Application que identifique de forma exclusiva este proyecto como el proyecto de la consola administrativa de HATS. El proyecto de consola administrativa de HATS sólo aparece en HATS Toolkit en la pestaña Navegador. Despliegue el archivo .ear creado en WebSphere Application Server e inícielo (consulte Inicio de la consola administrativa de HATS). Para cambiar el ámbito de la gestión del proyecto de la consola administrativa de HATS, consulte Selección del ámbito de gestión.
Otros temas de administración se describen en Funciones de terminal de pantalla.
La consola administrativa de HATS utiliza un bean JMX (Java™ Management Extensions) para llevar a cabo la administración remota. Cuando se habilita la seguridad global de WebSphere Application Server, la seguridad de WebSphere autentica estas llamadas de JMX que deben tener un nivel válido de autorización en WebSphere. Por consiguiente, la administración remota desde la consola administrativa de HATS no funciona correctamente a menos que el ID de usuario se defina como usuario de la consola administrativa de WebSphere Application Server con autoridad de administrador u operador.
La consola administrativa de HATS permite ver y cambiar los valores de determinación de problemas. También permite ver el estado de la conexión o desconectar conexiones de sistema principal. Si despliega una aplicación de HATS con posibilidades administrativas de HATS, puede correlacionar cada uno de los tres roles de HATS con unos ID de usuario de sistema concretos para mejorar la seguridad. Cada uno de los tres roles de HATS definidos (HATSAdministrator, HATSOperator y HATSMonitor) tiene posibilidades diferentes en la consola administrativa de HATS. Si desea obtener más información, consulte Roles de la consola administrativa de HATS.
De manera parecida, la consola administrativa de WebSphere Application Server permite ver y cambiar la configuración del entorno de WebSphere Application Server. Permite instalar, iniciar, detener y desinstalar aplicaciones Web, tales como aplicaciones de HATS. Existen roles de usuario (administrador, configurador, operador o supervisor) de la consola de WebSphere que proporcionan posibilidades diferentes en la consola administrativa de WebSphere Application Server. Los enlaces siguientes del centro de información de WebSphere Application Server proporcionan detalles adicionales sobre estos roles y políticas de seguridad:
Si la seguridad global de WebSphere está habilitada, los ID de usuario que tienen un rol de HATS pueden conectarse a la consola administrativa de HATS en una aplicación de HATS y pueden realizar tareas de administración sólo en esa aplicación de HATS específica. Si el usuario intenta cambiar el ámbito de gestión para administrar remotamente otra aplicación de HATS, la seguridad de WebSphere comprobará la autorización del ID de usuario. Si el ID de usuario no es un usuario válido de la consola administrativa de WebSphere Application Server con autorización de administrador u operador, las llamadas de JMX se bloquearán y la administración remota de HATS no funcionará correctamente.
Por ejemplo, si el ID de usuario no está definido en absoluto como usuario de la consola administrativa de WebSphere Application Server ni definido con sólo autorización de supervisor, la lista Seleccionar aplicación bajo Ámbito de gestión en la consola administrativa de HATS no mostrará ninguna otra aplicación de HATS. No será posible cambiar el ámbito de gestión porque no se listan otras aplicaciones.
Otro ejemplo sería si el ID de usuario está definido como usuario de consola administrativa de WebSphere Application Server con autorización de configurador, la lista mostrará otras aplicaciones de HATS y el usuario podrá cambiar el ámbito de una aplicación a otra. Sin embargo, la información que se muestra en la consola administrativa de HATS puede ser incorrecta y no tendrán efecto los cambios que se han intentado efectuar a través de la administración remota.
Por tanto, si la seguridad global de WebSphere está habilitada, existen dos opciones para utilizar la consola administrativa de HATS.
Para cualquier opción, si habilita la seguridad global de WebSphere, asegúrese de seleccionar la opción Habilitar seguridad de aplicación. Para WebSphere Application Server V6.x, desde consola administrativa de WebSphere, seleccione Seguridad > Administración, aplicaciones e infraestructura seguras > Seguridad de aplicación > Habilitar seguridad de aplicación. Para WebSphere Application Server V7.x, desde la consola administrativa de WebSphere, seleccione Seguridad > Seguridad global > Seguridad de aplicación > Habilitar seguridad de aplicación.
En resumen, si la seguridad global de WebSphere está habilitada, los ID de usuario que se correlacionan con algún rol de HATS también deben correlacionarse con los roles de administrador u operador de WebSphere Application Server para que la administración remota de HATS funcione correctamente.
La consola administrativa de HATS está vinculada a la seguridad de WebSphere. Esto significa que cuando la seguridad de WebSphere Application Server está habilitada, los administradores del sistema deben tener autenticación adecuada para llevar a cabo tareas administrativas de HATS. Las funciones de seguridad utilizadas por HATS se basan en el proceso de autenticación basado en el formato Java EE. Cuando la seguridad de WebSphere Application Server está habilitada, las operaciones de la consola administrativa de HATS están restringidas según el rol definido para el ID de usuario. Existen tres roles definidos para la consola administrativa de HATS. Cada rol tiene posibilidades distintas.
La correlación de roles con usuarios o grupos de usuarios se realiza con la consola administrativa de WebSphere.
Para WebSphere Application Server V6.x, asegúrese de que la opción Todos autenticados del panel Correlacionar roles de seguridad con usuarios y grupos está seleccionada para el rol de administrador de HATS. Para WebSphere Application Server V7.x, asegúrese de que la opción Todos autenticados en el campo de la aplicación está seleccionada utilizando el menú despleglable Correlacionar sujetos especiales del panel Correlacionar roles de seguridad con usuarios y grupos está seleccionada para el rol de administrador de HATS.
La consola administrativa de HATS está basada en la Web. Las tareas de administración se desempeñan mediante un navegador Web, a través de una interfaz de usuario que proporciona el servlet de la consola administrativa de HATS, HATSAdminServlet.
Para iniciar la consola administrativa de HATS, cargue este URL en el navegador: http://sistema_principal:puerto/nombre_aplicación/hatsadmin/admin, donde sistema_principal es el nombre del sistema principal, puerto es el número de puerto de transporte HTTP del servidor de aplicaciones en el que se ejecuta la aplicación de HATS y nombre_aplicación es el nombre de una aplicación de HATS que incluye soporte de administración.
Al iniciar la consola administrativa de HATS, ésta utiliza el idioma por omisión del servidor. Aunque, si lo desea, puede cambiarlo. Para ello seleccione Preferencias en el marco de navegación, seleccione el idioma que desee y reinicie el navegador. La nueva elección del idioma se aplica a dicho navegador hasta que se seleccione otro idioma en Preferencias.
Para iniciar la consola administrativa de HATS en HATS Toolkit, utilice la modalidad Depurar en servidor o Ejecutar en servidor.
Para iniciar la consola administrativa de HATS para un proyecto determinado, pulse con el botón derecho del ratón en el proyecto en la vista Proyectos de HATS y pulse Abrir consola administrativa.
Si el proyecto todavía no está en ejecución en un entorno de prueba local, se inicia mediante la modalidad Depurar en servidor y se abre una página de navegador Web en el URL de la consola administrativa.
Si el proyecto ya está en ejecución mediante la modalidad Ejecutar en servidor, se visualiza una solicitud que informa de que el servidor no se ejecuta en la modalidad Depuración. Si selecciona la opción Continuar en la modalidad actual, la consola administrativa se abrirá en modalidad Ejecutar en servidor.
Si desea obtener más información sobre la ejecución en modalidades de prueba distintas, consulte Testing modes for Web projects en la publicación Guía de iniciación de HATS.
Los valores del tiempo de ejecución que se cambian al ejecutar la consola administrativa en HATS Toolkit dependen de la modalidad que utilice. Si desea obtener más información, consulte Administración de componentes de la determinación de problemas.
Este apartado le guía por las distintas funciones de la consola administrativa de HATS.
Puede seleccionar el ámbito de gestión. La consola administrativa de HATS mantiene una lista de los ámbitos de gestión para la duración de HttpSession. Por omisión, el ámbito de gestión inicial seleccionado es la aplicación de empresa de HATS (.ear) de la aplicación de HATS utilizada para acceder a la consola administrativa de HATS. Puede cambiar el ámbito de gestión para gestionar otras aplicaciones de empresa de HATS desplegada dentro de la misma célula de WebSphere.
La clave para cambiar el ámbito de gestión es proporcionar la información de sistema principal y puerto para que la consola administrativa de HATS localice las aplicaciones de empresa de HATS instaladas. El valor de puerto especificado debe ser un puerto activo BOOTSTRAP_ADDRESS de WebSphere. Cada uno de los servidores de aplicaciones de WebSphere, los nodos y las células tienen un puerto BOOTSTRAP_ADDRESS. Si se especifica el valor de puerto para uno de estos recursos de WebSphere se podrán administrar las aplicaciones de empresa de HATS implementadas para dicho recurso. Si se especifica un sistema principal y un puerto de un nodo de WebSphere se podrán administrar todas las aplicaciones de empresa de HATS instaladas en dicho nodo. Si desea obtener más información acerca del puerto BOOTSTRAP_ADDRESS, consulte la documentación de WebSphere Application Server.
En un entorno protegido, un administrador puede ver el siguiente mensaje en la consola administrativa de HATS al intentar cambiar el ámbito de la administración:
Se ha producido un problema al intentar gestionar el ámbito seleccionado. No se han encontrado aplicaciones de HATS. No se ha cambiado el ámbito de gestión.
Esto puede ocurrir porque en un entorno protegido de WebSphere, el usuario no está autorizado a llevar a cabo la comunicación necesaria para llenar la lista de aplicaciones disponibles que se van a administrar.
Si WebSphere utiliza el sistema operativo local como registro del usuario, el nombre de usuario utilizado para acceder a la consola administrativa de HATS debe tener derechos de Administrador en el registro del sistema operativo local. Si WebSphere utiliza LDAP como registro del usuario, el nombre de usuario utilizado para acceder a la consola administrativa de HATS debe ser el ID del servidor utilizado por WebSphere para acceder a LDAP.
Existen dos paneles debajo de la cabecera Gestión de licencias en el marco de navegación izquierdo para gestionar la información sobre licencias:
Existen varios paneles distintos debajo de la cabecera Gestión de conexiones en el marco de navegación izquierdo con los que puede supervisar los distintos tipos de conexiones:
Cada conexión que aparece en estas pantallas representa un enlace de comunicaciones a un origen de datos de programa de fondo, como una base de datos o una aplicación 3270. Las pantallas permiten ver información detallada sobre qué usuarios que están conectados a qué orígenes de datos, y qué identificadores de conexión se utilizan. Si existe un nombre de unidad lógica o de agrupación, también se muestra. También puede concluir sesiones.
En el panel Agrupaciones de conexiones debajo de la cabecera Gestión de conexiones del marco de navegación izquierdo muestra información sobre las agrupaciones de conexiones definidas. Una agrupación de conexiones no aparece en la lista hasta que no se haya asignado, como mínimo, una conexión desde la agrupación.
Las agrupaciones de conexiones son colecciones de enlaces de comunicaciones con orígenes de datos de programas de fondo, como aplicaciones 3270, 5250 y VT o bases de datos. Cuando se ejecuta un objeto de integración o una aplicación por cuenta de una petición del cliente, obtiene una conexión disponible de una agrupación, la utiliza para acceder al origen de datos y luego la devuelve a la agrupación. Cuando está habilitada la agrupación de conexiones, la utilización del procesador producida por el establecimiento de la conexión es absorbida en su primer uso. Cada reutilización de la conexión se beneficia del establecimiento previo de la conexión y puede ejecutarse más rápidamente.
El panel Definiciones de agrupaciones de conexiones debajo de la cabecera Gestión de conexiones del marco de navegación izquierdo muestra información de definiciones de agrupaciones para las conexiones de sistema principal y base de datos. Una agrupación no aparece en la lista hasta que no se haya asignado, como mínimo, una conexión desde la agrupación definida.
Una definición de agrupación proporciona información sobre una colección de conexiones de orígenes de datos. Algunas definiciones relacionadas están asociadas con una definición de agrupación; por ejemplo, las definiciones de conexiones y macros y el nombre de lista de usuarios. Además de crear asociaciones entre otras definiciones, la definición de la agrupación proporciona parámetros de configuración para todas las conexiones de la agrupación, como el tamaño mínimo y máximo de la agrupación (en cuanto al número de conexiones activas) y temporizadores de conexión.
El panel Listas de usuarios debajo de la cabecera Gestión de usuarios del marco de navegación izquierdo muestra información sobre listas de usuarios.
Las listas de usuarios identifican los ID de usuarios y otros parámetros específicos de la conexión asociados con una definición de agrupación de conexiones concreta. Para los sistemas que sólo permiten una única conexión por ID de usuario, el número de ID de usuario determina el número de conexiones que pueden estar activas en una sola agrupación.
La consola administrativa de HATS permite supervisar el registro cronológico y el rastreo para facilitarle la resolución de problemas. Puede ver los mensajes de las anotaciones cronológicas, así como cambiar los valores de registro cronológico y de rastreo seleccionando los enlaces debajo de la cabecera Resolución de problemas en el marco de navegación izquierdo. Los valores para estas ayudas para la determinación de problemas se mantienen en los archivos de propiedades.
Si cambia los valores al acceder a la consola administrativa de HATS que se ejecuta en un entorno de ejecución, los cambios se guardan en el archivo runtime.properties. Aunque no es recomendable hacerlo, también puede editar directamente el archivo para cambiar los valores. El archivo se halla en el directorio dir_was/installedApps/nombre_ear correspondiente a una aplicación de empresa de HATS.
Si cambia los valores al acceder a la consola administrativa de HATS que se ejecuta en un entorno de prueba local en HATS Toolkit, los cambios se guardan en uno de dos archivos distintos. Los cambios se guardan en el archivo runtime.properties, si se ejecuta en modalidad Ejecutar en servidor, y en el archivo runtime-debug.properties, si se ejecuta en modalidad Depurar en servidor. Si desea obtener más información, consulte Inicio de la consola administrativa en HATS Toolkit. También puede editar directamente los archivos para cambiar los valores. Los archivos se encuentran en la raíz del proyecto .ear en HATS Toolkit. Tenga en cuenta que los cambios efectuados en el archivo runtime.properties en HATS Toolkit se retienen y pasan a aplicarse al desplegar la aplicación de HATS en un entorno de ejecución. El archivo runtime-debug.properties se ignora en el entorno de ejecución.
Si desea obtener más información sobre los valores de anotaciones cronológicas y de rastreo en estos archivos, consulte el Apéndice A. Archivos de propiedades de unidad ejecutable.
Los nombres de archivo de anotaciones cronológicas y de rastreo base del archivo runtime.properties se utilizan como plantillas para generar conjuntos exclusivos de archivos de anotaciones cronológicas y de rastreo para cada servidor de aplicaciones. El nombre del archivo de rastreo base por omisión es trace.txt; el nombre del archivo de anotaciones cronológicas base por omisión es messages.txt. El nombre del servidor de aplicaciones se añade al nombre de archivo base para generar la plantilla para los archivos de anotaciones cronológicas y de rastreo de un servidor de aplicaciones. El nombre del servidor de aplicaciones es el mismo que el nombre plenamente cualificado del servidor de aplicaciones, tal como lo define WebSphere. Este nombre es célula_nodo_servidor, donde:
El servidor de aplicaciones que ejecuta HATS es la concatenación del carácter de subrayado (_) seguido del nombre del servidor de aplicaciones y de otro carácter de subrayado (_).
Utilizando como ejemplo el archivo de rastreo, el nombre pasa a ser trace_célula_nodo_servidor.text. Por último, se añade a este nombre un índice (1, 2, 3, etc.) para distinguir entre varios archivos. Con varios archivos de rastreo configurados, los nombres de archivo de rastreo para este servidor de aplicaciones son trace_célula_nodo_servidor_1.txt, trace_célula_nodo_servidor_2.txt, etc.
Con el panel Ver anotaciones cronológicas podrá ver el archivo de anotaciones cronológicas de HATS, descargarlo y borrarlo. En el archivo de anotaciones cronológicas se guarda información sobre dos tipos de sucesos:
El archivo de anotaciones cronológicas tiene como finalidad que el usuario lo lea y lo utilice como referencia durante la resolución de problemas. La mayoría de los mensajes que aparecen en las anotaciones cronológicas se documentan en la publicación HATS Messages. Esta publicación contiene sugerencias para las acciones que puede llevar a cabo para corregir problemas cuando sea necesario.
Con el panel Valores de anotaciones cronológicas puede controlar si los sucesos de información y aviso se escriben en el archivo de anotaciones cronológicas además de definir el archivo en el que se escriben los sucesos de anotaciones cronológicas. Consulte Nombres de archivos de anotaciones cronológicas y de rastreo para obtener información sobre cómo se asigna el nombre a los archivos de anotaciones cronológicas. Si el archivo ya existe, los nuevos sucesos se añaden al mismo. Los sucesos de errores siempre se escriben en el archivo de anotaciones cronológicas. También puede definir la cantidad de archivos de anotaciones cronológicas que se deben conservar y el tamaño máximo de cada uno de ellos.
Con el panel Valores de rastreo puede seleccionar uno o más de los tipos de opciones de rastreo siguientes:
Para poder rastrear varias sesiones de sistema principal al mismo tiempo, la simulación de sistema principal utiliza varios puertos TCP/IP. Utilice los campos Rango de puertos TCP/IP para la grabación para establecer el rango de números de puertos para el uso de tiempo de ejecución de servidor. El puerto de inicio por omisión en el rango es 7021 y el puerto de fin por omisión es 7050.
Cuando se depuran aplicaciones en un sistema de prueba, puede controlar si una ventana de terminal que muestra pantallas de sistema principal se crea en la pantalla del servidor. Puede utilizar las pantallas de sistema principal que se muestran en la ventana del terminal para observar interacciones entre las aplicaciones de HATS y la aplicación de sistema principal en tiempo de ejecución. También puede interactuar con la aplicación de sistema principal mediante la pantalla de sistema principal en la ventana del terminal. Sólo se crean pantallas de terminal para las conexiones establecidas mientras esta opción está activa. No se crean para conexiones existentes o para conexiones desocupadas. No obstante, el panel Conexiones de sistema principal de la consola administrativa de HATS incluye un botón Conmutar pantalla que activa y desactiva el terminal de pantalla para las conexiones seleccionadas.
Para activar el terminal de pantalla para cualquier nueva conexión de sistema principal, seleccione el recuadro Habilitar terminal de pantalla en el panel Valores de rastreo, bajo la cabecera Resolución de problemas en el marco de navegación izquierdo; no obstante, puede utilizar la opción Conmutar terminal de pantalla en el panel Conexiones de sistema principal para activar y desactivar en cualquier momento el terminal de pantalla para una conexión concreta, independientemente de si se ha seleccionado el recuadro Habilitar terminal de pantalla en el panel Valores de rastreo.