diff options
Diffstat (limited to 'meta/recipes-core/images/build-appliance-image/README_VirtualBox_Guest_Additions.txt')
-rw-r--r-- | meta/recipes-core/images/build-appliance-image/README_VirtualBox_Guest_Additions.txt | 75 |
1 files changed, 75 insertions, 0 deletions
diff --git a/meta/recipes-core/images/build-appliance-image/README_VirtualBox_Guest_Additions.txt b/meta/recipes-core/images/build-appliance-image/README_VirtualBox_Guest_Additions.txt new file mode 100644 index 0000000000..e7298f2c3c --- /dev/null +++ b/meta/recipes-core/images/build-appliance-image/README_VirtualBox_Guest_Additions.txt | |||
@@ -0,0 +1,75 @@ | |||
1 | |||
2 | Installing VirtualBox Guest Additions | ||
3 | ===================================== | ||
4 | |||
5 | In order to use VirtualBox guest additions, they have to be build | ||
6 | first. They may have to be rebuilt each time the time you upgrade to | ||
7 | a new version of VirtualBox. | ||
8 | |||
9 | Make sure VM is configured with an Optical Drive. | ||
10 | |||
11 | Please follow these steps to install the VirtualBox Guest Additions on the | ||
12 | Build Appliance VM: | ||
13 | |||
14 | 1. Boot VM, select root "Terminal" instead of the default "Terminal <2>" | ||
15 | |||
16 | 2. Insert Guest additions CD into VM optical drive: | ||
17 | VM menu "Devices"->"Optical Drives"-> Select "VBoxGuestAdditions<version>.iso" | ||
18 | |||
19 | 3. Find your CDROM device. Typically it is /dev/hda for IDE. You can determine | ||
20 | the actual name <cdromedev> by viewing the cdrom info: | ||
21 | |||
22 | # cat /proc/sys/dev/cdrom/info | ||
23 | |||
24 | Mount the cdrom drive: | ||
25 | # mount -t iso9660 <cdromdev> /media/cdrom | ||
26 | i.e.: | ||
27 | # mount -t iso9660 /dev/hda /media/cdrom | ||
28 | |||
29 | 4. Build the additions: | ||
30 | |||
31 | First, we need to build of some prerequisite utilities. | ||
32 | (This is only needed to be done once) | ||
33 | |||
34 | # cd /lib/modules/<kernel-version>-yocto-standard/build | ||
35 | # make scripts | ||
36 | |||
37 | Now build the guest additions: | ||
38 | |||
39 | # /media/cdrom/VBoxLinuxAdditions.run --nox11 | ||
40 | |||
41 | At this point, providing there were no build errors, the guest additions are | ||
42 | built and installed. | ||
43 | |||
44 | 5. Check if vbox additions running: | ||
45 | |||
46 | # /etc/init.d/vboxadd status | ||
47 | |||
48 | If not running, try manually starting: | ||
49 | |||
50 | # /etc/init.d/vboxadd start | ||
51 | |||
52 | 6. Check if additons actually work, in particular folder sharing. | ||
53 | |||
54 | Host: Devices->Shared Folders->Shared Folder Settings... | ||
55 | Add any host folder and name it (i.e. "images") | ||
56 | |||
57 | Guest VM: create mount point for the shared folder, i.e.: | ||
58 | |||
59 | # mkdir ~/my-host | ||
60 | |||
61 | Mount the shared folder: (Watch out for spelling: it's vboxsf NOT vboxfs) | ||
62 | |||
63 | # mount -t vboxsf images ~/my-host | ||
64 | |||
65 | Verify mount, should see the contents of the shared folder: | ||
66 | |||
67 | # ls ~/my-host | ||
68 | |||
69 | |||
70 | |||
71 | |||
72 | |||
73 | |||
74 | |||
75 | |||