Installation

This is where we'll drop the installation instructions and links to the code

Linux

MacOS

MacOS Instructions

1/ Installation & Setup 1.1/ If not already installed, install homebrew: https://brew.sh/

1.2/ Check to see what version of Java is installed. You need java version 1.8: https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html (create a user account at Oracle and download) dhcp-40-200:Documents ferrini$ java -version java version "1.8.0_201" Java(TM) SE Runtime Environment (build 1.8.0_201-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.201-b09, mixed mode)

1.3/ Install gawk brew install gawk

1.4/ Install readlink brew install coreutils

1.5/ Install xquartz: http://www.xquartz.org

1.6/ Install gdal: brew install gdal

1.7/ Install MBSystem: https://www.mbari.org/products/research-software/mb-system/how-to-download-and-install-mb-system/#toggle-id-1

Users of the Homebrew package manager for MacOs can upgrade to the current release using: brew upgrade mbsystem or, if MB-System is being installed using Homebrew for the first time: brew update brew tap dwcaress/mbsystem brew install otps --with-tpxo8 brew install mbsystem

To update mbsystem use these commands

brew update brew upgrade

1.7/ Make sure you’re using GMT v 5*

1.8/ Download GMRTTiling-1.2.tgz bundle to your machine and uncompress it in the folder wherever you’d like it to be. (an older version:GMRTTiling-1.0.tgz is also available)

1/9 If necessary update the Config.php *this should not need to be edited unless the paths are not where they are specified below. To confirm use which mbedit which java ;PATH TO GMT bin DIRECTORY GMTPATH = "/usr/bin"

;PATH TO JAVA bin DIRECTORY JAVAPATH = "/usr/bin"

;PATH TO MBSYSTEM bin DIRECTORY MBSYSTEMPATH = "/usr/local/bin"

;PATH TO tiles DIRECTORY ;DEFAULT IS GmrtTiling/tiles DIRECTORY ;Uncomment this line to set another location ;TILEROOT = "/path/to/tiles"

;PATH TO GeoMapApp JAR FILE ;DEFAULT IS GeoMappApp.jar PACKAGED WITH GmrtTiling ;Uncomment this line to set another GeoMapApp.jar ;GMAPATH = "/path/to/GeoMapApp.jar"

1.10/ Make sure the path to the GMRTTool/bin folder is in your path E.g. use ‘sudo nano /etc/paths’ or ‘sudo vi /etc/paths’ to edit the /etc/paths file and add the path ferrini@MacBook-Pro TestCruise % more /etc/paths /usr/local/bin /usr/bin /bin /usr/sbin /sbin /Users/ferrini/Documents/GMRTTiling/bin

Setup should be complete!

For detailed instructions on how to execute the code, see: GMRTTiling: How-to

Troubleshooting:

GMRT_preproc issues: Java error: Confirm the version of java you’re using. ($ java -version). Should be version 1.8 as noted above. Check preproc.log and confirm where java is being pulled from when creating grids. Error: java.io.IOException: Cannot run program “/Library/Internet”: error=2, No such file or directory Should be from somewhere like this: /Library/Java/JavaVirtualMachines/jdk1.8.0_321.jdk/Contents/Home/jre/bin/java Check which versions of java are installed: /usr/libexec/java_home -V Matching Java Virtual Machines (3): 14 (x86_64) "Oracle Corporation" - "Java SE 14" /Library/Java/JavaVirtualMachines/jdk-14.jdk/Contents/Home 1.8.321.07 (x86_64) "Oracle Corporation" - "Java" /Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home 1.8.0_321 (x86_64) "Oracle Corporation" - "Java SE 8" /Library/Java/JavaVirtualMachines/jdk1.8.0_321.jdk/Contents/Home

The java path with /Library/Internet.. Will cause preproc to fail. Do not use this one. Make sure you’re using bash shell. Update the .bashrc and .bash_profile to insert the new paths. .bashrc : export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_321.jdk/Contents/Home .bash_profile: PATH=$PATH:$HOME/.local/bin:$HOME/bin:$JAVA_HOME/bin source ~/.bashrc

Windows