NDTS Installation: Difference between revisions
From Network for Advanced NMR
Jump to navigationJump to search
Mmaciejewski (talk | contribs) No edit summary |
Mmaciejewski (talk | contribs) No edit summary |
||
| Line 3: | Line 3: | ||
= Installing and Updating Daemon and Gateway = | = Installing and Updating Daemon and Gateway = | ||
This page | This page guides Facility Managers through installing, updating, uninstalling, and rolling back the two local NDTS components: | ||
* '''Gateway''' – | * '''Gateway''' – facility-level server that receives data from all workstations | ||
* '''Daemon''' – runs on every spectrometer workstation | * '''Daemon''' – runs on every spectrometer workstation | ||
Packages are provided as | Packages are provided as <code>.tar.gz</code> archives on the Facility Dashboard. | ||
== '''Gateway Installation''' == | == '''Gateway Installation''' == | ||
=== Prerequisites === | === Prerequisites === | ||
* A | * A '''Gateway UUID''' supplied by the NAN Repository administrator | ||
* A Linux host (Ubuntu 20.04 recommended) reachable by all workstations | * A Linux host (Ubuntu 20.04 recommended) reachable by all workstations | ||
* TCP | * TCP port '''60195''' open inbound from those workstations | ||
=== Steps === | === Installation Steps === | ||
<pre> | <pre> | ||
# Copy the .gz file to the gateway computer | # Copy the .gz file to the gateway computer | ||
| Line 36: | Line 36: | ||
=== Updating the Gateway === | === Updating the Gateway === | ||
<pre> | <pre> | ||
# Run the same installer script from a newer package | |||
cd dtgateway-installer | cd dtgateway-installer | ||
sudo ./install.sh # auto-detects an existing install; no prompts | sudo ./install.sh # auto-detects an existing install; no prompts | ||
| Line 48: | Line 48: | ||
=== Rolling Back the Gateway === | === Rolling Back the Gateway === | ||
Obtain the desired older package and run its | Obtain the desired older package and run its <code>install.sh</code>. | ||
Rolling back more than one or two versions is not recommended. | Rolling back more than one or two versions is not recommended. | ||
| Line 56: | Line 56: | ||
=== Prerequisites === | === Prerequisites === | ||
# '''Gateway IP address''' | |||
# Exact '''Instrument Name''' (set in the Facility Dashboard – no spaces) | |||
# '''Workstation UUID''' (generated when the spectrometer was added) | |||
*AlmaLinux only:* install | *AlmaLinux only:* install <code>chkconfig</code> before proceeding. | ||
=== Steps === | === Installation Steps === | ||
<pre> | <pre> | ||
# Copy the .gz file to the workstation | # Copy the .gz file to the workstation | ||
| Line 94: | Line 94: | ||
== '''Managing the Daemon Service''' == | == '''Managing the Daemon Service''' == | ||
The daemon uses | The daemon uses '''SysV service scripts''' for maximum compatibility: | ||
<pre> | <pre> | ||
sudo /sbin/service data-transport-daemon start | sudo /sbin/service data-transport-daemon start | ||
Revision as of 18:49, 2 June 2025
← 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
- Gateway IP address
- Exact Instrument Name (set in the Facility Dashboard – no spaces)
- Workstation UUID (generated when the spectrometer was added)
- AlmaLinux only:* install
chkconfigbefore 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
