Broadband Platform on HPCC - Revision history

Maechlin: /* Configuring Required Environment Variables */

2012-09-27T16:33:04Z

Configuring Required Environment Variables

2012-09-27T16:32:25Z

2012-09-27T04:12:24Z

Create Validation Runs and Start the Simulations

2012-09-27T03:47:07Z

Run Unit Tests

2012-09-27T03:43:27Z

Configuring Required Environment Variables

2012-09-27T03:38:14Z

Configuring Required Environment Variables

2012-09-27T03:19:20Z

2012-09-27T03:14:16Z

Install Desired Green's Functions and Validation Packages

2012-09-27T03:12:55Z

2012-09-27T03:01:41Z

Install and Build BBP on HPCC

← Older revision		Revision as of 16:33, 27 September 2012
Line 163:		Line 163:

	The step above is needed so users can run Broadband scripts on the head node (the steps in the next section will fail if these variables are not properly set!).		The step above is needed so users can run Broadband scripts on the head node (the steps in the next section will fail if these variables are not properly set!).
−

	== Run Unit Tests ==		== Run Unit Tests ==

@@ Line 120: / Line 120: @@
 <pre>
 gunzip < file.tar.gz | tar xvf -
 $ tar -xzvf bbp_northridge_gf_<version>.gz
 $ tar -xzvf bbp_lomaprieta_gf_<version>.gz

@@ Line 178: / Line 178: @@
 Additionally, users need to edit the setup_bbp_env.template file (located inside the utils/batch directory), and change the values for BBP_DIR, BBP_GF_DIR, and BBP_VAL_DIR as described in that file. Once edited, the file should be renamed to setup_bbp_env.sh. This file will be used by worker nodes when running the actual simulations.
-== Create Validation Runs and Start the Simulations==
+== Create Simulations Directory==
-After completing all the steps above, creating validation runs, and starting the simulations on HPCC is easy! Users should first create a top-level directory for their simulations:
+Users should first create a top-level directory for their simulations. This directory should be on a filesystem that has enough space to contain both input and output results. When results are calculated on the cluster, they are returned to this directory for review and analysis.
 <pre>
@@ Line 188: / Line 190: @@
 </pre>
-The next step is to create the validation runs using the provided bbp_hpcc_validation.py script. This script needs a few parameters, such as codebase to use, event to use for validation, number of realizations to run, a simulation directory where the results will go, and an e-mail address for job/status notifications. For example, to run 8 realizations of the lomap validation using the Graves & Pitarka method, users should type:
+== Create Validation Runs and Start the Simulations==
 <pre>

@@ Line 172: / Line 172: @@
 ./UnitTests.py
 </pre>
 == Edit setup_bbp_env.template ==

@@ Line 164: / Line 164: @@
 Please note that this example features the path names used in the steps above. Users need to customize these with their actual installation locations.
 The step above is needed so users can run Broadband scripts on the head node (the steps in the next section will fail if these variables are not properly set!).
 == Edit setup_bbp_env.template ==

@@ Line 118: / Line 118: @@
 Then, users need to untar inside the Green's Functions top-level directory each Green's Functions package downloaded from the Broadband website. For example:
 <pre>
 $ tar -xzvf bbp_northridge_gf_<version>.gz

@@ Line 119: / Line 119: @@
 <pre>
-$ tar -xzvf bbp_northridge_gf_<version>.tgz
+$ tar -xzvf bbp_northridge_gf_<version>.gz
-$ tar -xzvf bbp_lomaprieta_gf_<version>.tgz
+$ tar -xzvf bbp_lomaprieta_gf_<version>.gz
 ...
 </pre>
@@ Line 138: / Line 138: @@
 $ tar -xzvf bbp_lomaprieta_val_<version>.tgz
 </pre>
-−
 == Configuring Required Environment Variables ==

@@ Line 153: / Line 153: @@
 For bash:
-export BBP_DIR /home/rcf-104/earthquake/bbp
+export BBP_DIR=/home/rcf-104/earthquake/bbp
-export BBP_GF_DIR /home/rcf-104/earthquake/bbp_gf
+export BBP_GF_DIR=/home/rcf-104/earthquake/bbp_gf
-export BBP_VAL_DIR /home/rcf-104/earthquake/bbp_val
+export BBP_VAL_DIR=/home/rcf-104/earthquake/bbp_val
-export PYTHONPATH /home/rcf-104/earthquake/bbp/comps
+export PYTHONPATH=/home/rcf-104/earthquake/bbp/comps
 </pre>

← Older revision		Revision as of 03:01, 27 September 2012
Line 46:		Line 46:

	It is also possible to use the svn version of Broadband (as described in the User Guide), but users should be aware that unreleased Broadband code from svn can change daily and is not recommended for official/paper simulations.		It is also possible to use the svn version of Broadband (as described in the User Guide), but users should be aware that unreleased Broadband code from svn can change daily and is not recommended for official/paper simulations.
−	~~<pre>~~
−	~~-bash-3.2$ svn co https://source.usc.edu/svn/broadband/trunk~~
−	~~</pre>~~

	In this case, let us assume a user has downloaded the tgz file. After downloading the Broadband package from the website, users need to untar it using the following command:		In this case, let us assume a user has downloaded the tgz file. After downloading the Broadband package from the website, users need to untar it using the following command: