| 1 | $Id: vboxtxs-runvm-readme.txt 72397 2018-05-31 07:30:03Z 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/* (preserve the directory layout)
|
|---|
| 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. initrc: TODO: document init.rc setup
|
|---|
| 24 | 7b. systemd: Link/copy the vboxtxs-runvm.system to [/usr]/lib/systemd/system/
|
|---|
| 25 | Enable the vboxtxs-runvm service, usually using:
|
|---|
| 26 | systemctl enable vboxtxs-runvm
|
|---|
| 27 | 8. Check the cdrom location and /dev/kmsg equivalent of your linux distro
|
|---|
| 28 | in /opt/validationkit/linux/vboxtxs-runvm and fix it so it's correct.
|
|---|
| 29 | 9. reboot / done.
|
|---|
| 30 |
|
|---|
| 31 | TODO: Document other OSes as we add them.
|
|---|
| 32 |
|
|---|
| 33 | Note: vboxtxs-runvm uses a GUI session to launch the nested-VM for better
|
|---|
| 34 | visibility when troubleshooting the nested smoke test.
|
|---|
| 35 |
|
|---|
| 36 | If this causes problems try troubleshooting the XAUTHORITY and DISPLAY
|
|---|
| 37 | environment variables in vboxtxs-runvm.service. It might differ depending
|
|---|
| 38 | on the display manager of the particular linux distro.
|
|---|
| 39 |
|
|---|
| 40 |
|
|---|
| 41 |
|
|---|
| 42 | Testing the setup
|
|---|
| 43 | -----------------
|
|---|
| 44 |
|
|---|
| 45 | 1. Make sure the validationkit.iso is inserted.
|
|---|
| 46 | 2. Boot / reboot the guest.
|
|---|
| 47 | 3. To test the connection - Depending on the TXS transport options:
|
|---|
| 48 | nat) python testdriver/tst-txsclient.py --reversed-setup
|
|---|
| 49 | other) python testdriver/tst-txsclient.py --hostname <guest-ip>
|
|---|
| 50 | 4. To test the smoke test:
|
|---|
| 51 | python tests/smoketests/tdSmokeTest1.py -v -v -d --vbox-session-type gui --test-vms <guest-name>
|
|---|
| 52 |
|
|---|
