GEOS-5 Checkout and Build Instructions: Difference between revisions

Line 106:

== How to Setup and Run and Experiment ==

Now that you've built the code, let's try to run it. In the exercise that follows, we will ''clone'' a previous experiment. This will give you the basic idea of how to set up an experiment that we can refine in later exercises.

In what follows I will assume we are working on the NCCS computer '''discover'''.

=== Set up your experiment ID and associated directories ===

The first thing we need to do is decide on an '''experiment ID'''; that is, the name of our experiment. I'll call my experiment '''dragnet''', but you can pick any name you like. Usually it's something to do with the experiment.

Next, we need to set up two directory structures. The first, the '''home directory''' will contain the scripts we use to run the experiment. We don't want to lose these, so we'll make the home directory for the experiment actually reside in our home directories on '''discover''', which is backed up and recoverable in case anything goes wrong. Since I potentially will run many GEOS-5 experiments before I retire, I'm accumulating these home directories in a sub-directory called ''geo5''. So, if you follow that, make the home directory:

% mkdir -p /home/USERNAME/geos5/dragnet

where you substitute your username for USERNAME.

The second directory is the experiment directory, which is where the experiment is actually run from. This space is volatile, and the experiment can accumulate quite a bit of data as it runs, so we need a fairly large disk space to contain it. I put these things on my ''nobackup'' space on '''discover''', but note that ''nobackup'' means this is not backed up.

% mkdir /discover/nobackup/USERNAME/dragnet

There's nothing magical about these directory structures; you can use whatever you like. You'll just have to edit your scripts accordingly.

@@ Line 106: / Line 106: @@
 == How to Setup and Run and Experiment ==
 Now that you've built the code, let's try to run it.  In the exercise that follows, we will ''clone'' a previous experiment.  This will give you the basic idea of how to set up an experiment that we can refine in later exercises.
+In what follows I will assume we are working on the NCCS computer '''discover'''.
+=== Set up your experiment ID and associated directories ===
+The first thing we need to do is decide on an '''experiment ID'''; that is, the name of our experiment.  I'll call my experiment '''dragnet''', but you can pick any name you like.  Usually it's something to do with the experiment.
+Next, we need to set up two directory structures.  The first, the '''home directory''' will contain the scripts we use to run the experiment.  We don't want to lose these, so we'll make the home directory for the experiment actually reside in our home directories on '''discover''', which is backed up and recoverable in case anything goes wrong.  Since I potentially will run many GEOS-5 experiments before I retire, I'm accumulating these home directories in a sub-directory called ''geo5''.  So, if you follow that, make the home directory:
+ % mkdir -p /home/USERNAME/geos5/dragnet
+where you substitute your username for USERNAME.
+The second directory is the experiment directory, which is where the experiment is actually run from.  This space is volatile, and the experiment can accumulate quite a bit of data as it runs, so we need a fairly large disk space to contain it.  I put these things on my ''nobackup'' space on '''discover''', but note that ''nobackup'' means this is not backed up.
+% mkdir /discover/nobackup/USERNAME/dragnet
+There's nothing magical about these directory structures; you can use whatever you like.  You'll just have to edit your scripts accordingly.