You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

The information on this page refers to License Statistics v5.14. If you are running an older version of License Statistics, see documentation for versions previous to v5.14.


As of v5.14, due to significant changes in database structure, we are not able to deliver backward compatibility for custom queries saved in SQL Console. Saved queries may stop working after upgrading to License Statistics v5.14, and they will have to be removed or adjusted to accommodate the new structure.

You can query the database for additional usage data using the UI or at a command line, as described below. The reference to the MySQL database is stored in htdocs/application/data/sql/database_structure.sql.

Generating SQL reports using the UI

To run a SQL query on the License Statistics database using the UI:

  1. Log into License Statistics as an administrator.

  2. Click Administration at the top of the License Statistics page.

  3. From the Administration page, click the SQL Console tab. 

  4. Enter your SQL query in the "Execute Query" text box and click Execute to generate the report.

    Query results appear in the area below the "Execute Query" text box. The results will be returned in a grid only if you enter a query that returns data, eg. SELECT or SHOW.

You can export the data returned from the query by clicking on one of the options under Save As at the bottom right of the Query Results grid. For example, you may want to view the report in Excel or PDF so you can include it in a report or presentation. See Downloading License Statistics data for more information about obtaining data in various formats.

Use caution when running queries that use UPDATE or DELETE keywords, because using these keywords can cause data loss or corruption.

Saving a query

You can save SQL queries under the Saved Reports area so that you can easily run the query in the future.

To save a query for future use:

  1. Click Add New under the Saved Reports area.
  2. Enter a name for your report in the Report Name field.
  3. Enter the SQL query in the SQL query field.
  4. Click Save to save the query.
  5. To run the saved query, click the Run icon in the Action column for that query. The query appears in the SQL Query area.
  6. Click Execute to submit the query.

You can also save a query as a CSV, Excel or PDF file using Save As in the Saved Reports area. After selecting the format to which to save the file, you are prompted to either open or save the file.

Running a SQL query from a command line

To run a SQL query from a command line:

  1. Stop License Statistics.

  2. From a command line, navigate to the License Statistics installation directory, and then to mysql_x64 for 64-bit databases (mysql for License Statistics v4.19.1 and newer).

  3. Start the MySQL server by running mysql_start.bat for Windows or mysql_start.sh for Linux.

  4. Connect to the License Statistics database using the following command:

    For Windows: mysql -u root -h localhost -tcp -Dxformation_licstat
    For Linux: ./mysql -u root -h localhost -tcp -Dxformation_licstat --socket=data/mysql.sock

  5. After connecting to the database, run the desired MySQL commands.

  6. Stop the MySQL server by running mysql_stop.bat for Windows or mysql_stop.sh for Linux.

  7. Restart License Statistics.
  • No labels