The following steps are designed to get X-Formation's License Statistics up and running on Windows in 10 minutes or less, using a FLEXlm/FlexNet server as an example.
Important: When upgrading License Statistics to a new version:
- Be sure to make a backup (see Backing up and restoring the database) and then copy the License Statistics configuration file (xflicstat.cfg), license file (license.lic), and third-party utilities (for example lmutil.exe) to a safe location.
- Remove the current installation before installing the new version, because the License Statistics will not remove the currently installed version and will not install a new version into the same location as a previous version.
- If you are using an embedded database for License Statistics, you must replace xflicstat.cfg with your previous configuration file and restore your previous database before running the application for the first time.
Step 1: Download and install License Statistics.
Download the License Statistics installation from the License Statistics download page.
- If you have purchased 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.
Note that you can install License Statistics on any machine, not necessarily the license server.
Step 2: Activate the license.
When the installation is complete, the License Activator steps you through activating your license. 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 > Activate License Statistics).
When you activate your license, it generates a license file (*.lic) that you can reuse with new updates of the software (unless you are instructed to update the license for any reason).
In License Activator:
- Select the appropriate option based on whether you are installing License Statistics for the first time, upgrading License Statistics, or running the trial version of License Statistics:
- If you are installing License Statistics for the first time: Enter your Activation Key (sent to you via email). If you cannot locate your activation key, you can find it by going to License Activation Center (LAC) and clicking the link "Get your activation keys" on the LAC login page.
- 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. You can skip the remaining activation steps and continue with Step 3: Configure License Statistics for your site. - Click Next to continue, and then choose to activate the license for the current computer or browse for and select a different computer on which to activate the license.
- Click Next to continue, then click Activate to start the activation.
A final screen displays the progress and success (or failure) of the license activation. When activation is complete, close the License Activator window.
You may activate your license online instead of using License Activator; however, it is strongly recommended to use License Activator whenever possible to avoid activation problems.
Step 3: Configure License Statistics for your site.
To configure license servers to be monitored by License Statistics, see Adding and editing license servers.
When you configure your license servers:
- Change the setting for the query interval time from 10 minutes to 1 minute, to generate statistics every minute while adding your FlexNet server. 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.)
- Specify the path to your lmutil utility if needed.
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 ERROR or WARNING lines that indicate problems with parsing, monitoring servers, or adding or editing license servers. 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 whether the License Statistics web server port specified in the configuration file (which defaults to port 80) is not busy, because you may need to specify a different port, as described in Configuring web server ports.
- After testing License Statistics, be sure to modify the configuration file to change the UPDATE_INTERVAL setting from 1 minute to a larger value, as described in Step 3.