El administrador puede realizar más tareas de configuración de Client System Analyzer (CSA) modificando los parámetros de contexto del archivo WAR de la aplicación CSA.
|
Nombre del Parámetro |
Descripción |
Valor por Defecto |
|---|---|---|
| alertWhenDone | Si se define en true, se mostrará un mensaje que indica que el applet se ha ejecutado. | false |
| appletJAR | Indica el nombre del archivo JAR. | CSA.jar |
| application |
Indica el nombre de la aplicación asociada a esta instancia de CSA. Si no se especifica ninguna aplicación, los clientes recopilados por esta instancia de CSA no tendrán ninguna aplicación. |
Ninguno |
| autoRedir | Si se define en “true”, hace que la página JSP de CSA cambie automáticamente y utilice JVM de Sun si JVM se ha definido en JInitiator pero el cliente no tiene la versión apropiada de JInitiator instalada. | false |
| bwTestFile | Indica el nombre del archivo que se descarga del servidor durante la prueba de ancho de banda. |
CSA.mb (incluido con CSA en la aplicación Grid Control) |
| bwTestMsec | Indica la cantidad de tiempo que debe dedicar el applet a la prueba de ancho de banda. El applet calcula el ancho de banda contando el número de bytes que puede descargar en este intervalo. | 200 ms |
| classid |
Hace referencia al campo “classid” de la etiqueta OBJECT. Sólo es aplicable si JVM se define en “JInitiator”. El valor para Sun es “clsid:8AD9C840-044E-11D1-B3E9-00805F499D93”. |
Ninguno: Este campo DEBE estar definido si JVM se ha definido en “JInitiator” y se ignora en cualquier otro caso. |
| codebase | Hace referencia al campo codebase de la etiqueta OBJECT. Sólo es aplicable si JVM se define en "KInitator". | El valor por defecto para Sun es http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,4,0,0 |
| classid |
Hace referencia al campo “classid” de la etiqueta OBJECT. Sólo es aplicable si JVM se define en “JInitiator”. El valor para Sun es “clsid:8AD9C840-044E-11D1-B3E9-00805F499D93”. |
Ninguno: Este campo DEBE estar definido si JVM se ha definido en “JInitiator” y se ignora en cualquier otro caso. |
| collectCookie | Indica la lista de nombres de cookies que se deben recopilar. Este parámetro es una lista de nombres de cookies separados por comas. Sólo se recopilarán cookies del usuario actual del sistema operativo en el explorador actual. El administrador puede especificar ‘*’ para recopilar todas las cookies del usuario actual para el explorador actual. | Si este campo no está presente, no se recopilarán cookies. |
| cookieDomain | Indica el dominio de cookie de CSA. | Si no se define el dominio o la ruta de acceso de cookie, estará desactivada. |
| cookieMaxAge | Indica la duración máxima, en segundos, de la cookie en la máquina cliente. | 1 año |
| cookiePath | Indica la ruta de acceso de cookie de CSA. | Si no se define el dominio o la ruta de acceso, estará desactivada. |
| customClass | Hace referencia al nombre de la clase utilizada para recopilar datos personalizados (consulte a continuación). | Ninguno: El comportamiento por defecto es que no se ejecuta ningún código personalizado. |
| customKey1 customKey2 customKey3 |
Indican los valores de las tres claves personalizadas. Todas las recopilaciones de cliente realizadas por una página JSP de CSA que utiliza este descriptor de despliegue tendrán estos valores para las claves personalizadas. Estos valores se pueden sustituir por código personalizado. | Si no se especifica ningún valor de clave personalizada, no se recopilará ninguna (a menos que las recopile el código personalizado). |
| descriptionFile | Indica la ruta de acceso completa de un archivo de texto que contiene la descripción que se mostrará en la página de despliegue. El contenido del archivo debe ser texto con formato HTML. | Ninguno |
| destURL | Especifica la dirección URL de destino. Es la dirección URL con la que está enlazado el botón Continuar de la página JSP de CSA. | Si no se especifica ningún valor para destURL, el botón “Continuar” llevará al usuario a la página que incluye la referencia; si no existe, no se mostrará el botón “Continuar”. |
| destURLResultsParam | Especifica el nombre del parámetro de dirección URL que se agregará a la “dirección URL de destino” para indicar el nivel de cumplimiento del cliente. Por ejemplo, si el valor era “compliance” y el nivel de cumplimiento general del cliente ha sido crítico, se agregará el parámetro “compliance=critical” a la dirección URL de destino. | Sun |
| JVM | Este parámetro determina el tipo de JVM que se tiene que utilizar. Si el valor es “Sun”, la página JSP dirigirá el explorador para que utilice JVM de Sun. Si el valor es “Oracle”, la página dirigirá el explorador para que use Oracle JInitiator. Si el valor es “any”, JSP escribirá la etiqueta “applet” estándar, que hace que el cliente utilice cualquier JVM que se haya conectado al explorador. | Sun |
| maxExecInterval | Este parámetro se agrega al payload de cookie de CSA. Cuando la lógica de redireccionamiento lee la cookie, si el registro de hora de la cookie difiere de la hora actual más de lo especificado con este valor, se volverá a desplegar el applet. Este parámetro se puede sustituir por el parámetro de contexto “csa_execInterval” en el filtro o JSP de redireccionamiento. | 90 días |
| maxFileSize | Indica la cantidad máxima de datos, en KB, que se puede volver a enviar al receptor en una única solicitud. Si el tamaño de los datos enviados supera este límite, se rechazará la solicitud y se suprimirán los datos que ya se hayan escrito en la unidad de disco duro. | 100 |
| maxOutptFiles | Indica el número máximo de archivos de salida que puede estar presente en XML OutputDir. |
100 |
| outputDir | Hace referencia al directorio en el que se escribirán los archivos xml de configuración de CSA. Tanto la página del applet como la página del receptor deben leer este parámetro, que debe ser idéntico para ambas páginas. | Por defecto, los archivos de salida se escriben en el subdirectorio “csa_results” del directorio raíz de la aplicación (si existe el directorio raíz de la aplicación y el subdirectorio existe o se puede crear). No se recomienda utilizar el valor por defecto. |
| outputEnabled | Permite activar o desactivar la creación de archivos XML de salida. Es aplicable a ambas páginas. |
Por defecto, los archivos XML se crean y almacenan en XMLOutputDir. |
| pluginspage | Se utiliza para dirigir al usuario al Installer de JVM en Netscape ya que Netscape no soporta la instalación automática. Sólo es aplicable si JVM es JInitiator. El valor por defecto para Sun es http://java.sun.com/products/plugin/index.html#download. | Ninguno: Este campo DEBE estar definido si JVM se ha definido en “JInitiator” y se ignora en cualquier otro caso. receiver |
| receiver |
Indica la dirección URL a la que el applet debe enviar los datos recopilados. Nota: Al definir este parámetro, el administrador debe asegurarse de que la versión del receptor es la misma que la del applet. |
El valor por defecto consiste en buscar “CSAr.jsp” en la misma ruta de acceso que la página JSP de CSA. |
| ruleFile | Especifica la ruta de acceso en el servidor, en relación con la raíz de la aplicación Web, del archivo que contiene las reglas que se van a evaluar. | rules.xml |
| script | Especifica un archivo de comandos, proporcionado por el administrador, que se puede ejecutar en el archivo XML de CSA antes de que el agente lo marque para la carga. | Ninguno: Si no se especifica un archivo de comandos, no se ejecutará ninguno. |
| type | Hace referencia al campo “type” de la etiqueta OBJECT que considera la página JSP de CSA para desplegar el applet. Sólo es aplicable si JVM se define en “JInitiator”. Si JVM se define en “Sun”, el tipo es “application/x-java-applet”. | Ninguno: Este campo debe estar definido si JVM se ha definido en “JInitiator” y se ignora en cualquier otro caso. |
| viewData | Si se define en true, este parámetro permite al usuario final ver los datos recopilados después de haberlos enviado al servidor. | false |
Además de estos parámetros, también se pueden configurar los parámetros de redireccionamiento de CSA. El redireccionamiento se puede activar utilizando un filtro de servlet o incluyendo un archivo JSP de redireccionamiento de CSA en otra página. Los siguientes parámetros de contexto deben estar disponibles para que funcione el redireccionamiento.
|
Nombre del Parámetro |
Descripción |
Valor por Defecto |
|---|---|---|
| csa_csaURL | Indica la dirección URL de la página JSP de CSA a la que se debe redirigir al usuario. | Ninguno: Se debe definir este valor o no funcionará el redireccionamiento. |
| csa_execInterval | Indica el intervalo, en segundos, que transcurre entre las ejecuciones de CSA. Si la diferencia entre la antigüedad de la cookie y la hora actual del servidor es superior a execInterval, se redirige al usuario. |
Ninguno: Si no se define execInterval, sólo se redirigirá al usuario si hay cookie de CSA. |
| csa_redirectURL | Indica la dirección URL a la que se debe redirigir al usuario después de la ejecución de CSA. |
Ninguno: Si no se define este parámetro, se dirigirá al usuario de vuelta a la página solicitada originalmente. |
| csa_UIMode |
0: síncrono (en la ventana del explorador actual). 1: asíncrono visible. 2: asíncrono invisible. |
síncrono |
Nota: Si el administrador activa el redireccionamiento utilizando el filtro de servlet de CSA, los parámetros anteriores se tienen que proporcionar en forma de parámetros de inicialización del filtro (excepto el parámetro UIMode, que no es necesario en caso de que se utilice el filtro de servlet.)
En algunos casos, se pueden necesitar juegos distintos de parámetros para aplicaciones diferentes. Por ejemplo, puede que dos aplicaciones tengan un código personalizado y unos juegos de reglas diferentes y que el administrador desee asociarlas a distintos destinos de recopilador de CSA. En este caso, el administrador puede especificar los parámetros ruleFile, appletJar, script y outputDir para una aplicación en particular utilizando los parámetros de contexto “<nombre de la aplicación> ruleFile”, “<nombre de la aplicación> appletJar”, etc. Si se especifica una aplicación, como parámetro de contexto o mediante la dirección URL, CSA se ejecuta utilizando los valores de parámetro específicos de la aplicación. Si no se especifica ninguna aplicación o si uno de los parámetros de una aplicación no se sustituye, se utilizan los parámetros por defecto.
Algunos de los parámetros indicados en la tabla anterior también se pueden especificar como parámetros de URL. Si se especifica el parámetro “application” en la dirección URL, se utilizarán los parámetros de contexto asociados a dicha aplicación en lugar de los parámetros por defecto. Si se especifica un parámetro en la dirección URL, sustituirá el valor de dicho parámetro indicado en el descriptor de despliegue de la aplicación CSA y también sustituirá el valor específico de la aplicación para ese parámetro de contexto para los casos en que se especifica una aplicación.
Los parámetros que se pueden especificar en la dirección URL son: customKey1-3, alertWhenDone, application, autoRedir, bwTestMsec, JVM, uiMode.
Acerca de Client System Analyzer
Guía Básica de Información de Enterprise Manager
Copyright © 1996, 2007, Oracle. Todos los Derechos Reservados.