| 1 | $Id: vboxtxs-runvm-readme.txt 72521 2018-06-12 04:49:39Z vboxsync $
|
|---|
| 2 |
|
|---|
| 3 |
|
|---|
| 4 | VirtualBox Test eXecution Service
|
|---|
| 5 | =================================
|
|---|
| 6 |
|
|---|
| 7 | This readme briefly describes how to install the Test eXecution Service (TXS)
|
|---|
| 8 | for nested hardware-virtualization smoke testing on the various systems.
|
|---|
| 9 |
|
|---|
| 10 | The basic idea is to execute one smoke test within the VM and then launch
|
|---|
| 11 | the regular TXS service in the VM to report success or failure to the host.
|
|---|
| 12 |
|
|---|
| 13 | Linux Installation
|
|---|
| 14 | ------------------
|
|---|
| 15 |
|
|---|
| 16 | 1. scp/download latest release build of VirtualBox and install it in the VM.
|
|---|
| 17 | 2. scp/download the required smoke test VDI from remote test-resource to
|
|---|
| 18 | /home/vbox/testrsrc/3.0/tcp/win2k3ent-acpi.vdi
|
|---|
| 19 | 3. cd /root
|
|---|
| 20 | 3. scp/download VBoxValidationKit*.zip there.
|
|---|
| 21 | 5. unzip VBoxValidationKit*.zip
|
|---|
| 22 | 6. chmod -R u+w,a+x /opt/validationkit/
|
|---|
| 23 | 7a. Gnome: Copy /opt/validationkit/linux/vboxtxs-runvm.desktop to /etc/xdg/autostart
|
|---|
| 24 | 7b. KDE/Others: TODO: Document other desktop managers
|
|---|
| 25 | 8. Add the vbox user to sudo group using:
|
|---|
| 26 | sudo usermod -a -G sudo vbox
|
|---|
| 27 | 9. Ensure no password is required for vbox when using sudo:
|
|---|
| 28 | sudo echo "vbox ALL=(ALL:ALL) NOPASSWD: ALL" > /etc/sudoers.d/username
|
|---|
| 29 | 10. Check the cdrom location and /dev/kmsg equivalent of your linux distro
|
|---|
| 30 | in /opt/validationkit/linux/vboxtxs-runvm and fix it so it's correct
|
|---|
| 31 | 11. Reboot / done.
|
|---|
| 32 |
|
|---|
| 33 | TODO: Document other OSes as we add them.
|
|---|
| 34 |
|
|---|
| 35 | Note: vboxtxs-runvm uses a GUI session to launch the nested-VM for better
|
|---|
| 36 | visibility when troubleshooting the nested smoke test.
|
|---|
| 37 |
|
|---|
| 38 | If this causes problems try troubleshooting the XAUTHORITY and DISPLAY
|
|---|
| 39 | environment variables in vboxtxs-runvm.service. It might differ depending
|
|---|
| 40 | on the display manager of the particular linux distro.
|
|---|
| 41 |
|
|---|
| 42 |
|
|---|
| 43 |
|
|---|
| 44 | Testing the setup
|
|---|
| 45 | -----------------
|
|---|
| 46 |
|
|---|
| 47 | 1. Make sure the validationkit.iso is inserted.
|
|---|
| 48 | 2. Boot / reboot the guest.
|
|---|
| 49 | 3. To test the connection - Depending on the TXS transport options:
|
|---|
| 50 | nat) python testdriver/tst-txsclient.py --reversed-setup
|
|---|
| 51 | other) python testdriver/tst-txsclient.py --hostname <guest-ip>
|
|---|
| 52 | 4. To test the smoke test:
|
|---|
| 53 | python tests/smoketests/tdSmokeTest1.py -v -v -d --vbox-session-type gui --test-vms <guest-name>
|
|---|
| 54 |
|
|---|
