D Documentation Updates #
This chapter lists content changes for this document.
This manual was updated on the following dates:
Section D.1, “??? 2019 (Documentation Maintenance Update for SUSE Linux Enterprise Server 12 SP4)”
Section D.4, “September 2017 (Initial Release of SUSE Linux Enterprise Server 12 SP3)”
Section D.5, “November 2016 (Release of SUSE Linux Enterprise Server 12 SP2)”
Section D.6, “March 2016 (Documentation Maintenance Update for SUSE Linux Enterprise Server 12 SP1)”
Section D.7, “December 2015 (Initial Release of SUSE Linux Enterprise Server 12 SP1)”
Section D.8, “February 2015 (Documentation Maintenance Update)”
Section D.9, “October 2014 (Initial Release of SUSE Linux Enterprise Server 12)”
D.1 ??? 2019 (Documentation Maintenance Update for SUSE Linux Enterprise Server 12 SP4) #
- Bugfixes
In Section 14.16, “Disabling a Memory Balloon Device”, added missing information about how to disable a virtual memory balloon device in the VM Guest if needed (https://bugzilla.suse.com/show_bug.cgi?id=1127075).
D.2 February 2019 (Documentation Maintenance Update for SUSE Linux Enterprise Server 12 SP4) #
- Bugfixes
Corrected wrong file system size values in command line examples in Section 12.4, “Online Resizing of Guest Block Devices” (https://bugzilla.suse.com/show_bug.cgi?id=1122640).
In Chapter 7, Supported Guests, Hosts and Features, added SLES 12 SP 4 and 15 to the list of supported VM Guests (https://github.com/SUSE/doc-sle/pull/384).
In Section 14.13.2, “Loading and Configuring the SR-IOV Host Drivers”, add
After=network-online.target
to thebefore.service
file (https://bugzilla.suse.com/show_bug.cgi?id=1116659).In Section 10.5.1, “Terminology” and Section 10.5.3, “Creating and Managing Snapshots with
virsh
”, mentioned that external snapshots are not supported by Virtual Machine Manager and cannot be deleted withvirsh
(https://bugzilla.suse.com/show_bug.cgi?id=1125660).
D.3 October 2018 (Documentation Maintenance Update for SUSE Linux Enterprise Server 12 SP3) #
- General Changes to the Documentation
Improved consistency of Docker terminology throughout the documentation. This includes renaming a guide to Docker Open Source Engine Guide.
- Chapter 1, Virtualization Technology
In Section 1.1, “Overview”, mentioned that KVM is supported on the POWER architecture (Fate #321734).
- Chapter 9, Guest Installation
In Section 9.2, “Installing from the Command Line with
virt-install
”, addedlocation
option forvirt-install
(Doc Comment #32443).Added Open Virtual Machine Firmware chapter, see Section 6.5, “Installing UEFI Support” and Using UEFI and Secure Boot (Fate #320490, Fate #319531).
- Chapter 14, Configuring Virtual Machines
Disk space is restored after
virsh snapshot-delete
in Section 10.5.3.3, “Deleting a Snapshot” (Fate #317260).Added Section 18.6.2, “Emulated USB Device” (Fate #321173).
The experimental x-data-plane option was removed in qemu 2.5 and replaced with the more generic IOThreads. See Section 29.3.1.2, “IOThreads”.
- Bugfixes
In Section 18.5.4, “Troubleshooting”, specified values of the
swiotlb
parameter (https://bugzilla.suse.com/show_bug.cgi?id=1101458).In Section 10.7, “Migrating VM Guests”, updated the list of migration requirements (https://bugzilla.suse.com/show_bug.cgi?id=1089361).
KVM on IBM Z is no longer a Technology Preview. See Section 7.3, “KVM Hardware Requirements” (https://bugzilla.suse.com/show_bug.cgi?id=1076430).
In Section 18.6.3, “Paravirtualized PVUSB”, fixed a typo in a configuration file (https://bugzilla.suse.com/show_bug.cgi?id=1075949).
Updated PCI Pass-Through procedure in Section 18.5.1, “Configuring the Hypervisor for PCI Pass-Through” (https://bugzilla.suse.com/show_bug.cgi?id=1061906).
Wallclock synchronization is deprecated,
tsc_mode
is introduced in Section 16.2, “Xen Virtual Machine Clock Settings” (https://bugzilla.suse.com/show_bug.cgi?id=104587).Removed incorrect note about OES time synchronization in Section 16.2, “Xen Virtual Machine Clock Settings” (Doc Comment #34275).
Corrected OES support statements in Section 7.1, “Supported VM Guests” (Doc Comment #34274)
Fixed a typo in Section 10.5, “Creating and Managing Snapshots” (Doc Comment #35101).
D.4 September 2017 (Initial Release of SUSE Linux Enterprise Server 12 SP3) #
- General
Numerous small fixes and additions to the documentation, based on technical feedback.
Removed all references to the
faillog
package, which is no longer shipped (https://bugzilla.suse.com/show_bug.cgi?id=710788).
- Chapter 9, Guest Installation
Added
Enabling Console
item to Section 9.2, “Installing from the Command Line withvirt-install
” (Fate #319328).
Added the command
virsh resume
to Section 10.3.2, “Changing a VM Guest's State withvirsh
” (Doc Comment #33508).
- Chapter 14, Configuring Virtual Machines
- Chapter 27, Setting Up a KVM VM Host Server
Fixed number of queues to
2*N
in Procedure 27.1, “How to Enable Multiqueue virtio-net” (Doc Comment #33252).
- Chapter 29, Running Virtual Machines with qemu-system-ARCH
- Chapter 31, Linux Containers
- Bugfixes
Added sections on disk attaching/detaching—Section 12.2.5, “Attaching Volumes to a VM Guest” and Section 12.2.6, “Detaching Volumes from a VM Guest” (https://bugzilla.suse.com/show_bug.cgi?id=1025371).
In Chapter 6, Installation of Virtualization Components, corrected a button label in YaST (https://bugzilla.suse.com/show_bug.cgi?id=1052536).
D.5 November 2016 (Release of SUSE Linux Enterprise Server 12 SP2) #
- General
The e-mail address for documentation feedback has changed to
doc-team@suse.com
.The documentation for Docker Open Source Engine has been enhanced and renamed to Docker Guide.
- General Changes to this Guide
Added tip about changing the default boot kernel in Section 6.2, “Installing Xen”.
Moved and adjusted two network sections from Chapter 19, Virtual Networking to Section 13.2.3, “Using VLAN Interfaces” and Section 13.2.1.1, “Adding a Network Bridge”.
Removed the deprecated PCI and USB Pass-through related snippets in favor of VFIO (Fate #320350).
Removed the deprecated tool
vm-install
across the whole guide (Fate #319659).Updated parts of the guide that refer to Virtual Machine Manager and
virt-viewer
to work with versions 1.4 and 4.0 of those software packages, respectively (Fate #319990).
- Chapter 5, Virtualization Tools
In Section 5.2, “Virtualization GUI Tools” added note to disable automatic USB device redirection.
- Chapter 7, Supported Guests, Hosts and Features
Added PowerKVM and updated list in Section 7.2, “Supported VM Host Servers for SUSE Linux Enterprise Server 12 SP4 VM Guests” (https://bugzilla.suse.com/show_bug.cgi?id=984119 and Fate #320424).
Updated list in Section 7.1, “Supported VM Guests” (Fate #320426).
- Chapter 10, Basic VM Guest Management
Updated list in Section 10.7.1, “Migration Requirements” (Fate #320425).
- Chapter 11, Connecting and Authorizing
Fixed
usermod
options (https://bugzilla.suse.com/show_bug.cgi?id=983983).
- Chapter 13, Managing Networks
Extended the <dhcp> element with <host> for assigning the predefined IP and host name in Example 13.1, “NAT Based Network” (Fate #320265).
Added Section 13.1.1.5, “Obtaining IP Addresses with
nsswitch
for NAT Networks (in KVM)” (Fate #316628).Added more commands to obtain addresses in Section 13.1.2.2, “Listing Networks” (Fate #316628).
- Chapter 14, Configuring Virtual Machines
Fixed loading igb driver Section 14.13.2, “Loading and Configuring the SR-IOV Host Drivers”.
- Chapter 16, VM Guest Clock Settings
Use kvm-clock together with NTP (Section 16.1, “KVM: Using
kvm_clock
”, https://bugzilla.suse.com/show_bug.cgi?id=994806).
- Chapter 17, libguestfs
New section (Section 17.3.7, “Converting a Physical Machine into a KVM Guest”, Fate #316274).
- Chapter 18, Setting Up a Virtual Machine Host
New section (Section 18.6, “USB Pass-Through”, Fate #316612).
- Chapter 20, Managing a Virtualization Environment
- Chapter 21, Block Devices in Xen
Added Section 21.2, “Mapping Network Storage to Virtual Disk” (Fate #318801).
Added Section 21.5, “Scripts for Managing Advanced Storage Scenarios” (Fate #319810).
- Chapter 29, Running Virtual Machines with qemu-system-ARCH
Added Section 28.2.2.5, “Advanced Options for the qcow2 File Format”.
Added Section 29.3.1.4, “Accessing iSCSI Resources Directly” (Fate #320080).
- Bugfixes
Updated the network bridge invocation command lines in Section 29.4.3.2, “Connecting to a Bridge with qemu-bridge-helper” (https://bugzilla.suse.com/show_bug.cgi?id=983917).
Added PVHVM virtualization mode in Section 1.5, “I/O Virtualization” (https://bugzilla.suse.com/show_bug.cgi?id=958220).
- Section 30.10, “Live Migration”
postcopy
is a technology preview.
D.6 March 2016 (Documentation Maintenance Update for SUSE Linux Enterprise Server 12 SP1) #
- Chapter 7, Supported Guests, Hosts and Features
Added Windows 10 to the list, added latest RHEL versions (https://bugzilla.suse.com/show_bug.cgi?id=961307).
Added missing supported platform KVM for IBM IBM Z 1.1.0 (https://bugzilla.suse.com/show_bug.cgi?id=961678).
D.7 December 2015 (Initial Release of SUSE Linux Enterprise Server 12 SP1) #
- General
SMT Guide is now part of the documentation for SUSE Linux Enterprise Server.
Add-ons provided by SUSE have been renamed as modules and extensions. The manuals have been updated to reflect this change.
Numerous small fixes and additions to the documentation, based on technical feedback.
The registration service has been changed from Novell Customer Center to SUSE Customer Center.
In YaST, you will now reach https://bugzilla.suse.com/show_bug.cgi?id=867809).
via the group. is gone (
- General
Rewrote large parts of the PCI Pass-Through documentation since KVM PCI Pass-Through has been replaced by VFIO.
- Chapter 7, Supported Guests, Hosts and Features
Updated the lists of supported VM Guests and VM Host Servers (Fate #319284 and #319285).
- Chapter 10, Basic VM Guest Management
Refined the information about supported live migration scenarios in Section 10.7.1, “Migration Requirements” (Fate #319283).
Added Section 10.8.2, “Monitoring with
virt-top
” (Fate #319422).
- Chapter 12, Managing Storage
- Chapter 14, Configuring Virtual Machines
Added a note on how to add SR-IOV devices on VM Guest creation to Section 14.13, “Adding SR-IOV Devices” (Fate #315577).
- Chapter 19, Virtual Networking
Fixed unclear wording in Procedure 19.1, “Configuring a routed IPv4 VM Guest” (doc comment 28137).
- Chapter 23, Administrative Tasks
Added new list item for hosts in different subnets in Section 23.3, “Migrating Xen VM Guest Systems” (Fate #303927).
- Chapter 27, Setting Up a KVM VM Host Server
Added the whole chapter and moved
virtio
related KVM content to a subsidiary Section 27.3, “KVM Host-Specific Features”.
- Chapter 29, Running Virtual Machines with qemu-system-ARCH
Added support for e1000 network card variants in Section 29.4.1, “Defining a Network Interface Card”.
Updated the NIC command line specification to the preferred
-netdev
-device
in Section 29.4.1, “Defining a Network Interface Card”.
- Bugfixes
VFIO related improvements to Virtualization Guide (https://bugzilla.suse.com/show_bug.cgi?id=907145).
Added a snippet recommending only one watchdog device at a time in Section 18.1, “Best Practices and Suggestions” (https://bugzilla.suse.com/show_bug.cgi?id=917432).
virsh Console Configuration Is Not Documented (https://bugzilla.suse.com/show_bug.cgi?id=936785).
Wrong Table Title (https://bugzilla.suse.com/show_bug.cgi?id=938671).
Missing Word "Virtualized" (https://bugzilla.suse.com/show_bug.cgi?id=926337).
Added Section 12.5, “Sharing Directories between Host and Guests (File System Pass-Through)” (https://bugzilla.suse.com/show_bug.cgi?id=783346).
D.8 February 2015 (Documentation Maintenance Update) #
- Bugfixes
FIPS: starting of openvn client on SLES 12 fails... (https://bugzilla.suse.com/show_bug.cgi?id=911390).
Misleading Information Related to Supported Virtualization Host (Citrix XenServer) (https://bugzilla.suse.com/show_bug.cgi?id=912700).
qemu-bridge-helper Location (https://bugzilla.suse.com/show_bug.cgi?id=912882).
Virtualization Support Statement of OES 11 SP2 (https://bugzilla.suse.com/show_bug.cgi?id=914727).
D.9 October 2014 (Initial Release of SUSE Linux Enterprise Server 12) #
- General
Removed all KDE documentation and references because KDE is no longer shipped.
Removed all references to SuSEconfig, which is no longer supported (Fate #100011).
Move from System V init to systemd (Fate #310421). Updated affected parts of the documentation.
YaST Runlevel Editor has changed to Services Manager (Fate #312568). Updated affected parts of the documentation.
Removed all references to ISDN support, as ISDN support has been removed (Fate #314594).
Removed all references to the YaST DSL module as it is no longer shipped (Fate #316264).
Removed all references to the YaST Modem module as it is no longer shipped (Fate #316264).
Btrfs has become the default file system for the root partition (Fate #315901). Updated affected parts of the documentation.
The
dmesg
now provides human-readable time stamps inctime()
-like format (Fate #316056). Updated affected parts of the documentation.syslog and syslog-ng have been replaced by rsyslog (Fate #316175). Updated affected parts of the documentation.
MariaDB is now shipped as the relational database instead of MySQL (Fate #313595). Updated affected parts of the documentation.
SUSE-related products are no longer available from http://download.novell.com but from http://download.suse.com. Adjusted links accordingly.
Novell Customer Center has been replaced with SUSE Customer Center. Updated affected parts of the documentation.
/var/run
is mounted as tmpfs (Fate #303793). Updated affected parts of the documentation.The following architectures are no longer supported: IA64 and x86. Updated affected parts of the documentation.
The traditional method for setting up the network with
ifconfig
has been replaced bywicked
. Updated affected parts of the documentation.A lot of networking commands are deprecated and have been replaced by newer commands (usually
ip
). Updated affected parts of the documentation.arp
:ip neighbor
ifconfig
:ip addr
,ip link
iptunnel
:ip tunnel
iwconfig
:iw
nameif
:ip link
,ifrename
netstat
:ss
,ip route
,ip -s link
,ip maddr
route
:ip route
Numerous small fixes and additions to the documentation, based on technical feedback.
- Part I, “Introduction”
- Chapter 8, Starting and Stopping
libvirtd
Added introductory paragraph on
virt-install
.
- Chapter 9, Guest Installation
Updated Section 9.1, “GUI-Based Guest Installation” to match SUSE Linux Enterprise Server 12 state.
Added Section 9.2, “Installing from the Command Line with
virt-install
”.
- Chapter 12, Managing Storage
- Chapter 14, Configuring Virtual Machines
- Chapter 10, Basic VM Guest Management
Added tip in Section 10.4.2, “Saving and Restoring with
virsh
”.
- Part IV, “Managing Virtual Machines with Xen”
Migrated from Xend/xm toolkit to xl.
- Chapter 22, Virtualization: Configuration Options and Settings
- Chapter 28, Guest Installation
Added a tip on
nocow
option in Section 28.2.2, “Creating, Converting and Checking Disk Images”.
- Chapter 29, Running Virtual Machines with qemu-system-ARCH
- Chapter 30, Virtual Machine Administration Using QEMU Monitor
Added
device_add
anddevice_del
commands.
- Part VI, “Managing Virtual Machines with LXC”
- Bugfixes