Skip to content

Docker releases

4.10.1

2022-05-10

In short: New ability to edit the "stations" list, and new "polygons" entry under the "Layers" dropdown in the Map tab, with a similar edit capability as with the stations.

Template: 4.10.1/tethysdash-instance-template.tgz

Changes in the template:

  • config/TethysDash.conf (see mapOptions section in this file for more details):
    • mapOptions.baseLayersDir: New entry.
    • mapOptions.stationsFile: Deprecated.
4.10.1: digest: sha256:0fad50516cdd8b13a67ccd55f1b9e884c2984a573e9db0659bcec8e73a8a6e05 size: 5784

4.9.8

2022-04-25

Template: 4.9.8/tethysdash-instance-template.tgz

Maintenance release, including updated underlying base LRAUV image.

4.9.8: digest: sha256:e19b7cd2d63f930c550b0c2edfafc40d8a7a50440353ad2f213f4b24e29515a6 size: 5784

4.9.7

2022-04-18

Template: 4.9.7/tethysdash-instance-template.tgz

For app deployment purposes, the only changes are in docker-compose.yml:

  • Now with version: '3.7' (at the top of the file)
  • Now with additional init: true setting for each of the containers

These adjustments are intended for a more graceful termination of the containers. In the case of TethysDash, this should help prevent issues with potentially incomplete tasks (e.g., git related re-synchronization of clones) when the container is restarted as part of regular updates or OS system patches, etc.


4.9.6

2022-04-05

Template: 4.9.6/tethysdash-instance-template.tgz


4.9.52

2022-02-11

Template: 4.9.52/tethysdash-instance-template.tgz


4.9.51

2022-02-04

Template: 4.9.51/tethysdash-instance-template.tgz


4.9.4

2022-02-01

Template: 4.9.4/tethysdash-instance-template.tgz


4.9.1

2022-01-26

Template: 4.9.1/tethysdash-instance-template.tgz


4.8.9

2022-01-14

Template: 4.8.93/tethysdash-instance-template.tgz


4.8.7

2021-12-16

Template: 4.8.7/tethysdash-instance-template.tgz


4.8.6

2021-12-15

Template: 4.8.6/tethysdash-instance-template.tgz


4.8.4

2021-12-13

Template: 4.8.4/tethysdash-instance-template.tgz

Changes in the system:

  • Critical security update in the backend (v4.7.0).
  • As usual, please see the change logs for the frontend and the backend.

4.8.2

2021-11-18

Template: 4.8.3/tethysdash-instance-template.tgz

Changes in the system:

As usual, please see the change logs for the frontend and the backend.


4.8.0

2021-11-09

Template: 4.8.0/tethysdash-instance-template.tgz

  • docker-compose.yml: With placeholder X.Y.Z for the version of the mbari/tethysdash image. Of course, please set this to appropriate version in your deployment.

4.7.8

2021-11-08

Template: 4.7.8/tethysdash-instance-template.tgz

Changes in the template:

  • setenv.sh:

    • New optional variable TETHYSDASH_LOGS that facilitates mapping the location of the TethysDash application log directory. Adjust docker-compose.yml accordingly.
  • docker-compose.yml:

    • Optional use of the TETHYSDASH_LOGS variable to map the application log directory.
    • Change in the version of the 'mbari/tethysdash' image.

Change in how the main TethysDash log is exposed

The main application log is now explicitly captured in a file with name main.log. This means that a command like docker logs -f tethysdash(*) is not anymore the typical mechanism to see the log. Instead, one will look at this main log as follows:

docker exec -it tethysdash tail -f /usr/local/tomcat/logs/main.log

Alternatively, if that logs directory in the container is mapped to a host location via the TETHYSDASH_LOGS setting indicated above, one can then simply run on the host directly, for example:

tail -f td_logs/main.log

Such volume mapping is in general more convenient, especially considering that there are other log files generated by the application (e.g., ws.log for websocket-related activity), as well as in terms of persistence of the logs.

(*)

docker logs -f tethysdash will now only show basic logging related with the launch and termination of the TethysDash application as reported from the application server (Tomcat).

New index in TethysDash database

There is a new index specified for the event table in the database. This is typically a large table so, upon a first launch of this new release, a delay (potentially of a couple of minutes) will be noted until the index is completed. The service may not be very responsive while such reindexing takes place.


4.7.0

2021-10-12

Template: 4.7.0/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

4.6.2

2021-07-23

Template: 4.6.2/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

4.5.3

2021-06-07

Template: 4.5.3/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

  • config/TethysDash.conf: New optional entry vehicleNames (at first level) to indicate the concrete list of vehicle names for the UI to consider. This is a convenience for when the underlying lrauv-config repo involves more vehicles than desired to expose in the UI.

    vehicleNames = ["foo", "bar"]
    

4.5.2

2021-06-01

Template: 4.5.2/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

  • config/TethysDash.conf: The websockets section now looks like so:

    async {
      websockets {
        useWebsocket = true
      }
      ...
    
    NOTE: websockets will be the automatic default in a future version. For now, please keep the setting as indicated above.

Changes in the system:

Several enhancements and fixes have been incorporated since last announced version in this page. The main change is the use of proper websockets endpoint. As usual, please see the change logs for the frontend and the backend.


4.3

2020-12-14

Initial version with an experimental websockets server.

Template: 4.3/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

  • config/TethysDash.conf: Optional new entry useWebsocket under the async section. If set to true, TethysDash will push notifications about vehicle cell connection related events also via a proper websocket server.

    On the Dash4 frontend, there's a new "Websockets" section under UI Settings -> Experimental that allows to connect/disconnect to the websocket server.

4.2.3

2020-12-13

Template: 4.2.3/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

  • config/TethysDash.conf: Optional new entry onlyCellConn under pusher as a temporary setting to help reduce use of pusher by restricting notifications only to cell connection related events.

4.2.1

2020-12-07

Template: 4.2.1/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

4.2

2020-10-30

Template: 4.2/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

4.1.4

2020-10-19

Template: 4.1.4/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

4.1.1

2020-10-09

Template: 4.1.1/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

4.0.1

2020-10-05

Template: 4.0.1/tethysdash-instance-template.tgz

Changes in the template:

  • docker-compose.yml: Only change is the version of the 'mbari/tethysdash' image.

  • config/TethysDash.conf:

    • The dashui entry under the external section now refers to the new v4 version of the Dash UI, that is:

       dashui = ${external.base}"/dash4/"
      
    • Under the sbd section, add:

        # Regex for recognizing SBD Receipt e-mails from Iridium system.
        receipt.subject.regex = "SBD Mobile Terminated Message Queued for Unit: (\\d+)"
      

      (Note: this was introduced as part of v3.9.990be3.7.7 hotfix.)

Changes in the system:

As usual, please see the change logs for the frontend and the backend.


3.9.990

2020-09-26

Template: 3.9.990/tethysdash-instance-template.tgz.

NOTE: No changes in this template, except for the 'mbari/tethysdash' image version in docker-compose.yml.

3.9.982

2020-09-18

Template: 3.9.982/tethysdash-instance-template.tgz.

It contains:

.
├── README.md             (*)
├── setenv.sh
├── docker-compose.yml    (*)
└── config
    ├── TethysDash.conf   (*)
    ├── miscLinks.json
    ├── tileLayers.json
    └── stations.json

(*) Changed files wrt previous version.

  • README.md: Simplified (main instructions located here).

  • docker-compose.yml: Only change is reference to the new image.

  • config/TethysDash.conf:

    • New mail.user section with options related with emails sent to users. Right now only an optional sentCopyFolder.
    • New optional sbd.outgoing.copyFolder setting indicating folder where copies of outgoing SBD emails are to be stored.
    • Adjusted argos.subject.regex value reflecting change for use in MBARI instance.

3.9.81

2020-05-07

Template: 3.9.81/tethysdash-instance-template.tgz.

It contains:

.
├── README.md             (*)
├── setenv.sh
├── docker-compose.yml    (*)
└── config
    ├── TethysDash.conf   (*)
    ├── miscLinks.json
    ├── tileLayers.json   (*) New file
    └── stations.json

(*) Changed files wrt previous version.

  • README.md: Updated instructions.

  • docker-compose.yml: Only change is reference to the new image.

  • config/TethysDash.conf: New optional tileLayersFile entry under mapOptions. If used, do not change the value but rather edit the new file config/tileLayers.json

  • config/tileLayers.json: New file. This file can be used to indicate tile layers to be included on the map in the Dash UI. The contents of this file should be a JSON object containing a tileLayers member with a list of objects:

    {
      "tileLayers": [
        {
          "name": "<name to be shown>",
          [ "wms": true, ]
          [ "legendurl": "https://...", ]
          "urlTemplate": "https://...",
          "options" : {
            "attribution": "...",
            ...
          }
        },
      ]
    }
    

    For each given layer, the given information will be passed to the Leaflet library used by the Dash. In concrete, the Dash will use a TileLayer.WMS if "wms": true is given, or TileLayer otherwise. The "options" object is passed directly as given. The optional "legendurl" entry is used by the Dash to show a tooltip for the entry.

3.9.8

2020-04-30

Template: 3.9.8/tethysdash-instance-template.tgz.

NOTE: No changes in the template wrt 3.9.77, except for the image version in docker-compose.yml.

3.9.77

2020-03-16

Template: 3.9.77/tethysdash-instance-template.tgz.

It contains:

    .
    ├── README.md
    ├── setenv.sh
    ├── config
    │   ├── TethysDash.conf   (*)
    │   ├── miscLinks.json
    │   └── stations.json
    └── docker-compose.yml    (*)

(*) The only files with adjustments.

Upgrading to 3.9.77

  • config/TethysDash.conf:

    • New cellConnStatus section. This section includes two entries, hostNamePattern and hostNames, that allow to explicitly indicate the host name of the server to "ping" for checking cell connection status for each vehicle. (Note: this mechanism can be considered temporary until the corresponding information gets captured in the vehicle configuration itself.)

    • Section done removed. (The corresponding unneeded scripts have been removed from the image /opt/tethysdash/tools/{runShoreScripts.sh,tethysCentroid.py}.)

  • docker-compose.yml:

    • The only change here is about the new tethysdash image version.

Upgrade steps

  • Stop and remove your current tethysdash container (no need to stop the tdpostgres one):

    cd .../your/tethysdash/
    source setenv.sh
    docker-compose stop tethysdash
    docker-compose rm tethysdash
    
  • Do any necessary updates to your existing files from previous template as explained above.

  • Start new 3.9.77 tethysdash container:

    docker-compose up -d
    docker logs -f --tail=20 tethysdash
    

3.9.73

2020-02-20

Template: 3.9.73/tethysdash-instance-template.tgz.

It contains:

    .
    ├── README.md
    ├── setenv.sh
    ├── config
    │   ├── TethysDash.conf
    │   ├── miscLinks.json     <-  new file
    │   └── stations.json
    └── docker-compose.yml

Upgrading from 3.9.4 to 3.9.73

Summary of changes as reflected in the template:

  • README.md updated (some irrelevant details removed).

  • setenv.sh now, as a convenience, also creates some of the directories to make sure they are owned by the running user. For an upgrade, the directories will of course already exist, so the ownership should be changed as needed after stopping your current version and before launching the new version.

  • config/TethysDash.conf:

    • New entry sbd.outgoing.alternativeAddresses to indicate a list of alternative destination addresses for the SBDs. If not empty, new buttons in the GUI will be available as follows:
      • Send Commands to <vehicle-name> via alternative address when issuing a mission;
      • Submit to alternative address when issuing a command.
    • The entry external.miscLinks has been removed. Instead, this optional feature is indicated with the config/miscLinks.json file described below.
    • Obsolete mapOptions.stationsFile entry removed. This feature was already captured via config/stations.json file.
  • New file config/miscLinks.json to indicate any links to be included in the main dropdown menu in the Dash UI.

Upgrade steps

  • Stop your current 3.9.4 system:

    cd .../your/tethysdash/
    source setenv.sh
    docker-compose down
    
  • Do any necessary updates to your existing files from previous template as explained above.

  • If needed, recursively change ownership of mapped directories so they belong to current user.

  • Start new 3.9.73 system:

    source setenv.sh
    docker-compose up -d
    docker logs -f tethysdash
    

3.9.4

2019-12-06

Template: 3.9.4/tethysdash-instance-template.tgz.