If VMware Cloud Director on Linux fails or if it is not operating properly, you can examine the log files to determine the cause of the problem.
VMware Global Support routinely requests diagnostic information handling support requests. You can use the vmware-vcd-support
script to collect host log information, and VMware Cloud Director logs. For more information about collecting diagnostic information for VMware Cloud Director, see https://kb.vmware.com/s/article/1026312. When running the vmware-vcd-support
script, the logs might include information about decommissioned or replaced cells with status FAIL. See, https://kb.vmware.com/s/article/71349.
Shortcuts and Bash Environment Variables
Starting with VMware Cloud Director 10.5, you can use the following shortcuts for troubleshooting the VMware Cloud Director on Linux and Bash environment variables to simplify frequently used directory paths.
Environment Variable | Path | Example | Description |
---|---|---|---|
VCLOUD_DATA_TRANSFER |
${VCLOUD_HOME}/data/transfer Where |
cd $VCLOUD_DATA_TRANSFER |
Directory path for appliance cluster management and for providing temporary storage for uploads, downloads, and catalog items that are published or subscribed externally. |
VCLOUD_ETC |
${VCLOUD_HOME}/etc | cd $VCLOUD_ETC |
Directory path containing all configuration files. |
VCLOUD_LOGS |
${VCLOUD_HOME}/logs | cd $VCLOUD_LOGS echo $VCLOUD_LOGS ls -lrtah $VCLOUD_LOGS pushd $VCLOUD_LOGS |
Directory path containing all log files related to VMware Cloud Director |
Shortcut | Description | Use |
---|---|---|
cmt cell-management-tool |
Simplified command to run the cell management tool from anywhere | cell-management-tool --help cmt --help |
cell_pid |
Displays the process identifier of a VMware Cloud Director cell. You can use the process identifier to identify and manage processes within the cell. | cell_pid |
cell_status |
Prints the summary of the cell status. | cell_status |
thread_dump |
Generates a thread dump and prints the dump path. You can use thread dumps to learn more about the thread activity of the VMware Cloud Director installation and identify a deadlock, synchronization, or threading problems. | thread_dump |
heap_dump |
Generates a heap dump and prints the dump path. You can use heap dumps to learn more about the objects that are currently in memory and identify memory related issues. | heap_dump --username administrator_username heap_dump --username administrator_username --password administrator_password |
generate_support_bundle |
Generates log bundles from multiple distributed cells. | generate_support_bundle |