Diagnose licensing issues with log messages
- Last UpdatedDec 03, 2024
- 3 minute read
Use the Log Viewer as a diagnostic tool to gather more information about an issue. You can view logged messages sent to the Logger, to determine whether all processes are functioning properly. Logger is a background process that stores messages in the system log file.
Start the Log Viewer
-
Open the Operations Control Management Console (OCMC). The OCMC appears with the Log Viewer listed in the left pane.
-
Select Log Viewer to expand its groups. The Local group is listed beneath the Default Group.
Alternatively, if you don't have OCMC installed, you can:
-
Navigate to C:\Program Files (x86)\Common Files\ArchestrA.
-
Right-select aaLogViewer.exe, and then select Run as Administrator. Alternatively,double-select aaLogViewer.exe.
-
The User Account Control dialog box appears. Select Yes.
The Log Viewer window appears
For more information about the Log Viewer, refer to the Log Viewer Help.
The Log Flag Editor lists all the AVEVA components installed on the node you selected. Use the Log Flag Editor to assign a flag value to each category of the selected messages issued by a license manager component. By switching flags on or off, you can control which categories of messages are saved to the Logger.
Open the Log Flag Editor
-
Expand the Log Viewer list to show AVEVA nodes.
-
Select the node from the list that you want to enable with logging flags.
-
On the Action menu, select Log Flags.
Set log flags for a single component
-
Select the required component from the Component List view or select Global.
The Log Flags view shows the log flags for the component you selected. If you select Global, all the flags are displayed.
-
In the Log Flags view, select the check boxes of the log flags you want to enable.
-
On the File menu, select Apply. All component messages from the selected categories are logged.
The following table describes different components of License server, License API, and License Manager:
|
Product |
Components |
Log Flag |
Type of Information Logged |
|
License Server |
LicServer |
AELicServerInfo AELicServer |
Logs any error condition related to the initialization and running of the License Server and its dependencies. These log flags also track issues related to grace period entry usually as a result of copying or cloning a License Server running in a virtual machine environment. |
|
LicServer.AgentService |
LicServer SamService |
Logs information related to the publishing of licensing information to asset management clients and information related to controlling of the License Service from License Manager. |
|
|
LicAPI |
LicAPILoader |
AELicensing |
Logs exception messages from software due to input or environment. |
|
LicAPILoader |
Info-Licensing |
Logs informational messages during execution of Licensing operations. For example:
|
|
|
LicAPI |
AELicAcquire |
Logs custom messages during License Acquisition process. |
|
|
LicAPI |
AELicTiming |
Logs total time taken for License Acquisition process. |
|
|
LMWeb |
LicServAPI |
AELicensing |
Informational messages from Licensing operations like capability response created, posted during activation, messages about updating pair status, updating grace period status. |
Open a Log File
-
From the Action menu, select Open Log File.
-
Browse to locate the log file, and select Open.
-
The saved log messages appear in the message window.
For more information on the Log Flag Editor, refer to the Log Flag Editor User Guide.