This quick-start guide is
designed to get X-Formation's License Statistics up and
running in 10 minutes or less. Please see the License Statistics Manual for more detailed information.
Step 1: Extract the download file contents.
Extract the License Statistics
zip file contents. Use the /usr/xflicstat directory to limit configuration
changes to those given in Step 3.
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 demo versions. If you have a demo version of License
Statistics, please continue to Step 3.
After
the installation is complete, activate your License Statistics license as described in Activating a License Statistics License.
Important: License Statistics will not run until the license is activated.
Note
that you must re-activate your license whenever you upgrade your
license or renew your maintenance.
Step 3: Configure License Statistics for your site.
Open usr/xflicstat/xflicstat.cfg in a text editor such as Notepad, and make the following changes:
- 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.)
- 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.) 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.
Run the Usage Monitor as a daemon by entering the following command from a Unix command line:
xflicstat –b /path/configfile
where /path/configfile is the full path to the Usage Monitor configuration file; for example:
xflicstat –b ./xflicstat.cfg
Step 6: Test that the Usage Monitor is running normally.
- A
couple of minutes after starting the service, review the log file (usr/xflicstat/log/xflicstat.log) and ensure it
contains no FAIL or WARNING lines. Output similar to the following
indicates the service is running normally:
[2006-11-02 13:44:50] Ready for querying...
[2006-11-02 13:44:50] Starting monitor of @127.0.0.1!
- Check results in your browser by going to http://localhost:80.
- If
you don't see the results, check to ensure that an anti-virus program
or other setting (such as the License Statistics web server port
specified in the configuration file, which defaults to port 80) is not
stopping the software from writing files.
Now you've successfully installed, started, and tested the License Statistics Usage Monitor.
If you have problems you cannot solve using this guide or the License Statistics Manual, contact us at support@x-formation.com. Please include both your configuration file and your log file in your email to help us resolve the problem.