Commit 40a3950d authored by Jonathan Jenkins's avatar Jonathan Jenkins

documentation updates, pointed out by Xu Yang (thanks!!)

parent fa06ccc5
NOTE: see bottom of this file for suggested configurations on particular ANL
machines.
0 - Checkout, build, and install the trunk version of ROSS. At the time of
0 - Checkout, build, and install the trunk version of ROSS
(https://github.com/carothersc/ROSS). At the time of
release (0.4.0), ROSS's latest commit hash was 44b7b9a, so this revision is
"safe" in the unlikely case incompatible changes come along in the future. If
working from the CODES master branches, use the ROSS master branch.
......@@ -20,6 +21,12 @@ working from the CODES master branches, use the ROSS master branch.
<the result should be that the latest version of ROSS is installed in the
ROSS/install/ directory>
For more details on installing ROSS, go to
https://github.com/carothersc/ROSS/blob/master/README.md .
If using ccmake to configure, don't forget to set CMAKE_C_COMPILER and
CMAKE_CXX_COMPILER to mpicc/mpicxx
1 - If you are building codes-base directly from the repository, run
./prepare.sh
......@@ -32,10 +39,18 @@ working from the CODES master branches, use the ROSS master branch.
cd build
../configure --with-ross=/path/to/ross/install --prefix=/path/to/codes-base/install CC=mpicc
To enable network tracing with dumpi, use the option
--with-dumpi = /path/to/dumpi/install with configure.
To enable network tracing with dumpi
(http://sst.sandia.gov/about_dumpi.html), use the option
--with-dumpi=/path/to/dumpi/install with configure.
NOTE: we only require libundumpi for trace processing. Hence, if building
dumpi from source you may configure with --disable-libdumpi and
--enable-libundumpi (this is especially useful if you have mpich3, which
breaks libdumpi's function wrappers through const'ifying the MPI
interface).
To enable using the darshan I/O generator, use the option
To enable using the darshan I/O generator
(http://www.mcs.anl.gov/research/projects/darshan/), use the option
--with-darshan=/path/to/darshan with configure
3 - Build and install codes-base
......
......@@ -137,7 +137,14 @@ The following restrictions currently apply to the IO language:
Our primary network workload generator is via the DUMPI tool
(http://sst.sandia.gov/about_dumpi.html). DUMPI collects and reads events from
MPI applications. See the DUMPI documentation for how to generate traces.
MPI applications. See the DUMPI documentation for how to generate traces. There
are additionally publically-available traces at
http://portal.nersc.gov/project/CAL/doe-miniapps.htm.
Note on trace reading - the input file prefix to the dumpi workload generator
should be everything up to the rank number. E.g., if the dumpi files are of the
form "dumpi-YYYY.MM.DD.HH.MM.SS-XXXX.bin", then the input should be
"dumpi-YYYY.MM.DD.HH.MM.SS-"
== LP-IO
......
......@@ -198,7 +198,7 @@ int main(int argc, char *argv[])
}
if(du_params.file_name[0] == '\0' ){
fprintf(stderr, "Expected \"--r-trace-dir\" argument for dumpi workload\n");
fprintf(stderr, "Expected \"--dumpi-log\" argument for dumpi workload\n");
usage();
return 1;
}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment