CDash:Build Management: Difference between revisions
No edit summary |
No edit summary |
||
Line 36: | Line 36: | ||
</cdash> | </cdash> | ||
Then create the following CTest script | Then create the following CTest script: mymachine.ctest. This script uses the mymachine.cdash.xml to send the site description to CDash, then loop and ask CDash for build to perform: | ||
# These variables define the system and should be set | # These variables define the system and should be set | ||
Line 93: | Line 93: | ||
ctest_sleep(20) | ctest_sleep(20) | ||
endwhile(${CTEST_ELAPSED_TIME} LESS 36000) | endwhile(${CTEST_ELAPSED_TIME} LESS 36000) | ||
Start the script: | |||
ctest -S mymachine.ctest -V (verbose to see what's happening) | |||
One you launch the script on one client, go on CDash, go to the user.php page and click on "Schedule build" under "Actions" for a project (the icon of a floppy). |
Revision as of 20:10, 8 February 2010
CDash 1.6 implements a beta version of remote build management directly from CDash. This page describes how to enable build management in CDash and will be updated as we improve the concept.
Introduction
The main idea of the CDash/CTest build management is to have clients announce their availability to the CDash server. The server then schedule and allocate the proper clients based on the build requirements.
Installation
In your config.local.php put the following line:
$CDASH_MANAGE_CLIENTS = '1';
Then create a machine description XML file (mymachine.cdash.xml) on each client machine:
<?xml version="1.0" encoding="UTF-8"?> <cdash> <system> <platform>windows</platform> <version>7</version> <bits>32</bits> <basedirectory>C:/CDashClient</basedirectory> </system> <compiler> <name>MSVC</name> <version>2009</version> <generator>Visual Studio 9 2008</generator> </compiler> <cmake> <version>2.8</version> <path>C:/Program Files/CMake 2.8/bin</path> </cmake> <library> <name>OpenGL</name> <version>1.3</version> <include>C:/OpenGL</include> <path>C:/OpenGL-bin</path> </library> </cdash>
Then create the following CTest script: mymachine.ctest. This script uses the mymachine.cdash.xml to send the site description to CDash, then loop and ask CDash for build to perform:
# These variables define the system and should be set # In the future CTest might be able to determine this automatically set(CDASH_SITENAME "mysite") set(CDASH_SYSTEMNAME "Windows7-32bits") set(CDASH_SITE_CONFIG_FILE "C:/CDashExample/mymachine.cdash.xml") set(CDASH_TEMP_DIRECTORY "C:/CDashExample") set(CTEST_EXECUTABLE "C:/Program Files/CMake 2.8/bin/ctest") set(CTEST_DROP_SITE "localhost")
# Everything below this line shouldn't be modified set(CTEST_SOURCE_DIRECTORY "${CDASH_TEMP_DIRECTORY}/dummysource") set(CTEST_BINARY_DIRECTORY "${CDASH_TEMP_DIRECTORY}/dummybin") set(CTEST_DROP_URL "/CDash/submit.php") set(CTEST_DROP_METHOD "http") set(CTEST_DROP_LOCATION ${CTEST_DROP_URL}?sitename=${CDASH_SITENAME}&systemname=${CDASH_SYSTEMNAME}&submitinfo=1) set(CTEST_DROP_SITE_CDASH true) ctest_submit(FILES ${CDASH_SITE_CONFIG_FILE} RETURN_VALUE res) IF(NOT "${res}" STREQUAL "0") MESSAGE(FATAL_ERROR "Cannot submit site file") ENDIF(NOT "${res}" STREQUAL "0") # Get the siteid from CDash SET(CDASH_URL ${CTEST_DROP_METHOD}://${CTEST_DROP_SITE}${CTEST_DROP_URL}) SET(CDASH_CTESTSCRIPT_FILE ${CDASH_TEMP_DIRECTORY}/ctestscript.cdash) SET(CTEST_COMMAND "${CTEST_EXECUTABLE} -S ${CDASH_CTESTSCRIPT_FILE}") file(DOWNLOAD ${CDASH_URL}?sitename=${CDASH_SITENAME}&systemname=${CDASH_SYSTEMNAME}&getsiteid=1 ${CDASH_CTESTSCRIPT_FILE}) file(READ ${CDASH_CTESTSCRIPT_FILE} CDASH_SITE_ID) string(STRIP ${CDASH_SITE_ID} CDASH_SITE_ID) IF(${CDASH_SITE_ID} MATCHES "ERROR:") MESSAGE(FATAL_ERROR ${CDASH_SITE_ID}) ENDIF(${CDASH_SITE_ID} MATCHES "ERROR:") IF(${CDASH_SITE_ID} EQUAL "0") MESSAGE(FATAL_ERROR "Cannot define site id") ENDIF(${CDASH_SITE_ID} EQUAL "0") MESSAGE("SiteId="${CDASH_SITE_ID}) # Start the loop while (${CTEST_ELAPSED_TIME} LESS 36000) # Check if CDash has a job to run file(DOWNLOAD ${CDASH_URL}?siteid=${CDASH_SITE_ID}&getjob=1 ${CDASH_CTESTSCRIPT_FILE}) file(READ ${CDASH_CTESTSCRIPT_FILE} CDASH_CTEST_SCRIPT) IF(${CDASH_CTEST_SCRIPT} EQUAL "0") MESSAGE("Nothing to do...") ENDIF(${CDASH_CTEST_SCRIPT} EQUAL "0") # If it's not zero that means CDash has something for me IF(NOT ${CDASH_CTEST_SCRIPT} EQUAL "0") # Run the script MESSAGE("Running script") SET(CTEST_RUN_CURRENT_SCRIPT 0) ctest_run_script(${CDASH_CTEST_SCRIPT_FILE}) # Mark the job has done file(DOWNLOAD ${CDASH_URL}?siteid=${CDASH_SITE_ID}&jobdone=1 ${CDASH_CTESTSCRIPT_FILE}) MESSAGE("DONE Running script") ENDIF(NOT ${CDASH_CTEST_SCRIPT} EQUAL "0") ctest_sleep(20) endwhile(${CTEST_ELAPSED_TIME} LESS 36000)
Start the script:
ctest -S mymachine.ctest -V (verbose to see what's happening)
One you launch the script on one client, go on CDash, go to the user.php page and click on "Schedule build" under "Actions" for a project (the icon of a floppy).