| 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="vboxwatchdog-hostisln">
|
|---|
| 4 | <title>Host Isolation Detection</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>To detect whether a host is being isolated, that is, the host cannot reach the <ph
|
|---|
| 8 | conkeyref="vbox-conkeyref-phrases/product-name"/> server instance anymore, the host needs to set an alternating
|
|---|
| 9 | value to a global extradata value within a time period. If this value is not set within that time period a timeout
|
|---|
| 10 | occurred and the so-called host isolation response will be performed to the VMs handled. Which VMs are handled can
|
|---|
| 11 | be controlled by defining VM groups and assigning VMs to those groups. By default no groups are set, meaning that
|
|---|
| 12 | all VMs on the server will be handled when no host response is received within 30 seconds. </p>
|
|---|
| 13 | <p>Set the groups handled by the host isolation detection using the following command line: </p>
|
|---|
| 14 | <pre xml:space="preserve">--apimon-groups=<string[,stringN]></pre>
|
|---|
| 15 | <p>Using a global extradata value, as follows: </p>
|
|---|
| 16 | <pre xml:space="preserve">VBoxManage setextradata global VBoxInternal2/Watchdog/APIMonitor/Groups <string[,stringN]></pre>
|
|---|
| 17 | <p>Set the host isolation timeout using the following command line: </p>
|
|---|
| 18 | <pre xml:space="preserve">--apimon-isln-timeout=<ms></pre>
|
|---|
| 19 | <p>Using a global extradata value, as follows: </p>
|
|---|
| 20 | <pre xml:space="preserve">VBoxManage setextradata global VBoxInternal2/Watchdog/APIMonitor/IsolationTimeoutMS <ms></pre>
|
|---|
| 21 | <p>Set the actual host isolation response using the following command line: </p>
|
|---|
| 22 | <pre xml:space="preserve">--apimon-isln-response=<cmd></pre>
|
|---|
| 23 | <p>Using a global extradata value, as follows: </p>
|
|---|
| 24 | <pre xml:space="preserve">VBoxManage setextradata global VBoxInternal2/Watchdog/APIMonitor/IsolationResponse <cmd></pre>
|
|---|
| 25 | <p>The following response commands are available: </p>
|
|---|
| 26 | <ul>
|
|---|
| 27 | <li>
|
|---|
| 28 | <p><codeph>none</codeph>. This has no effect.
|
|---|
| 29 | </p>
|
|---|
| 30 | </li>
|
|---|
| 31 | <li>
|
|---|
| 32 | <p><codeph>pause</codeph>. Pauses the execution of a VM.
|
|---|
| 33 | </p>
|
|---|
| 34 | </li>
|
|---|
| 35 | <li>
|
|---|
| 36 | <p><codeph>poweroff</codeph>. Shuts down the VM by pressing
|
|---|
| 37 | the virtual power button. The VM will not have the chance of
|
|---|
| 38 | saving any data or veto the shutdown process.
|
|---|
| 39 | </p>
|
|---|
| 40 | </li>
|
|---|
| 41 | <li>
|
|---|
| 42 | <p><codeph>save</codeph>. Saves the current machine state and then powers off the VM. If
|
|---|
| 43 | saving the machine state fails the VM will be paused. </p>
|
|---|
| 44 | </li>
|
|---|
| 45 | <li>
|
|---|
| 46 | <p><codeph>shutdown</codeph>. Shuts down the VM in a gentle
|
|---|
| 47 | way by sending an <codeph>ACPI</codeph> shutdown event to
|
|---|
| 48 | the VM's operating system. The OS then has the chance of
|
|---|
| 49 | doing a clean shutdown.
|
|---|
| 50 | </p>
|
|---|
| 51 | </li>
|
|---|
| 52 | </ul>
|
|---|
| 53 | </body>
|
|---|
| 54 |
|
|---|
| 55 | </topic>
|
|---|
