Difference between revisions of "Xen 4.15 RC test instructions"

From Xen
(Copy from 4.14, not yet edited)
 
(update versions etc.)
Line 5: Line 5:
   
 
General things:
 
General things:
* Making sure that Xen 4.14 compiles and installs properly on different software configurations; particularly on distros
+
* Making sure that Xen 4.15 compiles and installs properly on different software configurations; particularly on distros
* Making sure that Xen 4.14, along with appropriately up-to-date kernels, work on different hardware.
+
* Making sure that Xen 4.15, along with appropriately up-to-date kernels, work on different hardware.
   
 
For more ideas about what to test, please see [[Testing_Xen|Testing Xen]].
 
For more ideas about what to test, please see [[Testing_Xen|Testing Xen]].
Line 15: Line 15:
 
== New features ==
 
== New features ==
   
  +
TBD
From CHANGELOG.md
 
 
- Use x2APIC mode whenever available, regardless of interrupt remapping
 
support.
 
- Performance improvements to guest assisted TLB flushes, either when using
 
the Xen hypercall interface or the viridian one.
 
- Assorted pvshim performance and scalability improvements plus some bug
 
fixes.
 
- Hypervisor framework to ease porting Xen to run on hypervisors.
 
- Initial support to run on Hyper-V.
 
- Initial hypervisor file system (hypfs) support.
 
- libxl support for running qemu-xen device model in a linux stubdomain.
 
- New 'domid_policy', allowing domain-ids to be randomly chosen.
 
- Option to preserve domain-id across migrate or save+restore.
 
- Support in kdd for initial KD protocol handshake for Win 7, 8 and 10 (64 bit).
 
   
 
= Installing =
 
= Installing =
   
 
== Getting a RC ==
 
== Getting a RC ==
  +
 
For the expressions/examples below, set the following bash/sh/... variable to the release candidate number (e.g. one of <code>rc1</code>, <code>rc2</code>, ... )
 
For the expressions/examples below, set the following bash/sh/... variable to the release candidate number (e.g. one of <code>rc1</code>, <code>rc2</code>, ... )
 
 
Line 43: Line 30:
   
 
=== From xen.git ===
 
=== From xen.git ===
With a recent enough <code>git</code> (>= 1.7.8.2), just pull from the proper tag (<code>4.14.0-$RC</code>) from the main repo directly:
 
git clone -b 4.14.0-$RC git://xenbits.xen.org/xen.git
 
   
With an older <code>git</code> version (and/or if that does not work, e.g., complaining with a message like this: <code>Remote branch 4.14.0-$RC not found in upstream origin, using HEAD instead</code>), do the following:
+
With a recent enough <code>git</code> (>= 1.7.8.2), just fetch from the proper tag (<code>4.15.0-$RC</code>) from the main repo directly:
git clone git://xenbits.xen.org/xen.git ; cd xen ; git checkout 4.14.0-$RC
+
git clone -b 4.15.0-$RC git://xenbits.xen.org/xen.git
  +
  +
With an older <code>git</code> version (and/or if that does not work, e.g., complaining with a message like this: <code>Remote branch 4.15.0-$RC not found in upstream origin, using HEAD instead</code>), do the following:
  +
git clone git://xenbits.xen.org/xen.git ; cd xen ; git checkout 4.15.0-$RC
   
 
=== From tarball ===
 
=== From tarball ===
   
 
Download:
 
Download:
https://downloads.xenproject.org/release/xen/4.14.0-$RC/xen-4.14.0-$RC.tar.gz
+
https://downloads.xenproject.org/release/xen/4.14.0-$RC/xen-4.15.0-$RC.tar.gz
https://downloads.xenproject.org/release/xen/4.14.0-$RC/xen-4.14.0-$RC.tar.gz.sig
+
https://downloads.xenproject.org/release/xen/4.14.0-$RC/xen-4.15.0-$RC.tar.gz.sig
   
 
== Building ==
 
== Building ==
Line 61: Line 49:
 
= Known issues =
 
= Known issues =
   
  +
TBD
* '''RC1 & RC2:''' build failure version of golang older than 1.11: add --disable-golang to configure line to work around (fixed in RC3).
 
   
 
= Test instructions =
 
= Test instructions =
   
 
== General ==
 
== General ==
  +
 
* Remove any old versions of Xen toolstack and userspace binaries (including <code>qemu</code>).
 
* Remove any old versions of Xen toolstack and userspace binaries (including <code>qemu</code>).
* Remove any Xen-related udev files under /etc because Xen 4.14 doesn't use those anymore.
+
* Remove any Xen-related udev files under /etc because since Xen 4.14 we don't use those anymore.
* Download and install the most recent Xen 4.14 RC, as described above. Make sure to check the <code>README</code> and <code>INSTALL</code> for changes in required development libraries and procedures. Some particular things to note:
+
* Download and install the most recent Xen 4.15 RC, as described above. Make sure to check the <code>README</code> and <code>INSTALL</code> for changes in required development libraries and procedures. Some particular things to note:
   
Once you have Xen 4.14 RC installed check that you can install a guest etc and use it in the ways which you normally would, i.e. that your existing guest configurations, scripts etc still work.
+
Once you have Xen 4.15 RC installed check that you can install a guest etc and use it in the ways which you normally would, i.e. that your existing guest configurations, scripts etc still work.
   
 
For more ideas about what to test, please see [[Testing Xen]] or the sections below.
 
For more ideas about what to test, please see [[Testing Xen]] or the sections below.
Line 81: Line 70:
   
 
=== RC1 ===
 
=== RC1 ===
None for now.
 
 
=== RC2 ===
 
xenhypfs: see https://lists.xenproject.org/archives/html/xen-devel/2020-06/msg00681.html
 
 
=== RC3 ===
 
None for now.
 
 
=== RC4 ===
 
None for now.
 
 
=== RC5 ===
 
None for now.
 
 
=== RC6 ===
 
 
None for now.
 
None for now.
   
Line 114: Line 88:
 
* '''Functionality tested''': High-level would include toolstacks, and major functionality (e.g., suspend/resume, migration, pass-through, stubdomains, &c)
 
* '''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 <code>Xen 4.14.0-<Some RC></code>''' for testing, please make sure you state that information!
+
The following template might be helpful: should you use <code>Xen 4.15.0-<Some RC></code>''' for testing, please make sure you state that information!
 
<pre>
 
<pre>
 
Subject: [TESTDAY] Test report
 
Subject: [TESTDAY] Test report
Line 157: Line 131:
 
</pre>
 
</pre>
   
[[Category:Xen_4.14]]
+
[[Category:Xen_4.15]]
 
[[Category:Xen]]
 
[[Category:Xen]]
 
[[Category:Community]]
 
[[Category:Community]]

Revision as of 14:22, 2 March 2021

Icon Info.png If you come to this page before or after the Test Day is completed, your testing is still valuable, and you can use the information on this page to test, post any bugs and test reports to xen-devel@. If this page is more than two weeks old when you arrive here, please check the current schedule and see if a similar but more recent Test Day is planned or has already happened.


What needs to be tested

General things:

  • Making sure that Xen 4.15 compiles and installs properly on different software configurations; particularly on distros
  • Making sure that Xen 4.15, along with appropriately up-to-date kernels, work on different hardware.

For more ideas about what to test, please see Testing Xen.

ARM Smoke Testing

If you use ARM Hardware, which is not widely available or not rackable (and thus not part of our automated test suite), please check out Xen ARM Manual Smoke Test. Helping out to manually test ARM boards (which will only take a few minutes) will guarantee that Xen 4.14 will work on the board that you use. If you want to see which boards need testing, check Xen ARM Manual Smoke Test/Results.

New features

TBD

Installing

Getting a RC

For the expressions/examples below, set the following bash/sh/... variable to the release candidate number (e.g. one of rc1, rc2, ... )

RC="<release candidate number>" # rc1, rc2 ...

Important notes:

For RC1: RC=rc1 (see #RC1)

From xen.git

With a recent enough git (>= 1.7.8.2), just fetch from the proper tag (4.15.0-$RC) from the main repo directly:

git clone -b 4.15.0-$RC git://xenbits.xen.org/xen.git

With an older git version (and/or if that does not work, e.g., complaining with a message like this: Remote branch 4.15.0-$RC not found in upstream origin, using HEAD instead), do the following:

git clone git://xenbits.xen.org/xen.git ; cd xen ; git checkout 4.15.0-$RC

From tarball

Download:

 https://downloads.xenproject.org/release/xen/4.14.0-$RC/xen-4.15.0-$RC.tar.gz 
 https://downloads.xenproject.org/release/xen/4.14.0-$RC/xen-4.15.0-$RC.tar.gz.sig

Building

Instructions are available for building Xen on Linux, NetBSD, and FreeBSD

Known issues

TBD

Test instructions

General

  • Remove any old versions of Xen toolstack and userspace binaries (including qemu).
  • Remove any Xen-related udev files under /etc because since Xen 4.14 we don't use those anymore.
  • Download and install the most recent Xen 4.15 RC, as described above. Make sure to check the README and INSTALL for changes in required development libraries and procedures. Some particular things to note:

Once you have Xen 4.15 RC installed check that you can install a guest etc and use it in the ways which you normally would, i.e. that your existing guest configurations, scripts etc still work.

For more ideas about what to test, please see Testing Xen or the sections below.

Specific ARM test Instructions

Specific x86 test instructions

RC specific things to test

RC1

None for now.

Reporting Bugs (& Issues)

  • Use Freenode IRC channel #xentest to discuss questions interactively
  • 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 (please CC the relevant maintainers and the Release Manager - jgross at suse dot com).

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.15.0-<Some RC> 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!