17.30 getlogs (collecting troubleshooting information)
Functionality
This command collects troubleshooting information required by the support service in batch when you encounter a problem with an unknown cause or unresolved issues.
The troubleshooting information is output to two files: tsinf_1st.dat for primary use, and tsinf_2nd.dat for secondary use.
When you execute the getlogs command on a management relay server, you also acquire troubleshooting information on the agents for the management relay server. Troubleshooting information on the agents for the management relay server is stored in JP1/IT Desktop Management 2 installation destination folder \mgr\log. For details, see the description on troubleshooting during agent installation in the JP1/IT Desktop Management 2 Configuration Guide.
Execute this command on the management server or a computer on which Remote Install Manager is installed.
Format
getlogs[ -f troubleshooting-information-storage-folder]
Argument
- -f troubleshooting-information-storage-folder
-
Specify the absolute path to the storage folder for troubleshooting information. Only a folder in a local drive can be specified.
To specify a path containing a space, enclose the strings with double quotation marks ("). Specify a folder name that is 150 bytes or fewer in length, and exclude the backslash (\) at the end of the folder name. All characters that Windows systems allow for folder names are acceptable.
If this argument is not specified, the troubleshooting information is stored into the following folder:
JP1/IT Desktop Management 2-installation-folder\mgr\troubleshoot
A temporary folder tsinf is created under the troubleshooting information folder when collecting information. It is deleted when the command is completed.
Storage location
JP1/IT Desktop Management 2-installation-folder\mgr\bin\
You can execute this command without specifying a storage location for the executable file, by using the command prompt provided by JP1/IT Desktop Management 2.
Notes
-
If the storage folder for the troubleshooting information already contains one or more of the following folders or files, the command cannot be not executed until the folder or the file is deleted:
-
tsinf folder
-
tsinf_1st.dat
-
tsinf_2nd.dat
However, when using task scheduler, if the folders or files described above exist, getlogs command execution will fail. Therefore, perform the execution after deleting the troubleshooting information.
-
-
The getlogs command uses a temporary folder which is set in the user environment variables TEMP. If a message (KDEX4041-E) is returned on getlogs command execution, check if there is enough space in this folder.
Return value
The following table shows the return values of the getlogs command.
Return value |
Description |
---|---|
0 |
The command finished normally. |
1 |
Collecting troubleshooting information partially failed. |
11 |
The format for specifying the command arguments is invalid. |
12 |
The specified folder is invalid, or the folder does not exist. |
51 |
You do not have the permissions to execute this command. |
101 |
Command execution was interrupted due to some other error. |
Example
The following example shows use of this command to collect troubleshooting information into C:\tmp\troubleshoot.
getlogs -f C:\tmp\troubleshoot
Related Topics: