Pkg xen devel - Mar 2013 - unblock: xcp-xapi - urgent documentation fixes

Package: release.debian.org
Severity: normal

The current README.Debian is quite old

It gives some advice that will lead to people having a broken system
(e.g. no networking).  It describes a procedure for configuring
networking that is completely opposite to what has been described more
recently on the upstream mailing list

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=702337

I'm happy to overhaul this document and submit a debdiff for the release
team to review - please confirm if this work should go ahead.  No other
files in the package will be changed.

Control: retitle -1 unblock: xen-api/1.3.2-14 (pre-approval)

On 2013-03-06 21:23, Daniel Pocock wrote:
> Package: release.debian.org
> Severity: normal
> 
> The current README.Debian is quite old
> 
> It gives some advice that will lead to people having a broken system
> (e.g. no networking).  It describes a procedure for configuring
> networking that is completely opposite to what has been described more
> recently on the upstream mailing list
> 
> http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=702337
> 
> I'm happy to overhaul this document and submit a debdiff for the
release
> team to review - please confirm if this work should go ahead.  No other
> files in the package will be changed.
> 
> 
I would be willing to consider this documentation fix if it indeed is as
bad as you suggest.  Though, I'd appreciate seeing a debdiff before
saying "yay" or "nay".

~Niels

On 03/07/2013 04:23 AM, Daniel Pocock wrote:
> Package: release.debian.org
> Severity: normal
> 
> The current README.Debian is quite old
> 
> It gives some advice that will lead to people having a broken system
> (e.g. no networking).  It describes a procedure for configuring
> networking that is completely opposite to what has been described more
> recently on the upstream mailing list
> 
> http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=702337
> 
> I'm happy to overhaul this document and submit a debdiff for the
release
> team to review - please confirm if this work should go ahead.  No other
> files in the package will be changed.
Hi Daniel and the release team,

First, thanks Daniel, for taking care of this. I do appreciate such
contributions.

I agree the README is not perfect, though I don't agree it is such a
disaster. The network configuration which I described in it does work,
contrary to what Daniel says. Others also reported using this howto
successfully. What's annoying though, is that to do it, you have to
reboot under a broken networking setup for a while, to be able to do
such a configuration, which is very annoying if you don't have a KVM
over IP in your server.

I have applied all of your git patches. Thanks for them. However, I
cannot apply the part that changes paragraph 4.2, as it did work for me,
and that I would not recommend removing all trace of the network
interface (you would loose network if you reboot without XCP).

I by the way believe that your paragraph "IMPORTANT BUG" is important
to
add. Mike told me Citrix guys would come back to me with a fix for
#695221 (though it's been weeks I didn't hear about him yet).

Cheers,

Thomas

On Wed, 2013-03-06 at 21:23 +0100, Daniel Pocock wrote:
> The current README.Debian is quite old
> 
> It gives some advice that will lead to people having a broken system
> (e.g. no networking).  It describes a procedure for configuring
> networking that is completely opposite to what has been described more
> recently on the upstream mailing list
It looks like this became #704148, so I'm closing this earlier request.

Regards,

Adam