Install 2017-11-10T07:35:17+00:00

Tethys uses freely available software and may be installed and modified freely.   There is nothing that in principal would prevent it from being installed on Linux or MacOS, but as most of our user community uses Windows we are currently concentrating our efforts on developing Windows installers.

Windows Installation

What should I download?

Tethys can be installed for either 32 or 64 bit architectures.  It is highly recommended that if at all possible the 64 bit version be installed on the server machine as there are limitations to 32 bit programs that can prevent the processing of large data sets. As of version 2.3, 32-bit Tethys is no longer being supported.  To use the 64 bit version, you must have a 64 bit version of Windows. If you wish to add data to Tethys that is stored in Microsoft Office format (e.g. Excel, Access), the server machine must either have Microsoft Office installed or a freely available driver from Microsoft (details are in the Tethys manual).   If a 32 bit version of Office is installed, the 64 bit server will not work and vice-versa.  As Microsoft does not currently permit 32 and 64 bit Office drivers to be installed on the same machine, it is important that these match. Determining which architecture of Office is installed depends on the version of Office.  For Office 2010,  open an Office program (e.g. Word), then select File > Help, then look for About Microsoft Word  (or other program). Next to the version line will be an indication of whether or not the program is 32 bit.  Note that the clients and servers can work with one another even if the architecture versions do not match.


(Be sure to read the 32/64 bit discussion above)

  • 64-bit Tethys installer v2.3.2
  • 32-bit Tethys installer v2.2
  • 64-bit Tethys installer v2.2
  • 32-bit Tethys installer v2.1
  • 64-bit Tethys installer v2.1

By default, only a small installer program is included.  Once you have selected the components of Tethys you would like installed, they will be downloaded automatically.  Users have occasionally reported problems with the automated downloads.  If this happens to you, please download one of the following zip files which contains everything that is needed.  The zip should be uncompressed, and the Tethys-Installer executable should double clicked to start the installation.   The installer always checks if the needed files are accessible before trying to download them.

  • 64-bit Tethys zipped archive v2.3.2
  • 32 and 64-bit Tethys zipped archive v2.1
  • 32 and 64-bit Tethys zipped archive v2.0

Firewall rules:  By default (this can be changed), Tethys runs RESTful web services on port 9779 and clients must be allowed to connect.  Ephemeris service (e.g. sunrise/sunset) requires the server to be able to open outgoing connections on port 6775.

Importing data

Note that to import data, you will need an appropriate open database connectivity (ODBC) connector.  Details can be found in the user manual.  Some common connectors that people might need:

  • Microsoft’s Access Database Engine (ACE) for Access and Excel documents if Microsoft Office is not installed.  Note that Microsoft does not allow mixing of 32 and 64 bit versions of Microsoft Office.  For the recommended 64 bit version of the server, 64 bit Office is required.
  • MySQL  relational database ODBC
  • PostgreSQL relational database ODBC
  • Oracle relational database ODBC

Tethys has been tested with the Microsoft ACE 2010 and MySQL drivers.

Release History

Brief notes on releases and links to zipped versions of current and older software.

  • 2016-03-26 v2.3.2 – Patch, includes fixes from 2.3.1, and an updated demonstration database and examples (function dbDemo in the Matlab client).
  • 2016-02-09 v2.3.1 – Patch for v2.3, includes a fix for translating Excel files that include multiple rows of user-defined Detection parameters.
  • 2016-01-05 v2.3 – Multiple source & Performance release. Can now import from multiple data sources using the GUI. Greatly increased performance retrieving Detection and Effort records in Matlab. Extended Matlab query input options. ITIS expanded to all Animalia. Documentation updates. Various bug fixes.
  • 2015-04-28 v2.2 – Multiple source pre-release. Various bug fixes, implemented new server-side data parsing for imports. Visible changes: Import GUI restructuring and improvements, Quality Assurance schema elements added to Detections and Deployments, Ensembles container implemented.
  • 2014-12-31 v2.1 – Minor bug fix release.  Visible changes:  Imports now permit elements to not be generated when there is no data for them, improvements to the import user interface.
  • 2014-02-24 v2.0 – Major release.   Visibile changes:  Better ERDDAP support, release of 64 bit version that improves speed and removes problems seen with large ERDDAP transfers.  Server now caches external queries, making development much faster.  Improvements to XML parsing time for Matlab.  Better graphical user interface for document submission.  Server now supports a RESTful architecture.
  • 2013-05-10 v1.0 – Initial release