Edit
Attach
P
rintable
r19 - 2014-02-04 - 18:17:49 - Main.sandyg
You are here:
TWiki
>
Deployment Web
>
DeploymentTroubleshooting
>
IntegrationsTroubleshooting
>
IntegrationsTroubleshootingRTCandBuildforge
>
HowToEnableVerboseLoggingForJBEAndAntTasksToGetMoreDebugInformationInConsoleAndLogs
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! <img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/new.png" alt="new.png" width="50" height="50" align="right"/> How do I enable verbose logging for Jazz Ant tasks, Jazz Build Engine, and Rational Build Forge integration with Rational Team Concert? %DKGRAY% Authors: IntegrationsTroubleshootingTeam<br> Build basis: Rational Team Concert 4.0.x. %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> This page provides information to help you enable verbose logging for your Jazz Build Engine and Ant tasks in order to increase the amount of debug information reported in the build logs that are generated by Rational Team Concert. ---++ Initial assessment * In order to debug a certain Jazz Ant task or Jazz Build Engine participant that is failing, you have the option to enable the verbose output. This option will get more details about the task or participant actions. ---++ Data gathering and subsequent analysis steps ---+++ Jazz Ant tasks tracing To better understand why a Jazz Ant task fails or does not work as expected, you can enable verbose logging for the Jazz Ant task. Example: <verbatim> <completeBuildActivity activityId="${compileActivityId}" buildResultUUID="${buildResultUUID}" repositoryAddress="${repositoryAddress}" userId="${userid}" password="${password}" verbose="true"/> </verbatim> The verbose output is captured in the build log files (step logs of Build Forge) that will be available in the build results overview in Rational Team Concert Eclipse client or web UI. To add debug output to the build, add echo statements into the Ant build script to validate build variables. Example: <verbatim> <echo message="Checking variable value for activityId: ${compileActivityId}" /> <echo message="Checking variable value for repositoryAddress: ${repositoryAddress}" /> </verbatim> ---+++ Jazz Build Engine and its participant tracing Add *-verbose* to the command where you invoke the participant. <verbatim> ${Build_Engine_Path}/jbe -userId ${Build_User} -pass ${Build_Password} -repository ${Repository_Address} -buildResultUUID ${buildResultUuid} -engineUUID ${engineUUID} -participants com.ibm.team.build.autoDeliver -noComplete -verbose. </verbatim> This will capture the verbose output of the participant in the Rational Team Concert build log files that will be available in build results overview in Rational Team Concert Eclipse client or web UI. <verbatim> /jbe -userId ${Build_User} -pass ${Build_Password} -repository ${Repository_Address} -engineId engine -verbose. </verbatim> This will start including the verbose output in the console that is running the Jazz Build Engine binary. ---+++ Rational Build Forge integration tracing To enable the verbose trace of the Build Forge integration with Rational Team Concert and to get details in the logs about what is happening in the background when you request a build from Rational Team Concert, enable verbose logging for the following properties: 1. In the log4j.properties file of the Change and Configuration Management (CCM) or Jazz application, enable verbose logging for the following properties and restart the server: <verbatim> log4j.logger.com.ibm.rational.buildforge=DEBUG log4j.logger.com.ibm.rational.connector.buildforge=ALL </verbatim> Or to reduce the noise and debug a particular task. <verbatim> log4j.logger.com.ibm.rational.buildforge.team.internal.service.BuildForgeBuildLoopScheduledTask=DEBUG log4j.logger.com.ibm.rational.buildforge.team.internal.service.BuildForgeEventPollerScheduledTask=DEBUG </verbatim> *Instead of restarting the server you can reload the log4j.properties file by accessing the following link*: !https://server:9443/ccm/admin?internal=true#action=com.ibm.team.repository.admin.reloadLoggingSettings (This will avoid having to restart the server) Now you can request the build from the Rational Team Concert build definition and all the tracing will be captured in the ccm.log or jazz.log file. ---+++ List all the Build engines defined in the repository use the following URL to get a list of all Build engines defined in the repository. Make sure Jazz Admin account is used. <verbatim> https://HOST:PORT/ccm/resource/virtual/build/engines?_prettyPrint=true </verbatim> Please note from this output , you can also check the engine state and which build definition it supports. ---+++ List all the Build definition defined in the repository. Again, use Jazz admin account and use the URL below: <verbatim> https://HOST:PORT/ccm/resource/virtual/build/definitions?_prettyPrint=true </verbatim> ---+++++!! Related topics: * Still need help troubleshooting your integrations issue? Refer to [[IntegrationsTroubleshooting][Integrations troubleshooting]] for additional topics. * For more troubleshooting topics, refer to [[BuildForgeAndRationalTeamConcertPerformanceTroubleshooting][Jazz and Build Forge performance troubleshooting]]. ---+++++!! External links: * None ---+++++!! Additional contributors: Main.ZeeshanChoudhry ---+++++!! Questions and comments %COMMENT{type="below"target="HowToEnableVerboseLoggingForJBEAndAntTasksToGetMoreDebugInformationInConsoleAndLogsComments" button="Submit"}% %INCLUDE{"HowToEnableVerboseLoggingForJBEAndAntTasksToGetMoreDebugInformationInConsoleAndLogsComments"}% <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r22
<
r21
<
r20
<
r19
<
r18
|
More topic actions...
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.