Broadband User Guide v15.3.0 - Revision history

Fsilva: /* Running Acceptance Tests */

2015-06-04T18:34:06Z

Running Acceptance Tests

Fsilva: /* Running Unit Tests */

2015-06-04T18:31:04Z

Running Unit Tests

Fsilva: /* Running Unit Tests */

2015-06-04T18:30:46Z

Running Unit Tests

Fsilva: /* Running Unit Tests */

2015-06-04T18:30:32Z

Running Unit Tests

Fsilva: /* Validating Downloaded Files */

2015-06-04T18:10:41Z

Validating Downloaded Files

Fsilva: /* Running Checksum Tests */

2015-06-04T18:05:32Z

Running Checksum Tests

Fsilva: /* Downloading the Platform */

2015-06-04T18:05:03Z

Downloading the Platform

Fsilva: /* Downloading the Platform */

2015-06-04T18:02:58Z

Downloading the Platform

Fsilva: /* Mac OS X Installation */

2015-06-04T18:01:15Z

Mac OS X Installation

Fsilva: /* MAC OS X Installation */

2015-06-04T18:00:45Z

MAC OS X Installation

← Older revision		Revision as of 18:34, 4 June 2015
Line 305:		Line 305:

	OK		OK
		+
		+	Please note that since the SDSU method will produce errors on Mac OS X systems, three of the tests above will fail. This is expected on a Mac OS X computer.

	= Performing Simulations =		= Performing Simulations =

@@ Line 255: / Line 255: @@
   /Users/maechlin/Documents/dev/bbp_2015/bbp_data/tmpdata/9642805/bbtoolbox_test_stat/parfilename_test_stat >>
   /Users/maechlin/Documents/dev/bbp_2015/bbp_data/logs/9642805/9642805.bbtoolbox_test_stat.log 2>&1
 This reduces the available number of ground motion methods that can be run on the Mac. On Linux, there are five methods available (GP, SDSU, UCSB, EXSIM, CSM). On a Mac, there are four methods available (GP, UCSB, EXSIM, CSM).

@@ Line 251: / Line 251: @@
 Please note that one of the SDSU components, BBToolbox, does not pass its Unit Test when running on a Mac OS X system. This is a known limitation of the current BBP release. You will see a message similar to:
-  test_bbtoolbox (test_bbtoolbox.Test_BBToolbox) ... /bin/sh: line 1:  6027 Abort trap: 6           /Users/maechlin/Documents/dev/bbp_2015/15.3.0/bbp/src/sdsu/bin/BBtoolbox.exe <
+  test_bbtoolbox (test_bbtoolbox.Test_BBToolbox) ... /bin/sh: line 1:  6027 Abort trap: 6
   /Users/maechlin/Documents/dev/bbp_2015/bbp_data/tmpdata/9642805/bbtoolbox_test_stat/parfilename_test_stat >>
   /Users/maechlin/Documents/dev/bbp_2015/bbp_data/logs/9642805/9642805.bbtoolbox_test_stat.log 2>&1

@@ Line 248: / Line 248: @@
 The tests should begin and will take between 30-60 minutes to run, depending on your computer speed. At the end of each test, a "ok" should be printed if the test was
 successful. At the end, the program will print the number of tests that passed and the number of tests that failed. If a test has failed, first check that you have built the executables.You can rerun just the specific test that failed (test_<module>.py). If the test is still failing, also verify that you have the ref_data directory, since it contains the input and reference files. If you're looking for more information about the failure, you can consult the Unit Tests log file in $BBP_DATA_DIR/logs/unit_tests.log .  If you can't determine the reason for the failure, contact [mailto:software@scec.org support].
 Once the unit tests all pass, proceed to the acceptance tests. If there are any failure or errors while running the unit tests, consult the Troubleshooting section at the end of this user guide for know issues and their solutions.

← Older revision		Revision as of 18:10, 4 June 2015
Line 65:		Line 65:

	== Validating Downloaded Files ==		== Validating Downloaded Files ==
		+
		+	But if you want to check the integrity of any individual BBP distribution file, these md5sum tests can be run for any BBP distribution file. After downloading the needed files to your local Linux or Mac OS X computer, users can calculate their checksums and compare them to the checksums on the Broadband web site to verify that you have the correct files.
		+
		+	=== Linux Computers ===
		+
		+	For Linux, if you type:
		+
		+	$ which md5sum
		+
		+	You should get something like /usr/bin/md5sum. If you see the message 'no md5sum in...', contact your Linux system administrator and ask to have md5sum added to your path.
		+
		+	Once you have the ''md5sum'' command installed on your system, you can type:
		+
		+	$ md5sum downloaded_file.tar.gz
		+
		+	where "downloaded_file.tar.gz" is the file downloaded from the Broadband website. Users should do this once for each of the downloaded files to make sure they have successfully downloaded the files. The easiest way to do it, it to have all .tar.gz distribution files and all .md5 files in the same directory and type:
		+
		+	$ md5sum -c *.md5
		+
		+	You should see a confirmation that each of the downloaded files are OK.
		+
		+	=== Mac OS X Systems ===
		+
		+	For Mac OS X, you can use the "md5" command, which works similarly to "md5sum". You can type:
		+
		+	$ md5 *.tar.gz
		+
		+	And you should see a list of md5 sums on the screen. Then compare them against the ones in the .md5 files to make sure they match. For example, assuming only the minimum set of files was downloaded:
		+
		+	$ cat *.md5
		+	24d88c5a22543409e89a22d64b451f85 bbp-dist-15.3.0.tar.gz
		+	f24dc01a6b1bf533b83067fbaa75c9d3 labasin-velocity-model-15.3.0.tar.gz
		+	d4f396be3b29082841ddd4622f39cabb northridge-validation-15.3.0.tar.gz
		+
		+	$ md5 bbp-dist-15.3.0.tar.gz
		+	MD5 (bbp-dist-15.3.0.tar.gz) = 24d88c5a22543409e89a22d64b451f85
		+	$ md5 labasin-velocity-model-15.3.0.tar.gz
		+	MD5 (labasin-velocity-model-15.3.0.tar.gz) = f24dc01a6b1bf533b83067fbaa75c9d3
		+	$ md5 northridge-validation-15.3.0.tar.gz
		+	MD5 (northridge-validation-15.3.0.tar.gz) = d4f396be3b29082841ddd4622f39cab
		+
		+	As you can see, the sums computed by md5 match the pre-computed values stores in the *.md5 files.

	== Broadband Platform Directory Structure Setup ==		== Broadband Platform Directory Structure Setup ==

@@ Line 195: / Line 195: @@
 Once the checksums agree, move on to the unit tests.
-If the script above pass, you can move onto the unit tests. But if you want to check the integrity of any individual BBP distribution file, these md5sum tests can be run for any BBP distribution file. After downloading the needed files to your local Linux or Mac OS X computer, users can calculate their checksums and compare them to the checksums on the Broadband web site to verify that you have the correct files. For Linux, if you type:
+If the script above pass, you can move onto the unit tests.
 == Running Unit Tests ==

← Older revision		Revision as of 18:05, 4 June 2015
Line 63:		Line 63:

	Alternatively, if you would like access to the latest version of the platform and get frequent but less thoroughly tested improvements, you can check out the platform from SCEC's Subversion repository. Only advanced users should take this approach, outlined in detail in the [[#Advanced Users\| Advanced Users section]].		Alternatively, if you would like access to the latest version of the platform and get frequent but less thoroughly tested improvements, you can check out the platform from SCEC's Subversion repository. Only advanced users should take this approach, outlined in detail in the [[#Advanced Users\| Advanced Users section]].
		+
		+	== Validating Downloaded Files ==

	== Broadband Platform Directory Structure Setup ==		== Broadband Platform Directory Structure Setup ==

← Older revision		Revision as of 18:02, 4 June 2015
Line 50:		Line 50:

	The installation instructions given later include a script that will confirm that the BBP files have been copied intact and unchanged onto your computer.		The installation instructions given later include a script that will confirm that the BBP files have been copied intact and unchanged onto your computer.
		+
		+	The minimum set up files from the BBP web site required for the Broadband Platform installation are:
		+
		+	*bbp-dist-15.3.0.tar.gz
		+	*bbp-dist-15.3.0.tar.gz.md5
		+	*labasin-velocity-model-15.3.0.tar.gz
		+	*labasin-velocity-model-15.3.0.tar.gz.md5
		+	*northridge-validation-15.3.0.tar.gz
		+	*northridge-validation-15.3.0.tar.gz.md5

	If multiple users are planning to use the platform on the same system, you only need one copy of the data files per machine. Each user will still need his or her own copy of the code files.		If multiple users are planning to use the platform on the same system, you only need one copy of the data files per machine. Each user will still need his or her own copy of the code files.

@@ Line 24: / Line 24: @@
 == Mac OS X Installation ==
-Mac OS X users should refer to our [[BBP on OS X Guide]] for installing the above dependencies to their system. After completing the steps on that guide, please return to this page and continue reading the installation instructions to finalize the Broadband Platform setup.
+Mac OS X users should refer to our [[BBP on OS X Guide]] for installing the above dependencies to their system. After completing the steps on that guide, please return to this page and continue reading these installation instructions to finalize the Broadband Platform setup.
 == User Account Setup ==

@@ Line 22: / Line 22: @@
 *GNU compilers (gcc, gfortran) v4.5.1
-== MAC OS X Installation ==
+== Mac OS X Installation ==
 Mac OS X users should refer to our [[BBP on OS X Guide]] for installing the above dependencies to their system. After completing the steps on that guide, please return to this page and continue reading the installation instructions to finalize the Broadband Platform setup.