The information on this page refers to License Statistics v6.18 or newer, which introduced the CLI and moved the License Statistics license from a file to the database. If you are running a previous version of License Statistics, see documentation for previous versions. |
If your Linux distribution is other than Debian, Ubuntu, or RedHat Enterprise Linux (which have dedicated installers), or you need more control over the installation process, you can use the generic (universal) installer.
This installation method requires more manual configuration than the DEB and RPM installers, but allows for a high level of customization including:
The following generic Linux installation procedure can be customized according to your needs.
All paths and commands used in the descriptions below are just examples of a customized installation procedure. This installation procedure requires advanced experience with customized installation, and all customizations are made at your own risk. |
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.
Back up all configuration and data files, especially the configuration file and MySQL data. |
Installation directory
mkdir -p /opt/xflicstat |
Data directories
For MySQL:
mkdir -p /var/opt/xflicstat/mysql |
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/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 than /opt/xflicstat datadir # if mysql data dir is different than /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 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} --tmpDir ${TMP_DIRECTORY} |
Reload systemd:
systemctl --system daemon-reload |
and optionally, enable License Statistics to start with the system:
systemctl enable xflicstat.service |
Configure the installation using the configuration file:
installation_directory/conf/xflicstat.cfg.
For example:
/opt/xflicstat/conf/xflicstat.cfg
Activate the license using:
/opt/xflicstat/bin/xflicstat-cli license activate activation_key
You may also use an alternative activation method, as described in Activating a license.
Start the service from a command line:
systemctl start xflicstat.service |
Access License Statistics in the browser:
{hostname}:80 |
Stop the service from a command line:
systemctl stop xflicstat.service |
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/ |