NDTS Installation

← Back to NAN Data Transport System Overview

Installing and Updating Daemon and Gateway

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

• Gateway – a 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

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

Re-run the same installer script with the 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.

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