Question about Java build execution environment
Hi,
I'm having problems calling javadoc from a Jazz build - a local build - where ant invokes javadoc.exe externally. Looks like a problem with the build execution envirnment calling javadoc.exe. Can someone explain the execution environment - path, classpath, etc - defined for a build execution and then is it different for local and remote builds. I also had some problems with the Java compiler even though a JAVA_HOME is set and is in the PATH. The ecj.jar fixed it, but seems like a hack when both Eclipse and my PATH have a JDK available. FYI, this is simply the Hello example from the buildsystem with a javadoc command added. The abrupt end and garbage at the end are from the log. I am not as much concerned about getting javadoc to work as I am understanding the build execution environment. Builds require many 3rd-party tools for building and analysis and I am curious how they can are integrated into Jazz builds. Failing on javadoc (and javac) is a concern. Many thanks. C:\java\jazz\workspace-admin\JazzBuildTest\build.xml:91: Javadoc failed: java.io.IOException: CreateProcess: javadoc.exe -d C:\java\jazz\workspace-admin\JazzBuildTest\javadoc -doctitle "<h1>Hello</h1>" -bottom "<i>Copyright © 2007 Hello.</i>" -classpath C:\java\jazz\jazz0.6M2a\client\eclipse\plugins\org.apache.ant_1.7.0.v200706080842\lib\ant-launcher.jar;C:\java\jazz\jazz0.6M2a\buildsystem\ecj.jar;C:\java\jazz\jazz0.6M2a\buildsystem\buildtoolkit\com.ibm.team.build.client_0.5.0.I20070823-2239.jar;C:\java\jazz\jazz0.6M2a\buildsystem\buildtoolkit\com.ibm.team.build.common_0.5.0.I20070823-2239.jar;C:\java\jazz\jazz0.6M2a\buildsystem\buildtoolkit\com.ibm.team.build.toolkit_0.5.0.I20070823-2239.jar;C:\java\jazz\jazz0.6M2a\buildsystem\buildtoolkit\com.ibm.team.filesystem.client_0.6.0.I20070823-2239.jar;C:\java\jazz\jazz0.6M2a\buildsystem\buildtoolkit\com.ibm.team.filesystem.common.workitems_0.6.0.I20070823-2239.jar;C:\java\jazz\jazz0.6M2a\buildsystem\buildtoolkit\com.ibm.team.filesystem.common_0.6.0.I20070823-2239.jar;C:\java\jazz\jazz0.6M2a\buildsystem\buildtoolkit\com.ibm.team.foundation.common_ ?~ |
2 answers
I will need more information to fully answer your question. Are you using
the javadoc ant task, or invoking javadoc some other way? You say externally, does this mean with the ant "exec" task? It would help to see the full build.xml. I did successfully add a javadoc ant task invocation to the M3 example build at /jazz/buildsystem/buildtoolkit/examples/compile-ant-test/build.xml (in the "compile" target) like this: <javadoc sourcefiles="src/*.java" destdir="doc"> <classpath> <pathelement path="${junitJar}" /> </classpath> </javadoc> The execution environment is this: You run the jazz build engine application. The engine fetches a request from the respository and then spawns an ant process to run your build file. So, the OS environment like PATH, etc should be inherited as you'd expect. In M2, things were a little confusing because the "new build definition" wizard was launching the build engine for you (using a jre). This is no longer happening in M3. So, it should be clear when you launch the build engine what JVM you're using (since you're starting it yourself on the command line). To do certain things in your script, you may need the build engine to be running under a JDK (not jre). I suggest running the build engine at the command line like this (assuming a JDK is on the path): cd /jazz/buildsystem/buildengine/eclipse jbe -repository http://localhost:9080/jazz -engineId yourEngineId -userId yourUser -pass yourPass -sleeptime 1 Note: the sleeptime of 1 second is useful for testing, but the default of 30 seconds is probably better in real use. As far as local vs. remote, if you're invoking the build engine yourself on the command line, there should be no difference. The build engine app is just a client. |
|
Thanks. I am using the ant task and am on M2, not M3,
which might explain the problem. I said externally because it looks like the ant javadoc tasks launches javadoc.exe externally and was concerned because ant tasks for other tools will likely do the same. Your ant task didn't work for me - same exception. If I take the command from the exception and run on the commands line, it works, though: javadoc.exe -d C:\java\jazz\workspace-admin\JazzBuildTest\javadoc -classpath C:\java\jazz\buildsystem\junit.jar -version -author C:\java\jazz\workspace-admin\JazzBuildTest\src\hello\*.java. So it sounds like an env problem and I am guessing it is related to M2 local build. And that if I used a remote engine it might work - I'll try that. Thanks for the information and help. |
Your answer
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.