Page History

If you have any problems installing or running the Usage Monitor, review the log file, described in License Statistics log file, to investigate the cause of the problem.

Inability to query license server

If the log includes the error, "Unable to query license server machine," you should check for communication errors between the license server and the Usage Monitor. To do this, navigate to the License Statistics directory from a command line and enter one of the following commands, depending on whether you are running the command for an LM-X, FLEXlm/FlexNet, IBM LUM, Sentinel LM/RMS, or RLM license server:

For an LM-X license server, type the command:
Wiki Markup
lmxendutil \-licstatxml \[-host
host -port port]
where host and port are the host and port appropriate for your license server. The host and port designations are optional. If the host information is omitted, the local host is used; if the port information is omitted, the default port is used.

For a FLEXlm/FlexNet license server, type the command:
lmutil
Wiki Markup
lmstat \-a \-c \[port\]@
host
lmutil lmdiag -n -c
Wiki Markup
 \[port\]@
host
where port and host are the port and host appropriate for your license server. The port designation is optional; if it is omitted, the default port is used.

For an RLM license server, type the command:
rlmutil
Wiki Markup
rlmstat \-a \-c \[port\]@
hostwhere port and host are the port and host appropriate for your license server. The port designation is optional; if it is omitted, the default port is used.

For a Sentinel LM/RMS license server, type the command:
Wiki Markup
lsmon \[
host]where host is the host appropriate for your license server. The host designation is optional; if it is omitted, the local host is used.

For an IBM LUM license server, type the command:
i4blt -s -lc -k -n host
i4blt -s -lco -k -n host
i4blt -ll -k -n host
where host is the host appropriate for your license server.

If there are errors in the communication between the license server and the Usage Monitor, this command will return information about the errors. Otherwise, the command returns normal statistics information for the indicated license server.

Failure to import log file

When using License Statistics to import data, partial/rotated logs are not supported; if associated checkins/checkouts are not contained in the same log file, the data import may fail. In such cases, you will see an error message such as: "Cannot import log file. Checkin at line 177 references a checkout from an earlier log file. Merge the log files and try again." (Where line 177 is the line that contains the checkin that has no associated checkout contained in the same log file.)

You can try to merge the partial log files into one log file that contains complete checkin/checkout information, as described below.

For Windows, type the following from a command line:

type file1 file2... filen > output.txt

For Linux, type the following in a console:

cat file1 file2... filen > output.txt

where file1 file2... filen are the names of any number of files to be merged and output.txt is the name of the file that will result from the merge.

Apache web server troubleshooting

If you are running License Statistics with an Apache web server and have issues starting Apache, see if the following sections help with the problem.

Apache is not starting for unknown reason

You can attempt to start Apache manually using the following command:

Code Block
LD_LIBRARY_PATH="/usr/xflicstat/apache/lib" /usr/xflicstat/apache/bin/httpd -f /usr/xflicstat/apache/conf/htttpd.conf -d /usr/xflicstat/apache

Note any error message you receive when trying to start Apache so that support can help you further if needed.

Apache is not starting when using RedHat/CentOS

If you use RedHat/CentOS for running LicenseStatistics, and Apache does not start, check the xflicstat.log file. If you see warnings such as "Waiting for httpd process, which takes longer than usual..." the problem is likely due to a configuration problem. RedHat/CentOS distributions often do not have a "nogroup" group, which is configured by default. To fix this, edit the /usr/xflicstat/apache/conf/httpd.conf file as follows:

Code Block
User nobody Group nobody

Apache is not starting when launching License Statistics as a non-root user

If Apache does not start when you attempt to launch License Statistics as a non-root user, and the log contains "Permission denied" warnings like those shown in the example below, this indicates a permissions problem.

Code Block
[Mon Feb 06 09:29:31 2012] [error] [client 127.0.0.1] (13)Permissiondenied: access to / denied [Mon Feb 06 09:32:18 2012] [error] [client 127.0.0.1] (13)Permissiondenied: access to /index.php denied

Warnings such as these likely indicate that you lost proper permissions for the /usr/xflicstat/htdocs directory during the process of copying/extracting the License Statistics files. Apache needs to have privileges for reading/executing files in this directory. Adjust your permissions and try again.

You want to manually configure Apache

If you want to manually configure Apache, you can edit the configuration files located in /usr/xflicstat/apache/conf. The Apache log files are:

...

please review the troubleshooting information for the issue you're experiencing.

LDAP issues

License server issues

Combining realtime and denials data under a single server

Query tool executable error