| 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="diskencryption-startvm">
|
|---|
| 4 | <title>Starting a VM with Encrypted Images</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | When a VM is started using <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>, a dialog will open where
|
|---|
| 9 | the user needs to enter all passwords for all encrypted images
|
|---|
| 10 | attached to the VM. If another frontend like VBoxHeadless is
|
|---|
| 11 | used, the VM will be paused as soon as the guest tries to access
|
|---|
| 12 | an encrypted disk. The user needs to provide the passwords
|
|---|
| 13 | through <userinput>VBoxManage</userinput> using the following
|
|---|
| 14 | command:
|
|---|
| 15 | </p>
|
|---|
| 16 | <pre xml:space="preserve">VBoxManage controlvm <varname>uuid</varname>|<varname>vmname</varname> addencpassword <varname>ID</varname>
|
|---|
| 17 | <varname>password</varname> [--removeonsuspend yes|no]</pre>
|
|---|
| 18 | <p><varname>ID</varname> must be the same as the password
|
|---|
| 19 | identifier supplied when encrypting the images.
|
|---|
| 20 | <varname>password</varname> is the password used when
|
|---|
| 21 | encrypting the images. Optionally, you can specify
|
|---|
| 22 | <codeph>--removeonsuspend</codeph> yes|no to specify whether to
|
|---|
| 23 | remove the password from VM memory when the VM is suspended.
|
|---|
| 24 | Before the VM can be resumed, the user needs to supply the
|
|---|
| 25 | passwords again. This is useful when a VM is suspended by a host
|
|---|
| 26 | suspend event and the user does not want the password to remain
|
|---|
| 27 | in memory.
|
|---|
| 28 | </p>
|
|---|
| 29 | </body>
|
|---|
| 30 |
|
|---|
| 31 | </topic>
|
|---|
