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
READMEfor changes in required development libraries and procedures. Some particular things to note:- In Xen 4.3 the default installation path has changed from
/usrto/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
xlis, and what differences are expected betweenxmandxl.- In particular,
xendtypically did network setup (i.e., bridging, &c), whilexldoes not. So you will need to set up your networking through the standard distro tools. - For less common commands, check the
xlman page to make sure names or argument conventions haven't changed.
- In particular,
- Try to use
xlfor things that you used to usexmfor.
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!
