Ubuntu 18.04

Note

To install JetStream, you will need to either be logged in as root or be an administrative user using sudo. The examples below use sudo.

JetStream will install systemd service units for jetstream-server and jetstream-relay services, with /etc/jetstream-server.rsp and /etc/jetstream-relay.rsp configuration files respectively. The server service is enabled by default.

New Installation

To install JetStream on Ubuntu, run the following:

# sudo dpkg -i go-jetstream_<version>.deb

Your server should now be running.

Update Existing Installation

To update JetStream on Linux, run:

# sudo dpkg -i go-jetstream_<version>.deb

If you have made modifications to system configuration files, such /etc/jetstream-server.rsp, you may be prompted to overwrite the file with a new version. Say can say “N” to keep your current configuration, and then refer to /etc/jetstream-server.rsp.dist to see which changes were made to the default configuration.

Uninstall

To uninstall JetStream:

# sudo dpkg -P go-jetstream

Check Service

You can check if the JetStream service is running by running the systemctl status command. Under normal circumstances, the command should report that the process is active(running) under the Active heading. For example:

# systemctl status jetstream-server
● jetstream-server.service - Go:JetStream server service
   Loaded: loaded (/lib/systemd/system/jetstream-server.service; enabled; vendor preset: enabled)
   Active: active (running) since Thu 2019-10-03 15:23:37 PDT; 1min 41s ago
 Main PID: 681 (jetstream)
    Tasks: 26 (limit: 2314)
   CGroup: /system.slice/jetstream-server.service
           ├─ 681 /usr/local/bin/jetstream server @/etc/jetstream-server.rsp
           └─1172 /usr/local/bin/jetstream server @/etc/jetstream-server.rsp

Check Server

You can check that the server is active by making a simple API call on the command-line.

# /usr/local/bin/jetstream api --no-auth getServerInfo
{
 "allowRemoteControl": true,
 "apiControlPort": 8886,
 ...
 "license": {
   "expiry": "2020-10-01 (365 days from now including today)",
   "valid": true
 },
 ...
 "version": "2.0.0"
}

Active Directory

If your system is integrated with Active Directory, you may need to enable JetStream authentication in sssd. See Active Directory Integration.

Firewalls

There may be internal or external firewalls preventing connections. See Firewalls for tips on firewall configuration.