M3 Deployspace

The m3-deployspace repository contains scripts and configuration for deploying MBARI media management (M3) related applications onto MBARI's infrastructure. Typically, to redeploy an application to the correct servers, navigate to its folder and run the build.sh script in the directory.

If this repository does not contain a build script for the application, refer to the apps source repo, which may contain the build.sh script instead.

Health Checks

For a fast health check of VARS services, view the JSON at https://m3.shore.mbari.org/config/health/status. It will list all the expected services and the healthStatus for each service. If the health status field for a service is empty or missing it means that the service is down. A good health check will look something like:

[
    {
        "name": "annosaurus",
        "healthStatus": {
            "jdkVersion": "21.0.8+9-LTS",
            "availableProcessors": 2,
            "freeMemory": 31702200,
            "maxMemory": 4294967296,
            "totalMemory": 140509184,
            "application": "annosaurus",
            "version": "1.4.1",
            "description": "Annotation Service"
        }
    },
    {
        "name": "beholder",
        "healthStatus": {
            "jdkVersion": "24.0.2+12",
            "availableProcessors": 4,
            "freeMemory": 23337848,
            "maxMemory": 1073741824,
            "totalMemory": 65011712,
            "application": "beholder",
            "version": "0.0.12",
            "description": "Framegrab server"
        }
    },
    {
        "name": "charybdis",
        "healthStatus": {
            "jdkVersion": "unknown",
            "availableProcessors": -1,
            "freeMemory": 30988304,
            "maxMemory": 4181721088,
            "totalMemory": 50331648,
            "application": "charybdis",
            "version": "0.5.3-SNAPSHOT",
            "description": "Publication Dataset Server"
        }
    },
    {
        "name": "oni",
        "healthStatus": {
            "jdkVersion": "21.0.8+9-LTS",
            "availableProcessors": 2,
            "freeMemory": 73660448,
            "maxMemory": 1073741824,
            "totalMemory": 125829120,
            "application": "oni",
            "version": "1.8.0",
            "description": "Organism Naming Infrastructure: Knowledge-base and User Accounts"
        }
    },
    {
        "name": "panoptes",
        "healthStatus": {
            "jdkVersion": "21.0.8+9-LTS",
            "availableProcessors": 4,
            "freeMemory": 8917856,
            "maxMemory": 4294967296,
            "totalMemory": 41943040,
            "application": "panoptes",
            "version": "0.4.9",
            "description": "Image Archiver"
        }
    },
    {
        "name": "raziel",
        "healthStatus": {
            "jdkVersion": "21.0.8+9-LTS",
            "availableProcessors": 4,
            "freeMemory": 14136304,
            "maxMemory": 1073741824,
            "totalMemory": 50331648,
            "application": "raziel",
            "version": "0.5.3-SNAPSHOT",
            "description": "Configuration/Key Store"
        }
    },
    {
        "name": "skimmer",
        "healthStatus": {
            "jdkVersion": "Python 3.13.7 (main, Aug 15 2025, 22:06:01) [GCC 14.2.0]",
            "availableProcessors": 4,
            "freeMemory": 1163243520,
            "maxMemory": 4055433216,
            "totalMemory": 4055433216,
            "application": "skimmer",
            "version": "0.3.0",
            "description": "ROI Service"
        }
    },
    {
        "name": "vampire-squid",
        "healthStatus": {
            "jdkVersion": "21.0.8+9-LTS",
            "availableProcessors": 2,
            "freeMemory": 35252544,
            "maxMemory": 4294967296,
            "totalMemory": 100663296,
            "application": "vampire-squid",
            "version": "1.2.2",
            "description": "Video Asset Manager"
        }
    },
    {
        "name": "vars-kb-server",
        "healthStatus": {
            "jdkVersion": "21.0.8+9-LTS",
            "availableProcessors": 2,
            "freeMemory": 73636072,
            "maxMemory": 1073741824,
            "totalMemory": 125829120,
            "application": "oni",
            "version": "1.8.0",
            "description": "Organism Naming Infrastructure: Knowledge-base and User Accounts"
        }
    },
    {
        "name": "vars-user-server",
        "healthStatus": {
            "jdkVersion": "21.0.8+9-LTS",
            "availableProcessors": 2,
            "freeMemory": 73611424,
            "maxMemory": 1073741824,
            "totalMemory": 125829120,
            "application": "oni",
            "version": "1.8.0",
            "description": "Organism Naming Infrastructure: Knowledge-base and User Accounts"
        }
    }
]