Konfigurationsparameter

Der Administrator kann Client System Analyzer (CSA) weiter konfigurieren, indem die Kontextparameter in der WAR-Datei der CSA-Anwendung geändert werden.

Parametername

Beschreibung

Standardwert

alertWhenDone Wenn dieser Parameter auf True festgelegt ist, wird mit einer Meldung angegeben, dass das Applet erfolgreich ausgeführt wurde. false
appletJAR Der Name der JAR-Datei CSA.jar
application

Der Name der Anwendung, die mit dieser CSA Instance verknüpft ist. Wenn keine Anwendung angegeben wird, haben Clients, die von dieser CSA Instance erfasst werden, keine Anwendung.

none
autoRedir Wenn dieser Parameter auf “True” festgelegt ist, wechselt die CSA JSP-Seite automatisch zur Benutzung der Sun JVM, wenn JVM auf JInitiator festgelegt wurde, auf dem Client jedoch nicht die entsprechende Version von JInitiator installiert ist. false
bwTestFile Der Name der Datei, die aus dem Server während des Bandbreitentests heruntergeladen wird.
CSA.mb (in CSA in Grid Control-Anwendung enthalten)
bwTestMsec Die Zeit, die das Applet für den Bandbreitentest aufwenden soll. Das Applet berechnet die Bandbreite, indem die Anzahl von Byte gezählt wird, die in diesem Intervall heruntergeladen werden kann. 200 ms
classid

Das Feld “classid” für das OBJECT Tag. Nur anwendbar, wenn JVM auf “JInitiator” festgelegt ist. Die classid für Sun ist “clsid:8AD9C840-044E-11D1-B3E9-00805F499D93”
Keine – dieses Feld MUSS festgelegt werden, wenn JVM auf “JInitiator” festgelegt ist. Sonst wird es ignoriert.
codebase
das Feld “codebase” für das OBJECT Tag. Nur anwendbar, wenn JVM auf “JInitiator” festgelegt ist

None – Dieses Feld MUSS festgelegt werden, wenn JVM auf “JInitiator” festgelegt ist. Sonst wird es ignoriert.
codebase Das Feld codebase für das OBJECT Tag. Nur anwendbar, wenn JVM auf "KInitator" festgelegt ist. Der Standardwert für Sun ist http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,4,0,0
classid

Das Feld “classid” für das OBJECT Tag. Nur anwendbar, wenn JVM auf “JInitiator” festgelegt ist. Die classid für Sun ist “clsid:8AD9C840-044E-11D1-B3E9-00805F499D93”
None – dieses Feld MUSS festgelegt werden, wenn JVM auf “JInitiator” festgelegt ist. Sonst wird es ignoriert.

None – Dieses Feld MUSS festgelegt werden, wenn JVM auf “JInitiator” festgelegt ist. Sonst wird es ignoriert.
collectCookie Die Liste mit den Namen der zu erfassenden Cookies. Dieser Parameter ist eine durch Komma getrennte Liste mit Cookie-Namen. Nur Cookies für den aktuellen BS-Benutzer in dem aktuellen Browser werden erfasst. Der Administrator kann ‘*' angeben, um alle Cookies des aktuellen Benutzers für den aktuellen Browser zu erfassen. Wenn dieses Feld nicht vorhanden ist, werden keine Cookies erfasst.
cookieDomain Die Domain des CSA Cookies. Wenn die Domain oder der Pfad des Cookies nicht festgelegt ist, sind Cookies deaktiviert.
cookieMaxAge Die maximale Dauer in Sekunden des Cookies auf dem Client-Rechner. Standardwert ist 1 Jahr
cookiePath Der Pfad des CSA Cookies. Wenn die Domain oder der Pfad nicht festgelegt ist, sind Cookies deaktiviert.
customClass Der Name der Klasse, die für das Erfassen von benutzerdefinierten Daten verwendet wird (siehe unten) None – Standardmäßig wird kein benutzerdefinierter Code ausgeführt
customKey1
customKey2
customKey3
Die Werte der drei benutzerdefinierten Schlüssel. Alle Client-Erfassungen, die von einer CSA JSP-Seite ausgeführt werden, die diesen Deployment-Deskriptor verwendet, haben diese Werte für die benutzerdefinierten Schlüssel. Diese Werte können durch benutzerdefinierten Code außer Kraft gesetzt werden. Wenn keine benutzerdefinierten Schlüsselwerte angegeben werden, erfolgt keine Erfassung (es sei denn, sie werden von dem benutzerdefinierten Code erfasst)
descriptionFile Der vollständige Pfad der Textdatei, die die Beschreibung enthält, die auf der Deployment-Seite angezeigt wird. Der Inhalt der Datei muss HTML-formatierter Text sein. none
destURL Gibt den Ziel-URL an. Dies ist der URL, mit dem die Schaltfläche Fortfahren auf der CSA JSP-Seite verknüpft ist. Wenn kein destURL angegeben wird, führt die Schaltfläche "Fortfahren" den Benutzer zu der referenzierenden Seite. Wenn keine referenzierende Seite vorhanden ist, wird die Schaltfläche "Fortfahren" nicht angezeigt.
destURLResultsParam Gibt den Namen des URL-Parameters an, der zu dem “Ziel-URL” hinzugefügt wird, um die Konformitäsebene des Clients anzugeben. Wenn der Wert z.B. “compliance” und die Gesamt-Konformitätsebene des Clients "critical" war, würde der Parameter “compliance=critical” zu dem Ziel-URL hinzugefügt. Sun
JVM Bestimmt den Typ der JVM, der benutzt werden soll. Wenn der Wert “Sun” ist, weist die JSP-Seite den Browser an, die Sun JVM zu benutzen. Wenn der Wert “Oracle” ist, weist die Seite den Browser an, Oracle Jinitiator zu verwenden. Wenn der Wert “any” ist, schreibt die JSP das Standard-“Applet-”Tag. In diesem Fall verwendet der Client die JVM, die an den Browser angeschlossen ist. Sun
maxExecInterval Parameter, der zu der CSA Cookie Payload hinzugefügt wird. Wenn die Redirection-Logik das Cookie liest und der Zeitstempel des Cookies um mehr als diesen Wert von der aktuellen Zeit abweicht, wird das Applet erneut bereitgestellt. Dieser Parameter kann durch den Kontextparameter “csa_execInterval” im Redirection JSP/filter außer Kraft gesetzt werdeb. 90 Tage
maxFileSize Maximale Datenmenge in KB, die in einer einzigen Anforderung an den Empfänger zurückgesendet werden kann. Wenn die Größe der gesendeten Daten diesen Grenzwert überschreitet, wird die Anforderung zurückgewiesen und die Daten, die schon auf die Festplatte geschrieben sind, werden gelöscht. 100
maxOutptFiles Maximale Anzahl von Ausgabedateien, die in XML OutputDir vorhanden sein können.
100
outputDir Verzeichnis, in das CSA-Konfigurations-Xml-Dateien geschrieben werden. Die Applet-Seite und die Empfänger-Seite müssen diesen Parameter lesen. Dieser Parameter muss für beide Seiten identisch sein. Standardmäßig werden die Ausgabedateien in das Unterverzeichnis “csa_results” des Anwendungs-Root-Verzeichnisses geschrieben (wenn das Anwendungs-Root-Verzeichnis vorhanden ist und das Unterverzeichnis vorhanden ist oder erstellt werden kann). Die Benutzung des Standardwertes für diesen Parameter wird nicht empfohlen.
outputEnabled Aktiviert oder deaktiviert das Erstellen von Ausgabe-XML-Dateien. Für beide Seiten anwendbar
Standardmäßig werden die XML-Dateien in XMLOutputDir erstellt und gespeichert.
pluginspage Leitet den Benutzer zu dem JVM-Installationsprogramm unter Netscape um, da Netscape die automatische Installation nicht unterstützt. Nur anwendbar, wenn JVM Jinitiator ist. Standardwert für Sun ist http://java.sun.com/products/plugin/index.html#download None – Dieses Feld MUSS festgelegt werden, wenn JVM auf “JInitiator” festgelegt ist. Sonst wird es ignoriert.
receiver
receiver

Der URL, an den das Applet die erfassten Daten senden soll.

Hinweis: Bei der Festlegung dieses Parameters muss der Administrator sicherstellen, dass die Version des Empfänger identich mit der Version des Applets ist.

Standardmäßig wird nach “CSAr.jsp” in demselben Pfad wie bei der CSA JSP-Seite gesucht.
ruleFile Gibt den Pfad auf dem Server bezogen auf das Root-Verzeichnis der Web-Anwendung für die Datei an, die die auszuwertende Regel enthält. rules.xml
script Gibt ein vom Benutzer bereitgestelltes Skript an, das in der CSA XML-Datei ausgeführt werden kann, bevor es für das Hochladen durch den Agent markiert wird. None – Wenn kein Skript angegeben wird, wird kein Skript ausgeführt
type Das Feld “type” für das OBJECT Tag, das von der CSA JSP-Seite wiedergegeben wird, um das Applet bereitzustellen. Dis ist nur anwendbar, wenn die JVM auf “JInitiator” festgelegt ist. Wenn die JVM auf “Sun” festgelegt ist, ist der Typ “application/x-java-applet” None – Dieses Feld muss festgelegt werden, wenn JVM auf “JInitiator” festgelegt ist. Sonst wird es ignoriert.
viewData Wenn dieser Parameter auf True festgelegt ist, kann der Endbenutzer die erfassten Daten anzeigen, nachdem sie an den Server gesendet wurden. false

Neben diesen Parametern können auch CSA Redirection-Parameter konfiguriert werden. Redirection kann mit dem Servlet-Filter oder durch Aufnahme einer CSA Redirection JSP-Datei auf einer anderen Seite aktiviert werden. Die folgenden Kontextparameter müssen vorhanden sein, damit die Redirection verwendet werden kann.

Parametername

Beschreibung

Standardwert

csa_csaURL Der URL der CSA JSP-Seite, auf die der Benutzer umgeleitet werden soll. Kein Standardwert: Dieser Wert muss festgelegt werden, sonst kann die Redirection nicht verwendet werden
csa_execInterval Das Intervall in Sekunden zwischen den Ausführungen von CSA. Wenn die Differenz zwischen dem Alter des Cookies und der aktuellen Server-Zeit größer ist als execInterval, wird der Benutzer umgeleitet.
None. Wenn execInterval nicht festgelegt ist, wird der Benutzer nur umgeleitet, wenn CSA Cookie vorhanden ist.
csa_redirectURL Der URL, zu dem der Benutzer umgeleitet werden soll, nachdem CSA ausgeführt wurde.
None: Wenn dieser Parameter nicht festgelegt ist, wird der Benutzer wieder zu der ursprünglich angeforderten Seite umgeleitet
csa_UIMode

0 - synchronous (im aktuellen Browser-Fenster)

1 - asynchronous visible

2 - asynchronous invisible

synchronous


Hinweis: Wenn der Administrator die Umleitung mit dem CSA Servlet-Filter aktiviert, müssen die oben angegebenen Parameter in Form der Initialisierungsparameter für den Filter angegeben werden (außer bei dem UIMode-Parameter, der bei dem der Servlet-Filter nicht erforderlich ist.)

Kontextparameter mit einer Anwendung verknüpfen

In bestimmten Fällen sind unterschiedliche Gruppen von Parametern für unterschiedliche Anwendungen erforderlich. Zwei verschiedene Anwendungen haben z.B. unterschiedliche Regelgruppen und unterschiedlichen benutzerdefinierten Code und der Administrator möchte sie mit unterschiedlichen CSA Collector-Zielen verknüpfen. In diesem Fall kann der Administrator die Parameter ruleFile, appletJar, script und outputDir für eine bestimmte Anwendung angeben, indem er die Kontextparameter “<application name> ruleFile,” <application name> appletJar” usw. angibt. Wenn eine Anwendung angegeben wird, entweder als Kontextparameter oder über den URL, wird CSA mit den Parameterwerten ausgeführt, die für die Anwendung spezifisch sind. Wenn keine Anwendung angegeben wird oder wenn einer der Parameter für eine Anwendung nicht außer Kraft gesetzt wird, werden die Standardparameter benutzt.

URL-Parameter

Einige der Parameter in der obigen Tabelle können auch als URL-Parameter angegeben werden. Wenn der Parameter “application” in dem URL angegeben wird, werden Kontextparameter, die mit dieser Anwendung verknüpft sind, anstelle der Standardparameter benutzt. Wenn ein Parameter in dem URL angegeben wird, setzt er den Wert für diesen Parameter, wie in dem Deployment-Deskriptor der CSA-Anwendung angegeben, außer Kraft, ebenso wie den anwendungsspezifischen Wert für diesen Kontextparameter, wenn eine Anwendung angegeben wird.

Folgende Parameter können in dem URL angegeben werden: customKey1-3, alertWhenDone, application, autoRedir, bwTestMsec, JVM, uiMode.

Verwandte Themen

Client System Analyzer

Über das Clonen

Wegweiser zu Enterprise Manager-Informationen