Parametri di configurazione

L'amministratore può ulteriormente configurare Client System Analyzer (CSA) modificando i parametri di contesto nel file WAR dell'applicazione CSA.

Nome parametro

Descrizione

Valore predefinito

alertWhenDone Se impostato su true, viene visualizzato un messaggio che indica che l'applet è stata eseguita. false
appletJAR Il nome del file JAR. CSA.jar
application

Il nome dell'applicazione associata all'istanza CSA. Se non viene specificata alcuna applicazione, i client raccolti dall'istanza CSA non avranno un'applicazione.

nessuno
autoRedir Se impostato su "true", la pagina JSP CSA passa automaticamente all'utilizzo di Sun JVM se JVM è stato impostato su JInitiator ma sul client non è installata la versione appropriata di JInitiator. false
bwTestFile Il nome del file scaricato dal server durante il test dell'ampiezza di banda.
CSA.mb (fornito con CSA nell'applicazione Grid Control)
bwTestMsec La quantità di tempo che l'applet deve impiegare per il test dell'ampiezza di banda. L'applet calcola l'ampiezza di banda contando il numero di byte che può scaricare nell'intervallo specificato. 200 ms
classid

Il campo "classid" per la tag OBJECT (applicabile solo se JVM è impostato su "JInitiator"). L'impostazione di classid per Sun è "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
nessuno: questo campo DEVE essere impostato se JVM è impostato su "JInitiator" ed è ignorato in caso contrario
codebase
: il campo "codebase" per la tag OBJECT (applicabile solo se JVM è impostato su "JInitiator").

nessuno: questo campo DEVE essere impostato se JVM è impostato su "JInitiator" ed è ignorato in caso contrario.
codebase Il campo codebase per la tag OBJECT (applicabile solo se JVM è impostato su "KInitator"). L'impostazione predefinita per Sun è http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,4,0,0
classid

Il campo "classid" per la tag OBJECT (applicabile solo se JVM è impostato su "JInitiator"). L'impostazione di classid per Sun è "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
nessuno: questo campo DEVE essere impostato se JVM è impostato su "JInitiator" ed è ignorato in caso contrario.

nessuno: questo campo DEVE essere impostato se JVM è impostato su "JInitiator" ed è ignorato in caso contrario.
collectCookie La lista di nomi dei cookie da raccogliere. Questo parametro è una lista separata da virgole di nomi di cookie. Vengono raccolti solo i cookie per l'utente corrente del sistema operativo nel browser corrente. L'amministratore può specificare '*' per raccogliere tutti i cookie dell'utente corrente per il browser corrente. Se questo campo non è presente, non viene raccolto alcun cookie.
cookieDomain Il dominio del cookie CSA. Se il dominio o il percorso del cookie non è impostato, i cookie sono disabilitati.
cookieMaxAge La durata massima, in secondi, del cookie sul computer client. L'impostazione predefinita è 1 anno.
cookiePath Il percorso del cookie CSA. Se il dominio o il percorso non è impostato, i cookie sono disabilitati.
customClass Il nome della classe utilizzato per raccogliere i dati personalizzati (vedere di seguito). nessuno: per impostazione predefinita, non viene eseguito alcun codice personalizzato.
customKey1
customKey2
customKey3
I valori delle tre chiavi personalizzate. Tutte le raccolte client eseguite da una pagina JSP CSA che utilizza il descrittore di distribuzione hanno questi valori per le chiavi personalizzate. Tali valori possono essere sostituiti dal codice personalizzato. Se non viene specificato alcun valore per le chiavi personalizzate, non ne viene raccolto alcuno (a meno che tali valori non vengano raccolti dal codice personalizzato).
descriptionFile Il percorso completo di un file di testo contenente la descrizione visualizzata nella pagina della distribuzione. Il contenuto del file deve essere testo in formato HTML. nessuno
destURL Specifica l'URL di destinazione. Si tratta dell'URL al quale il pulsante Procedi nella pagina JSP CSA è collegato. Se non viene specificato un URL per destURL, selezionando il pulsante "Procedi" si passa alla pagina di provenienza; se non c'è alcuna pagina di provenienza, il pulsante "Procedi" non viene visualizzato.
destURLResultsParam Specifica il nome del parametro dell'URL che verrà aggiunto all'URL di destinazione per indicare il livello di conformità del client. Ad esempio, se il valore è "compliance" e il livello di conformità complessivo del client è critico (critical), all'URL di destinazione viene aggiunto il parametro "compliance=critical". Sun
JVM Determina il tipo di JVM da utilizzare. Se il valore è "Sun", la pagina JSP indica al browser di utilizzare Sun JVM. Se il valore è "Oracle", la pagina indica al browser di utilizzare Oracle Jinitiator. Se il valore è "qualsiasi", JSP scrive la tag "applet" standard, in base alla quale il client utilizza la JVM collegata al browser. Sun
maxExecInterval Parametro aggiunto al payload del cookie CSA. Quando la logica di reindirizzamento legge il cookie, se l'indicatore orario del cookie presenta una differenza superiore a questo valore rispetto all'ora corrente, l'applet viene distribuita di nuovo. Questo parametro può essere sostituito dal parametro di contesto "csa_execInterval" nel filtro/JSP di reindirizzamento. 90 giorni
maxFileSize Quantità massima di dati, in KB, che può essere inviata al ricevente in una singola richiesta. Se la dimensione dei dati inviati supera questo limite, la richiesta viene rifiutata e tutti i dati già scritti sull'unità fissa vengono eliminati. 100
maxOutptFiles Numero massimo di file di output che possono essere presenti in XML OutputDir.
100
outputDir Directory in cui vengono scritti i file XML della configurazione CSA. Sia la pagina dell'applet che la pagina del ricevente devono leggere questo parametro, che deve essere identico per le due pagine. Per impostazione predefinita, i file di output vengono scritti nella sottodirectory "csa_results" della directory radice dell'applicazione (se la directory radice dell'applicazione esiste e se la sottodirectory esiste o può essere creata). L'utilizzo del valore predefinito per questo parametro è sconsigliato.
outputEnabled Abilita o disabilita la creazione dei file XML di output (applicabile a entrambe le pagine).
Per impostazione predefinita, i file XML vengono creati e memorizzati in XMLOutputDir.
pluginspage È utilizzato per indirizzare l'utente all'Installer JVM in Netscape poiché Netscape non supporta l'installazione automatica (applicabile solo se il valore di JVM è Jinitiator). L'impostazione predefinita per Sun è http://java.sun.com/products/plugin/index.html#download nessuno: questo campo DEVE essere impostato se JVM è impostato su "JInitiator" ed è ignorato in caso contrario
receiver
receiver

L'URL al quale l'applet deve inviare i dati raccolti.

Nota: quando si imposta questo parametro, l'amministratore deve assicurarsi che la versione del ricevente sia la stessa dell'applet.

In base all'impostazione predefinita, "CSAr.jsp" viene cercato nello stesso percorso della pagina JSP CSA.
ruleFile Specifica il percorso sul server, in relazione alla radice dell'applicazione Web, del file che contiene le regole da valutare. rules.xml
script Specifica uno script, fornito dall'amministratore, che può essere eseguito sul file XML CSA prima che venga contrassegnato per il caricamento da parte dell'agente. nessuno: se non viene specificato uno script, non viene eseguito alcuno script.
tipo Il campo "type" per la tag OBJECT la cui visualizzazione viene eseguita dalla pagina JSP CSA per la distribuzione dell'applet. È applicabile solo se JVM è impostato su "JInitiator". Se JVM è impostato su "Sun", il tipo è "application/x-java-applet". nessuno: questo campo deve essere impostato se JVM è impostato su "JInitiator" ed è ignorato in caso contrario.
viewData Se impostato su true, questo parametro consente all'utente finale di visualizzare i dati raccolti dopo l'invio al server. false

Oltre a questi parametri, è possibile configurare i parametri di reindirizzamento CSA. Il reindirizzamento può essere abilitato utilizzando un filtro del servlet o includendo un file JSP di reindirizzamento CSA in un'altra pagina. Affinché il reindirizzamento funzioni devono essere disponibili i parametri di contesto riportati di seguito.

Nome parametro

Descrizione

Valore predefinito

csa_csaURL L'URL della pagina JSP CSA alla quale l'utente deve essere reindirizzato. nessun valore predefinito: è necessario impostare questo valore affinché il reindirizzamento funzioni.
csa_execInterval L'intervallo, in secondi, tra le esecuzioni di CSA. Se la differenza tra la durata del cookie e l'ora corrente del server è superiore al valore di execInterval, l'utente viene reindirizzato.
nessuno: se il valore di execInterval non è impostato, l'utente viene reindirizzato solo se è presente un cookie CSA.
csa_redirectURL L'URL al quale l'utente deve essere indirizzato dopo l'esecuzione di CSA
nessuno: se questo parametro non è impostato, l'utente viene reindirizzato alla pagina richiesta inizialmente.
csa_UIMode

0: sincrono (nella finestra del browser corrente)

1: asincrono visibile

2: asincrono invisibile

sincrono


Nota: se l'amministratore consente il reindirizzamento utilizzando il filtro del servlet CSA, i parametri sopra elencati devono essere forniti come parametri di inizializzazione per il filtro (ad eccezione del parametro UIMode, che non è richiesto per il filtro del servlet).

Associazione dei parametri di contesto a un'applicazione

In alcuni casi sono richiesti set di parametri differenti per applicazioni differenti. Ad esempio, è possibile che due applicazioni diverse presentino codice personalizzato e set di regole differenti e che l'amministratore desideri associarle a oggetti di CSA Collector diversi. In questo scenario, l'amministratore può specificare i parametri ruleFile, appletJar, script e outputDir per una determinata applicazione utilizzando i parametri di contesto "<nome applicazione> ruleFile", "<nome applicazione> appletJar" e così via. Se viene specificata un'applicazione, come parametro di contesto o tramite l'URL, CSA viene eseguito utilizzando i valori di parametro specifici dell'applicazione. Se non viene specificata alcuna applicazione, o se uno dei parametri per un'applicazione non viene sostituito, vengono utilizzati i parametri predefiniti.

Parametri URL

Alcuni dei parametri nella tabella riportata sopra possono essere specificati anche come parametri URL. Se si specifica il parametro "applicazione" per l'URL, i parametri di contesto associati all'applicazione vengono utilizzati al posto dei parametri predefiniti. Se si specifica un parametro per l'URL, sostituisce il valore per il parametro specificato nel descrittore di distribuzione dell'applicazione CSA, oltre a sostituire il valore specifico dell'applicazione per il parametro di contesto nei casi in cui viene specificata un'applicazione.

I parametri che possono essere specificati per l'URL sono customKey1-3, alertWhenDone, application, autoRedir, bwTestMsec, JVM e uiMode.

Argomenti correlati

Informazioni su Client System Analyzer

Informazioni sulla duplicazione

Enterprise Manager Information Roadmap