Referenzbefehle › pdm_logfile – Ändern der Cutover-Größe von STDLog

pdm_logfile – Ändern der Cutover-Größe von STDLog

Mit "pdm_logfile" können Sie die Cutover-Größe Ihrer Datei "STDLog.x" ändern. Der Cutover kann stattfinden, nachdem eine angegebene Anzahl von Byte geschrieben wurde. Bei UNIX wird dieser Wert bei jedem "pdm_init</cs> zurückgesetzt. Bei Windows werden die Einstellungen bei jedem "pdm_halt</cs> und "pdm_init</cs> beibehalten.

Syntax

Dieser Befehl hat das folgende Format:

pdm_logfile [-L|-h]

oder

pdm_logfile [-g -h] [-b bytes]

Beispiel

Um die Cutover-Größe zu ändern und einen Cutover Ihrer Datei "STDLog.x</cs> bei 500.000 Byte festzulegen, setzen Sie den folgenden Befehl ab:

pdm_logfile -f STD -b 500000

-L

Erstellt eine Liste der aktuellen Cutovers.

-q

Führt pdm_logfile im Ruhemodus aus.

-b bytes

Gibt die Anzahl der geschriebenen Byte an, bevor ein Cutover stattfindet.

Restrictions

Sie können pdm_load ausführen, während CA SDM aktiv ist; die Leistung kann jedoch sehr beeinträchtigt werden. Führen Sie pdm_load am besten aus, wenn kein Benutzer CA SDM verwendet.

Wichtig! Bei UNIX muss der LIBPATH vor der Ausführung mehrerer CA SDM-Dienstprogramme festgelegt werden. Verwenden Sie pdm_task, um den LIBPATH vor der Ausführung eines Dienstprogramms festzulegen. Geben Sie zum Beispiel "pdm_task pdm_clean_attachments ..." ein.

pdm_log4j_config-Hilfsprogramm: Ändern der log4j-Eigenschaftsdatei

Mit dem Hilfsprogramm pdm_log4j_config.p können Sie die log4j-Eigenschaftsdatei von CA SDM, Webkomponenten, PDM_RPC, Support-Automatisierung, REST und CMDB Visualizer konfigurieren. Führen Sie das Batch-Skript des Hilfsprogramms aus, das auf Ihrer Umgebung basiert. Führen Sie für Windows in der Befehlszeile pdm_log4j_config aus. Führen Sie für UNIX die Datei pdm_log4j_config.sh aus.

Dieser Befehl hat das folgende Format:

pdm_log4j_config -f <Komponente> -d
pdm_log4j_config -h
pdm_log4j_config -f <Komponente>  [-a | -n <Name>] [-l <Protokollebene>] [I <Max.Anzahl von Protokolldateien>] [-s <Max. Größe von Protokolldateien>] [-t <Protokollebenengrenzwert>]

-f

Gibt die log4j-Konfiguration von CA SDM oder der CA SDM-Komponente an, die Sie ändern möchten. Geben Sie einen der folgenden Werte ein:

SDM_WEB, SDM_RPC, REST, SA oder Viz.

Hinweis: Verwenden Sie die obligatorische Option zusammen mit den anderen Optionen.

-d

Zeigt die aktuelle log4j.properties-Konfiguration an.

-h

Zeigt Hilfe zum Dienstprogramm an.

-a

Führt alle Änderungen an log4j.properties global durch.

-n

Gibt an, dass Sie nur Klassen oder Pakete mit einem spezifischen Namen ändern wollen.

Geben Sie einen Namen einer spezifischen Klassen, z. B. bop_logging, oder eines vollständigen Pakets, z. B. com.ca.ServicePlu, an

-l

Gibt die Protokollebene an, die Sie festlegen wollen.

Hinweis: Legen Sie die Option -a- oder -n-Option fest.

-i

Gibt die Obergrenze für die Anzahl con Dateien an, die Sie festlegen wollen.

Hinweis: Legen Sie die Option -a- oder -n-Option fest.

-s

Gibt die Obergrenze für die Dateigröße an, die Sie festlegen wollen.

Hinweis: Legen Sie die Option -a- oder -n-Option fest.

Wichtig! Ändern Sie den Appender in der log4j.properties-Datei von Visualizer in "Rolling File Appender" um, bevor Sie den Befehl mit diesem Parameter ausführen. Wenn Sie den Appender nicht ändern, generiert MaxFileSize Protokolle in derselben Datei.

-t

Gibt den Grenzwert für die Protokollebene an.

Hinweis: Legen Sie die Option -a- oder -n-Option fest.

Beispiele für die Verwendung des Hilfsprogramms

Die folgende Liste zeigt Beispiele für die Verwendung des Hilfsprogramms pdm_log4j_config an:

• Ändern Sie den in der Eigenschaftsdatei konfigurierten Ausführlichkeitsgrad des Protokolls für alle Logger mithilfe der Variablen -l und -a.

  Legen Sie zum Beispiel für alle in Support-Automatisierung konfigurierten Logger auf eine DEBUG-Ebene fest:

  pdm_log4j_config -f SA -a -l DEBUG
  

• Ändern Sie den Ausführlichkeitsgrad des Protokolls für eine spezifische Logger-Klasse oder einen spezifischen Paketnamen in der CA SDM-log4j-Eigenschaftsdatei mithilfe der Variablen -l und -a.

  Legen Sie zum Beispiel den Logger für das pdm_rpc-Paket mithilfe eines der folgenden Codebeispiele auf DEBUG fest:

  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
  

• Ändern Sie die Höchstanzahl von Protokolldateien, die für alle Appender erstellt werden sollen (Eigenschaft "MaxBackupIndex"), mithilfe der Variablen -i und -a in der log4j-Eigenschaftsdatei von REST.

  Legen Sie zum Beispiel die Höchstanzahl von Dateien für alle Appender auf 9 fest.

  pdm_log4j_config -f REST -a -i 9
  

• Ändern Sie die in der CA SDM-log4j-Eigenschaftsdatei konfigurierte Höchstanzahl von Protokolldateien für einen Appender für eine bestimmte Klasse oder Gruppe von Klassen (Eigenschaft "MaxBackupIndex") mithilfe der Variablen -i und -n.

  Legen Sie zum Beispiel die Höchstanzahl von Dateien für alle Dateien für bop_logging auf 7 fest.

  pdm_log4j_config -f SDM_WEB -n bop_logging -i 7
  

• Ändern Sie die in der REST-log4j-Eigenschaftsdatei konfigurierte maximale Größe aller Protokolldateien, die für sämtliche Appender erstellt werden (Eigenschaft "MaxFileSize") mithilfe der Variablen -s und -a.

  Legen Sie zum Beispiel die maximale Größe für Dateien für alle Appender auf 9 MB fest.

  pdm_log4j_config -f REST -a -s 9MB
  

• Ändern Sie die in der CA SDM-log4j-Eigenschaftsdatei konfigurierte maximale Größe von Protokolldateien für einen Appender für eine bestimmte Klasse oder Gruppe von Klassen (Eigenschaft "MaxFileSize") mithilfe der Variablen -s und -n.

  Legen Sie zum Beispiel die maximale Größe für Dateien für bop_logging auf 7 MB fest.

  pdm_log4j_config -f SDM_WEB -n bop_logging -s 7MB
  

• Ändern Sie den in der log4j-Eigenschaftsdatei für Support-Automatisierung konfigurierten Grenzwert der Protokollebene für alle Appender (Eigenschaft "Threshold") mithilfe der Variablen -t und -a.

  Legen Sie zum Beispiel den Protokollebenengrenzwert auf DEBUG fest.

  pdm_log4j_config -f SA -a -t DEBUG
  

  Hinweis: Der Parameter-Protokollebenengrenzwert -t überschreibt die Parameterprotokollebene -l. Wenn Sie die Protokollebene und den Grenzwert ändern, werden die Debug-Protokolle vom Servlet nicht in der Datei angezeigt.

• Ändern Sie den in der in der CA SDM-log4j-Eigenschaftsdatei konfigurierten Protokollebenengrenzwert für einen Appender für eine bestimmte Klasse oder Gruppe von Klassen (Eigenschaft "Threshold") mithilfe der Variablen -t- und -n.

  Legen Sie zum Beispiel den Protokollebenengrenzwert auf WARN fest.

  pdm_log4j_config -f SDM_WEB -n bop_logging -t WARN
  

• Führen Sie den folgenden Befehl aus, um die aktuelle Logger- und Appender-Konfiguration der REST-log4j-Eigenschaftsdatei anzuzeigen:

  pdm_log4j_config -f REST -d 
  

Wichtig! Verwenden Sie die Variablen -l, -i, -s und -t-Variablen zusammen mit der Option -a- oder -n. Verwenden Sie nicht beide Optionen gleichzeitig. Die Option -f ist obligatorisch. Die Optionen -h- und -d sind für alle anderen Optionen gegenseitig exklusiv.

Manuelles Ändern Sie des Aktualisierungsintervalls der Protokolldatei

Administratoren können ändern, wie oft CA SDM die log4j.properties-Datei nach Änderungen durchsucht. Standardmäßig beträgt das Aktualisierungsintervall 60 Sekunden. CA SDM-Komponenten einschließlich SDM-Servlets, PDM_RPC, Support-Automatisierung, CMDB Visualizer und REST verwenden für die Protokollierung log4j.

Gehen Sie wie folgt vor:

1. Öffnen Sie das folgende Verzeichnis auf dem CA SDM-Server:

   NX_ROOT
   

2. Öffnen Sie die Datei "NX.env" zum Bearbeiten.
3. Ändern Sie die Variable NX_LOG4J_REFRESH_INTERVAL mit einem Wert in Millisekunden.

   Hinweis: Wenn Sie einen negativen oder nicht numerischen Wert eingeben, wird der Standardwert von 60 Sekunden verwendet.

4. Speichern Sie die Datei "NX.env".

Ändern des Appenders jsrvr.log

Standardmäßig wird in Protokollen von Servlets wie PDMContextListener, pdmweb, UploadServlet und pdm_report in der Datei jsrvr.log die Protokollebene INFO verwendet. Sie können die Grenzwertebene des jsrvr.log-Appenders, so ändern, dass für alle Meldungen auf INFO-Ebene Protokolleinträge erstellt werden.

Gehen Sie wie folgt vor:

1. Ändern Sie die Ebene in der log4j.properties-Datei auf folgenden Grenzwert:

   log4j.appender.jsrvrlog.Threshold=debug
   

2. Ändern Sie die Protokollebene von UploadServlet:

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

3. Öffnen Sie die Datei jsrvr.log.
4. Stellen Sie sicher, dass die Debug-Protokollmeldungen von UploadServlet angezeigt werden.

Hinweis: Wenn Sie die Protokollebene ändern, ohne den Grenzwert zu ändern, werden die DEBUG-Protokolle vom Servlet nicht in der Datei angezeigt. Es sind nicht an alle Servlets explizite Logger angehängt. Zum Beispiel enthält die Datei log4j.properties nicht pdmweb, BOServlet, pdm_export, pdm_report und pdm_cache, die zum pdmweb-Servlets gehören. Um DEBUG-Protokolle von diesen Servlets zu sehen, ändern Sie die Protokollebene für pdmweb.

Ändern des Appenders jstd.log

Sämtliche Protokolle von Anwendungen, bei denen es sich nicht um Web-Anwendungen handelt, werden separat in der Datei jstd.log-Datei abgelegt. Sie können Protokolle für alle Anwendungen dieser Art, wie z. B. pdm_rpc, anzeigen, indem Sie die Protokollebene der spezifischen Anwendung ändern.

Gehen Sie wie folgt vor:

1. Ändern Sie die folgende Protokollebene:

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

2. Öffnen Sie log4j.properties und überprüfen Sie, ob die Protokolleinträge angezeigt werden.