...
The information on this page refers to License Statistics v6.17 or newer, which made changes to changed the License Statistics installation procedure for Linux. If you are running a previous version of License Statistics, see documentation for previous versions. |
...
This installation method requires more manual configuration than the DEB and RPM installers, but allows for a high level of customization including:
- running Running the application with a custom user
- optionally Optionally running the application in non-service mode
- allows putting files to custom directories Customizing locations for files in the filesystem
- allows running Running the application on more platforms than officially supported DEB and RPM
Installation
an example The following generic Linux installation procedure that can be customized according to the your needs.
- Download the License Statistics installation from the License Statistics download page.
Create user and group.
Code Block addgroup --system licstat adduser --ingroup licstat --no-create-home --system --disabled-login --shell /bin/false licstat
Create installation and data directories.
Installation directoryCode Block mkdir -p /opt/xflicstat
Data directories
For MySQL:Code Block mkdir -p /var/opt/xflicstat/mysql
For license file:Code Block mkdir -p /var/opt/xflicstat/license
For logs:Code Block mkdir -p /var/opt/xflicstat/log
For temporary and runtime files:Code Block mkdir -p /var/opt/xflicstat/tmp
Set ownership and group:
Code Block chown licstat:licstat /opt/xflicstat \ /var/opt/xflicstat/mysql \ /var/opt/xflicstat/license \ /var/opt/xflicstat/log \ /var /opt/xflicstat/tmp
Extract License Statistics:
Code Block tar xzf license_statistics_v6.17.0_linux_x64.tar.gz -C /opt/xflicstat
and set ownership:
Code Block chown -R licstat:licstat /opt/xflicstat/
Set the port in the License Statistics configuration file /opt/xflicstat/conf/xflicstat.cfg:
Code Block 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:
Code Block 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:
Code Block 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:
Code Block cp /opt/xflicstat/scripts/default /etc/default/xflicstat
and set in /etc/default/xflicstat:
Code Block LOG_DIRECTORY=/var/opt/xflicstat/log LICENSE_DIRECTORY=/var/opt/xflicstat/license TMP_DIRECTORY=/var/opt/xflicstat/tmp
Install systemd unit:
Code Block cp /opt/xflicstat/scripts/xflicstat.service /lib/systemd/system/xflicstat.service
and edit:
Code Block systemctl edit xflicstat.service
and set:
Code Block [Service] User=licstat
If installation directory is different than /opt/xflicstat, also set the new installation directory with:
Code Block ExecStart=/opt/xflicstat/bin/xflicstat --run --logDir ${LOG_DIRECTORY} --licenseDir ${LICENSE_DIRECTORY} --tmpDir ${TMP_DIRECTORY}
Reload systemd:
Code Block systemctl --system daemon-reload
and optionally enable License Statistics to start with system:
Code Block systemctl enable xflicstat.service
...