pdm_logfile - Modifica delle dimensioni cutover del file stdlog

Comandi di riferimento › pdm_logfile - Modifica delle dimensioni cutover del file stdlog

pdm_logfile - Modifica delle dimensioni cutover del file stdlog

Il comando pdm_logfile consente di modificare le dimensioni cutover del file stdlog.x. Il cutover si può verificare dopo la scrittura di un numero specificato di byte. In UNIX, questo valore viene ripristinato ogni volta che si esegue il comando pdm_init. In Windows, le impostazioni vengono mantenute ogni volta che si eseguono i comandi pdm_halt e pdm_init.

Sintassi

Il comando presenta il seguente formato:

pdm_logfile [-L|-h]

pdm_logfile [-g -h] [-b byte]

Esempio

Per impostare il cutover dei file stdlog.x ogni 500.000 byte, immettere il comando seguente:

pdm_logfile -f STD -b 500000

-L

Crea un elenco dei cutover correnti.

-q

Esegue il comando pdm_logfile in modalità non interattiva.

-b byte

Specifica il numero di byte che devono essere scritti prima del cutover.

Restrictions

È possibile eseguire il comando pdm_load mentre CA SDM è attivo, tuttavia le prestazioni potrebbero risentirne in modo significativo. Si consiglia di eseguire il comando pdm_load quando nessun utente sta utilizzando CA SDM.

Importante: in UNIX, LIBPATH deve essere impostato prima di eseguire diverse utilità di CA SDM. Utilizzare pdm_task per impostare LIBPATH prima di eseguire un'utilità. Immettere ad esempio "pdm_task pdm_clean_attachments...".

Utilità pdm_log4j_config - Modifica del file delle proprietà log4j

L'utilità pdm_log4j_config consente di configurare i file delle proprietà log4j di CA SDM, i componenti Web, PDM_RPC, Support Automation, Resto e CMDB Visualizer. Esegue lo script in batch dell'utilità adatto al proprio ambiente. Per Windows, eseguire pdm_log4j_config dalla riga di comando. Per UNIX, eseguire il file pdm_log4j_config.sh.

Il comando presenta il seguente formato:

pdm_log4j_config -f <component> -d
pdm_log4j_config -h
pdm_log4j_config -f <component>  [-a | -n <name>] [-l <log level>] [I <max # of log files>] [-s <max size of log files>] [-t <log level threshold>]

-f

Specifica la configurazione log4j di CA SDM o il componente di CA SDM che si desidera modificare. Immettere uno dei valori seguenti:

SDM_WEB, SDM_RPC, REST, SA, o Viz.

Nota: utilizzare l'opzione obbligatoria con le altre opzioni.

-d

Visualizza la configurazione corrente di log4j.properties.

-h

Visualizza la Guida in linea dell'utilità.

-a

Completa tutte le modifiche a log4j.properties a livello globale.

-n

Specifica la modifica di un nome di classe o di pacchetto specifico.

Specificare un nome di classe, ad esempio bop_logging, oppure un nome di pacchetto completo, ad esempio com.ca.ServicePlus.

-l

Specifica il livello di registro che si desidera impostare.

Nota: specificare l'opzione di -a oppure -n.

-i

Specifica l'indice di numero di file massimo che si desidera impostare.

Nota: specificare l'opzione di -a oppure -n.

-s

Specifica le dimensioni di file massime che si desidera impostare.

Nota: specificare l'opzione di -a oppure -n.

Importante Modificare l'appender nel file log4j.properties del Visualizer in Rolling File Appender prima di eseguire il comando con questo parametro. Se non si modifica l'appender, MaxFileSize genera registri nello stesso file.

-t

Specifica la soglia del livello di registro.

Nota: specificare l'opzione di -a oppure -n.

Esempi di uso dell'utilità

L'elenco seguente fornisce alcuni esempi di utilizzo dell'utilità pdm_log4j_config:

Modifica del livello di dettaglio del registro per tutti i logger configurati nel file delle proprietà mediante le variabili -l e -a.
Ad esempio, è possibile impostare tutti i logger configurati in Support Automation a un livello di DEBUG:
```
pdm_log4j_config -f SA -a -l DEBUG
```
Modifica del livello di dettaglio del registro per una classe di logger o un nome di pacchetto specifico nel file delle proprietà log4j di CA SDM mediante le variabili -l e -n.
Ad esempio, è possibile impostare il logger per il pacchetto pdm_rpc su DEBUG utilizzando uno dei seguenti codici di esempio:
```
pdm_log4j_config -f SDM_RPC -n pdm_rpc -l DEBUG
```
```
pdm_log4j_config -f SDM_RPC -n com.ca.ServicePlus.pdm_rpc -l DEBUG
```
Modificare il numero massimo di file di registro da creare per tutti gli appender (proprietà MaxBackupIndex) utilizzando le variabili -i e -a nel file delle proprietà log4j di REST.
Ad esempio, impostare 9 come numero massimo di file per tutti gli appender.
```
pdm_log4j_config -f REST -a -i 9
```
Modifica del numero massimo di file di registro configurati nel file delle proprietà log4j di CA SDM per la creazione di un appender per una classe specifica o un insieme di classi (proprietà MaxBackupIndex) mediante le variabili -i e -n.
Ad esempio, è possibile impostare 7 come numero massimo di file per bop_logging.
```
pdm_log4j_config -f SDM_WEB -n bop_logging -i 7
```
Modifica delle dimensioni massime di ciascun file di registro configurato nel file delle proprietà log4j di REST per la creazione degli appender (proprietà MaxFileSize) mediante le variabili -s e -a.
Ad esempio, è possibile impostare 9 come dimensione massima dei file per tutti gli appender.
```
pdm_log4j_config -f REST -a -s 9MB
```
Modifica delle dimensioni massime dei file di registro configurati nel file delle proprietà log4j di CA SDM per la creazione di un appender per una classe specifica o un insieme di classi (proprietà MaxFileSize) mediante le variabili -s e -n.
Ad esempio, è possibile impostare 7 come dimensione massima di bop_logging.
```
pdm_log4j_config -f SDM_WEB -n bop_logging -s 7MB
```
Modifica della soglia del livello di registro per tutti gli appender configurati nel file delle proprietà dlog4j di Support Automation (proprietà di soglia) mediante le variabili -t e -a.
Ad esempio, è possibile impostare la soglia del livello di registro su DEBUG.
```
pdm_log4j_config -f SA -a -t DEBUG
```
Nota: il parametro -t della soglia del livello di registro prevale sul parametro -l del livello di registro. In caso di modifica del livello di registro e del livello di soglia, i registri di debug del servlet non verranno visualizzati nel file.
Modifica della soglia del livello di registro per un appender per una classe specifica o un insieme di classi (proprietà di soglia) configurato nel file delle proprietà log4j di CA SDM mediante le variabili -t e -n.
Ad esempio, è possibile impostare la soglia del livello di registro su WARN.
```
pdm_log4j_config -f SDM_WEB -n bop_logging -t WARN
```
Esecuzione del comando seguente per la visualizzazione della configurazione del logger e dell'appender corrente nel file delle proprietà log4j di REST:
```
pdm_log4j_config -f REST -d 
```

Importante. Utilizzare le variabili -l, -i, -s, e -t insieme a una delle opzioni -a o -n, ma non utilizzare entrambe le opzioni. L'opzione -f è obbligatoria. Le opzioni -h e -d sono escludono automaticamente qualsiasi altra opzione.

Modifica manuale dell'intervallo di aggiornamento del file di registro

Gli amministratori possono modificare l'intervallo di monitoraggio delle modifiche del file log4j.properties. Per impostazione predefinita, l'intervallo di aggiornamento è impostato ogni 60 secondi. I componenti di CA SDM, inclusi i servlet SDM, PDM_RPC, Support Automation, CMDB Visualizer e REST eseguono la connessione mediante il file log4j.

Procedere come descritto di seguito:

Aprire la directory seguente sul server CA SDM:
```
NX_ROOT
```
Aprire il file NX.env per la modifica.
Modificare la variabile NX_LOG4J_REFRESH_INTERVAL con un valore in millisecondi.
Nota: se il valore immesso è negativo o non numerico, verrà utilizzato il valore predefinito di 60 secondi.
Salvare il file NX.env.

Modifica dell'appender jsrvr.log

Per impostazione predefinita, i servlet quali PDMContextListener, pdmweb, UploadServlet e pdm_report registrano i messaggi di livello INFO nel file jsrvr.log. Modificare il livello di soglia dell'appender jsrvr.log per eseguire la registrazione di qualsiasi messaggio del livello INFO.

Procedere come descritto di seguito:

Modificare il livello nel file log4j.properties con la seguente soglia:
```
log4j.appender.jsrvrlog.Threshold=debug
```

Modifica il livello di registro di UploadServlet:

log4j.logger.com.ca.ServicePlus.uploadservlet=debug, jsrvrlog

Aprire il file jsrvr.log.
Confermare che i messaggi di livello DEBUG di UploadServlet vengano visualizzati.

Nota: in caso di modifica del livello di registro ma non del livello di soglia, i registri DEBUG del servlet non verranno visualizzati nel file. Non tutti i servlet dispongono di logger espliciti associati. Ad esempio, il file log4j.properties include pdmweb, BOServlet, pdm_export, pdm_report e pdm_cache appartenenti al servlet pdmweb. Per visualizzare i registri di debug da questi servlet, modificare il livello di registro pdmweb.

Modifica dell'appender jstd.log

Tutti i registri delle applicazioni nonwebapp vengono aggiunti al file jstd.log separatamente. Per visualizzare i registri per tali applicazioni, ad esempio pdm_rpc, modificare il livello di registro dell'applicazione desiderata.

Procedere come descritto di seguito:

Modificare il seguente livello di registro:

log4j.logger.com.ca.ServicePlus.pdm_rpc=debug

Aprire log4j.properties e verificare che le voci di registro vengano visualizzate.

Contatta CA Technologies