From aeec95caf99e8246ba0bb41e2ee346cf684f9f47 Mon Sep 17 00:00:00 2001 From: Shane Snyder Date: Tue, 31 Oct 2017 17:39:26 -0500 Subject: [PATCH] add docs for new Cray regression harnesses --- darshan-test/regression/README.BG.ALCF.txt | 2 +- darshan-test/regression/README.CRAY.ALCF.txt | 28 +++++++++++++++++++ darshan-test/regression/README.CRAY.NERSC.txt | 28 +++++++++++++++++++ 3 files changed, 57 insertions(+), 1 deletion(-) create mode 100644 darshan-test/regression/README.CRAY.ALCF.txt create mode 100644 darshan-test/regression/README.CRAY.NERSC.txt diff --git a/darshan-test/regression/README.BG.ALCF.txt b/darshan-test/regression/README.BG.ALCF.txt index 4eca2b7..1d352f4 100644 --- a/darshan-test/regression/README.BG.ALCF.txt +++ b/darshan-test/regression/README.BG.ALCF.txt @@ -12,7 +12,7 @@ To run regression tests: make install # darshan util - ../configure --prefix=/home/carns/working/darshan/install + ../configure --prefix=/home/carns/working/darshan/install-cetus make install - start a screen session by running "screen" diff --git a/darshan-test/regression/README.CRAY.ALCF.txt b/darshan-test/regression/README.CRAY.ALCF.txt new file mode 100644 index 0000000..1a32939 --- /dev/null +++ b/darshan-test/regression/README.CRAY.ALCF.txt @@ -0,0 +1,28 @@ +See README.txt for general instructions. This file contains notes for testing on the Cray platform @ the ALCF +(more specifically: theta.alcf.anl.gov). This example assumes that you are using the Cray module +method to add instrumentation. + +To run regression tests: + +- unload any existing darshan module in the environment and switch to gnu compilers + module unload darshan + module switch PrgEnv-intel PrgEnv-gnu + +- compile and install both darshan-runtime and darshan-util in the same directory + examples: + + # darshan runtime + ../configure --with-mem-align=64 --with-log-path=/projects/SSSPPg/carns/darshan-logs --prefix=/home/carns/working/darshan/install-theta --with-jobid-env=COBALT_JOBID --disable-cuserid --host=x86_64 CC=cc + make install + + # darshan util + ../configure --prefix=/home/carns/working/darshan/install-theta + make install + +- start a screen session by running "screen" + note: this is suggested because the tests may take a while to complete depending on scheduler + availability + +- run regression tests + ./run-all.sh /home/carns/working/darshan/install-cetus /projects/SSSPPg/carns/darshan-test cray-module-alcf + diff --git a/darshan-test/regression/README.CRAY.NERSC.txt b/darshan-test/regression/README.CRAY.NERSC.txt new file mode 100644 index 0000000..3a6dde7 --- /dev/null +++ b/darshan-test/regression/README.CRAY.NERSC.txt @@ -0,0 +1,28 @@ +See README.txt for general instructions. This file contains notes for testing on the Cray platform @ NERSC +(more specifically: cori.nersc.gov). This example assumes that you are using the Cray module +method to add instrumentation. + +To run regression tests: + +- unload any existing darshan module in the environment and switch to gnu compilers + module unload darshan + module switch PrgEnv-intel PrgEnv-gnu + +- compile and install both darshan-runtime and darshan-util in the same directory + examples: + + # darshan runtime + ../configure --with-mem-align=8 --with-log-path=/global/cscratch1/sd/ssnyder/darshan-logs --prefix=/global/homes/s/ssnyder/working/darshan/install-cori --with-jobid-env=SLURM_JOB_ID --disable-cuserid CC=cc + make install + + # darshan util + ../configure --prefix=/global/homes/s/ssnyder/working/darshan/install-cori + make install + +- start a screen session by running "screen" + note: this is suggested because the tests may take a while to complete depending on scheduler + availability + +- run regression tests + ./run-all.sh /global/homes/s/ssnyder/working/darshan/install-cori /global/cscratch1/sd/ssnyder/darshan-test cray-module-nersc + -- 2.26.2