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