The Xentara Licence Server v1.0
User Manual
systemd Service (Linux)

Table of Contents

See also
systemd System and Service Manager at systemd.io
Note
The user executing the commands in this section will need special privileges to be able to use sudo(8). This is usually accomplished by adding the user to the sudo user group. This can only be done by the root user, or by another user that already has sudo access.

Under Linux, the Xentara licence server package contains a service unit file for the systemd service manager. The file is a template unit file that allows you to enable a service that will automatically start the Xentara licence server when the system is started.

The Xentara licence server systemd unit is called xentara-licence-server@.service. The @ symbol at the end of the name tells systemd that this is a template unit file. systemd expects the template parameter to be placed after the @ symbol when referring to the service. The template parameter for the Xentara licence server service is the username of the Linux user under which the Xentara licence server should be run.

man pages
systemd(1), systemctl(1), systemd.service(5), systemd.unit(5), journalctl(1)

Enabling the Service

Enter the following command in a shell to tell systemd to start a service that runs the Xentara licence server as the Linux user username:

sudo systemctl enable xentara-licence-server@username

The Xentara licence server will be run without parameters, and will thus search for licence and configuration files in the default locations. You should normally place the licence and configuration files in the user’s home directory under .config/xentara-licence-server/. For instance, for the user username used in the examples on this page, the licence files should be placed in the directory ~username/.config/xentara-licence-server/licence/.

Stopping and Starting the Service

You can stop and start the service using the following commands:

sudo systemctl stop xentara-licence-server@username
sudo systemctl start xentara-licence-server@username

To restart the service (e.g. to reload a changed configuration file), use the following command:

sudo systemctl restart xentara-licence-server@username

Getting Status and Log Entries

Note
These commands do not require sudo(8) and can be executed by any user. Only the root user and the user under which the Xentara licence server is running will be able to see log entries, though.

You can print the status of the Xentara licence server service, together with the last log entries, using the following command:

systemctl status xentara-licence-server@username

You can show more log entries using the journalctl(1) command. To show the last 100 log entries, you can use the following command, for example:

journalctl --unit=xentara-licence-server@username --lines=100

To show log entries as they are printed, you can use the following command:

journalctl --unit=xentara-licence-server@username --follow

journalctl has many filtering and output options, which are described in the journalctl(1) man page.

Disabling the Service

To disable the service entirely, so that the Xentara licence server is no longer started automatically, use the following command:

sudo systemctl disable xentara-licence-server@username