foam-extend4.1-coherent-io

Archived

This repository has been archived on 2023-11-20. You can view files and clone it, but cannot push or open issues or pull requests.

History

Martin Beaudoin 2adbd0457a Correction for a problem with newer versions of CMake that are refusing to upload the test harness results to the CDash server. The generated error message is the following: "Error message was: Illegal characters found in URL" Diagnostic: If the environment variable CDASH_SUBMIT_LOCAL_HOST_ID is not initialized, the FQN hostname of the system will be picked by the CMake/CTest scripts. The CTest internal system command used for retrieving the FQN hostname is indeed leaving a carriage return in the returned hostname string. That string is in turn reused to construct an URL that will be shared with the CDash service. The presence of such characters (\n and \r) is no longer accepted by newer versions of CTest/CMake. Solution: The solution is simply to check and remove such characters from the hostname string.		2018-04-15 21:51:43 -04:00
..
foam-extend/4.1	Correction for a problem with newer versions of CMake that are refusing to upload the test harness	2018-04-15 21:51:43 -04:00
OSIG/Turbomachinery	test harness enabled	2013-12-17 10:30:27 +00:00
README.txt	Update test harness to 4.0. Cesare Guardino	2016-06-07 16:28:09 +01:00

README.txt

Description
===========
This part of the repository is for FOAM test harnesses.

Directory Structure
===================

foam-extend-4.0 : Test harness for foam-extend version 4.0. See the file foam-extend-4.0/README.txt for more information

OSIG : CMake/CTest scripts for FOAM Special Interest Group (OSIG) test harness
OSIG/TurboMachinery : Test harness for the TurboMachinery OSIG. See the file OSIG/Turbomachinery/README.txt for more information.

1: Select your git branch of choice: ie:

git checkout master # For Hrv master branch

2: Make sure your FOAM environment is properly configured to run FOAM.

3: The minimal cmake version number for running the test loop is 2.8.0. Make sure you are there.

4: Make sure you have the test harness scripts available under your git branch;
otherwise, you will need to fetch this from Hrv's master branch, and merge it into yours

ls $WM_PROJECT_DIR/testHarness # Checking availability of testHarness under this branch

5: move to the runDir directory for the FOAM test harness

cd $WM_PROJECT_DIR/testHarness/foam-extend/4.0/runDir

6: Normally, if using the master branch, everything should already be setup for you to run the test harness.
Still, I recommand always checking that these two important files are up-to-date:

cp ../CMakeFiles/CMakeLists.txt $WM_PROJECT_DIR
cp ../CMakeFiles/CTestConfig.cmake.foam-extend $WM_PROJECT_DIR/CTestConfig.cmake

7: Next, running the test loop is pretty simple:

cd $WM_PROJECT_DIR/testHarness/foam-extend/4.0/runDir # you should already be there...
./Allclean
./Allrun_Experimental

8: The results will be published on the CDash dashboard on foam-extend.

To see your results:
URL : http://foam-extend.sourceforge.net/CDash/index.php?project=foam-extend-4.0

9: You can customize your system identifier on the dashboard using the environment variable $CDASH_SUBMIT_LOCAL_HOST_ID.
Otherwise, the fully qualified name of your system will be used.

A good customization idea would be to add the name of your git branch in your system ID.
I will probably modify my scripts to add this information automagically.

NB: Please no "forward slash" or "/" in the system ID; it looks like CDash will choke on this.

10: In general, see the file $WM_PROJECT_DIR/testHarness/foam-extend/4.0/README.txt for the necessary information about running the
test loop.

11: Please do not hesitate to report any problems, comments, suggestions about the test loop.