3.9.81

2020-05-07

Updated 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

Updated 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

Updated 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

Updated 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.