Log Collection Utility cloud-bugtool
255
22.3. Log Collection Utility cloud-bugtool
CloudPlatform provides a command-line utility called cloud-bugtool to make it easier to collect the logs
and other diagnostic data required for troubleshooting. This is especially useful when interacting with
Citrix Technical Support.
You can use cloud-bugtool to collect the following:
• Basic system and environment information and network configuration including IP addresses,
routing, and name resolver settings
• Information about running processes
• Management Server logs
• System logs in /var/log/
• Dump of the cloud database
Warning
cloud-bugtool collects information which might be considered sensitive and confidential. Using
the --nodb option to avoid the cloud database can reduce this concern, though it is not
guaranteed to exclude all sensitive data.
22.3.1. Using cloud-bugtool
Log in as root on any compute node where CloudPlatform has been installed.
To gather all the possible troubleshooting data, run cloud-bugtool with no arguments:
# /usr/share/cloudstack-management/util/cloud-bugtool
The output is written to a .zip file. The location of this file is displayed on the console.
You can also use command-line options to specify which data will be collected:
• -f, --full : Collects all the data.
• -m, --minimal : Collects only system properties and the most recent log files.
• -d, --nodb : Does not collect the cloud database dump.
To display the current list of options on standard output, run cloud-bugtool with the command-line
option -h or --help.
22.4. Data Loss on Exported Primary Storage
Symptom
Loss of existing data on primary storage which has been exposed as a Linux NFS server export on an
iSCSI volume.