This is the ported version of SeisComP3 for Mac OS X / macOS.
Original project homepage: http://www.seiscomp3.org
The original software has been developed by the GEOFON Program at Helmholtz Centre Potsdam, GFZ German Research Centre for Geosciences and gempa GmbH.
SeisComP3 is distributed under the SeisComP Public License
SeisComP3-macOS installs on:
- macOS High Sierra 10.13.x
- macOS Mojave 10.14.x
- macOS Catalina 10.15.x
After compilation SeisComP3-macOS will be installed in your Home Directory: ${HOME}/seiscomp3
- Apple Xcode 9.x or Xcode 10.x or Xcode 11.x (depends on your macOS version)
- or "clang compiler" command-line, install with:
xcode-select --install
- GNU GFortran 6.3 or later
- Homebrew package manager for macOS
You can choose to install the developer tools via command-line only (saves space), or download Xcode IDE (8GB or more) from Apple's App Store for free.
The command-line works pretty well, so open up Terminal.app from Applications > Utilities and type:
xcode-select --install
Install GNU Fortran by downloading the latest installer for macOS here: https://gcc.gnu.org/wiki/GFortranBinaries
or direct download from: https://github.com/fxcoudert/gfortran-for-macOS/releases
Homebrew is the missing package manager for Mac: [Homebrew Webpage here] (http://brew.sh)
In Terminal.app copy/paste this command:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
All the dependencies packages will be installed in /usr/local/Cellar/
Check if your system is correctly setup with:
brew doctor
Note: If you have Macports package manager installed it's better to not to mix up with Homebrew. or you could rename Macports default directory /opt/local to /opt/local.OFF
With Homebrew installed, install seiscomp3 dependencies packages for macOS:
brew install cmake
brew install flex
brew install md5sha1sum
Check installed version of OpenSSL with:
brew list openssl
It should point to OpenSSL v1.11 and later:
/usr/local/Cellar/openssl@1.1/1.1.1d/bin/openssl
/usr/local/Cellar/openssl@1.1/1.1.1d/include/openssl/ (104 files)
/usr/local/Cellar/openssl@1.1/1.1.1d/lib/libcrypto.1.1.dylib
/usr/local/Cellar/openssl@1.1/1.1.1d/lib/libssl.1.1.dylib
....
If an older version is installed (like OpenSSL 1.0), then delete this version
brew uninstall openssl
Then (re)install latest version of OpenSSL with Homebrew:
brew install openssl
Install Boost:
brew install boost
Currently there are compilation issues with boost version 1.73. Version 1.72 works fine.
We therefore included the possibility to pass a version variable BOOST_VERSION_REQUIRED
with cmake in case the user has installed a specific boost version as boost@version.
Please note that seiscomp3 compiles fine using the easily available version boost@1.60.
We used the brew extract command to extract version 1.72 of boost into a private tap
of ours and then installed boost@1.72. Note that you should in that case not forget to
link boost@1.72 so that the link /usr/local/opt/boost@1.72 exists, since cmake is looking
for that.
Note: macOS 10.13 and later is required for Qt5.
brew install qt
If you need Qt4 for any reason (macOS < 10.13 ):
Qt4 is no longer officialy supported by Homebrew
[See homebrew-qt4 page] (https://github.com/cartr/homebrew-qt4)
brew install qt@4
If this doesn't work then try with command:
brew tap cartr/qt4
brew tap-pin cartr/qt4
brew install qt@4
The latest Homebrew version installs MySQL8 by default, which used to have some upgrade issues with Seiscomp3 InnoDB, but this has been fixed recently. You can also use mysql@5.7, that should also work fine.
brew install mysql
Note: for compilation with MySQL 8, you might possibly need to change the following line in the file usr/local/Cellar/mysql/8.[VERSION]/include/mysql/mysql_com.h:
#include <mysql/udf_registration_types.h>
to
#include "mysql/udf_registration_types.h"
since otherwise you get compilation issues "mysql/udf_registration_types.h' file not found with angled".
Copy default MYSQL configuration file to /usr/local/etc/
sudo cp $(brew --prefix mysql)/support-files/my-default.cnf /etc/my.cnf
For better performance with a MySQL database, adjust the following parameters in /etc/my.cnf
innodb_buffer_pool_size = 64M
innodb_flush_log_at_trx_commit = 2
To have launchd start mysql now and restart at login:
brew services start mysql
Recommended: MySQL Workbench application for macOS. MySQL Workbench from Oracle is a free GUI to administer MySQL databases. [Install MySQL Workbench from Oracle's website] (https://dev.mysql.com/downloads/workbench/)
After downloading the zipped "seiscomp3-macos-master.zip" to your Downloads folder move it to a new directory, e.g.: "seiscomp3-git". Also create the installation directory and build-directory e.g. builds-seiscomp3-macos, like this:
Create the installation directory in your Home folder:
mkdir -p ${HOME}/seiscomp3
Create the build-directory:
mkdir ~/Downloads/seiscomp3-git
mkdir ~/Downloads/seiscomp3-git/builds-seiscomp3-macos
Move the zipped file to the ~/Downloads/seiscomp3-git folder:
mv ~/Downloads/seiscomp3-macos-master.zip ~/Downloads/seiscomp3-git/
cd ~/Downloads/seiscomp3-git/
unzip ~/Downloads/seiscomp3-macos-master.zip
Now we are ready to compile seiscomp3-macos with GUI manually from the builds directory, like this:
cd builds-seiscomp3-macos
cmake -DCMAKE_INSTALL_PREFIX=${HOME}/seiscomp3 -DSC_GLOBAL_GUI_QT5=ON ../seiscomp3-macos-master
make -j 2
make install
For QT4, you need to pass SC_GLOBAL_GUI=ON rather than SC_GLOBAL_GUI_QT5=ON.
Note: If you have some specific version of Python required that you would like to use, you can
either adapt the CMakeLists.txt file to set the necessary paths accordingly or pass the variable
Python_VERSION_REQUIRED to use with cmake, with the version number you would like to use:
cmake -DCMAKE_INSTALL_PREFIX=${HOME}/seiscomp3 -DSC_GLOBAL_GUI_QT5=ON -DPython_VERSION_REQUIRED=[VERSION] ../seiscomp3-macos-master`
If everything compiled fine, the files will be installed in ${HOME}/seiscomp3.
Start for the GUI application 'scrttv' from ${HOME}/seiscomp3/bin/scrttv
${HOME}/seiscomp3/bin/scrttv
To avoid getting seedlink errors when starting seiscomp3 with "files open exceed max files ...", increase the max open files on system's startup.
Create a plist file named: limit.seiscomp3-maxfiles.plist with this content:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>limit.seiscomp3-maxfiles</string>
<key>ProgramArguments</key>
<array>
<string>launchctl</string>
<string>limit</string>
<string>maxfiles</string>
<string>524288</string>
<string>524288</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>ServiceIPC</key>
<false/>
</dict>
</plist>
Place this plist file in /Library/LaunchDaemons/
Then set root:wheel permission with command:
sudo chown root:wheel /Library/LaunchDaemons/limit.seiscomp3-maxfiles.plist
Launch it with command:
sudo launchctl load -w /Library/LaunchDaemons/limit.seiscomp3-maxfiles.plist
On macOS, you may need to deactivate the App Nap functionality for the GUIs to operate without crashes. This problem was noted with SeisComP version 4, but may in some way or the other also apply to SeisComP3, even though the master is based on spread and thus significantly different. To do that easily systemwide, you can use the OnyX software (tested with version 3.8.5 on macOS Catalina) to easily do that (tab Parameters --> Misc --> Turn off App Nap). Alternatively, you can do that via the command line or check out to deactivate App Nap for individual apps.
https://docs.gempa.de/seiscomp3/current/apps/global.html
If you get the -lcrypto compile error:
ld error: -lcrypto not found
then you need to fix it. Just do a:
brew doctor
which warns you that /usr/bin occurs befor /usr/local/bin:
Warning: /usr/bin occurs before /usr/local/bin
You need to edit your $PATH in ~/.bashrc like this:
PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/usr/X11/bin
to this line:
PATH=/usr/local/bin:/usr/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/X11/bin
Then in the Terminal, source your ~/.bashrc file:
source ~/.bashrc