| 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-linux">
|
|---|
| 4 | <title>Linux: Starting the Watchdog Service With init</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>On Linux, the watchdog service can be automatically started during host boot by adding appropriate parameters to
|
|---|
| 8 | the file <filepath>/etc/default/virtualbox</filepath>. There is one mandatory parameter,
|
|---|
| 9 | <codeph>VBOXWATCHDOG_USER</codeph>, which must be set to the user which will later start the VMs. For backward
|
|---|
| 10 | compatibility you can also specify <codeph>VBOXBALLOONCTRL_USER</codeph>. </p>
|
|---|
| 11 | <p>The parameters in the following table all start with the <codeph>VBOXWATCHDOG_</codeph> prefix string. For
|
|---|
| 12 | example: <codeph>VBOXWATCHDOG_BALLOON_INTERVAL</codeph> and <codeph>VBOXWATCHDOG_LOGSIZE</codeph>. Legacy
|
|---|
| 13 | parameters such as <codeph>VBOXBALLOONCTRL_INTERVAL</codeph> can still be used. </p>
|
|---|
| 14 | <table id="table-vboxwatchdog-config-params">
|
|---|
| 15 | <title><ph conkeyref="vbox-conkeyref-phrases/product-name"/> Watchdog Configuration Parameters</title>
|
|---|
| 16 | <desc><ph conkeyref="vbox-conkeyref-phrases/product-name"/> Watchdog Configuration Parameters</desc>
|
|---|
| 17 | <tgroup cols="3">
|
|---|
| 18 | <thead>
|
|---|
| 19 | <row>
|
|---|
| 20 | <entry>
|
|---|
| 21 | <p>
|
|---|
| 22 | <b outputclass="bold">Parameter</b>
|
|---|
| 23 | </p>
|
|---|
| 24 | </entry>
|
|---|
| 25 | <entry>
|
|---|
| 26 | <p>
|
|---|
| 27 | <b outputclass="bold">Description</b>
|
|---|
| 28 | </p>
|
|---|
| 29 | </entry>
|
|---|
| 30 | <entry>
|
|---|
| 31 | <p>
|
|---|
| 32 | <b outputclass="bold">Default</b>
|
|---|
| 33 | </p>
|
|---|
| 34 | </entry>
|
|---|
| 35 | </row>
|
|---|
| 36 | </thead>
|
|---|
| 37 | <tbody>
|
|---|
| 38 | <row>
|
|---|
| 39 | <entry>
|
|---|
| 40 | <p>
|
|---|
| 41 | <codeph>USER</codeph>
|
|---|
| 42 | </p>
|
|---|
| 43 | </entry>
|
|---|
| 44 | <entry>
|
|---|
| 45 | <p>
|
|---|
| 46 | The user which the watchdog service runs as
|
|---|
| 47 | </p>
|
|---|
| 48 | </entry>
|
|---|
| 49 | <entry>
|
|---|
| 50 | <p/>
|
|---|
| 51 | </entry>
|
|---|
| 52 | </row>
|
|---|
| 53 | <row>
|
|---|
| 54 | <entry>
|
|---|
| 55 | <p>
|
|---|
| 56 | <codeph>ROTATE</codeph>
|
|---|
| 57 | </p>
|
|---|
| 58 | </entry>
|
|---|
| 59 | <entry>
|
|---|
| 60 | <p>
|
|---|
| 61 | Number of log files, 0 disables log rotation
|
|---|
| 62 | </p>
|
|---|
| 63 | </entry>
|
|---|
| 64 | <entry>
|
|---|
| 65 | <p>
|
|---|
| 66 | 10
|
|---|
| 67 | </p>
|
|---|
| 68 | </entry>
|
|---|
| 69 | </row>
|
|---|
| 70 | <row>
|
|---|
| 71 | <entry>
|
|---|
| 72 | <p>
|
|---|
| 73 | <codeph>LOGSIZE</codeph>
|
|---|
| 74 | </p>
|
|---|
| 75 | </entry>
|
|---|
| 76 | <entry>
|
|---|
| 77 | <p>
|
|---|
| 78 | Maximum log file size to trigger rotation, in bytes
|
|---|
| 79 | </p>
|
|---|
| 80 | </entry>
|
|---|
| 81 | <entry>
|
|---|
| 82 | <p>
|
|---|
| 83 | 1MB
|
|---|
| 84 | </p>
|
|---|
| 85 | </entry>
|
|---|
| 86 | </row>
|
|---|
| 87 | <row>
|
|---|
| 88 | <entry>
|
|---|
| 89 | <p>
|
|---|
| 90 | <codeph>LOGINTERVAL</codeph>
|
|---|
| 91 | </p>
|
|---|
| 92 | </entry>
|
|---|
| 93 | <entry>
|
|---|
| 94 | <p>
|
|---|
| 95 | Maximum time interval to trigger log rotation, in
|
|---|
| 96 | seconds
|
|---|
| 97 | </p>
|
|---|
| 98 | </entry>
|
|---|
| 99 | <entry>
|
|---|
| 100 | <p>
|
|---|
| 101 | 1 day
|
|---|
| 102 | </p>
|
|---|
| 103 | </entry>
|
|---|
| 104 | </row>
|
|---|
| 105 | <row>
|
|---|
| 106 | <entry>
|
|---|
| 107 | <p>
|
|---|
| 108 | <codeph>BALLOON_INTERVAL</codeph>
|
|---|
| 109 | </p>
|
|---|
| 110 | </entry>
|
|---|
| 111 | <entry>
|
|---|
| 112 | <p>
|
|---|
| 113 | Interval for checking the balloon size, in
|
|---|
| 114 | milliseconds
|
|---|
| 115 | </p>
|
|---|
| 116 | </entry>
|
|---|
| 117 | <entry>
|
|---|
| 118 | <p>
|
|---|
| 119 | 30000
|
|---|
| 120 | </p>
|
|---|
| 121 | </entry>
|
|---|
| 122 | </row>
|
|---|
| 123 | <row>
|
|---|
| 124 | <entry>
|
|---|
| 125 | <p>
|
|---|
| 126 | <codeph>BALLOON_INCREMENT</codeph>
|
|---|
| 127 | </p>
|
|---|
| 128 | </entry>
|
|---|
| 129 | <entry>
|
|---|
| 130 | <p>
|
|---|
| 131 | Balloon size increment, in megabytes
|
|---|
| 132 | </p>
|
|---|
| 133 | </entry>
|
|---|
| 134 | <entry>
|
|---|
| 135 | <p>
|
|---|
| 136 | 256
|
|---|
| 137 | </p>
|
|---|
| 138 | </entry>
|
|---|
| 139 | </row>
|
|---|
| 140 | <row>
|
|---|
| 141 | <entry>
|
|---|
| 142 | <p>
|
|---|
| 143 | <codeph>BALLOON_DECREMENT</codeph>
|
|---|
| 144 | </p>
|
|---|
| 145 | </entry>
|
|---|
| 146 | <entry>
|
|---|
| 147 | <p>
|
|---|
| 148 | Balloon size decrement, in megabytes
|
|---|
| 149 | </p>
|
|---|
| 150 | </entry>
|
|---|
| 151 | <entry>
|
|---|
| 152 | <p>
|
|---|
| 153 | 128
|
|---|
| 154 | </p>
|
|---|
| 155 | </entry>
|
|---|
| 156 | </row>
|
|---|
| 157 | <row>
|
|---|
| 158 | <entry>
|
|---|
| 159 | <p>
|
|---|
| 160 | <codeph>BALLOON_LOWERLIMIT</codeph>
|
|---|
| 161 | </p>
|
|---|
| 162 | </entry>
|
|---|
| 163 | <entry>
|
|---|
| 164 | <p>
|
|---|
| 165 | Balloon size lower limit, in megabytes
|
|---|
| 166 | </p>
|
|---|
| 167 | </entry>
|
|---|
| 168 | <entry>
|
|---|
| 169 | <p>
|
|---|
| 170 | 64
|
|---|
| 171 | </p>
|
|---|
| 172 | </entry>
|
|---|
| 173 | </row>
|
|---|
| 174 | <row>
|
|---|
| 175 | <entry>
|
|---|
| 176 | <p>
|
|---|
| 177 | <codeph>BALLOON_SAFETYMARGIN</codeph>
|
|---|
| 178 | </p>
|
|---|
| 179 | </entry>
|
|---|
| 180 | <entry>
|
|---|
| 181 | <p>
|
|---|
| 182 | Free memory required for decreasing the balloon size,
|
|---|
| 183 | in megabytes
|
|---|
| 184 | </p>
|
|---|
| 185 | </entry>
|
|---|
| 186 | <entry>
|
|---|
| 187 | <p>
|
|---|
| 188 | 1024
|
|---|
| 189 | </p>
|
|---|
| 190 | </entry>
|
|---|
| 191 | </row>
|
|---|
| 192 | </tbody>
|
|---|
| 193 | </tgroup>
|
|---|
| 194 | </table>
|
|---|
| 195 | </body>
|
|---|
| 196 |
|
|---|
| 197 | </topic>
|
|---|
