NDTS Installation

← Back to NAN Data Transport System Overview

Installing and Updating Daemon and Gateway

This page guides Facility Managers through installing, updating, uninstalling, and rolling back the two local NDTS components:

• Gateway – facility-level server that receives data from all workstations
• Daemon – runs on every spectrometer workstation

Packages are provided as .tar.gz archives on the Facility Dashboard.

Gateway Installation

Prerequisites

• A Gateway UUID supplied by the NAN Repository administrator
• A Linux host (Ubuntu 20.04 recommended) reachable by all workstations
• TCP port 60195 open inbound from those workstations

Installation Steps

# Copy the .gz file to the gateway computer
tar xf data-transport-gateway-<version>.tar.gz
cd dtgateway-installer
sudo ./install.sh
# → You will be prompted only for the Gateway UUID

Firewall Note

Open port 60195 to each NDTS workstation; no other inbound ports are required.

Verifying the Service

sudo systemctl status data-transport-gateway      # should show “active (running)”
sudo systemctl start  data-transport-gateway      # start if not running

Updating the Gateway

# Run the same installer script from a newer package
cd dtgateway-installer
sudo ./install.sh             # auto-detects an existing install; no prompts

Uninstalling the Gateway

sudo ./uninstall.sh           # script is included inside every package

Rolling Back the Gateway

Obtain the desired older package and run its install.sh. Rolling back more than one or two versions is not recommended.

---

Daemon Installation (Workstation)

Prerequisites

1. Gateway IP address
2. Exact Instrument Name (set in the Facility Dashboard – no spaces)
3. Workstation UUID (generated when the spectrometer was added)

• AlmaLinux only:* install chkconfig before proceeding.

Installation Steps

# Copy the .gz file to the workstation
tar xf data-transport-daemon.<distro>-<version>.tar.gz
cd dtdaemon-installer
sudo ./install.sh
# → Prompts:
#   • Gateway IP address
#   • Instrument name  (e.g., nmr600)
#   • Workstation UUID

Updating the Daemon

# Best practice: ensure no acquisition is running and the UI is closed
cd dtdaemon-installer
sudo ./install.sh              # updates binaries and restarts the daemon

Uninstalling the Daemon

sudo ./uninstall.sh

Rolling Back the Daemon

tar xf data-transport-daemon.<distro>-<old-version>.tar.gz
cd dtdaemon-installer
sudo ./install.sh              # not advised to roll back >2 versions

Managing the Daemon Service

The daemon uses SysV service scripts for maximum compatibility:

sudo /sbin/service data-transport-daemon start
sudo /sbin/service data-transport-daemon stop
sudo /sbin/service data-transport-daemon restart
sudo /sbin/service data-transport-daemon status

What’s Next?

• Configuring the Daemon
• Running and Monitoring the Daemon