Versions Compared

Old Version 1

changes.mady.by.user Tracy McCurdy

Saved on

compared with

New Version Current

changes.mady.by.user Tomasz Ryba

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


The information on this page refers to License Statistics v6.6 18 or newer, which introduced added the ability to restart License Statistics from the License Statistics Manager tool.  Please note that the License Statistics Manager tool replaces direct editing of the xflicstat.cfg configuration file for Windows installations.(either using a new Restart button or via an alert that is issued if the configuration has changed while License Statistics is running). License Statistics v6.18 also removed the ability to activate licenses using the License Statistics Manager. License activation is now done using the Management tab on the Licensing page or the CLI, which was introduced with v6.18. If you are using a version previous to v6.18, see documentation for previous versions.


Info

License Statistics Manager is available for Windows installations only.


Info

License Statistics Manager requires .NET Runtime v4.8. Many Windows installations have .NET preinstalled; however, if you do not have the .NET platform installed or your version is other than v4.8, download the .NET v4.8 installation from Microsoft at https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48 (direct download link: https://go.microsoft.com/fwlink/?LinkId=2085155) and install it prior to installing License Statistics.

For details about preinstalled and supported .NET versions, see Microsoft's documentation at https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/versions-and-dependencies#net-framework-48.

Before running License Statistics, you must configure it for your specific environment and needs. For Windows installations, the License Statistics Manager, which opens automatically upon completion of the License Statistics installation, guides you through all configuration options, including License setup. For Linux installations, please see Configuring License Statistics.

...

After you have configured License Statistics, you are ready to start it as a service on Windows (see Starting and stopping License Statistics on Windows). If you make changes to the configuration when License Statistics is running, you must restart License Statistics for any changes to the configuration file to take effect.

Using the License Statistics Manager

Upon completion of the installation, the License Statistics Manager tool opens, as shown below. License Statistics Manager can also be run from the Windows Start Menu or by using the LicenseStatisticsManager.exe file, which is located by default in C:\Program Files\X-Formation\License Statistics\manager. 

Be sure to review all settings and change them as needed for your environment and preferences.

Restarting License

...

Statistics

If you make changes to the configuration when License Statistics is running, you will see a message that asks whether you want to restart License Statistics. You must restart License Statistics for any changes to the configuration to take effect.

Image Added

You can also restart License Statistics as needed at any time by using the Restart button at the top

...

To setup your license, click the License button under the Configuration area of the License Statistics Manager.

image-2020-03-27-15-11-46-490.pngImage Removed

Image Added

Anchor
config_settings
config_settings

...

Configuration

...

settings

The License Statistics Manager lets you review and change your configuration settings. (Prior to v6.6, these settings were reviewed and changed using the xflicstat.cfg file.)

...

  • If you are updating License Statistics from a version prior to v6.6 to v6.6 or newer, or if you're installing License Statistics on a new host, you can use Import under the Configuration area of the License Statistics Manager

...

  • to locate and import your settings from a backed up xflicstat.cfg file. You should also follow the upgrade instructions, as appropriate for your installation.
  • If you don't have an existing xflicstat.cfg file, or you prefer to change your settings manually using the License Statistics Manager, click Settings under the Configuration area of the License Statistics Manager to open the Configuration Settings dialog. 

    Image Added

The following sections describe the configuration settings available from the License Statistics Manager.Configuration Settings dialog, including:

Anchor
config_webserver
config_webserver
Webserver settings

The Webserver settings let you specify your HTTP server information. For more details, see HTTP Server configuration.

screenshot-6.pngImage Removed

Database settings

The Database settings let you configure the License Statistics database. For more information, including backing up and restoring the database, see The License Statistics database.

The Webserver settings also include the ability to create a keystore, described next.

Image Added

Anchor
keystore
keystore
Creating a keystore

The Webserver settings let you browse for and specify the location of a keystore, or if no keystore exists, to create a keystore using a wizard to guide you. You can also create a keystore manually; however, creating a keystore using the License Statistics Manager wizard simplifies the process.

To create a keystore using the License Statistics Manager wizard: 

  1. To the right of the Keystore field, click Create to open the keystore creation wizard.
     
    Image Added

  2. Browse for each of the paths that define the information needed to create the keystore, as described below. All fields are required except as noted.

    Certificate The certificate file (standalone or bundled with intermediate certificates)
    Intermediate An optional file with intermediate certificates (provided by CA)
    Private KeyThe private key file
    Password 

    The password for the new keystore that will be created

    Key AliasThe alias in the keystore for the new key that will be created


  3. Click Save to create the keystore file in the application files,
    or
    Click Save As to create the keystore in a different location.

After saving the keystore definition, the keystore creation wizard will close, and the HTTP settings will be automatically populated with the specified Keystore path, Password and Key Alias.

Anchor
config_db
config_db
Database settings

The Database settings let you configure the License Statistics database. 

Image Addedscreenshot-2.pngImage Removed

The Database settings include the following.

FieldRequired
Default value set by License Statistics Manager
Description
EmbeddedNo
N/A

Check this box to use an embedded MySQL server. Leave this box unchecked if using an external MySQL server.

If you use an embedded MySQL server, the database will be created automatically the first time you run License Statistics, and the default values for all fields except "Password" will be filled in automatically.

If you use an external MySQL server, the database must be created manually before running License Statistics, and you must fill in all required fields.

HostYes
EMBEDDED64
To use the embedded MySQL server delivered with License Statistics, set this value to EMBEDDED64.

To use an external MySQL server, specify the server name or IP address.

PortYes
3306
To use an external MySQL server, specify the server port.
UsernameYes
root
Username for the account created in the License Statistics database.
PasswordNo
empty
Password for the account created in the License Statistics database.
DatabaseYes
xformation_licstat

Name of License Statistics database.

Anchor
config_LDAP
config_LDAP
LDAP settings

The LDAP settings let you enable and configure LDAP SSL. For more information, see Enabling LDAP SSL. 

screenshot-3.pngImage RemovedImage Added

LDAP settings include the following.

Field

Default

Description

Certificate
empty
Path to the file with the certificate.
Verify
Demand

Defines if the LDAP server certificate should be verified.

To turn verification on, toggle this setting to "Demand."

To turn verification off, toggle this to "Allow" or "Off."

Keystore
empty
Path to the keystore containing the server certificate.
Password
changeit
Password for the keystore.

Anchor
config_other
config_other
Other settings

The settings under "Other," include the Java path, core settings and a toggle for LM-X extended logging. The settings in the Core section should not be specified only if changed unless you are instructed to do so by X-Formation Support. 

Image Added

Support options

The License Statistics Manager includes options that assist X-Formation in providing support in case of issues, as described below.

Anchor
download_support_file
download_support_file
Downloading a support file 

If you experience issues with License Statistics, you should include a support file in your email to X-Formation Support. You can easily produce this file using the Download Support File button in the Support section of the License Statistics Manager. See Reporting a Bug in License Statistics for more information about obtaining support for License Statistics.  

Image Added

Anchor
reset_pwd
reset_pwd
Resetting the Administrator password

You can reset the password for the License Statistics Administrator (admin) user to its default setting (admin) using the Reset Password button in the Maintenance section of the License Statistics Manager. (License Statistics must be running to execute this operation.)

Image Added

Anchor
db_backup
db_backup
Creating a backup file

If X-Formation Support requests a backup of your database, you can create the backup using the Backup button in the Maintenance section of the License Statistics Manager. For more information, see Backing up and restoring an embedded database.

Image Addedscreenshot-5.pngImage Removed