BBP on OS X Guide - Revision history

Fsilva: /* BBP 15.3.0 Installation on Mac OS X */

2015-06-12T16:59:31Z

BBP 15.3.0 Installation on Mac OS X

Fsilva: /* Related Entries */

2015-06-11T22:14:12Z

Related Entries

Fsilva at 22:12, 11 June 2015

2015-06-11T22:12:14Z

Fsilva at 16:39, 11 June 2015

2015-06-11T16:39:11Z

Fsilva: /* BBP 15.3.0 Installation on Mac OS X */

2015-06-11T16:24:33Z

BBP 15.3.0 Installation on Mac OS X

Fsilva at 16:22, 11 June 2015

2015-06-11T16:22:39Z

Fsilva: /* OS X 10.10 Yosemite using MacPorts */

2015-06-04T18:37:49Z

OS X 10.10 Yosemite using MacPorts

Fsilva: /* OS X 10.9 Mavericks using MacPorts */

2015-06-04T18:37:40Z

OS X 10.9 Mavericks using MacPorts

Fsilva: /* Method 2: Installation Without Mac Ports */

2015-06-04T18:37:31Z

Method 2: Installation Without Mac Ports

Fsilva: /* Method 1: Installation using Mac Ports */

2015-06-04T17:43:12Z

Method 1: Installation using Mac Ports

@@ Line 13: / Line 13: @@
 == BBP 15.3.0 Installation on Mac OS X ==
-This section describes the installation of the BBP 15.3.0 distribution on Mac OS X using a package management tool called Mac Ports. Mac Ports simplifies the installation process by automating several of the installation steps, but it will require administrator access unless you want to install it from the source (a few extra steps that we will not cover in this guide). If you prefer not to use Mac Ports, you can follow the directions provided by one developer who installed BBP 15.3.0 without using Mac Ports. Details are provided in the [[BBP_on_OS_X_Guide_Without_Mac_Ports]] page.
+This section describes the installation of the BBP 15.3.0 distribution on Mac OS X using a package management tool called Mac Ports. Mac Ports simplifies the installation process by automating several of the installation steps, but it will require administrator access unless you want to install it from the source (a few extra steps that we will not cover in this guide). If you prefer not to use Mac Ports in order to have greater flexibility in selecting the packages you would like to install, you can follow the directions provided by one developer who installed BBP 15.3.0 on his Mac OS X laptop without using Mac Ports. Details are provided in the [[BBP_on_OS_X_Guide_Without_Mac_Ports]] page.
 The steps below will guide you through the installation of Mac Ports and the necessary C/Fortran GNU compilers in addition to the Python packages required by the Broadband Platform. At the end of this section, we provide information about running the Unit and Acceptance Tests available on the Broadband Platform, along with some Mac OS X-specific details.

@@ Line 151: / Line 151: @@
 == Related Entries ==
 *[[Broadband Platform]]
 *[[CME Project]]

← Older revision		Revision as of 22:12, 11 June 2015
Line 49:		Line 49:
	=== Unit and Acceptance Tests for Mac OS X ===		=== Unit and Acceptance Tests for Mac OS X ===

		+	==== Running Unit Tests ====
		+
		+	In order to run the unit tests, users should go to the tests directory and type:
		+
		+	$ ./UnitTests.py
		+
		+	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].
		+
		+	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 <
		+	/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
		+	ERROR
		+
		+	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).
		+
		+	After running the unit tests, users can proceed to the acceptance tests below.
		+
		+	==== Running Acceptance Tests ====
		+
		+	To run the acceptance tests, users should:
		+
		+	$ ./AcceptTests.py
		+
		+	There will be one test for each method in the platform, for both the validation mode (historical events) and the scenario modes (hypotethical earthquakes). These tests will take somewhere between 2 and 3 hours to run, depending on how fast the computer is.
		+
		+	Since the acceptance tests can take a long time to run, you may wish to resume where you left off. This feature is supported automatically. If you do not wish to resume, delete the resume file in $BBP_DATA_DIR/logs/resume.txt. If there are any failure or errors while running the acceptance tests, consult the Troubleshooting section at the end of this user guide for known issues and their solutions.
		+
		+	When they're complete, the console will either print "OK" or how many tests failed. Acceptance test failures indicate that the modules are not integrated correctly. On Mac OS X, the SDSU codebase is not yet fully supported and will cause the 3 SDSU acceptance tests to fail. For the other tests, if a certain acceptance test fails, you can get more information by consulting the acceptance test logs in $BBP_DATA_DIR/logs/acceptance_test_logs/<test that failed>.log. If you can't determine the reason for the failure, contact [mailto:software@scec.org support].
		+
		+	Here's the expected output when running on a Mac OS X, showing the three SDSU tests failing (which is expected for this release):
		+
		+	-bash-4.1$ ./AcceptTests.py
		+	Number of tests to run: 12
		+	test_user-CSM (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_user-EXSIM (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_user-GP (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_user-SDSU (__main__.BBP2G_Acceptance_Tests) ... /
		+	/bin/sh: line 1: 56574 Abort trap: 6 /Users/fsilva/Work/svn/temp/15.3.0/bbp/src/sdsu/bin/BBtoolbox.exe <
		+	/Users/fsilva/Work/svn/temp/bbp_sims/tmpdata/4047777/bbtoolbox_northridge_3_sta/parfilename_northridge_3_ sta >>
		+	/Users/fsilva/Work/svn/temp/bbp_sims/logs/4047777/4047777.bbtoolbox_northridge_3_sta.log 2>&
		+	FAIL
		+	test_user-UCSB (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_valid-northridge-CSM (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_valid-northridge-EXSIM (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_valid-northridge-GP (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_valid-northridge-GP_seis (__main__.BBP2G_Acceptance_Tests) ... ok
		+	test_valid-northridge-SDSU (__main__.BBP2G_Acceptance_Tests) ...
		+	/bin/sh: line 1: 58755 Abort trap: 6 /Users/fsilva/Work/svn/temp/15.3.0/bbp/src/sdsu/bin/BBtoolbox.exe <
		+	/Users/fsilva/Work/svn/temp/bbp_sims/tmpdata/4049707/bbtoolbox_northridge_3_sta/parfilename_northridge_3_sta >>
		+	/Users/fsilva/Work/svn/temp/bbp_sims/logs/4049707/4049707.bbtoolbox_northridge_3_sta.log 2>&1
		+	FAIL
		+	test_valid-northridge-SDSU_seis (__main__.BBP2G_Acceptance_Tests) ...
		+	/bin/sh: line 1: 58788 Abort trap: 6 /Users/fsilva/Work/svn/temp/15.3.0/bbp/src/sdsu/bin/BBtoolbox.exe <
		+	/Users/fsilva/Work/svn/temp/bbp_sims/tmpdata/4050735/bbtoolbox_northridge_3_sta/parfilename_northridge_3_sta >>
		+	/Users/fsilva/Work/svn/temp/bbp_sims/logs/4050735/4050735.bbtoolbox_northridge_3_sta.log 2>&1
		+	FAIL
		+	test_valid-northridge-UCSB (__main__.BBP2G_Acceptance_Tests) ... ok
		+
		+	======================================================================
		+	FAIL: test_user-SDSU (__main__.BBP2G_Acceptance_Tests)
		+	----------------------------------------------------------------------
		+	Traceback (most recent call last):
		+	File "./AcceptTests.py", line 111, in permutation_test
		+	self.failIf(rc != 0, "Acceptance test failed to execute")
		+	AssertionError: Acceptance test failed to execute
		+
		+	======================================================================
		+	FAIL: test_valid-northridge-SDSU (__main__.BBP2G_Acceptance_Tests)
		+	----------------------------------------------------------------------
		+	Traceback (most recent call last):
		+	File "./AcceptTests.py", line 111, in permutation_test
		+	self.failIf(rc != 0, "Acceptance test failed to execute")
		+	AssertionError: Acceptance test failed to execute
		+
		+	======================================================================
		+	FAIL: test_valid-northridge-SDSU_seis (__main__.BBP2G_Acceptance_Tests)
		+	----------------------------------------------------------------------
		+	Traceback (most recent call last):
		+	File "./AcceptTests.py", line 111, in permutation_test
		+	self.failIf(rc != 0, "Acceptance test failed to execute")
		+	AssertionError: Acceptance test failed to execute
		+
		+	----------------------------------------------------------------------
		+	Ran 12 tests in 3647.739s
		+
		+	FAILED (failures=3)

	== Potential Additional Steps ==		== Potential Additional Steps ==

@@ Line 46: / Line 46: @@
 # Compile the Broadband Platform by going into the src directory and typing "make"
 # Continue the Installation Instructions on [[Broadband_User_Guide_v15.3.0#User_Account_Setup|Broadband User Guide v15.3.0]]
 == Potential Additional Steps ==

@@ Line 15: / Line 15: @@
 This section describes the installation of the BBP 15.3.0 distribution on Mac OS X using a package management tool called Mac Ports. Mac Ports simplifies the installation process by automating several of the installation steps, but it will require administrator access unless you want to install it from the source (a few extra steps that we will not cover in this guide). If you prefer not to use Mac Ports, you can follow the directions provided by one developer who installed BBP 15.3.0 without using Mac Ports. Details are provided in the [[BBP_on_OS_X_Guide_Without_Mac_Ports]] page.
-This method uses Mac Ports, a software tool designed help install software on a Mac. The steps below describe alternative way to install the BBP on a Mac running Mac OS X Mavericks and Yosemite. Mac Ports helps you install all the needed Python and GNU packages on your Mac. Please note that you only need to follow on of the methods. If you decide to use Method 1: Mac Ports, you do not need to do anything in Method 2 and vice-versa.
+The steps below will guide you through the installation of Mac Ports and the necessary C/Fortran GNU compilers in addition to the Python packages required by the Broadband Platform. At the end of this section, we provide information about running the Unit and Acceptance Tests available on the Broadband Platform, along with some Mac OS X-specific details.
 === OS X 10.9 Mavericks using MacPorts ===

@@ Line 43: / Line 43: @@
 # Install PyProj, using the command: <br />$ sudo pip install pyproj
 # Compile the Broadband Platform by going into the src directory and typing "make"
-# Continue in the Both Methods section below
+# Continue the Installation Instructions on [[Broadband_User_Guide_v15.3.0#User_Account_Setup|Broadband User Guide v15.3.0]]
 == Method 2: Installation Without Mac Ports ==

@@ Line 111: / Line 111: @@
 </li>
-<li>Download the minimum set of required BBP files (6 file required currently) from the BBP web site:
+<li>Continue the Installation Instructions on [[Broadband_User_Guide_v15.3.0#User_Account_Setup|Broadband User Guide v15.3.0]]
-*bbp-dist-15.3.0.tar.gz
+</li>
 == Potential Additional Steps ==