Server: Installation & Setup

The Network of Models Server (NoM Server) uses the NoM Client to run models and server results.

Installation

An instance of the Network of Models Server (NoM Server) can be installed from the ESA Space Environments repository.

Note: both the client and the server need to be installed.

""" New install """
pip install git+HTTPS://USERNAME:PASSWORD@space-env-repo.estec.esa.int/network-of-models/code/nom-client.git
pip install git+HTTPS://USERNAME:PASSWORD@space-env-repo.estec.esa.int/network-of-models/code/nom-server.git


""" Update installation """
pip install --upgrade git+HTTPS://USERNAME:PASSWORD@space-env-repo.estec.esa.int/network-of-models/code/nom-client.git
pip install --upgrade git+HTTPS://USERNAME:PASSWORD@space-env-repo.estec.esa.int/network-of-models/code/nom-server.git

Access to this repository can be requested by emailing space-env@esa.int

Configuration

The NoM Server is configured using a JSON configuration file.

Example configuration file:

{
  "server": {
    "server_name": "Network of Models Server",
    "server_uri": "",
    "server_port": 5002,
    "server_protocol": "https",
    "log_file": "",
    "usage_log_file": "",
    "debug": "false",
    "model_timeout": 10,
    "results_directory": ""
  },
  "web_api": {
    "api_base": "api"
  },
  "db": {
    "mysql": {
        "username": "",
        "password": "",
        "host": "",
        "database": ""
    }
  },
  "nom_client_configuration": {
    "servers": {
      "local_server": {
        "type": "local_server",
        "models_directory": "",
        "working_directory": ""
      }
    }
  }
}

The location of this configuration file is specified by setting the value of an environment variable NOM_SERVER_CONFIGURATION.

Access to a MySQL/MariaDB database is required to provide access to long running model runs.