Ubuntu 16.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
.
New Installation¶
To install JetStream on Linux, run the following:
# sudo dpkg -i go-jetstream_<version>.deb
Edit /etc/jetstream-server.rsp
and add in your license key (provided by Jet Digital) by appending the --license-password
option. For instance:
# sudo vi /etc/jetstream-server.rsp
--api-allow-remote-control
--trigger-dir=/var/lib/jetstream/triggers
--persistent-state-dir=/var/lib/jetstream/state
--license-password=12345678
Enable and start the service:
# sudo systemctl enable jetstream-server
# sudo systemctl start jetstream-server
Your server should now be fully operational.
Update Existing Installation¶
To update JetStream on Linux, run:
# sudo dpkg -i go-jetstream_<version>.deb
# sudo systemctl daemon-reload
# sudo systemctl restart jetstream-server
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 and licensed by making a simple API call on the command-line. If prompted for a password, just hit enter.
# /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"
}
Next Steps¶
Try connecting to the JetStream server and doing some transfers. See Connecting To JetStream for tips on setting up a connection. If you want to further customize your JetStream installation, see Setup.