From Fedora Project Wiki
(https://pagure.io/fesco/issue/1749)
Line 11: Line 11:
  
 
== Current status ==
 
== Current status ==
* Targeted release: [[Releases/27 | Fedora 27 ]]  
+
* Targeted release: [[Releases/28 | Fedora 28 ]]  
 
* Last updated: {{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}  
 
* Last updated: {{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}  
 
<!-- After the change proposal is accepted by FESCo, tracking bug is created in Bugzilla and linked to this page  
 
<!-- After the change proposal is accepted by FESCo, tracking bug is created in Bugzilla and linked to this page  
Line 33: Line 33:
 
== Scope ==
 
== Scope ==
 
* Proposal owners:
 
* Proposal owners:
** Adding the VirtualBox guest drivers to the kernel package. To make this happen work is underway to clean them up and submit them upstream.
+
** The VirtualBox guest drivers have been merged into linux-next and will be in 4.16, the kernel-release with which F28 will ship. The separate vboxsf kernel-driver has been submitted upstream and is awaiting review upstream. If the vboxsf driver does not get accepted upstream in time we can ship with VirtualBox guest integration without shared-folder support.
** Package VirtualBox Guest Additions userspace parts
+
** Package VirtualBox Guest Additions userspace parts [https://bugzilla.redhat.com/show_bug.cgi?id=1481630 (Review Request)]
 
** Add VirtualBox Guest Additions package to the default package list for the Workstation product
 
** Add VirtualBox Guest Additions package to the default package list for the Workstation product
 
* Other developers: N/A (not a System Wide Change)
 
* Other developers: N/A (not a System Wide Change)
Line 46: Line 46:
  
 
== How To Test ==
 
== How To Test ==
# Install Fedora 27 into a VirtualBox virtual-machine.
+
# Install Fedora 28 into a VirtualBox virtual-machine.
 
# Test the features listed below under "User Experience".
 
# Test the features listed below under "User Experience".
  
Line 54: Line 54:
 
* Seamless mode support (only show guest windows, hide guest background)
 
* Seamless mode support (only show guest windows, hide guest background)
 
* Copy and paste between guest and host
 
* Copy and paste between guest and host
 +
* 3D passthrough
 
* Folder sharing
 
* Folder sharing
* 3D passthrough
 
  
 
== Dependencies ==
 
== Dependencies ==
Line 61: Line 61:
  
 
== Contingency Plan ==
 
== Contingency Plan ==
* Contingency mechanism: The proposal owner will remove the VirtualBox Guest Additions package from the default package list for the Workstation product if it is not working properly
+
* Contingency mechanism:  
 +
** The proposal owner will remove the VirtualBox Guest Additions package from the default package list for the Workstation product if it is not working properly
 +
** If the vboxsf kernel driver is not yet ready we can ship with VirtualBox guest integration without shared-folder support.
 
* Contingency deadline: Beta Freeze
 
* Contingency deadline: Beta Freeze
 
* Blocks release? No
 
* Blocks release? No
Line 72: Line 74:
 
TODO
 
TODO
  
[[Category:ChangePageIncomplete]]
+
[[Category:ChangeReadyForWrangler]]
 
[[Category:SelfContainedChange]]
 
[[Category:SelfContainedChange]]

Revision as of 06:05, 21 December 2017

VirtualBox Guest Integration

Summary

VirtualBox is popular, easy to use virtual-machine software. The purpose of this change is to ship the VirtualBox guest-drivers and -tools by default in the Fedora workstation product.

Owner

  • Name: Hans de Goede
  • Email: hdegoede@redhat.com
  • Release notes owner:
  • Product: Workstation

Current status

  • Targeted release: Fedora 28
  • Last updated: 2017-12-21
  • Tracker bug: <will be assigned by the Wrangler>

Detailed Description

VirtualBox runs on Windows. MacOS and Linux and is used by many users to try it Linux for the first time. As such it is important for Fedora to work well in VirtualBox virtual-machines. Like other virtual-machines VirtualBox virtual-machines can offer an enhanced user-experience when some VirtualBox specific guest-drivers and guest-tools are installed. This change is about adding the guest-drivers to the Fedora kernel package, packaging the userspace-tools (VirtualBox Guest Additions) and adding the VirtualBox Guest Additions package to the default package list for the Workstation product.

Benefit to Fedora

Better integration with VirtualBox leads to a much better user-experience for users who decide to run Fedora under VirtualBox. Also see the extra features this enables below under "User Experience".

Scope

  • Proposal owners:
    • The VirtualBox guest drivers have been merged into linux-next and will be in 4.16, the kernel-release with which F28 will ship. The separate vboxsf kernel-driver has been submitted upstream and is awaiting review upstream. If the vboxsf driver does not get accepted upstream in time we can ship with VirtualBox guest integration without shared-folder support.
    • Package VirtualBox Guest Additions userspace parts (Review Request)
    • Add VirtualBox Guest Additions package to the default package list for the Workstation product
  • Other developers: N/A (not a System Wide Change)
  • Release engineering: [1] (a check of an impact with Release Engineering is needed)
  • Policies and guidelines: N/A (not a System Wide Change)
  • Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

Upgrade paths which automatically install new default packages will automatically get this feature enabled. Users using other upgrade paths (e.g. a manual dnf update) will need to install the VirtualBox Guest Additions package manually to get this feature enabled.

How To Test

  1. Install Fedora 28 into a VirtualBox virtual-machine.
  2. Test the features listed below under "User Experience".

User Experience

Users running Fedora under VirtualBox will gain the following features:

  • Automatic resizing of the guest desktop-resolution to the vm's window-size
  • Seamless mode support (only show guest windows, hide guest background)
  • Copy and paste between guest and host
  • 3D passthrough
  • Folder sharing

Dependencies

N/A (not a System Wide Change)

Contingency Plan

  • Contingency mechanism:
    • The proposal owner will remove the VirtualBox Guest Additions package from the default package list for the Workstation product if it is not working properly
    • If the vboxsf kernel driver is not yet ready we can ship with VirtualBox guest integration without shared-folder support.
  • Contingency deadline: Beta Freeze
  • Blocks release? No
  • Blocks product? Workstation

Documentation

N/A (not a System Wide Change)

Release Notes

TODO