If you have problems with the file agent step in your Antz
build, you can enable tracing to help debug your problems.
Complete the following steps to enable tracing:
- Create a log4j.properties on your computer.
For example:
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
Note: If
log4j.rootLogger=DEBUG generates
too many messages, change the content of the
log4j.properties file
to:
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
(To limit the
number of messages, comment out the last line.)
- Upload the log4j.properties file that
was created in the previous step to the z/OS® USS
directory.
- Edit startbfa.sh and specify the location of this log4j.properties
file. This is done by setting the system property log4j.configuration.
In the following example the configuration file is fully specified
by the URL: 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"
- Restart the Rational® Build
Agent using the modified startbfa.sh and request
your Antz build. You will see additional tracing in the build log
file.
Note: With tracing enabled, you will see error lines
from
com.ibm.team.repository.common.util.ExtensionRegistryReader on
the component elements with ID attributes that are not unique. An
example of such an error is shown below. You can ignore those messages.
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.