Versions Compared

Key

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


The information on this page refers to License Statistics v6.18 or newer, which introduced the ability to activate the license from UI. If you are running an older version of License Statistics, see documentation for versions prior to v6.18.


Info
The following steps are designed to

...

help you get a new License Statistics installation up and running

...

on Windows

...

Important: If you're upgrading to a newer version of License Statistics, be sure to make a backup (see Backing up the database) before uninstalling License Statistics. All files will be deleted from the License Statistics installation directory during the uninstallation.

Step 1: Download the License Statistics installation file.

Download the License Statistics installation from the Support Portal, as instructed in your download email. The installation wizard will step you through the procedure.

Important: You can install License Statistics on any machine, not necessarily the license server.

Step 2: Activate the license.

Note: License activation is not necessary for the trial version. If you have chosen to run License Statistics as a trial, please continue to Step 3.

After the installation is complete, activate your License Statistics license by entering your Order ID in the License Activation Tool dialog that appears. You can find your Order ID in the download email you received or by logging into the X-Formation Support Portal.

...

. To update an existing License Statistics installation, please see Updating License Statistics.
  1. Download the License Statistics installation from the License Statistics download page.
    • If you have purchased License Statistics: Enter your Activation Key, included in the email sent to you after purchasing License Statistics, to obtain your download. If you have trouble locating your Activation Key, please contact X-Formation Support .
    • If you are downloading the trial version of License Statistics: Fill out the request form as instructed on the License Statistics download page to obtain your download
  2. Start the installer and follow the installation instructions.

  3. Start License Statistics.
  4. Activate the license using Licensing page on UI.

    You may also use an alternative activation method, as described in Activating a License Statistics license.


    Info

    You must re-activate your license whenever you upgrade your license or renew your maintenance.

...

Step 3: Configure License Statistics for your site.

Open the configuration file, xflicstat.cfg, in a text editor such as Notepad. By default, the configuration file automatically opens from the License Statistics installation wizard at the end of the installation, or you can open the configuration file from the X-Formation License Statistics program group at any time. In the configuration file:

  • Change the setting for UPDATE_INTERVAL from 10 minutes to 1 minute, to generate statistics every minute. This setting will let you quickly confirm that License Statistics is running normally, which you'll do in Step 6. (After you verify that License Statistics is running normally, you should change this setting to a larger value.)
  • Wiki Markup
    Uncomment one of the FLEXNET_SERVER lines and enter the information  for the server you want to monitor in the format \[port\]@host, where port  is optional (leave blank to use the default port) and host is the name  or IP address of the license server. For example, FLEXNET_SERVER =  27000@host1. (If you need to monitor more than one server, you can  specify additional servers in the same manner later.)
  • Uncomment the LMUTIL_PATH line and specify the path to your lmutil utility.
  • Save and close the configuration file.

Step 4: Ensure you have the latest lmutil version.

You must use lmutil v9.2 or newer with License Statistics. (You can check your lmutil version on Windows in the file Properties or by running lmutil -v from a command line.) You can request a download of the newest lmutil version from http://www.globes.com/support/fnp_utilities_download.htm.

Step 5: Start the service.

Start the service by selecting Usage Monitor > Start from the X-Formation License Statistics program group. (To stop the service, select Usage Monitor > Stop.)

Step 6: Test that the Usage Monitor is running normally.

  • A couple of minutes after starting the service, review the log file by selecting Troubleshooting > Log File from the X-Formation License Statistics program group. Ensure the log file contains no FAIL or WARNING lines. Output similar to the following indicates the service is running normally:
No Format

[2012-01-02 13:44:50] Ready for querying...
[2012-01-02 13:44:50] To view statistics please go to http://localhost:80
  • Check results in your browser by going to http://localhost:80. The first time you access the License Statistics web interface, your login information is set to username = admin, password = admin.
  • If you don't see the results check if License Statistics web server port specified in the configuration file, which defaults to port 80, is not busy. You can specify a different port as described in this article.

Now you've successfully installed, started, and tested the License Statistics Usage Monitor.

...

  1. Test that License Statistics is running normally by using the Open Browser button in the License Statistics Manager, or by going to http://localhost:80 (or other address matching your configuration). The first time you access the License Statistics web interface, your login credentials will be set to username = admin, password = admin.


Tip

To begin monitoring license servers after a new installation, add the license server(s) to be monitored as instructed in Adding and editing license servers


Tip
  • Make sure you have all the utility executables required by the license servers you will be monitoring, as described in License server dependent requirements.
  • Ensure the utility version corresponds with the license server version. If you don't know which version to use, please contact your vendor.
  • Make sure that 3rd party utilities are always stored outside of the License Statistics installation directory so they will not be removed by the installer upon subsequent installations.

Installing from a command line

Alternatively, you can install/update License Statistics from a command line (or remotely) using the msiexec tool. You must have administrative privileges to use this tool.

The msiexec tool uses the following syntax:

msiexec /i {msi_installer} INSTALLDIR="{path}" /qn

where INTALLDIR is optional (default: C:\Program Files\X-Formation\License Statistics)


For example:

msiexec /i license_statistics_v6.15.1_win64_x64.msi /qn