Support Tools

Running the Support Script on the ZRM server

ZMC includes a support script that gathers various logs helpful for troubleshooting. It includes options for mailing the logs to the Zmanda Support Team (e-mail must be configured and running on the ZRM server).

To start the script, log in as root and run the following commands:

# cd /opt/zmanda/zrm/bin 
# ./zm-support  

This generates an archive of all the log files in the current directory. The automatically-generated file name will be displayed at the end of zm-support run:

...

/opt/zmc/logs/zmc_gui_debug.log
/opt/zmc/logs/zmc_gui_errors.log
/opt/zmc/logs/zmc_installer_16904.log
/opt/zmc/logs/zmc_server.log
/opt/zmc/mysql/data/mysqld.log
/opt/zmc/apache2/logs/access_log
/opt/zmc/apache2/logs/error_log
/opt/zmc/apache2/logs/httpd.pid
/opt/zmc/apache2/logs/NOTEMPTY

Please send this log file -> zm-logs-ZmandaNetworkAccountID-LogID.tar.g

You can email the file using your regular e-mail mechanism.

Alternatively, use zm-support --ship-to-zmanda to send the logs, assuming e-mail is configured on the Amanda server.

zm-support Options

The --help option generates a usage message. Options are detailed below.

--config ConfigFile1 [, ConfigFile2...] 

Specifies configuration files to include in the archive. By default, all configuration files are archived.

--skip-config ConfigFile1 [, ConfigFile2...] 

Same as above, except this specifies configurations to exclude.

--no-zmc 

Excludes ZMC and related information from the archive.

--no-amanda 

Excludes Amanda and related information from the archive.

--no-mysql-dump 

Excludes the ZMC mysql database from the archive.

--no-mysql-zrm 

Excludes the ZMC mysql-zrm log files from the archive.

--no-var-log-messages 

Excludes the /var/log/messages file from the archive.

-f or --ftp-to-zmanda 

Automatically transfer the archive to Zmanda Support using ftp.

-ship 

Automatically mails the archive to Zmanda Support.

--no-tar

Rather than creating an archive, create a system information file (system-info-timestamp) in the current directory, and list the configurations and logs that should be examined or sent to Zmanda Support.

-v 

List the files as they are gathered. The default to operate silently.

--help 

Display a usage message

Running the Windows Client Support Script

The zwc-support utility collects system log files, log files related to ZWC and system related information. The utility then archives these log files into a single compressed file. This compressed file can be then sent to the Zmanda Support team for analysis.