| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="ts_vboxbugreport">
|
|---|
| 4 | <title>Using the VBoxBugReport Command to Collect Debug Information
|
|---|
| 5 | Automatically</title>
|
|---|
| 6 |
|
|---|
| 7 | <body>
|
|---|
| 8 | <p>
|
|---|
| 9 | The <userinput>VBoxBugReport</userinput> command is used to collect
|
|---|
| 10 | debug information automatically for an <ph conkeyref="vbox-conkeyref-phrases/product-name"/>
|
|---|
| 11 | installation. This command can be useful when you need to gather
|
|---|
| 12 | information to send to Oracle Support.
|
|---|
| 13 | </p>
|
|---|
| 14 | <p>
|
|---|
| 15 | The following examples show how to use
|
|---|
| 16 | <userinput>VBoxBugReport</userinput>.
|
|---|
| 17 | </p>
|
|---|
| 18 | <p>
|
|---|
| 19 | By default, the command collects <userinput>VBoxSVC</userinput>
|
|---|
| 20 | process logs, device settings, and global configuration data for
|
|---|
| 21 | an <ph conkeyref="vbox-conkeyref-phrases/product-name"/> host.
|
|---|
| 22 | </p>
|
|---|
| 23 | <pre xml:space="preserve">$ VBoxBugReport
|
|---|
| 24 | ...
|
|---|
| 25 | 0% - collecting VBoxSVC.log.10...
|
|---|
| 26 | 7% - collecting VBoxSVC.log.9...
|
|---|
| 27 | ...
|
|---|
| 28 | 64% - collecting VBoxSVC.log.1...
|
|---|
| 29 | 71% - collecting VBoxSVC.log...
|
|---|
| 30 | 78% - collecting VirtualBox.xml...
|
|---|
| 31 | 85% - collecting HostUsbDevices...
|
|---|
| 32 | 92% - collecting HostUsbFilters...
|
|---|
| 33 | 100% - compressing...
|
|---|
| 34 |
|
|---|
| 35 | Report was written to '2019-03-26-13-32-02-bugreport.tgz'</pre>
|
|---|
| 36 | <p>
|
|---|
| 37 | The results are saved as a compressed tar file archive in the
|
|---|
| 38 | same directory where the command is run.
|
|---|
| 39 | </p>
|
|---|
| 40 | <p>
|
|---|
| 41 | To specify a different output file location:
|
|---|
| 42 | </p>
|
|---|
| 43 | <pre xml:space="preserve">$ VBoxBugReport --output ~/debug/bug004.tgz</pre>
|
|---|
| 44 | <p>
|
|---|
| 45 | To output all debug information to a single text file, rather
|
|---|
| 46 | than a <filepath>tgz</filepath> file:
|
|---|
| 47 | </p>
|
|---|
| 48 | <pre xml:space="preserve">$ VBoxBugReport --text</pre>
|
|---|
| 49 | <p>
|
|---|
| 50 | To collect information for a specific VM, called
|
|---|
| 51 | <codeph>Windows_10</codeph>:
|
|---|
| 52 | </p>
|
|---|
| 53 | <pre xml:space="preserve">$ VBoxBugReport Windows_10</pre>
|
|---|
| 54 | <p>
|
|---|
| 55 | This command collects machine settings, guest properties, and
|
|---|
| 56 | log files for the specified VM. Global configuration information
|
|---|
| 57 | for the host is also included.
|
|---|
| 58 | </p>
|
|---|
| 59 | <p>
|
|---|
| 60 | To collect information for several VMs, called
|
|---|
| 61 | <codeph>Windows_7</codeph>, <codeph>Windows_8</codeph>, and
|
|---|
| 62 | <codeph>Windows_10</codeph>:
|
|---|
| 63 | </p>
|
|---|
| 64 | <pre xml:space="preserve">$ VBoxBugReport Windows_7 Windows_8 Windows_10</pre>
|
|---|
| 65 | <p>
|
|---|
| 66 | To collect information for all VMs:
|
|---|
| 67 | </p>
|
|---|
| 68 | <pre xml:space="preserve">$ VBoxBugReport --all</pre>
|
|---|
| 69 | <p>
|
|---|
| 70 | To show a full list of the available command options, run
|
|---|
| 71 | <userinput>VBoxBugReport --help</userinput>.
|
|---|
| 72 | </p>
|
|---|
| 73 | </body>
|
|---|
| 74 |
|
|---|
| 75 | </topic>
|
|---|
