Difference between revisions of "CDash:Build Management"

From KitwarePublic
Jump to navigationJump to search
Line 46: Line 46:
 
   set(CTEST_EXECUTABLE "C:/Program Files/CMake 2.8/bin/ctest")
 
   set(CTEST_EXECUTABLE "C:/Program Files/CMake 2.8/bin/ctest")
 
   set(CTEST_DROP_SITE "localhost")
 
   set(CTEST_DROP_SITE "localhost")
 
 
   # Everything below this line shouldn't be modified
 
   # Everything below this line shouldn't be modified
 
   set(CTEST_SOURCE_DIRECTORY "${CDASH_TEMP_DIRECTORY}/dummysource")
 
   set(CTEST_SOURCE_DIRECTORY "${CDASH_TEMP_DIRECTORY}/dummysource")
Line 55: Line 54:
 
   set(CTEST_DROP_SITE_CDASH true)
 
   set(CTEST_DROP_SITE_CDASH true)
 
   ctest_submit(FILES ${CDASH_SITE_CONFIG_FILE} RETURN_VALUE res)
 
   ctest_submit(FILES ${CDASH_SITE_CONFIG_FILE} RETURN_VALUE res)
 
 
   IF(NOT "${res}" STREQUAL "0")
 
   IF(NOT "${res}" STREQUAL "0")
 
     MESSAGE(FATAL_ERROR "Cannot submit site file")
 
     MESSAGE(FATAL_ERROR "Cannot submit site file")
 
   ENDIF(NOT "${res}" STREQUAL "0")
 
   ENDIF(NOT "${res}" STREQUAL "0")
 
 
   # Get the siteid from CDash
 
   # Get the siteid from CDash
 
   SET(CDASH_URL ${CTEST_DROP_METHOD}://${CTEST_DROP_SITE}${CTEST_DROP_URL})
 
   SET(CDASH_URL ${CTEST_DROP_METHOD}://${CTEST_DROP_SITE}${CTEST_DROP_URL})
Line 65: Line 62:
 
   SET(CTEST_COMMAND "${CTEST_EXECUTABLE} -S ${CDASH_CTESTSCRIPT_FILE}")
 
   SET(CTEST_COMMAND "${CTEST_EXECUTABLE} -S ${CDASH_CTESTSCRIPT_FILE}")
 
   file(DOWNLOAD ${CDASH_URL}?sitename=${CDASH_SITENAME}&systemname=${CDASH_SYSTEMNAME}&getsiteid=1
 
   file(DOWNLOAD ${CDASH_URL}?sitename=${CDASH_SITENAME}&systemname=${CDASH_SYSTEMNAME}&getsiteid=1
${CDASH_CTESTSCRIPT_FILE})
+
      ${CDASH_CTESTSCRIPT_FILE})
 
   file(READ ${CDASH_CTESTSCRIPT_FILE} CDASH_SITE_ID)
 
   file(READ ${CDASH_CTESTSCRIPT_FILE} CDASH_SITE_ID)
 
   string(STRIP ${CDASH_SITE_ID} CDASH_SITE_ID)
 
   string(STRIP ${CDASH_SITE_ID} CDASH_SITE_ID)
 
 
   IF(${CDASH_SITE_ID} MATCHES  "ERROR:")
 
   IF(${CDASH_SITE_ID} MATCHES  "ERROR:")
 
     MESSAGE(FATAL_ERROR ${CDASH_SITE_ID})
 
     MESSAGE(FATAL_ERROR ${CDASH_SITE_ID})
 
   ENDIF(${CDASH_SITE_ID} MATCHES  "ERROR:")
 
   ENDIF(${CDASH_SITE_ID} MATCHES  "ERROR:")
 
 
   IF(${CDASH_SITE_ID} EQUAL "0")
 
   IF(${CDASH_SITE_ID} EQUAL "0")
 
     MESSAGE(FATAL_ERROR "Cannot define site id")
 
     MESSAGE(FATAL_ERROR "Cannot define site id")
 
   ENDIF(${CDASH_SITE_ID} EQUAL "0")
 
   ENDIF(${CDASH_SITE_ID} EQUAL "0")
 
 
   MESSAGE("SiteId="${CDASH_SITE_ID})
 
   MESSAGE("SiteId="${CDASH_SITE_ID})
 
 
   # Start the loop
 
   # Start the loop
 
   while (${CTEST_ELAPSED_TIME} LESS 36000)
 
   while (${CTEST_ELAPSED_TIME} LESS 36000)
 
 
     # Check if CDash has a job to run
 
     # Check if CDash has a job to run
 
     file(DOWNLOAD ${CDASH_URL}?siteid=${CDASH_SITE_ID}&getjob=1 ${CDASH_CTESTSCRIPT_FILE})
 
     file(DOWNLOAD ${CDASH_URL}?siteid=${CDASH_SITE_ID}&getjob=1 ${CDASH_CTESTSCRIPT_FILE})
 
     file(READ ${CDASH_CTESTSCRIPT_FILE} CDASH_CTEST_SCRIPT)
 
     file(READ ${CDASH_CTESTSCRIPT_FILE} CDASH_CTEST_SCRIPT)
 
 
     IF(${CDASH_CTEST_SCRIPT} EQUAL "0")
 
     IF(${CDASH_CTEST_SCRIPT} EQUAL "0")
 
       MESSAGE("Nothing to do...")
 
       MESSAGE("Nothing to do...")
 
     ENDIF(${CDASH_CTEST_SCRIPT} EQUAL "0")
 
     ENDIF(${CDASH_CTEST_SCRIPT} EQUAL "0")
 
 
     # If it's not zero that means CDash has something for me
 
     # If it's not zero that means CDash has something for me
 
     IF(NOT ${CDASH_CTEST_SCRIPT} EQUAL "0")
 
     IF(NOT ${CDASH_CTEST_SCRIPT} EQUAL "0")

Revision as of 16:05, 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 (might change in the future). 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)