Page History

...

1. Download the License Statistics installation from the License Statistics download page.

2. Create user and group.

   Code Block
   addgroup --system licstat adduser --ingroup licstat --no-create-home --system --disabled-login --shell /bin/false licstat

3. Create installation and data directories.

   Note
   Back up all configuration and data files, especially the configuration file, MySQL data, and the license file.

   
   Installation directory

   Code 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

   
   

4. 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/

   
   

5. 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

   
   

6. 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:

   
   

7. 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

   
   

8. 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

   
   

9. 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}

   
   

10. Reload systemd:

    Code Block
    systemctl --system daemon-reload

    and optionally enable License Statistics to start with system:

    Code Block
    systemctl enable xflicstat.service

    
    

...