Pour configurer plus précisément Client System Analyzer (CSA), l'administrateur peut modifier les paramètres de contexte dans le fichier WAR de l'application CSA.
|
Nom du paramètre |
Description |
Valeur par défaut |
|---|---|---|
| alertWhenDone | Si la valeur est True, un message indiquant que l'applet a été exécutée apparaît. | false |
| appletJAR | Nom du fichier JAR. | CSA.jar |
| application |
Nom de l'application associée à cette instance CSA. Si aucune application n'est indiquée, les clients collectés par cette instance CSA n'auront aucune application. |
aucune |
| autoRedir | Si la valeur est "True", la page JSP CSA passe automatiquement en mode d'utilisation de la JVM Sun si cette dernière a été paramétrée sur JInitiator et que le client ne dispose pas de la version appropriée de JInitiator. | false |
| bwTestFile | Nom du fichier téléchargé à partir du serveur lors du test de la bande passante. |
CSA.mb (fourni avec CSA dans l'application Grid Control) |
| bwTestMsec | Temps que l'applet doit consacrer au test de la bande passante. Pour calculer la bande passante, l'applet compte le nombre d'octets qu'elle peut télécharger au cours de l'intervalle défini. | 200 ms |
| classid |
Champ "classid" de la balise OBJECT. Applicable uniquement si la JVM est paramétrée sur "JInitiator". Pour Sun, l'ID de classe est "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93" |
aucune – ce champ DOIT être défini si la JVM est paramétrée sur "JInitiator" ; sinon, il est ignoré |
| codebase | Champ "codebase" de la balise OBJECT. Applicable uniquement si la JVM est paramétrée sur "KInitator". | Pour Sun, la valeur par défaut est http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,4,0,0 |
| classid |
Champ "classid" de la balise OBJECT. Applicable uniquement si la JVM est paramétrée sur "JInitiator". Pour Sun, l'ID de classe est "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93" |
aucune – ce champ DOIT être défini si la JVM est paramétrée sur "JInitiator" ; sinon, il est ignoré |
| collectCookie | Liste des noms des cookies à collecter. Ce paramètre est une liste de cookies séparés par une virgule. Seuls les cookies relatifs à l'utilisateur OS en cours dans le navigateur Web en cours d'exécution seront collectés. L'administrateur peut entrer le symbole "*" pour collecter tous les cookies de l'utilisateur en cours pour le navigateur en cours. | En cas d'absence de ce champ, aucun cookie ne sera collecté. |
| cookieDomain | Domaine du cookie CSA. | Si le domaine ou le chemin du cookie n'est pas défini, les cookies sont désactivés. |
| cookieMaxAge | Durée de vie maximale du cookie, en secondes, sur l'ordinateur client. | Valeur par défaut : 1 an |
| cookiePath | Chemin du cookie CSA. | Si le domaine ou le chemin n'est pas défini, les cookies sont désactivés. |
| customClass | Nom de la classe utilisée pour collecter des données personnalisées (voir ci-dessous) | aucune – avec le comportement par défaut, aucun code personnalisé n'est exécuté |
| customKey1 customKey2 customKey3 |
Valeurs des trois clés personnalisées. Ces valeurs seront attribuées à toutes les collectes client effectuées par une page JSP CSA utilisant ce descripteur de déploiement. Ces valeurs peuvent être remplacées par un code personnalisé. | Si aucune valeur de clé personnalisée n'est fournie, aucune ne sera collectée (sauf si elles sont collectées via du code personnalisé). |
| descriptionFile | Chemin d'accès complet du fichier texte contenant la description qui apparaîtra sur la page de déploiement. Le contenu de ce fichier doit être du texte au format HTML. | aucune |
| destURL | Indique l'URL de destination. Il s'agit de l'URL à laquelle le bouton Poursuivre de la page JSP CSA est relié. | Si aucune URL de destination n'est indiquée, le bouton "Poursuivre" amène l'utilisateur à la page de référence. Si cette dernière n'existe pas, le bouton "Poursuivre" n'apparaît pas. |
| destURLResultsParam | Stipule le nom du paramètre d'URL qui sera ajouté à l'URL de destination pour indiquer le niveau de conformité du client. Par exemple, si la valeur est "compliance" et que le niveau de conformité général du client est "critical", le paramètre "compliance=critical" sera ajouté à l'URL de destination. | Sun |
| JVM (Java Virtual Machine) | Ce paramètre détermine le type de JVM (machine virtuelle Java) à utiliser. Si la valeur est "Sun", la page JSP demande au navigateur Web d'utiliser la JVM Sun. Si la valeur est "Oracle", la page demande au navigateur Web d'utiliser Oracle JInitiator. Si la valeur est "any", la page JSP écrit la balise standard "applet", ce qui permet au client d'utiliser la JVM reliée au navigateur Web, quelle qu'elle soit. | Sun |
| maxExecInterval | Paramètre ajouté aux données traitées (payload) de cookie de CSA. Lorsque la logique de réacheminement lit le cookie, si la différence entre l'horodatage de ce cookie et l'heure en cours est supérieure à la valeur définie, l'applet est redéployée. Ce paramètre peut être remplacé par le paramètre de contexte "csa_execInterval" dans la page JSP/le filtre de réacheminement. | 90 jours |
| maxFileSize | Quantité maximale de données (en Ko) que vous pouvez renvoyer au destinataire dans une seule demande. Si la taille des données envoyées dépasse cette limite, la demande est rejetée et les données déjà écrites sur le disque dur sont supprimées. | 100 |
| maxOutptFiles | Nombre maximal de fichiers de sortie qui peuvent être présents dans le répertoire de sortie XML (OutputDir). |
100 |
| outputDir | Répertoire dans lequel les fichiers XML de configuration CSA sont écrits. La page d'applet et la page de réception doivent toutes deux lire ce paramètre, et celui-ci doit être identique pour les deux pages. | Par défaut, les fichiers de sortie sont écrits dans le sous-répertoire "csa_results" du répertoire racine de l'application (si ce dernier existe, et si le sous-répertoire existe ou peut être créé). Pour ce paramètre, l'utilisation de la valeur par défaut n'est pas conseillée. |
| outputEnabled | Active ou désactive la création de fichiers XML de sortie. Applicable aux deux pages. |
Par défaut, les fichiers XML sont créés et stockés dans XMLOutputDir. |
| pluginspage | Permet de diriger l'utilisateur vers l'outil d'installation JVM sous Netscape, puisque ce dernier ne prend pas en charge l'installation automatique. Applicable uniquement si la JVM est Jinitiator. Pour Sun, la valeur par défaut est http://java.sun.com/products/plugin/index.html#download. | aucune – ce champ DOIT être défini si la JVM est paramétrée sur "JInitiator" ; sinon, il est ignoré receiver |
| receiver |
URL à laquelle l'applet doit envoyer les données collectées. Remarque : lors de la définition de ce paramètre, l'administrateur doit s'assurer que la version du destinataire (receiver) est identique à celle de l'applet. |
Par défaut, le système recherche "CSAr.jsp" dans le même chemin que la page JSP CSA. |
| ruleFile | Indique, sur le serveur, le chemin relatif (par rapport au répertoire racine de l'application Web) du fichier contenant les règles à évaluer. | rules.xml |
| script | Indique un script, fourni par l'administrateur, qui peut être exécuté sur le fichier XML CSA avant d'être marqué pour téléchargement vers le serveur par l'agent. | aucune – si aucun script n'est indiqué, aucun n'est exécuté. |
| type | Champ "type" de la balise OBJECT, recomposé par la page JSP CSA pour déployer l'applet. Applicable uniquement si la JVM est paramétrée sur "JInitiator". Si elle est paramétrée sur "Sun", le type est "application/x-java-applet". | aucune – ce champ doit être défini si la JVM est paramétrée sur "JInitiator" ; sinon, il est ignoré. |
| viewData | S'il a la valeur True, ce paramètre permet à l'utilisateur final d'afficher les données collectées après leur envoi au serveur. | false |
En plus de ces paramètres, vous pouvez configurer les paramètres de réacheminement CSA. Pour activer le réacheminement, utilisez un filtre de servlet ou incluez un fichier JSP de réacheminement CSA dans une autre page. Les paramètres de contexte suivants doivent être disponibles pour que le réacheminement fonctionne.
|
Nom du paramètre |
Description |
Valeur par défaut |
|---|---|---|
| csa_csaURL | URL de la page JSP CSA vers laquelle l'utilisateur doit être réacheminé. | Aucune valeur par défaut. Pour que le réacheminement fonctionne, cette valeur doit être définie. |
| csa_execInterval | Intervalle, en secondes, entre deux exécutions de CSA. Si la différence entre l'ancienneté du cookie et l'heure du serveur en cours est supérieure à la valeur execInterval, l'utilisateur est réacheminé. |
aucune. Si le paramètre execInterval n'est pas défini, l'utilisateur n'est réacheminé que s'il existe un cookie CSA. |
| csa_redirectURL | URL vers laquelle l'utilisateur doit être dirigé après l'exécution de CSA. |
aucune : si ce paramètre n'est pas défini, l'utilisateur est réacheminé vers la page demandée initialement. |
| csa_UIMode |
0 - synchrone (dans la fenêtre de navigateur Web en cours) 1 - asynchrone visible 2 - asynchrone invisible |
synchrone |
Remarque : si l'administrateur active le réacheminement à l'aide du filtre de servlet CSA, vous devez fournir les paramètres ci-dessus sous forme de paramètres d'initialisation pour le filtre (à l'exception du paramètre UIMode qui n'est pas obligatoire dans le cas du filtre de servlet).
Dans certains cas, vous pouvez avoir besoin d'ensembles de paramètres distincts pour différentes applications. Par exemple, deux applications distinctes peuvent avoir des ensembles de règles et un code personnalisé différents, et l'administrateur peut souhaiter les associer à différentes cibles Collecteur CSA. Dans cette situation, l'administrateur peut indiquer les paramètres ruleFile, appletJar, script et outputDir pour une application particulière, à l'aide des paramètres de contexte "<nom de l'application> ruleFile", "<nom de l'application> appletJar", etc. Si une application est indiquée, en tant que paramètre de contexte ou via son URL, CSA est exécuté à l'aide des valeurs de paramètre propres à cette application. Si aucune application n'est indiquée ou si l'un des paramètres d'une application n'est pas remplacé, les paramètres par défaut sont utilisés.
Certains paramètres indiqués dans le tableau ci-dessus peuvent également être stipulés comme paramètres d'URL. Si le paramètre "application" est indiqué dans l'URL, les paramètres de contexte associés à cette application sont utilisés à la place des paramètres par défaut. Si un paramètre est indiqué dans l'URL, il remplace la valeur de ce paramètre définie dans le descripteur de déploiement de l'application CSA, ainsi que la valeur propre à l'application pour ce paramètre de contexte (dans les situations où une application est indiquée).
Les paramètres pouvant être spécifiés dans l'URL sont les suivants : customKey1-3, alertWhenDone, application, autoRedir, bwTestMsec, JVM et uiMode.
A propos de Client System Analyzer
Enterprise Manager - Guide d'informations
Copyright © 1996, 2007, Oracle. Tous droits réservés.