Commit e0a3819a authored by Philip Carns's avatar Philip Carns
Browse files

first cut at README.md

parent 40ea027a
# ATPESC 2015 hands-on exercises
Please feel free to use the hands-on time to improve your own applications or
ask the presenters for I/O advice! We are also providing optional structured
exercises for attendees who would like to gain experience working with the
tools and technologies presented at ATPESC without necessarily working on a
specific application.
The attendees are required to have a laptop with a working web browser and
SSH client. For the purpose of this tutorial, all exercises can be performed
via an SSH terminal.
## Darshan exercises
The Darshan hands-on exercises are all to be performed on the Mira
supercomputer (https://www.alcf.anl.gov/mira). Please use the ATPESC2015
project for job submissions and the /projects/ATPESC2015 directory for data
storage.
### Initial setup
* Confirm account access if you haven’t already (see presenters for
details)
* Log on to Mira
* ssh mira.alcf.anl.gov
* Download the tutorial materials to your home directory
* mkdir atpesc2015-io
* cd atpesc2015-io
* git clone https://xgitlab.cels.anl.gov/ATPESC-IO/hands-on-2015.git
* cd hands-on-2015
Please ask your instructors if you have questions or need assistance. Two
exercises are described below. Near the end of the session we will invite
attendees to present their findings informally for discussion.
See instructions below in “Running hands-on example programs” for information
about how to compile and submit the example programs.
### Hands-on exercise: warpdrive
The hands-on material includes an example application called “warpdrive”.
There are two versions of this application: warpdriveA and warpdriveB. Both
of them do the same amount of I/O from each process, but one of them performs
better than the other. Which one has the fastest I/O? Why?
Hands-on exercise: teleport
### Hands-on exercise: teleport
The hands-on material includes an example application called “teleport”.
There are two versions of this application: teleportA and teleportB. Both of
them do the same amount of I/O from each process, but one of them performs
better than the other. Which one has the fastest I/O? Why?
### Running hands-on example programs
* Compile example programs and submit into the job queue (see below for
details on example programs)
* mpicc <exampleprogram>.c -o <exampleprogram>
* optional: edit <exampleprogram>.sh and add “-M <email_address>” to
the qsub command line to receive an email when your job has started and
completed
* <exampleprogram>.sh
* Check the queue to see when your jobs complete
* qstat |grep <username>
* Look for log files in /projects/logs/darshan/mira/2015/8/13/<username>*.darshan.gz
* Copy log files to your home directory
* Use darshan-job-summary.pl or darshan-parser to investigate Darshan
characterization data
* darshan-job-summary.pl will produce *.pdf files with an analysis summary.
* You can copy these to your laptop using scp to view them.
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