CentOS¶
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. Both services are disabled by default.
New Installation¶
To install JetStream on CentOS, run the following:
# sudo rpm -i go-jetstream-<version>.x86_64.rpm
Enable and start the service:
# sudo systemctl enable jetstream-server
# sudo systemctl start jetstream-server
CentOS runs the firewalld firewall by default, so you may also need to add a firewall exception, for instance:
# sudo firewall-cmd --permanent --zone=public --add-port=8886/tcp --add-port=8886/udp
# sudo systemctl restart firewalld
Your server should now be running.
Note
Additional UDP ports may be opened for concurrent transfers. See Network/Firewall.
Update Existing Installation¶
To update JetStream on CentOS, run:
# sudo rpm -U go-jetstream-<version>.x86_64.rpm
# 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 (/usr/lib/systemd/system/jetstream-server.service; enabled; vendor preset: disabled)
Active: active (running) since Thu 2019-10-03 15:02:36 PDT; 15min ago
Main PID: 1276 (jetstream)
Tasks: 27
CGroup: /system.slice/jetstream-server.service
├─1276 /usr/local/bin/jetstream server @/etc/jetstream-server.rsp
└─1629 /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.