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