TethysL CLI Installation¶
Java based executables as well a binary executables for various platforms are made available at: https://okeanids.mbari.org/dl/tethysl/. These are described below.
The Java based release is the recommended installation option as most TethysL development and testing is primarily done on this environment. On the other hand, although generated automatically from the Java-based release,1 the binary releases are not as fully tested and may be unexpected issues with them.
A "Java release" means an executable format that is to be run via the
which is part of a typical Java runtime environment installation.
tethysl executable itself is a shell script that launches TethysL via
java command, which is assumed to be on your
If not already on your system, you can install Java using common package managers
or directly from java.com.
tethysl-X.Y.Z.zipin some location of your choice. This will create a directory
tethysl-X.Y.Z/under that location.
Open a terminal session and
cdto the extracted
make installas follows depending on where you want the
tethyslbash executable script to be installed.
tethyslunder the default location
sudo make install PREFIX="/opt/tethysl"
PREFIXvalue to be indicated should be the parent directory of
The native binaries are automatically generated from the Java-based release, but are not yet as stable and fully functional in general, or all of them available for the latest TethysL release.
A binary release means a standalone, native
Depending on target platform, each binary release is packaged as a ZIP archive,
only containing the corresponding executable program,
which is named
tethysl for both Linux and macOS,
tethysl.exe for Windows.
The executable binary for macOS is not signed, so it will not run right away
when downloaded from the internet.
xattr -d com.apple.quarantine tethysl to allow its execution.
Typically, you will want the CLI executable to be findable through the
PATHenvironment variable. (In particular, the VSCode extension will assume this.) Extract the executable from the zip in a location that is part of the
To verify the installation, run
tethysl --help, which should display the usage message on your terminal.