Wenn Sie im Antz-Build Probleme mit dem Dateiagentenschritt haben, können Sie die Traceerstellung für das Debugging von Fehlern aktivieren.
Warum und wann dieser Vorgang ausgeführt wird
Führen Sie die folgenden Schritte aus, um die Traceerstellung durchzuführen:
- Erstellen Sie auf Ihrem Computer eine Datei des Typs
log4j.properties.
Beispiel:
log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%-4r %-5p [%t] %c %3x - %m%n
Anmerkung: Wenn
log4j.rootLogger=DEBUG zu viele Nachrichten generiert, ändern Sie den Inhalt
der Datei
log4j.properties wie folgt:
log4j.rootLogger=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%-4r %-5p [%t] %c %3x - %m%n
log4j.logger.com.ibm.teamz.fileagent=DEBUG
(Um die Anzahl der Nachrichten zu begrenzen, setzen Sie
die letzte Zeile auf Kommentar.)
- Laden Sie die Datei log4j.properties, die Sie im vorherigen Schritt erstellt haben,
in das z/OS-USS-Verzeichnis.
- Editieren Sie die Datei 'startbfa.sh', und geben Sie die Positin dieser Datei 'log4j.properties' an.
Dazu müssen Sie die Systemeigenschaft log4j.configuration entsprechend einstellen.
Im folgenden Beispiel lautet der vollständige URL
der Konfigurationsdatei wie folgt:
file:/u/user1/log4j.properties.
FA_JAVA_OPTIONS="-Djava.ext.dirs=${JAVA_HOME}/lib/ext"
FA_JAVA_OPTIONS="${FA_JAVA_OPTIONS}:${BLD_TOOLKIT}"
FA_JAVA_OPTIONS="${FA_JAVA_OPTIONS} -Dlog4j.configuration=file:/u/user1/log4j.properties"
- Starten Sie Rational Build Agent erneut, wobei Sie die modifizierte Datei startbfa.sh verwenden, und fordern Sie Ihren Antz-Build an.
In der Buildprotokolldatei können Sie zusätzliche Tracedaten sehen.
Anmerkung: Ist die Traceerstellung aktiviert,
werden Fehlerzeilen aus
com.ibm.team.repository.common.util.ExtensionRegistryReader für die Komponentenelemente angezeigt,
deren ID-Attribute nicht eindeutig sind.
Ein Beispiel für einen solchen Fehler ist unten dargestellt.
Sie können diese Nachrichten ignorieren.
9467 ERROR [main] com.ibm.team.repository.common.util.ExtensionRegistryReader
- The com.ibm.team.repository.common bundle's plugin.xml file contains a <component>element
with the id attribute value com.ibm.team.repository that is not unique.