The following steps are designed to get X-Formation's License Statistics up and running on Windows with a FLEXlm/FlexNet server in 10 minutes or less.
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 and install License Statistics.
Download the License Statistics installation from the License Statistics download page.
- If you are downloading a purchased version of License Statistics: Enter your Activation Key to obtain the download. Your Activation Key was included in an email sent to you after purchasing/renewing License Statistics, along with instructions for downloading and installing License Statistics.
- 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.
After the download is complete, an installation wizard will step you through the installation procedure.
Important: You can install License Statistics on any machine, not necessarily the license server.
Step 2: Activate the license.
When the download is complete, a license activation dialog gives you options to run the trial version of License Statistics or activate your license.
- If you have purchased License Statistics: Enter your Activation Key or, if you are upgrading License Statistics, select the option to browse for and select a previously activated license file.
- If you are running the trial version of License Statistics: Select the option to run License Statistics as a trial.
Note that you must re-activate your license whenever you upgrade your license or renew your maintenance. You can open the license activation dialog at any time by clicking Activate License Statistics in the X-Formation License Statistics program group (Start > All Programs > X-Formation > License Statistics).
Step 3: Configure License Statistics for your site.
By default, the License Statistics configuration file, xflicstat.cfg, automatically opens at the end of the installation. You can also 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.)
- 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 License Statistics > Start License Statistics from the X-Formation License Statistics program group. (To stop the service, select License Statistics > Stop License Statistics.)
Step 6: Test that License Statistics 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:
[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.