1
- [ ![ Build Status] ( https://travis-ci.org/lindig /xen-test-vm.svg?branch=master )] ( https://travis-ci.org/lindig /xen-test-vm )
1
+ [ ![ Build Status] ( https://travis-ci.org/xapi-project /xen-test-vm.svg?branch=master )] ( https://travis-ci.org/xapi-project /xen-test-vm )
2
2
3
3
# Xen Test VM
4
4
5
- This repository contains OCaml code to build a minimal
6
- para-virtualised kernel to run on the Xen hypervisor for testing Xen. The
7
- kernel is built using the Mirage unikernel framework.
5
+ This repository contains OCaml code to build a minimal para-virtualised
6
+ kernel to run on the Xen hypervisor for testing Xen. The kernel is built
7
+ using the Mirage unikernel framework.
8
8
9
- # Building
9
+ # Binary Releases
10
+
11
+ Binary releases are hosted on
12
+ [ GitHub] ( https://github.com/xapi-project/xen-test-vm/releases ) as
13
+ ` xen-test.vm.gz ` . The uncompressed file is the kernel that needs to be
14
+ installed.
15
+
16
+ # Installing the VM
17
+
18
+ The VM is built as ` src/test-vm.xen ` and available as binary
19
+ release. The file goes into ` /boot/guest ` on a host:
20
+
21
+ HOST=host
22
+ ssh root@$HOST "test -d /boot/guest || mkdir /boot/guest"
23
+ scp test-vm.xen root@$HOST:/boot/guest
24
+
25
+ The kernel needs to be registered with Xen on the host. As root on
26
+ ` $HOST ` , do:
27
+
28
+ xe vm-create name-label=minion
29
+ # this echoes a UUID for the new VM named "minion"
30
+ xe vm-param-set PV-kernel=/boot/guest/test-vm.xen uuid=$UUID
31
+
32
+ Once installed, use the CLI on the host to operate the VM or use
33
+ XenCenter.
34
+
35
+ # Building from Source Code
10
36
11
37
The code relies on some pinned OCaml packages in Opam. This dependency
12
38
cannot be expressed naturally in the depends section of an ` opam ` file. For
@@ -20,26 +46,11 @@ calling `make` will build `src/test-vm.xen`
20
46
A ` Dockerfile ` can be used to create a Docker container environment for
21
47
compiling the VM. It is used for building on Travis.
22
48
23
- # Travis
49
+ # Travis CI
24
50
25
51
The VM is built on Travis using the [ Dockerfile] ( ./Dockerfile ) - see the
26
- [ .travis.yml] ( ./travis.yml ) .
27
-
28
- # Installing the VM
29
-
30
- The VM is built as ` src/test-vm.xen ` . Installing it on a Xen host:
31
-
32
- HOST=host
33
- ssh root@$HOST "test -d /boot/guest || mkdir /boot/guest"
34
- scp src/test-vm.xen root@$HOST:/boot/guest
35
-
36
- As root on $HOST:
37
-
38
- xe vm-create name-label=minion
39
- # this echoes a UUID for the new VM named "minion"
40
- xe vm-param-set PV-kernel=/boot/guest/test-vm.xen uuid=$UUID
41
-
42
- Once installed, use the CLI on the host to operate the VM or XenCenter.
52
+ [ .travis.yml] ( .travis.yml ) . Travis also creates the releases hosted on
53
+ [ GitHub] ( https://github.com/xapi-project/xen-test-vm/releases ) .
43
54
44
55
# Out-of-Band Control Messages
45
56
0 commit comments