Page tree
Skip to end of metadata
Go to start of metadata


The information on this page refers to License Statistics v5.15 or newer, which upgraded MySQL to v5.7. If you are using an earlier version of License Statistics, please refer to the documentation for releases prior to v5.15.

By default, License Statistics uses an embedded MySQL database, which is delivered with the application. The embedded database will be automatically installed and configured until you change your xflicstat.cfg configuration file to use an external database.

Although the embedded database is easier to use and more convenient for getting started with License Statistics, we strongly recommend using it only for testing and evaluation purposes.

For production environments, using an external database has advantages such as:

  • Faster upgrade procedure
  • Increased data protection when stored on a host different from the License Statistics server
  • Ability to customize database settings to optimize performance


Note that License Statistics supports only MySQL 5.7.x. Other versions are not supported.

To use an external database with License Statistics:

  1. Create the database. For example, type the following in the MySQL console:

    mysql> CREATE DATABASE database_name character set latin1 collate latin1_swedish_ci;

    where database_name is the name of the database.

  2. Edit or replace your existing mysqld configuration file with the MySQL config.ini file included in the License Statistics distribution. These settings are important for performance, because the default mysqld configuration file is not configured for the high volume of data License Statistics pushes through the database.

  3. Restart the MySQL server.

    Note: Each time you restart the MySQL server, make sure it is reading the proper configuration file.
  4. Edit the following settings in the configuration file (xflicstat.cfg):

    SettingDescription
    MYSQL_SERVERMySQL server name or IP address.
    MYSQL_PORT3306 (default).
    MYSQL_USERNAMEUsername for the account created in the License Statistics database.
    MYSQL_PASSWORDPassword for the account created in the License Statistics database.
    MYSQL_DATABASE

    Name of the database created for License Statistics.