From bc61bb3302db1d517281a6876428f9f0c09026ef Mon Sep 17 00:00:00 2001
From: Tino Lippold <Tino.Lippold@de.bosch.com>
Date: Mon, 31 May 2021 12:05:31 +0000
Subject: [PATCH] Update virtual box guide
Signed-off-by: Tino Lippold <Tino.Lippold@de.bosch.com>
---
content/guides/virtualbox.md | 39 ++++++++++++++++++++++++++++++++----
1 file changed, 35 insertions(+), 4 deletions(-)
diff --git a/content/guides/virtualbox.md b/content/guides/virtualbox.md
index d07e9bfae..309982e6b 100644
--- a/content/guides/virtualbox.md
+++ b/content/guides/virtualbox.md
@@ -95,9 +95,11 @@ For instructions on uninstalling VirtualBox, are also provided in the [user manu
# VirtualBox Setup
-VirtualBox can be configured both from its GUI or via the command line.
+VirtualBox can be configured as follows:
+- option A: from its GUI
+- option B: via the command line
-## From the VirtualBox GUI
+## Option A: From the VirtualBox GUI
- If you have not already downloaded an Apertis SDK image, the
[images]({{< ref "images.md" >}}) page contains information regarding the
@@ -114,7 +116,9 @@ VirtualBox can be configured both from its GUI or via the command line.
- Go to `Machine` â–¸ `New` or click the **New** Icon. This launches the **Create
New Virtual Machine** screen.
-- Enter a name and select the following from the menus:
+- Enter a name and select type and version from the menus:
+ - Name: recommendation is to use the format
+ `Apertis $RELEASE.$REVISION SDK` e.g. `Apertis v2020.0 SDK`
- Type: `Linux`
- Version: `Debian (64 bit)`
@@ -164,7 +168,7 @@ might crash).
If you would like additional information about creating a new virtual machine you can find it in the [VirtualBox manual](https://www.virtualbox.org/manual/ch01.html#gui-createvm)
{{% /notice %}}
-## From the Command Line
+## Option B: From the Command Line
- Run the following commands:
@@ -232,6 +236,9 @@ enable full screen rendering within VirtualBox SDK images. Full screen is not
the only reason to install guest additions, though. Shared folders are another
very handy feature.
+Before starting installation of the Guest Additions it might be helpful to adapt the
+[keyboard layout]( {{< ref "sdk-usage.md#change-the-keyboard-layout" >}} ).
+
## Installation
{{% notice info %}}
@@ -296,6 +303,30 @@ E.g:
This command will mount the share folder to the current `/mnt`.
+Beside the manual mounting of the shared folder it is possible to enable the automatic mounting.
+Please set a tick mark for the `Auto-mount` option and provide a mount path e.g. `/mnt/vmshare`.
+In order to access the mount path with user access rights you have to call
+
+ $ sudo usermod -a -G vboxsf "$USER"
+
+and reboot your virtual machine afterwards. See also the [VirtualBox manual](http://www.virtualbox.org/manual/ch04.html).
+
+## Setting up shared clipboard
+
+Via the shared clipboard functionality the clipboard of the guest OS can be shared with that of your host.
+Enter the **Shared Clipboard** menu item by opening the **Devices** menu of the virtual machine.
+Then select the mode according your needs, recommendation is **Bidirectional** because this will always make
+sure that both clipboards contain the same data. Further information can be found in the
+[VirtualBox manual](http://www.virtualbox.org/manual/ch03.html).
+
+## Setting up drag and drop
+
+Oracle VM VirtualBox enables you to drag and drop content from the host to the guest, and vice versa.
+Enter the **Drag and Drop** menu item by opening the **Devices** menu of the virtual machine.
+Then select the mode according your needs, recommendation is **Bidirectional** because this enables drag and drop
+operations in both directions. Further information e.g. known limitations can be found in the
+[VirtualBox manual](http://www.virtualbox.org/manual/ch04.html).
+
## Adjusting virtual machine window size
Once the guest additions are installed, the window size can be changed. Select the option **Adjust Window Size**. Then resize the window to make it appear as a normal working size.
--
GitLab