8.8 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.
In a single-server configuration system, execute this command on the management server. In a multi-server configuration system, execute this command on the management server or database server.
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-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-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.
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
-
-
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: