Page MenuHomeFreeBSD

xen: add troubleshooting section
ClosedPublic

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

Details

Summary

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

Diff Detail

Repository
rD FreeBSD doc repository
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

royger created this revision.Thu, Feb 7, 3:22 PM
bcr added a comment.Thu, Feb 7, 3:52 PM

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.

en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
1725 ↗(On Diff #53656)

There should be an empty line after the title tag.

1726 ↗(On Diff #53656)

s/constain/contains/

1727 ↗(On Diff #53656)

s/troubleshot/troubleshoot/

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)

s/troubleshootting/troubleshooting/

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)

s/reate/rate/

1764 ↗(On Diff #53656)

s/guest/guests/

1772 ↗(On Diff #53656)

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

1780 ↗(On Diff #53656)

s/this/these/
s/helps/help/

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.

royger marked 17 inline comments as done.Mon, Feb 11, 11:10 AM

Thanks, new version coming.

en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
1824 ↗(On Diff #53656)

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

royger updated this revision to Diff 53768.Mon, Feb 11, 11:11 AM

Apply requested fixes, run igor.

bcr accepted this revision.Mon, Feb 11, 5:57 PM

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.Mon, Feb 11, 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.