Skip to content

Commit 400f89e

Browse files
committed
Updated documentation and Travis setup to point to github.com/xen-project.
1 parent 242850c commit 400f89e

File tree

2 files changed

+35
-24
lines changed

2 files changed

+35
-24
lines changed

Diff for: .travis.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,5 +20,5 @@ deploy:
2020
file: src/test-vm.xen.gz
2121
skip_cleanup: true
2222
on:
23-
repo: lindig/xen-test-vm
23+
repo: xapi-project/xen-test-vm
2424
tags: true

Diff for: README.md

+34-23
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,38 @@
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)
22

33
# Xen Test VM
44

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.
88

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
1036

1137
The code relies on some pinned OCaml packages in Opam. This dependency
1238
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`
2046
A `Dockerfile` can be used to create a Docker container environment for
2147
compiling the VM. It is used for building on Travis.
2248

23-
# Travis
49+
# Travis CI
2450

2551
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).
4354

4455
# Out-of-Band Control Messages
4556

0 commit comments

Comments
 (0)