Re: Extend documentation (was: Re: Issue getting my first Xen domU up)

2019-02-06 Thread Andrew Daugherity
> On Feb 6, 2019, at 11:17 AM, Roger Pau Monné  wrote:
> 
> Adding Benedict who wrote the Xen handbook documentation, and
> hopefully would be able to fix it :).
> 
> I suggest the following is added to the handbook:
> […]



While you’re at it, I think some other updates to that handbook page are in 
order.  I just read it again for the first time in a good while and the 
following things caught my eye:

- 21.8.2 mentions using Xen 4.7 on FreeBSD 11 and Xen 4.11 on FreeBSD-CURRENT 
>= r336475.  As 12.0 has been released, that merits a mention here… while 
"FreeBSD 12.0-RELEASE r341666 GENERIC" does have a higher rev number, I’m not 
sure whether or not it contains the necessary stuff for Xen 4.11.

- The /var/log/xen dir is created (and owned) by the xen-tools4{7,11} packages, 
so no need to manually create it.

- Wouldn’t 'onifpresent' be a better setting for xc0 in /etc/ttys? Then if you 
booted back to a vanilla kernel, it won’t try (and fail) to start a getty for a 
nonexistent device.

- The DomU example creates a FreeBSD 10.3 VM.  Probably better to showcase a 
supported release…

- Seeing "Xen(TM)" sprinkled throughout the document interrupts the reading 
flow.  Surely it’s enough to use the trademark symbol for the first mention and 
then simply "Xen" thereafter?

- Is it really necessary to 'xl destroy' the DomU after shutting it down?  Once 
it’s shut down, it shouldn’t be in the list any more, and you just 'xl create' 
with the new config, right?


It’s nice to see Xen support in FreeBSD continue to improve!  (Even if I I’ve 
only run it as a DomU so far…)


Cheers,
Andrew

___
freebsd-xen@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-xen
To unsubscribe, send any mail to "freebsd-xen-unsubscr...@freebsd.org"


Re: Extend documentation (was: Re: Issue getting my first Xen domU up)

2019-02-06 Thread Benedict Reuschling
Hello Roger,

Am 06.02.19 um 18:17 schrieb Roger Pau Monné:
> Adding Benedict who wrote the Xen handbook documentation, and
> hopefully would be able to fix it :).
> 
> On Tue, Feb 05, 2019 at 08:18:05PM +, Marcin Cieslak wrote:
>> On Tue, 5 Feb 2019, Eric Bautsch wrote:
>>
>>> And yes, the qemu-dm-titania.log would have been the place to look. I feel
>>> pretty stupid. It says:
>>
>> Don't feel stupid. I am using Xen with Dom0 on FreeBSD for months now
>> and I didn't know where the qemu logs go - I was able to figure out
>> the problem by staring at the configuration file for a long time.
>>
>> Therefore your question was very helpful also for me - thanks!
> 
> It seems there's one piece missing in the handbook which I didn't
> realize, the if_tap module needs to be loaded for QEMU to work.
> 
> I suggest the following is added to the handbook:
> 
> ```
> sysrc -f /boot/loader.conf if_tap_load="YES"
> ```
> 
> And then I've also realized the following line:
> 
> ```
> sysrc -f /boot/loader.conf hw.pci.mcfg=0
> ```
> 
> Is only needed for Xen 4.7, but not for Xen 4.11.
> 
> Finally it might be interesting to add a reference to the location of
> the Xen logs. This should likely be added at the end of the document,
> I think something along the lines of:
> 
> ```
> Xen toolstack related logs can be found at /var/log/xen/ be sure to
> check the contents of that directory if experiencing issues.
> ```
> 
> Sorry to bother you Benedict, but do you think you could make the
> following changes?
> 
> Thanks, Roger.
> 

I could make those change, but not today as we are recording BSDNow.tv.
Tomorrow is better. The changes themselves seem straightforward enough.
I'll come up with a patch and add you to the review on Phabricator.

Cheers,
Benedict



signature.asc
Description: OpenPGP digital signature


Re: Extend documentation (was: Re: Issue getting my first Xen domU up)

2019-02-06 Thread Rodney W. Grimes
> Adding Benedict who wrote the Xen handbook documentation, and
> hopefully would be able to fix it :).
> 
> On Tue, Feb 05, 2019 at 08:18:05PM +, Marcin Cieslak wrote:
> > On Tue, 5 Feb 2019, Eric Bautsch wrote:
> > 
> > > And yes, the qemu-dm-titania.log would have been the place to look. I feel
> > > pretty stupid. It says:
> > 
> > Don't feel stupid. I am using Xen with Dom0 on FreeBSD for months now
> > and I didn't know where the qemu logs go - I was able to figure out
> > the problem by staring at the configuration file for a long time.
> > 
> > Therefore your question was very helpful also for me - thanks!
> 
> It seems there's one piece missing in the handbook which I didn't
> realize, the if_tap module needs to be loaded for QEMU to work.
> 
> I suggest the following is added to the handbook:
> 
> ```
> sysrc -f /boot/loader.conf if_tap_load="YES"
> ```
> 
> And then I've also realized the following line:
> 
> ```
> sysrc -f /boot/loader.conf hw.pci.mcfg=0
> ```
> 
> Is only needed for Xen 4.7, but not for Xen 4.11.
> 
> Finally it might be interesting to add a reference to the location of
> the Xen logs. This should likely be added at the end of the document,
> I think something along the lines of:
> 
> ```
> Xen toolstack related logs can be found at /var/log/xen/ be sure to
> check the contents of that directory if experiencing issues.
> ```

Is there a troubleshooting section in the handbook?
If not there should be, and this would defanitly be mentioned
in that section.  

> 
> Sorry to bother you Benedict, but do you think you could make the
> following changes?
> 
> Thanks, Roger.

-- 
Rod Grimes rgri...@freebsd.org
___
freebsd-xen@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-xen
To unsubscribe, send any mail to "freebsd-xen-unsubscr...@freebsd.org"


Extend documentation (was: Re: Issue getting my first Xen domU up)

2019-02-06 Thread Roger Pau Monné
Adding Benedict who wrote the Xen handbook documentation, and
hopefully would be able to fix it :).

On Tue, Feb 05, 2019 at 08:18:05PM +, Marcin Cieslak wrote:
> On Tue, 5 Feb 2019, Eric Bautsch wrote:
> 
> > And yes, the qemu-dm-titania.log would have been the place to look. I feel
> > pretty stupid. It says:
> 
> Don't feel stupid. I am using Xen with Dom0 on FreeBSD for months now
> and I didn't know where the qemu logs go - I was able to figure out
> the problem by staring at the configuration file for a long time.
> 
> Therefore your question was very helpful also for me - thanks!

It seems there's one piece missing in the handbook which I didn't
realize, the if_tap module needs to be loaded for QEMU to work.

I suggest the following is added to the handbook:

```
sysrc -f /boot/loader.conf if_tap_load="YES"
```

And then I've also realized the following line:

```
sysrc -f /boot/loader.conf hw.pci.mcfg=0
```

Is only needed for Xen 4.7, but not for Xen 4.11.

Finally it might be interesting to add a reference to the location of
the Xen logs. This should likely be added at the end of the document,
I think something along the lines of:

```
Xen toolstack related logs can be found at /var/log/xen/ be sure to
check the contents of that directory if experiencing issues.
```

Sorry to bother you Benedict, but do you think you could make the
following changes?

Thanks, Roger.
___
freebsd-xen@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-xen
To unsubscribe, send any mail to "freebsd-xen-unsubscr...@freebsd.org"