Table of contents
Running the Support Script
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 Amanda server).
To start the script, log in as root and run the following commands:
# cd /opt/zmanda/amanda/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.
Location
The Zmanda Client for Windows support utility zwc-support.bat gets installed when you install the Zmanda Client for Windows. The default location of the utility is C:\Program Files\Zmanda\Zmanda Client for Windows\bin.
Files Gathered
The following types of log files are gathered by zwc-support:
Zmanda Client for Windows Installation Logs
- C:\amanda_install.log
- C:\amanda_uninstall.log
- C:\Program Files\Zmanda\Zmanda Client for Windows\Debug\LogFile.txt
Zmanda Client for Windows Debug Logs:
- C:\Program Files\Zmanda\Zmanda Client for Windows\Debug\LogFile(n).txt
- Zmanda Client for Windows configuration info
System Logs:
- System-info
- Application and System Logs
Additional information:
- Files and Folders count on all the drives.
- Environment variables list.
Output File
After the utility is run, an output file with the name zwc-logs-datetimestamp.cab is created in the Zmanda installation directory.