A.9.1 acmcapture (troubleshooting data collection command)

NAME

acmcapture - Collection of AdvancedCopy Manager troubleshooting data

SYNOPSIS

Solaris and Linux versions

/opt/FJSVccm/bin/acmcapture dirname

Windows version

<AdvancedCopy Manager CCM program directory>\bin\acmcapture.bat dirname

DESCRIPTION

This command collects AdvancedCopy Manager troubleshooting data. Data is collected for all AdvancedCopy Manager components installed on the server where this command is executed.

[Format of the filename or directory name for the troubleshooting data]

[For Solaris]
The collected data is stored in a file with the "acmcapture_HOSTNAME_YYYYMMDD_ttmmss.tar.Z" format under the directory specified for "dirname".
[For Linux]
The collected data is stored in a file with the "acmcapture_HOSTNAME_YYYYMMDD_ttmmss.tar.gz" format under the directory specified for "dirname".
[For Windows]
The collected data is stored in a directory with the "acmcapture_HOSTNAME_YYYYMMDD_ttmmss" format under the directory specified for "dirname".

The name of the host where the command is executed is used for HOSTNAME. If characters other than alphanumeric and hyphens are used in the host name, then "NOHOSTNAME" is used as the host name. Values are truncated to 15 characters.

For YYYYMMDD, YYYY is the year, MM is the month, and DD is the day.
For ttmmss, tt is the hour, mm is minutes, and ss is seconds.

OPERANDS

dirname

Directory where the troubleshooting data is stored.

Specify a directory with plenty free space - 500MB or more is recommended. Regard 500MB as a rough guide, since the size of the troubleshooting data will vary depending on the system environment and conditions. If there is not enough free space, then this command will terminate abnormally without collecting troubleshooting data.

Specify an existing directory, otherwise this command will terminate abnormally without collecting troubleshooting data.

EXIT STATUS

=0 : Completed successfully
>0 : Terminated abnormally

EXAMPLES

[For Solaris]

Collect data to the /tmp directory.

# acmcapture /tmp
Executing.........................................
Completed.
OUTPUT=/tmp/acmcapture_srv01_20090323_094614.tar.Z

[For Linux]

Collect data to the /tmp directory.

# acmcapture /tmp
Executing.........................................
Completed.
OUTPUT=/tmp/acmcapture_srv01_20090323_094614.tar.gz

[For Windows]

Collect data to the C:\temp directory.

C:¥> acmcapture.bat C:\temp
Executing.........................................
Completed.
OUTPUT=C:\temp\acmcapture_srv01_20090323_094614

NOTES

For systems with a cluster configuration, please mount the shared disk by either of node. to gather information on the shared disk.
And execute this command. at both nodes.
Execute this command when other AdvancedCopy Manager commands are in the stopped state. Data collection may not be performed correctly if other AdvancedCopy Manager commands are running.