Hitachi

JP1 Version 12 JP1/IT Desktop Management 2 Configuration Guide


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.

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

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: