Skip to content

Docker releases

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.

Changes in the system:

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


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.