Changes between Version 64 and Version 65 of VboxApps

Timestamp:

Mar 24, 2014, 2:26:41 PM (10 years ago)

Author:

davea

Comment:

--

VboxApps

@@ -154 +154 @@
   If missing or zero, the host port number is assigned dynamically, and is written to a file
   '''vbox_port_forward.xml''' in the slot directory.
- '''copy_to_shared''':: file(s) you wish to copy into the shared directory before launch.
+ '''copy_to_shared''':: copy the given file into the shared directory before launch.
   This directive can be used more than once.
+
+== Vboxwrapper command-line options ==
+
+ --trickle X :: Send a trickle message reporting elapsed time every X seconds.
+  Use this for creating granting if needed.
+ -- nthreads N :: Create a virtual machine that will use N cores.
+ --vmimage file :: Use "file" as the VM image.
+   This lets you create an app version with several images,
+   and the app_plan function can decide which one to use for the particular host.
+ -- register_only :: Register the VM but don't run it.  For debugging; see below.
 
 == Creating jobs for VM apps ==
@@ -165 +175 @@
 
 This causes the BOINC client to copy them to and from the '''slot/x/shared/''' directory.
+
+== Debugging VM apps ==
+
+To debug a VM within the BOINC/VboxWrapper framework:
+
+ * Launch BOINC with --exit_before_start
+ * When BOINC exits, launch the VboxWrapper with the register_only
+ * Set the VBOX_USER_HOME environment variable to the vbox directory
+   under the slot directory.
+   This changes where the VirtualBox applications look for the
+   root VirtualBox configuration files.
+   It may or may not apply to your installation of VirtualBox.
+   It depends on where your copy of VirtualBox came from
+   and what type of system it is installed on.
+ * Now Launch the VM using the VirtualBox UI.
+   You should now be able to interact with your VM.
 
 == Premade vboxwrapper executables ==