Skip to main content
The Nginx service provides HTTP access to registry metadata and archived file listings on MAMS servers. It enables services like Sahabah to discover available archived model runs.

​
Purpose

Each MAMS server (main and archive servers) runs an Nginx service on port 8083. Primary functions:
  • Registry metadata: Query registry.json to discover which models and date ranges are available on each server
  • Available runs discovery: List directories for a given model and date to determine which runs are archived for that day
  • File serving: HTTP access to archived NetCDF files
Used by the Sahabah service to query registry metadata and discover available archived runs.

​
Deployment

  • Main Server: Service mams-archive_mams-local-archive on port 8083
  • Archive Servers: Service mams-archive_mams-archive on port 8083

​
Authentication

  • Nginx (Registry): mams / archive2025 (port 8083)
  • ModMS Query/Web: modms / CLandSky (port 8081)

​
Endpoints

​
Main Server

Base URL: http://mams.devops.arabiaweather.com:8083
  • GET /archives/meta: Serves registry.json with information about models and date ranges on each server
  • GET /archives/registry.json: Direct access to registry file (same as /archives/meta)
  • GET /archives/{path}: Serves archived files and provides JSON directory listings
  • GET /health: Health check (no authentication required)
/archives/meta endpoint is only available on the main MAMS server, not on archive servers.

​
Archive Servers

Base URL: http://138.201.49.117:8083 (example for Mams.04)
  • GET /archives/{path}: Serves archived files and directory listings
  • GET /health: Health check (no authentication required)
For example requests, see the API Examples page.

​
Features

  • Directory listing: JSON format with human-readable sizes and local time
  • Caching: 5-minute cache for static content, 1-minute for registry metadata
  • Security headers: X-Content-Type-Options, X-Frame-Options, X-XSS-Protection
  • CORS: Enabled for API access
  • Compression: Gzip enabled for text, JSON, and XML files

​
Use Cases

​
Discovering Available Runs

  1. Query /archives/meta to find which server has the data
  2. List directories for that model/date on the appropriate server
  3. Directory listing shows available run times

​
Sahabah Service Integration

  • Query registry metadata via APP__WEATHER__MAMS_REGISTRY_URL (port 8083)
  • Discover available archived runs by listing directories
  • Query actual data via APP__WEATHER__MAMS_QUERY_URL (port 8081)