Bug 201578 - Update bhyve chapter with note on CPU UG feature & zfs vol examples
Summary: Update bhyve chapter with note on CPU UG feature & zfs vol examples
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Allan Jude
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-07-15 04:22 UTC by Shawn Debnath
Modified: 2015-07-21 17:57 UTC (History)
1 user (show)

See Also:

Attachments
SVN diff en_US.ISO8859-1/books/handbook/virtualization/chapter.xml (3.86 KB, patch)
2015-07-15 04:22 UTC, Shawn Debnath 		no flags Details | Diff
chapter.xml igor cleanup (39.46 KB, patch)
2015-07-15 05:22 UTC, Shawn Debnath 		no flags Details | Diff
chapter.xml igor cleanup rev 2 (39.46 KB, patch)
2015-07-15 05:50 UTC, Shawn Debnath 		no flags Details | Diff
chapter.xml igor cleanup rev 3 (39.59 KB, patch)
2015-07-15 20:53 UTC, Shawn Debnath 		no flags Details | Diff
Final reviewed patch (D3105) (64.40 KB, patch)
2015-07-20 19:40 UTC, Shawn Debnath 		no flags Details | Diff
Show Obsolete (4) View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
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 freebsd_triage 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