Archived/Xen 4.3 RC1 test instructions: Difference between revisions
From Xen
Jump to navigationJump to search
(Stray 4.2 references, typos, spelling) |
No edit summary |
||
Line 1: | Line 1: | ||
= What needs to be tested = |
= What needs to be tested = |
||
General things: |
|||
{{TODO|Add a list of what needs to be tested at the Xen Document Day}} |
|||
* Making sure that Xen 4.3 compiles and installs properly on different software configurations; particularly on distros |
|||
* Making sure that Xen 4.3, along with appropriately up-to-date kernels, work on different hardware. |
|||
Specific features: |
|||
⚫ | |||
= Installing = |
|||
== Getting RC1 == |
== Getting RC1 == |
||
⚫ | |||
* '''xen''': Pull from the main repo, and update to tag <code>4.3.0-rc1</code>: |
* '''xen''': Pull from the main repo, and update to tag <code>4.3.0-rc1</code>: |
||
git clone -b 4.3.0-rc1 git://xenbits.xen.org/xen.git |
|||
* '''tarball''': [http://bits.xensource.com/oss-xen/release/4.3.0-rc1/xen-4.3.0-rc1.tar.gz Xen 4.3.0 RC1 Tarball] (and [http://bits.xensource.com/oss-xen/release/4.3.0-rc1/xen-4.3.0-rc1.tar.gz.sig signature]) |
* '''tarball''': [http://bits.xensource.com/oss-xen/release/4.3.0-rc1/xen-4.3.0-rc1.tar.gz Xen 4.3.0 RC1 Tarball] (and [http://bits.xensource.com/oss-xen/release/4.3.0-rc1/xen-4.3.0-rc1.tar.gz.sig signature]) |
||
== |
== Building == |
||
* '''Fedora 16/17''': You need these packages installed to build Xen 4.3 from source. Also applies to RHEL6/CentOS6, but there you probably first need to enable EPEL repo to be able to find some of the rpms: |
|||
yum groupinstall "Development Libraries" |
|||
yum groupinstall "Development Tools" |
|||
yum install transfig wget tar less texi2html libaio-devel dev86 glibc-devel e2fsprogs-devel gitk mkinitrd iasl xz-devel bzip2-devel |
|||
yum install pciutils-libs pciutils-devel SDL-devel libX11-devel gtk2-devel bridge-utils PyXML qemu-common qemu-img mercurial texinfo |
|||
yum install libidn-devel yajl yajl-devel ocaml ocaml-findlib ocaml-findlib-devel python-devel uuid-devel libuuid-devel openssl-devel |
|||
yum install glibc-devel.i686 |
|||
Instructions are available for building Xen on [[Compiling_Xen_From_Source|Linux]] and [[Compiling_Xen_From_Source_on_NetBSD|NetBSD]]. |
|||
* '''Debian/Ubuntu''': This list might be incomplete, please complete/fix/test the package list!: |
|||
apt-get install build-essential bcc bin86 gawk bridge-utils iproute libcurl3 libcurl4-openssl-dev bzip2 module-init-tools transfig tgif |
|||
apt-get install texinfo texlive-latex-base texlive-latex-recommended texlive-fonts-extra texlive-fonts-recommended pciutils-dev mercurial |
|||
apt-get install make gcc libc6-dev zlib1g-dev python python-dev python-twisted libncurses5-dev patch libvncserver-dev libsdl-dev libjpeg62-dev |
|||
apt-get install iasl libbz2-dev e2fslibs-dev git-core uuid-dev ocaml ocaml-findlib libx11-dev bison flex xz-utils libyajl-dev |
|||
apt-get install gettext |
|||
If you have a 64 bit Debian/Ubuntu system, you also need to install: |
|||
apt-get install gcc-multilib libc6-dev-i386 |
|||
* '''NetBSD''': You will need to following packages from pkgsrc to build Xen 4.3 from source: |
|||
<pre> |
|||
devel/mercurial |
|||
devel/scmgit |
|||
devel/gmake |
|||
lang/python27 |
|||
devel/py-curses |
|||
devel/dev86 |
|||
devel/glib2 |
|||
devel/yajl |
|||
</pre> |
|||
= Test instructions = |
= Test instructions = |
||
* Remove any old versions of Xen toolstack binaries (including <code>qemu</code>). |
* Remove any old versions of Xen toolstack and userspace binaries (including <code>qemu</code>). |
||
* Download and install the most recent Xen 4.3 RC. Make sure to check the <code>README</code> for changes in required development libraries and procedures. Some particular things to note: |
* Download and install the most recent Xen 4.3 RC, as described above. Make sure to check the <code>README</code> for changes in required development libraries and procedures. Some particular things to note: |
||
** In Xen 4.3 the default installation path has changed from <code>/usr</code> to <code>/usr/local</code>. Take extra care when removing any old versions to allow for this. |
|||
* Read the [[XL|xl wiki page]] to understand what <code>xl</code> is, and what differences are expected between <code>xm</code> and <code>xl</code>. |
* Read the [[XL|xl wiki page]] to understand what <code>xl</code> is, and what differences are expected between <code>xm</code> and <code>xl</code>. |
||
** In particular, <code>xend</code> typically did network setup (i.e., bridging, &c), while <code>xl</code> does not. So you will need to set up your networking through the standard distro tools. |
** In particular, <code>xend</code> typically did network setup (i.e., bridging, &c), while <code>xl</code> does not. So you will need to set up your networking through the standard distro tools. |
||
Line 52: | Line 33: | ||
= Reporting Bugs (& Issues) = |
= Reporting Bugs (& Issues) = |
||
* Report any bugs / missing functionality / unexpected results. |
* Report any bugs / missing functionality / unexpected results. |
||
* Please put '''[TestDay]''' into the subject line |
* Please put '''[TestDay]''' into the subject line |
Revision as of 11:01, 29 April 2013
What needs to be tested
General things:
- Making sure that Xen 4.3 compiles and installs properly on different software configurations; particularly on distros
- Making sure that Xen 4.3, along with appropriately up-to-date kernels, work on different hardware.
Specific features:
Installing
Getting RC1
- xen: Pull from the main repo, and update to tag
4.3.0-rc1
:
git clone -b 4.3.0-rc1 git://xenbits.xen.org/xen.git
- tarball: Xen 4.3.0 RC1 Tarball (and signature)
Building
Instructions are available for building Xen on Linux and NetBSD.
Test instructions
- Remove any old versions of Xen toolstack and userspace binaries (including
qemu
). - Download and install the most recent Xen 4.3 RC, as described above. Make sure to check the
README
for changes in required development libraries and procedures. Some particular things to note:- In Xen 4.3 the default installation path has changed from
/usr
to/usr/local
. Take extra care when removing any old versions to allow for this.
- In Xen 4.3 the default installation path has changed from
- Read the xl wiki page to understand what
xl
is, and what differences are expected betweenxm
andxl
.- In particular,
xend
typically did network setup (i.e., bridging, &c), whilexl
does not. So you will need to set up your networking through the standard distro tools. - For less common commands, check the
xl
man page to make sure names or argument conventions haven't changed.
- In particular,
- Try to use
xl
for things that you used to usexm
for.
Reporting Bugs (& Issues)
- Report any bugs / missing functionality / unexpected results.
- Please put [TestDay] into the subject line
- Also make sure you specify the RC number you are using
- Make sure to follow the guidelines on Reporting Bugs against Xen.
Reporting success
We would love it if you could report successes by e-mailing xen-devel@lists.xen.org
, preferably including:
- Hardware: Please at least include the processor manufacturer (Intel/AMD). Other helpful information might include specific processor models, amount of memory, number of cores, and so on
- Software: If you're using a distro, the distro name and version would be the most helpful. Other helpful information might include the kernel that you're running, or other virtualization-related software you're using (e.g., libvirt, xen-tools, drbd, &c).
- Guest operating systems: If running a Linux version, please specify whether you ran it in PV or HVM mode.
- Functionality tested: High-level would include toolstacks, and major functionality (e.g., suspend/resume, migration, pass-through, stubdomains, &c)
The following template might be helpful: should you use Xen 4.3.0-RC1 for testing, please make sure you state that information!
Subject: [TESTDAY] Test report * Hardware: * Software: * Guest operating systems: * Functionality tested: * Comments:
For example:
Subject: [TESTDAY] Test report * Hardware: Dell 390's (Intel, dual-core) x15 HP (AMD, quad-core) x5 * Software: Ubuntu 10.10,11.10 Fedora 17 * Guest operating systems: Windows 8 Ubuntu 12.10,11.10 (HVM) Fedora 17 (PV) * Functionality tested: xl suspend/resume pygrub * Comments: Window 8 booting seemed a little slower than normal. Other than that, great work!