The information on this page refers to License Statistics v6.17 or newer, which changed the License Statistics installation procedure for Linux. If you are running a previous version of License Statistics, see documentation for previous versions. |
If your Linux platform is other than DEB or RPM (which have dedicated installers), License Statistics can be installed on most other Linux platforms using a universal installer.
This installation method requires more manual configuration than the DEB and RPM installers, but allows for a high level of customization including:
- Running the application with a custom user
- Optionally running the application in non-service mode
- Customizing locations for files in the filesystem
- Running the application on more platforms than officially supported DEB and RPM
Installation
The following generic Linux installation procedure can be customized according to your needs.
- Download the License Statistics installation from the License Statistics download page.
Create user and group.
addgroup --system licstat adduser --ingroup licstat --no-create-home --system --disabled-login --shell /bin/false licstat
Create installation and data directories.
Installation directorymkdir -p /opt/xflicstat
Data directories
For MySQL:mkdir -p /var/opt/xflicstat/mysql
For license file:mkdir -p /var/opt/xflicstat/license
For logs:mkdir -p /var/opt/xflicstat/log
For temporary and runtime files:mkdir -p /var/opt/xflicstat/tmp
Set ownership and group:
chown licstat:licstat /opt/xflicstat \ /var/opt/xflicstat/mysql \ /var/opt/xflicstat/license \ /var/opt/xflicstat/log \ /var /opt/xflicstat/tmp
Extract License Statistics:
tar xzf license_statistics_v6.17.0_linux_x64.tar.gz -C /opt/xflicstat
and set ownership:
chown -R licstat:licstat /opt/xflicstat/
Set the port in the License Statistics configuration file /opt/xflicstat/conf/xflicstat.cfg:
WEBSERVER_PORT = 8080 # if not run as root port must be greater than 1024
Set options in the MySQL configuration file /opt/xflicstat/embedded/etc/mysql/mysql.conf:
user = licstat basedir # if installation is different then /opt/xflicstat: datadir # if mysql data dir is different then /var/opt/xflicstat/mysql:
Bootstrap the database:
LD_LIBRARY_PATH=/opt/xflicstat/embedded/lib /opt/xflicstat/embedded/bin/mysqld \ --defaults-file=/opt/xflicstat/embedded/etc/mysql/mysql.conf \ --initialize-insecure
Copy the default file:
cp /opt/xflicstat/scripts/default /etc/default/xflicstat
and set in /etc/default/xflicstat:
LOG_DIRECTORY=/var/opt/xflicstat/log LICENSE_DIRECTORY=/var/opt/xflicstat/license TMP_DIRECTORY=/var/opt/xflicstat/tmp
Install systemd unit:
cp /opt/xflicstat/scripts/xflicstat.service /lib/systemd/system/xflicstat.service
and edit:
systemctl edit xflicstat.service
and set:
[Service] User=licstat
If installation directory is different than /opt/xflicstat, also set the new installation directory with:
ExecStart=/opt/xflicstat/bin/xflicstat --run --logDir ${LOG_DIRECTORY} --licenseDir ${LICENSE_DIRECTORY} --tmpDir ${TMP_DIRECTORY}
Reload systemd:
systemctl --system daemon-reload
and optionally enable License Statistics to start with system:
systemctl enable xflicstat.service
Configuration
Configure the installation using the configuration file:
{installation_directory}/conf/xflicstat.cfg.
For example:
/opt/xflicstat/conf/xflicstat.cfg
Activating the license
License files must be placed in {license_directory}.
For example:
/var/opt/xflicstat/license
- Go to the directory:
/var/opt/xflicstat/license - Run the lacutil tool:
/opt/xflicstat/bin/lacutil -activate -act_key {activation_key}
You may also use an alternative activation method, as described in https://docs.x-formation.com/display/LICSTAT/Activating+a+License+Statistics+license
Starting the service
Start the service from a command line:
systemctl start xflicstat.service
Access License Statistics in the browser:
{hostname}:80
Stopping the service
Stop the service from a command line:
systemctl stop xflicstat.service
Removing the service
- Stop the service.
- Remove the directories with or without data directories, according to your needs.
Updating the service
- Download the License Statistics installation from the License Statistics download page.
- Stop the service (see Stopping, above).
- Backup the xflicstat.cfg file; for example: /opt/xflicstat/conf/xflicstat.cfg
- Clear the current installation directory; for example: /opt/xflicstat
Install the new version by extracting new files:
tar xzf license_statistics_v6.17.0_linux_x64.tar.gz -C /opt/xflicstat
and setting ownership:
chown -R licstat:licstat /opt/xflicstat/
- Optionally, restore the configuration file or reconfigure the default configuration file.
- Start the service (see Starting the service, above).