Support Tools

Using the Zmanda Troubleshooting Scripts

Licensed users can collect and send troubleshooting information directly to the Zmanda Support Team using convenient scripts located on ZRM servers and Windows clients.

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.

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.