Description
Use the
tacmd pdcollect command to remotely
execute the pdcollect script in the specified host computer and transfer
the resultant pdcollect file to the local computer. If no host is
specified, the local host is run. This command can collect eWas log
files and the
CANDLEHOME/config/.ConfigData
directory.
Note: If this command terminates abnormally, the
temporary folder remains and needs to be cleaned manually.
CLI syntax
tacmd pdcollect
[ {-s|--server} [ {smb|ssh|rexec|rsh}:// ] HOST [ :PORT ] ]
[{-u|--username} USERNAME]
[{-p|--password} PASSWORD]
[{-c|--candlehome} CANDLEHOME]
[{-d|--directory} LOCAL_TAR_DIRECTORY]
[{-o|--options} PD_OPTION...]
[ {-a|--archivename} FILENAME ]
[ {-f|--force} ]
[ {-m|--migrate-export} ]
where:
- -s|--server
- Identifies the server on which to execute the pdcollect script.
Optionally, a specific connection protocol and a port can be specified.
By default, all supported protocols are attempted until a connection
is successfully established on one of them. The only valid protocols
for this argument are SMB|SSH|REXEC|RSH.
Note: -u and -p
options are required if -s option is specified with a value different
from localhost.
- -u|--username
- A valid user log in ID on the specified host. The software prompts
you for the username if you do not specify one. The user name is not
required if the command is executed locally.
Note: -u and
-p options are required if -s option is specified with a value different
from localhost.
- -p|--password
- The password for the specified username. The software prompts
you for the password if you do not specify one. The password is not
required if the command is executed locally.
Note: -u and
-p options are required if -s option is specified with a value different
from localhost.
- -d|--directory
- The desired location to put the transferred file in the local
computer. If not specified, it is placed in the local temp folder.
The CANDLEHOME directory should not be used
as the local directory path.
- -c|--candlehome
- The candlehome directory used to execute the pdcollect script.
If not specified, the path "C:\IBM\ITM" is used as candlehome in Windows systems
and "/opt/ibm/itm" is used in UNIX systems. Provide the directory path with double
quotation marks.
- -o|--options
- The options to change default command behavior can be any of
the following options separated by spaces, in any order or case:
- noapp
- Specifies that application event log data is not to be collected.
- nosec
- Specifies that security event log data is not to be collected.
- nosys
- Specifies that system event log data is not to be collected.
- noevent
- Specifies that no event log data is to be collected. Equivalent
to specifying noapp, nosec and nosys.
- nohist
- Specifies that history files are not to be collected.
- nologs
- Specifies that IBM Tivoli Monitoring log and trace files are
not to be collected. If nologs is specified, neither audit logs are
collected.
- noprompt
- Specifies that all interactions with the user are suppressed.
- noaudit
- Specifies that IBM Tivoli Monitoring audit log files are not
to be collected.
Note: The options noapp, nosec, nosys, and noevent
apply only if the target machine is Windows.
- -a|--archivename
- The desired archive file name. Specify the file name without
the extension. If the archive file is needed for a PMR, the suggested
archive name is the PMR number associated with the logs being collected.
Example: 62064,499,000. If not specified, the default archive name
is pdcollect-HOSTNAME. This -a|--archivename option does not support
specifying the file path. To specify the destination of the transferred
file, the -d|--directory option must be used in conjunction with the
-a|--archivename option.
- -f|--force
- Specifies that all interaction with you is suppressed. If not
specified, you are prompted before archiving the collected files.
- -m|--migrate-export
- Executes the migrate-export script before collecting data.
CLI example
This example is used to invoke the pdcollect script on the remote
computer demerzel, transfer the resultant tar file to the local computer,
and place it under the "
c:\demerzel" directory.
tacmd pdcollect -s demerzel.tivlab.austin.ibm.com -u root -p bug2app3r
-c /opt/IBM/ITM -d “c:\demerzel” -o nosys noevent
Related commands
Return to Table 1.