Linux

We recommend installing License server to a separate virtual machine in order to simplify its administration. License server doesn’t depend on a third-party software, consumes 10MB of physical memory and grows by 200KB for each active client.

There are three versions of Linux installation packages:

  • RPM - package for RHEL, CentOS, Fedora and other rpm-based distros. The package was built and tested on CentOS 7 and expected to work on all versions above.

  • DEB - package for Debian, Ubuntu and other deb-based distros. The package was built and tested on Ubuntu 16.04 and as well expected to work on all versions above.

  • tar.bz2 - binary files for any other Linux system with glibc >= 2.12.

One can download them here: http://downloads.russian3dscanner.com/LicenseServer/Linux/. All examples below consider version 1.2.2 for simplicity.

RPM installation:

Installation steps described here were made on the raw installation of CentOS 7 Minimal. If you have any trouble installing it on your system, please contact us.

$ curl https://downloads.r3ds.com/file/r3ds-dl/LicenseServer/1.2.2/a51b8e1ff3db2c9e1b84ef78fb4fb32b/r3dslicserver-1.2.2-1.el7.x86_64.rpm -O
$ sudo rpm -Uvh r3dslicserver-1.2.2-1.el7.x86_64.rpm
$
$ # Enable and start r3dslicserver systemd service.
$ sudo systemctl enable r3dslicserver.service
$ sudo systemctl start r3dslicserver.service
$
$ # Firewall configuration blocks arbitrary incoming connections.
$ # Allow connections to the port 7307 which r3dslicserver listens by default.
$ sudo firewall-cmd --permanent --new-service=r3dslicserver
$ sudo firewall-cmd --permanent --service=r3dslicserver --add-port=7307/tcp
$ sudo firewall-cmd --permanent --service=r3dslicserver --set-short="R3DS License Server"
$ sudo firewall-cmd --permanent --add-service=r3dslicserver
$ sudo firewall-cmd --reload

tar.bz2 installation:

$ # Download and put in /opt/r3dslicserver.
$ # /opt/r3dslicserver is not required but otherwise additional configuration will be needed.
$ curl https://downloads.r3ds.com/file/r3ds-dl/LicenseServer/1.2.2/a51b8e1ff3db2c9e1b84ef78fb4fb32b/r3dslicserver-1.2.2.tar.bz2 -O
$ sudo mkdir -p /opt
$ sudo cp r3dslicserver-1.2.2.tar.bz2 /opt
$ cd /opt
$ sudo tar xf r3dslicserver-1.2.2.tar.bz2
$ sudo ln -s r3dslicserver-1.2.2 r3dslicserver
$
$ # Add group and user for server.
$ sudo groupadd -r r3dslicserver
$ sudo useradd -r -g r3dslicserver -s /sbin/nologin -c "R3DS License Server" r3dslicserver
$
$ # Copy configuration files.
$ sudo mkdir -p /etc/opt/r3dslicserver/licenses
$ sudo cp r3dslicserver/etc/r3dslicserver/r3dslicserver.ini /etc/opt/r3dslicserver/
$ sudo cp r3dslicserver/lib/systemd/system/r3dslicserver.service /etc/systemd/system/
$
$ # Install and activate systemd service files.
$ sudo cp r3dslicserver/lib/systemd/system/r3dslicserver.service /etc/systemd/system/
$ sudo systemctl enable r3dslicserver.service
$ sudo systemctl start r3dslicserver.service

Your firewall configuration may block arbitrary incoming connections. In that case please repeat last steps from RPM installation section.

Check Installation

To check status whether the server is running one can use standard systemd command:

$ sudo systemctl status r3dslicserver.service

It will show the status of the server with some of the most recent messages:

● r3dslicserver.service - R3DS license server
   Loaded: loaded (/usr/lib/systemd/system/r3dslicserver.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2021-04-05 04:12:48 EDT; 12s ago
 Main PID: 1485 (r3dslicserver)
   CGroup: /system.slice/r3dslicserver.service
           └─1485 /opt/r3dslicserver/bin/r3dslicserver

Apr 05 04:12:48 centos7raw systemd[1]: Started R3DS license server.
Apr 05 04:12:48 centos7raw systemd[1]: Starting R3DS license server...
Apr 05 04:12:48 centos7raw r3dslicserver[1485]: Using configuration from /etc/opt/r3dslicserver/r3dslicserver.ini
Apr 05 04:12:48 centos7raw r3dslicserver[1485]: License directory load OK, licenses: 0 (0 valid), total seats...lid)
Apr 05 04:12:48 centos7raw r3dslicserver[1485]: Listening on "0.0.0.0:7307"
Hint: Some lines were ellipsized, use -l to show in full.