Bug 201578

Summary:

Update bhyve chapter with note on CPU UG feature & zfs vol examples

Product:

Documentation

Reporter:

Shawn Debnath <sd>

Component:

Books & Articles

Assignee:

Allan Jude <allanjude>

Status:

Closed FIXED

Severity:

Affects Many People

CC:

allanjude

Priority:

---

Version:

Latest

Hardware:

Any

OS:

Any

Attachments:

Description	Flags
SVN diff en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	none
chapter.xml igor cleanup	none
chapter.xml igor cleanup rev 2	none
chapter.xml igor cleanup rev 3	none
Final reviewed patch (D3105)	none

Description Shawn Debnath 2015-07-15 04:22:12 UTC

Created attachment 158786 [details]
SVN diff en_US.ISO8859-1/books/handbook/virtualization/chapter.xml

To run a bhyve guest with multiple vCPUs, the "VMX unrestriced mode" or "unrestricted guest privileges (UG)" mode is required from the CPU. The current section in the handbook doesn't mention this and may throw new folks off as they are getting started with FreeBSD and bhyve. See Peter Grehan's note in this thread: http://freebsd.1045724.n5.nabble.com/VM-unrestricted-guest-capability-required-td5953993.html

Also, since ZFS is getting quite popular within the FreeBSD community, it seems fit to show the user how to create a zfs volume for use with bhyve.

This change adds a couple sentences in the intro paragraph about the required CPU UG feature if they are planning on creating vms with multiple vCPUS and also adds a section titled "Using ZFS with Bhyve Guests".

Comments, feedback welcome. Happy to change as you guys see fit.

Thanks,
Shawn

Comment 1 Shawn Debnath 2015-07-15 05:22:58 UTC

Created attachment 158788 [details]
chapter.xml igor cleanup

Cleaned up all igor issues, existing and ones introduced by my previous patch, in the chapter.xml.

Comment 2 Shawn Debnath 2015-07-15 05:50:01 UTC

Created attachment 158789 [details]
chapter.xml igor cleanup rev 2

Changed "third" to "Third" based on xmj's feedback.

Comment 3 Shawn Debnath 2015-07-15 20:53:33 UTC

Created attachment 158813 [details]
chapter.xml igor cleanup rev 3

Fixed build break

Comment 4 Shawn Debnath 2015-07-15 22:40:47 UTC

Review: https://reviews.freebsd.org/D3105

Comment 5 Shawn Debnath 2015-07-20 19:40:20 UTC

Created attachment 159023 [details]
Final reviewed patch (D3105)

Comment 6 commit-hook freebsd_committer

2015-07-21 17:56:26 UTC

A commit references this bug:

Author: allanjude
Date: Tue Jul 21 17:55:38 UTC 2015
New revision: 47035
URL: https://svnweb.freebsd.org/changeset/doc/47035

Log:
  Update bhyve chapter with note on CPU UG feature and zfs vol examples

  PR:		201578
  Submitted by:	Shawn Debnath <shawn@debnath.net>
  Approved by:	wblock (mentor)
  Differential Revision:	https://reviews.freebsd.org/D3105

Changes:
  head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml