Page MenuHomeFreeBSD

xen: add troubleshooting section

Authored by royger on Feb 7 2019, 3:22 PM.



This contains some tips to troubleshoot FreeBSD as a host or when
attempting to create guests.

Diff Detail

rD FreeBSD doc repository - subversion
Automatic diff as part of commit; lint not applicable.
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

It seems like a lot, but most of these are easy to fix. Let textproc/igor run over it a couple of times and you'll get the exact spots where you need to fix things.
Thank you for the work writing these. I'd be happy to review an updated diff.

1725 ↗(On Diff #53656)

There should be an empty line after the title tag.

1726 ↗(On Diff #53656)


1727 ↗(On Diff #53656)


1729 ↗(On Diff #53656)

You can move the closing <para> up right behind the "guest." part. textproc/igor will tell you about these.

1733 ↗(On Diff #53656)

You can start writing right after <para>, no need for a line break here.

1734 ↗(On Diff #53656)


1740 ↗(On Diff #53656)

Extra space after a sentence stop. textproc/igor will also find and tell you about those occurances (what a snitch). ;-)

1762 ↗(On Diff #53656)

The "in order" can be left out.

1763 ↗(On Diff #53656)


1764 ↗(On Diff #53656)


1772 ↗(On Diff #53656)

I'd add: "To activate verbose booting, run this command:"

1780 ↗(On Diff #53656)


1783 ↗(On Diff #53656)

s/diagnostic/diagnostics/ (or even analysis?)

1788 ↗(On Diff #53656)

The "creation" should be capitalized. textproc/igor will remind you of that. Only a few words in title tags are lowercase like "the", "a", or "of".

1799 ↗(On Diff #53656)

I'd also add <literal> tags to this instance of xl.

1800 ↗(On Diff #53656)

Sentence stop missing here. Not sure if textproc/igor is looking for those...

1824 ↗(On Diff #53656)

you can also use the &os; placeholder here (and in the next two lines) if you like, but it's optional.

1826 ↗(On Diff #53656)

I'd add a sentence stop after the </filename> here and start a new sentence: Both log files can contain useful information for debugging.

Thanks, new version coming.

1824 ↗(On Diff #53656)

I've left this as 'freebsd', since the guest name in the example config name uses 'freebsd' instead of &os;

Apply requested fixes, run igor.

OK as well. Thanks for doing the work. Let me know if I should commit it (giving proper attribution, of course).

This revision is now accepted and ready to land.Feb 11 2019, 5:57 PM

If it's not too much hassle please commit it :)

Thanks for the reviews!

This revision was automatically updated to reflect the committed changes.