VMs and logical component layout¶

flowchart TD
    subgraph UI["User Interfaces"]
        direction TB
        dash4["Dash4"]
        dash5["Dash5"]
        obs["Observability"]
    end

    okeanids["Okeanids<br/>(VM: <b>okeanids</b>)"]
    backend["TethysDash backend<br/>(VM: <b>tethysdash2</b>)"]
    lrauv@{ img: "../img/lrauv.svg", label: "LRAUVs", pos: "b", w: 50, h: 48 }
    database[("<b>tethysdash</b><br/>Postgres")]
    mount[("<b>/LRAUV</b><br/>Share mount")]

    UI --- okeanids
    okeanids --- lrauv
    okeanids --- backend
    backend --- database
    backend --- mount

    classDef ui fill:#fdf3d0,stroke:#e0c060,color:#000
    classDef store fill:#f0d8ea,stroke:#c090b8,color:#000
    classDef veh fill:none,stroke:none
    class dash4,dash5,obs,okeanids,backend ui
    class database,mount store
    class lrauv veh

• Main index page: https://okeanids.mbari.org/home/

  General entry point for users/operators.
  
  

• Dash4 frontend: https://okeanids.mbari.org/dash4/

  Main user interface with extended features for LRAUV monitoring and commanding. Includes administrative functions.
  
  

• Dash5 frontend: https://dash5.mbari.org/
  
  

• Observability:

  Various services expose observability metrics, which are visualized with a Grafana setup on the statusdev machine. See also the Monitoring section.
  
  

okeanids¶

okeanids is the primary endpoint for client applications and LRAUV vehicles. This is a "front-end" machine to the actual apps in various servers to:

• Provide secure (HTTPS) access to the UIs and LRAUVs
• Expose the LRAUV definitions (JSON) and mission schemas (XML)
• Expose TethysDataViz and cell map
• Expose various other resources

See /etc/apache2/sites-available/okeanids.conf for details.

Tethysdash2¶

tethysdash2 is the VM where the TethysDash backend runs. By TethysDash backend we refer to the TethysDash server application itself as well as to other associated services that support operations for the LRAUV vehicles and UI applications.

See /etc/apache2/sites-available/010-tethysdash.conf for details.

Database¶

tethysdash is the primary (postgres) database for TethysDash.

Network share¶

Several subdirectories under /LRAUV on tethysdash2 are handled by TethysDash.

Service start-up¶

• Apache and docker configured by IS to start at boot time.

• The TethysDash system itself (including the database) is configured to start at boot time via corresponding Docker Compose support.

LRAUVs¶

As can be seen in secure.cfg (in the lrauv-config configuration repository), LRAUVs are by default configured to interact with the TethysDash backend via okeanids:

Vehicle.dashIP      = "134.89.2.23"; // numeric IPv4 to okeanids.mbari.org
Vehicle.dashPort    = "443";
Vehicle.dashPath    = "/TethysDash";
Vehicle.dashSSL     = 1 bool;