Commands Reference, Volume 1

ctsnap Command

Purpose

Gathers configuration, log, and trace information about the Reliable Scalable Cluster Technology (RSCT) components.

Syntax

ctsnap[-h][-doutput_directory]

Description

The ctsnap command gathers configuration, log, and trace information about the RSCT components that are installed with the base operating system. The ctsnap command collects data only on the local node on which it (ctsnap) is running. Depending on the products that are installed, the following components may be included:

Audit log resource manager (IBM.AuditRM)
Cluster security services (ctsec)
Configuration resource manager (IBM.ConfigRM)
Domain management server resource manager (IBM.DMSRM)
Event management (ha_em)
Event response resource manager (IBM.ERRM)
File system resource manager (IBM.FSRM)
First failure data capture (ct_ffdc)
Group services (cthags)
Host resource manager (IBM.HostRM)
Resource monitoring and control (ctrmc)
Sensor resource manager (IBM.SensorRM)
Topology services (cthats)

This command is typically run when a problem is encountered with any of these components in order to provide information to your software service organization.

The output of ctsnap is a compressed tar file (ctsnap.host_name.nnnnnnnn.tar.Z) and a log file (ctsnap.host_name.nnnnnnnn.log, where nnnnnnnn is the timestamp when the ctsnap command was run and host_name is the name of the host on which the command is running. Both files should be provided to the software service organization. By default, these files are placed in the /tmp/ctsupt directory.

Flags

-d output_directory: Identifies the output directory (The default directory is /tmp/ctsupt).
-h: Writes the command's usage statement to standard output.

Security

Privilege control: only the root user can run this command.

Exit Status

0: Command has run successfully.
1: Command was not successful.

Restrictions

This command applies to the cthags and cthats subsystems only.

Standard Output

When the -h flag is specified, this command's usage statement is written to standard output.

Standard Error

Error messages are written to standard error (and to the ctsnap.host_name.nnnnnnnn.log file).

Examples

To gather RSCT support information, enter:
```
ctsnap
```
To gather RSCT support information and place it in the /tmp/mydir directory, enter:
```
ctsnap -d /tmp/mydir
```

Location

/usr/sbin/rsct/bin/ctsnap: Contains the ctsnap command

Files

/tmp/ctsupt: Location of the default directory that contains the output files.
/tmp/ctsupt/ctsnap.host_name.nnnnnnnn.log: Location of the log file of the command execution, where nnnnnnnn is a timestamp and host_name is the name of the host on which the command is running.
tmp/ctsupt/ctsnap.host_name.nnnnnnnn.tar.Z: Location of the compressed tar file that contains the collected data, where nnnnnnnn is a timestamp and host_name is the name of the host on which the command is running.

Related Information

Commands: lssrc