[Darshan-commits] [Git][darshan/darshan][master] 3 commits: update changelog for darshan-3.1.5-pre1

Tue Oct 31 17:46:42 CDT 2017

Shane Snyder pushed to branch master at darshan / darshan


Commits:
d8ede451 by Shane Snyder at 2017-10-31T16:20:52-05:00
update changelog for darshan-3.1.5-pre1

- - - - -
aeec95ca by Shane Snyder at 2017-10-31T17:39:26-05:00
add docs for new Cray regression harnesses

- - - - -
2ef3a729 by Shane Snyder at 2017-10-31T17:45:44-05:00
update docs to describe DARSHAN_EXCLUDE_DIRS

- - - - -


5 changed files:

- ChangeLog
- darshan-runtime/doc/darshan-runtime.txt
- darshan-test/regression/README.BG.ALCF.txt
- + darshan-test/regression/README.CRAY.ALCF.txt
- + darshan-test/regression/README.CRAY.NERSC.txt


Changes:

=====================================
ChangeLog
=====================================

--- a/ChangeLog
+++ b/ChangeLog
@@ -2,6 +2,24 @@
 Darshan Release Change Log
 --------------------------
 
+Darshan-3.1.5-pre1
+=============
+* modify Darshan MPI instrumentation method to intercept both MPI and
+  PMPI symbols to workaround MPI implementations that are calling
+  PMPI routines directly (e.g., the Fortran bindings of OpenMPI2).
+  Contributed in part by Chris Zimmer.
+* add a new python utility for analzying DXT trace files (dxt_analyzer).
+  Contributed by Alex Sim.
+* bug fix to disable Darshan module instrumentation after the
+  Darshan shutdown procedure has began, an issue that was
+  leading to negative timers in some cases
+* bug fix for autoconf ignoring specified libbz2 location. Contributed
+  by Glenn Lockwood.
+* add regression tests harnesses for Cray systems at ALCF & NERSC
+* add support for DARSHAN_EXCLUDE_DIRS environment variable to
+  explicitly disable instrumentation for files in given
+  directories. Contributed by Cristian Simarro.
+
 Darshan-3.1.4
 =============
 * bug fix to prevent darshan-parser segfault when parsing logs with


=====================================
darshan-runtime/doc/darshan-runtime.txt
=====================================
--- a/darshan-runtime/doc/darshan-runtime.txt
+++ b/darshan-runtime/doc/darshan-runtime.txt
@@ -555,6 +555,7 @@ behavior at runtime:
 * DARSHAN_LOGFILE: specifies the path (directory + Darshan log file name) to write the output Darshan log to. This overrides the default Darshan behavior of automatically generating a log file name and adding it to a log file directory formatted using darshan-mk-log-dirs script.
 * DARSHAN_MODMEM: specifies the maximum amount of memory (in MiB) Darshan instrumentation modules can collectively consume at runtime (if not specified, Darshan uses a default quota of 2 MiB).
 * DARSHAN_MMAP_LOGPATH: if Darshan's mmap log file mechanism is enabled, this variable specifies what path the mmap log files should be stored in (if not specified, log files will be stored in `/tmp`).
+* DARSHAN_EXCLUDE_DIRS: specifies a list of comma-separated paths that Darshan will not instrument at runtime (in addition to Darshan's default blacklist)
 * DXT_ENABLE_IO_TRACE: setting this environment variable enables the DXT (Darshan eXtended Tracing) modules at runtime. Users can specify a numeric value for this variable to set the number of MiB to use for tracing per process; if no value is specified, Darshan will use a default value of 4 MiB.
 
 == Debugging


=====================================
darshan-test/regression/README.BG.ALCF.txt
=====================================
--- 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"


=====================================
darshan-test/regression/README.CRAY.ALCF.txt
=====================================
--- /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
+


=====================================
darshan-test/regression/README.CRAY.NERSC.txt
=====================================
--- /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
+



View it on GitLab: https://xgitlab.cels.anl.gov/darshan/darshan/compare/48dbd2e8f97e54f3d48870b55440dc64e0c7ec64...2ef3a7294e87bda1b969c3d0c5eb0cc92ea2ee21

---
View it on GitLab: https://xgitlab.cels.anl.gov/darshan/darshan/compare/48dbd2e8f97e54f3d48870b55440dc64e0c7ec64...2ef3a7294e87bda1b969c3d0c5eb0cc92ea2ee21
You're receiving this email because of your account on xgitlab.cels.anl.gov.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/darshan-commits/attachments/20171031/c5b7a223/attachment-0001.html>
