Xen users - May 2006 - Re: [Xen-devel] Xen 3.0 User Manual revision

Alan,

The Xen Users Manual could be greatly improved with the inclusion of a
trouble-shooting section.  There seems to be a number of issues that
resurface frequently on this list (and certainly in my work) and
consolidating how-to information for resolving problems could save all
of us a lot of time.  While any number of formats would work, I suggest
(at least) a list of things to check for a given problem or error
message.  For example: for the infamous device-not-connected message, a
list of all the things that could go wrong when devices are being
connected from mistyped file names to exhausting the loop device pool. 


The checklist should include some general OS items as well as
Xen-specific items.  For example, the checklist for failure of ping
connectivity to a domU might include checking routing as well as
attachment of a VIF to a bridge.  This need not be a full tutorial on
solving Linux (or other) administration problems, but some hints could
be useful.

Thanks in advance for whatever improvements you make to the user
manual,

Colin Brown
Franklin University - CIS


_______________________________________________
Xen-users mailing list
Xen-users@lists.xensource.com
http://lists.xensource.com/xen-users

The section early on about software prerequisites is a little skimpy.
It would be nice if, instead of just a brief list, there was a
sentence or two about what each thing was used for (so if things go
wrong, you have more clues about where to start looking).  In
particular, some things need kernel options enabled, so installing the
user-space packages is not enough.
-- 
bill-xen@carpenter.ORG (WJCarpenter)    PGP 0x91865119
38 95 1B 69 C9 C6 3D 25    73 46 32 04 69 D6 ED F3


_______________________________________________
Xen-users mailing list
Xen-users@lists.xensource.com
http://lists.xensource.com/xen-users

Hi Colin,

Colin Brown wrote:
> Alan,
> 
> The Xen Users Manual could be greatly improved with the inclusion of a
> trouble-shooting section.
 > [...]
> 
> Thanks in advance for whatever improvements you make to the user
> manual,
I am not the "Alan" you name in this mail, but:

Do you know there is wiki.xensource.com?

So you can add documentation about everything xyou find out about xen 
but what is not documented in the official manual.

Wiki editing needs some practice, but is similar,m  but simpler than 
writing HTML.

Henning

_______________________________________________
Xen-users mailing list
Xen-users@lists.xensource.com
http://lists.xensource.com/xen-users