Reference Blog Releases Reliability GitHub
Step 1Install the DriverStep 2Log in to the CoreLog in to a Core that uses TLSStep 3Start the DriverStep 4Check the Driver
ReferenceEnterpriseStandalone DriverInstallEnterprise

Install a standalone Driver

Install the Synnax Driver on a computer other than the Core, log it in to the Core, and start it.

Each Core includes the Driver, which connects the devices on the Core’s computer. To connect devices on a different computer, install a standalone Driver on that computer. It connects to one Core over the network.

Step 1Install the Driver

Before you install:

  • Set the data acquisition modules of the controller to the NI-DAQmx real-time programming mode in NI MAX. See the NI CompactRIO user manual.
  • Turn on SSH on the controller. You can turn it off after you install the Driver.

Open an SSH connection to the controller and log in as admin. On NI Linux Real-Time, admin is root, so the commands on this page need no sudo there. Run:

curl -LO https://github.com/synnaxlabs/synnax/releases/download/driver/v0.60.1/install-driver-nilinuxrt.sh && chmod +x install-driver-nilinuxrt.sh && ./install-driver-nilinuxrt.sh

The script installs the Driver as a service and starts it. The service also starts each time the controller starts. The Driver runs as root.

Check the installation:

synnax-driver version

The output ends with the version:

Synnax Driver v0.60.1

Step 2Log in to the Core

You need the username and password of a user who can create racks. Run login with admin rights, so that the service reads the login: with sudo on Linux and macOS, in an administrator terminal on Windows, and as admin with no sudo on NI Linux Real-Time:

sudo synnax-driver login

The command asks for the address of the Core, and checks that it can reach the Core. Then it asks for the username and the password:

Host [localhost]: 10.0.0.45
Port [9090]:
Secure (Y/N) [N]:
Username: driver
Password:

The command then creates a rack for the Driver and an API key for that rack. It saves only the API key, never the password, and the Driver logs in as its rack with the key. When the output shows API key saved successfully!, the Driver is logged in.

An upgraded Driver that saved a username and password does this at its first start, and keeps its rack. If that user cannot create racks, the Driver logs the warning Failed to enroll Driver, and keeps logging in with the password. To fix it, run login as a user that can create racks, or create an API key for the rack in the Console and set it as api_key in the configuration.

Log in to a Core that uses TLS

Answer Y to Secure when the Core uses TLS, and give the host name of the certificate, not an IP address. A certificate from a public authority, such as Let’s Encrypt, needs no more setup.

For a certificate from your own authority, or from a Core that runs with --auto-cert:

  • Linux, NI Linux Real-Time, and Windows -> add the CA certificate to the trust store of the operating system. See Install certificates.
  • macOS -> the Driver does not read the macOS keychain. See the macOS tab of Install the certificate. Set GRPC_DEFAULT_SSL_ROOTS_FILE_PATH in /etc/synnax/driver.env, before you run login.

On Linux and NI Linux Real-Time, you can instead set the same variable in /etc/synnax/driver.env, before you run login. See Environment file. The Driver then trusts only the certificates in that file.

Step 3Start the Driver

The Driver started before you logged in, so restart it:

synnax-driver restart

Step 4Check the Driver

Check the service:

synnax-driver status

A running Driver prints:

Synnax Driver is running (PID: 28191)

The Driver shows in the devices toolbar under the host name of its computer. To connect devices to it, see Devices.

Previous in Enterprise

Production checklist

Next

Configuration