snapshot.py

Use this script as a debugging tool to troubleshoot system errors. It records a snapshot of the current state of the machine.

Overview

Run this script manually to generate debugging information before restarting the instance.

Usage

Run this script as follows:

Options

The following options are available for the snapshot.py script:

-h|--help
Provides information on using the script.
--extra
An arbitrary command whose output should be placed in the generated log file. For example, you can have snapshot.py execute the lsof command like this:
--extra '/usr/sbin/lsof -n -P -b -i -U'

Enclose commands with options in quotes.

-v|--verbose
Provides output on the actions performed by the script.
Note: The output from snapshot.py is written to a log file in the [LOG_DIR]/runtime directory. Use the output (snapshot.log) to troubleshoot any system or CollabNet related errors.

Cluster location

Important: The snapshot.py script generates a log file for the node on which it is run. When a CollabNet site is deployed on a cluster and you need information to troubleshoot problems, it is recommended that you run this script on all the nodes.