14.4.1 Checking log files
If a problem occurs, JP1/IT Desktop Management 2 - Agent acquires log data. Check the logs, and then take action. You can view the log contents for each PC.
JP1/IT Desktop Management 2 - Agent collects the following three types of log data about the distribution function, by using Remote Installation Manager:
-
Agent basic log (USER_CLT.LOG file)
-
Log data for the entire JP1/IT Desktop Management 2 - Agent (Windows event log and MAIN.LOG file)
-
Log data relating to automatic change of connection destinations (USER.LOG file)
Use the Windows Event Viewer Windows to check the Windows event log. Use a text editor to check other log files, which are stored in JP1/IT Desktop Management 2 - Agent-installation-directory\log.
The following describes each log file:
- Organization of this subsection
(1) Agent basic log
Basic log messages about agent operations are output to the USER_CLT.LOG file for each PC. We recommend that you first view this file to check the agent operation. This file contains simple messages indicating that each process has started or stopped. If a process fails, the cause of the error is also output to this file.
The following operations cause data to be output to the USER_CLT.LOG file:
-
Starting and stopping products and processes
-
Logon and logoff
-
Receiving a job execution request
-
Polling
-
Receiving and executing jobs
-
Downloading packages
-
Uploading a file
-
Automated registration of system configuration information
-
Registration in and unregisgration from an ID group
-
Packaging
-
Internal error and application exception
For details about the file format and messages, see the manual Job Management Partner 1 Version 10 Job Management Partner 1/IT Desktop Management 2 - Messages.
(2) Log data for the entire JP1/IT Desktop Management 2 - Agent
Log data for the entire JP1/IT Desktop Management 2 - Agent is acquired in the Windows event log and the MAIN.LOG file.
(a) Checking the Windows event log
You can use Event Viewer to check the event log data acquired while using JP1/IT Desktop Management 2 - Agent. In the Log menu of the Event Viewer, you can select Select Computer to check events of other PCs running Windows. For details about how to use the Event Viewer, see the Windows documentation or Help.
Numbers (event IDs) displayed in the Event column in the Event Viewer are equivalent to message IDs. The following describes the meanings of the numbers.
Event ID |
Description |
---|---|
0 to 999 |
Windows interface-related |
1000 to 1999 |
TCP/IP-related |
5000 to 5999 |
Setup-related |
6000 to 6999 |
Packaging-related |
7000 to 7999 |
Installation-related |
8000 to 8999 |
Relay-related |
10000 to 19999 |
Managing server-related |
In the Event Viewer window, double-click an event to display a detailed description of that event.
Depending on the event, memory dump information might be output in event details. If you contact us about JP1/IT Desktop Management 2 - Agent errors, please provide us with this memory dump information also.
For details about event log messages output by JP1/IT Desktop Management 2, see the manual Job Management Partner 1 Version 10 Job Management Partner 1/IT Desktop Management 2- Messages.
(b) Checking the MAIN.LOG file
For each PC, JP1/IT Desktop Management 2 - Agent acquires log data also in the MAIN.LOG file. The following shows the file format.
The meanings of message type and function type displayed in the MAIN.LOG file are as follows.
Message type |
Meaning |
---|---|
Informational |
Information message |
Warning |
Warning message |
Error |
Error message |
Function type |
Meaning |
---|---|
Package |
During packaging (error in JP1/IT Desktop Management 2 - Agent) |
Install |
During installation (error in JP1/IT Desktop Management 2 - Agent) |
Setup |
During installation in GUI installation mode (error in JP1/IT Desktop Management 2 - Agent) |
TCP/IP |
Interface with TCP/IP |
System |
Interface with Windows |
User |
User log (output from the LogFile function of the installation script) |
Server |
During relay (error in JP1/IT Desktop Management 2 - Agent) |
(3) Log data relating to automatic change of connection destinations
If the connection destination of an agent is automatically set or changed based on the information file for higher connection destinations, log data for each PC is collected in the USER.LOG file. The following shows the format of the USER.LOG file.
The following shows the meaning of message text displayed in the message is as follows:
Message text |
Meaning |
---|---|
Match [smallest-ID-address]-[largest-ID-address]:Change [old-connection-destination:product-type-of-old-connection-destination]->[new-connection-destination:product-type-of-new-connection-destination] |
The connection destination of the agent was changed normally. |
Match [smallest-ID-address]-[largest-ID-address]:No Changed [existing-connection-destination:type-of-existing-connection-destination] |
The connection destination that has already been set matches the definition in the information file for higher connection destinations. The connection destination does not change. |
No Match IP Address List, No Changed [existing-connection-destination: product-type-of-existing-connection-destination] |
The IP address of the agent is not found in the definition of the information file for higher connection destinations. The connection destination does not change. |
Not exist No.[order-of-the-item] Value: LineNo[line-number] |
In the line [line-number] in the information file for higher connection destinations, the nth item (n is indicated by order-of-the-item) is not specified. The definition of this line is invalid. |
IP Address is not available:"[specified-value]" :LineNo[line-number] |
In the line [line-number] in the information file for higher connection destinations, an invalid IP address is specified. The definition of this line is invalid. |
Higher manager value is over 64 character:"[specified-value]" :LineNo[line-number] |
In the line [line-number] in the information file for higher connection destinations, more than 64 single-byte characters are specified as the connection destination. The definition of this line is invalid. |
Connection type value is not "netmdm" or "netmdmw":"[specified-value]" :LineNo[line-number] |
In the line [line-number] in the information file for higher connection destinations, a value other than netmdm and netmdmw is specified as the device type of the connection destination. The definition of this line is invalid. |
Match [smallest-ID-address]-[largest-ID-address]:Change Multicast IP Address [old-multicast-address]->[new-multicast-address] |
The multicast address of the agent was changed normally. |
Match [smallest-ID-address]-[largest-ID-address]:No Changed Multicast IP Address [multicast-address] |
The multicast address that has already been set matches the definition in the information file for higher connection destinations. The multicast address does not change. |
Multicast IP Address is not available:"[multicast-address]":LineNo[line-number] |
In the line [line-number] in the information file for higher connection destinations, an invalid multicast address is specified. The definition of this line is valid, except for the multicast address setting. |
Multicast IP Address is under 224.0.0.0:"[specified-value]":LineNo[line-number] |
In the line [line-number] in the information file for higher connection destinations, a multicast address smaller than 224.0.0.0 is specified. The definition of this line is valid, except for the multicast address setting. |
Multicast IP Address is over 239.255.255.255:"[specified-value]":LineNo[line-number] |
In the line [line-number] in the information file for higher connection destinations, a multicast address larger than 239.255.255.255 is specified. The definition of this line is valid, except for the multicast address setting |
Use Option "MultiBoard Environment": Not Execution |
Automatic change of connection destinations is disabled because the network adapter has been configured during setup of the agent. |
Match [smallest-ID-address]-[largest-ID-address]:Clear SubHostName [registry-number] |
The connection destination that has already been set and that does not match the definition in the information file for higher connection destinations was deleted from the registry. |
Match [smallest-ID-address]-[largest-ID-address]:Clear SubServiceName [registry-number] |
For the connection destination that has already been set, the device type that does not match the definition in the information file for higher connection destinations was deleted from the registry. |
Match [smallest-ID-address]-[largest-ID-address]:Changed Multi Server Option [YES|NO] |
Settings to perform polling for multiple higher systems were changed normally. If polling to multiple higher systems is performed, YES is displayed. If not, NO is displayed. |