Troubleshooting - Overview
When you experience problems with Licence Manager, there are several activities you can perform to help you identify the problem. Two key activities are:
- reviewing the Licence Manager log file
You can open the log file in Licence Manager or from Windows Explorer. To open the log file in Licence Manager, choose View > Log. To open the log file from Windows Explorer, browse to the location where the log file is saved. The default location is C:\Users\Public\GEOVIA\LicenceManager\share\etc\ssilm.log.
- temporarily turning on user function logging (which logs each function that a user runs from a GEOVIA program)
To turn on user function logging, choose Edit > Properties and select the Function Logging check box. Alternatively, you can use a text editor to modify the configuration file. The default location for the configuration file is also C:\Users\Public\GEOVIA\LicenceManager\share\etc\ssilm.cnf.
Most errors that cause Licence Manager to fail are recorded in the log file. The log file is the first place you check when you experience an issue. When trying to troubleshoot possible problems:
- Examine the log file and include it with any queries to your local GEOVIA support office.
- Start the Licence Manager service from the Service > Start function.
To start the Licence Manager service, you require Administrator permissions. - Run NetworkLicenceManager.exe from the command prompt instead of as a service.
Running NetworkLicenceManager.exe from the command prompt allows you to see errors that do not usually appear in the log file. Depending your computer setup, you might require Administrator permissions.When you install Licence Manager with a GEOVIA program, the NetworkLicenceManager.exe is installed in the \bin directory of your GEOVIA program. For the path, see Licence Manager Folder Paths. When you run NetworkLicenceManager.exe without parameters, you get a list of the command-line options available. To start a server, try using NetworkLicenceManager.exe -server, which generates error messages when something is going wrong.
- Run the Licence Manager as a pseudo-client, which enables you to see whether the Licence Manager server is granting licences.
By running the Licence Manager server as a pseudo‑client, you can determine whether a separately running Licence Manager is granting licences correctly. If this method works but the GEOVIA program is still not working correctly, you know that the problem is not because the Licence Manager server is incorrectly configured.For example, to run a pseudo-client that pretends to be Surpac 6.0, in a command prompt type:
networklicencemanager -client surpac2 6.0 -lm <licence-server>
Note: Licence Manager recognizes surpac2 as the program name for Surpac. You can try this same command with the name of any program and version in Licence Manager. If the process finishes running immediately, and you can type more characters in the command prompt, it means that the licence server you specified for Surpac 6.0 is not correctly serving licences.
If the process continues running, and you cannot type in the command prompt, it means that the licence server is serving licences.
Note: To interrupt the process, press Ctrl+C.