A Documentation Updates #
This chapter lists content changes for this document.
This manual was updated on the following dates:
Section A.2, “December 2018 (Initial Release of SUSE Linux Enterprise Server 12 SP4)”
Section A.4, “September 2017 (Initial Release of SUSE Linux Enterprise Server 12 SP3)”
Section A.5, “April 2017 (Documentation Maintenance Release)”
Section A.6, “November 2016 (Initial Release of SUSE Linux Enterprise Server 12 SP2)”
Section A.7, “March 2016 (Documentation Maintenance Release)”
Section A.8, “December 2015 (Initial Release of SUSE Linux Enterprise Server 12 SP1)”
Section A.9, “February 2015 (Documentation Maintenance Release)”
Section A.10, “October 2014 (Initial Release of SUSE Linux Enterprise Server 12)”
A.1 February 2019 (Documentation Maintenance Update for SUSE Linux Enterprise Server 12 SP4) #
- Bugfixes
Corrected the description of the purpose of entries in
/boot/zipl/active_devices.txt
(https://bugzilla.suse.com/show_bug.cgi?id=1119484).
A.2 December 2018 (Initial Release of SUSE Linux Enterprise Server 12 SP4) #
- Section 14.1, “List of Optional Modules”
Updated the list of optional modules for SUSE Linux Enterprise Server 12 SP4.
- Section 14.2, “List of Available Extensions”
Added a list of available extensions for SUSE Linux Enterprise Server 12 SP4.
- Part VI, “Updating and Upgrading SUSE Linux Enterprise”
Updated the chapters of this part, including Figure 19.1, “Overview of Supported Upgrade Paths” and Section 19.3.6, “Migrate your PostgreSQL Database” (Fate #325659).
In Section 19.3.9, “Adjust Your SMT Client Setup”, added how to de-register an SMT client in case of problems upgrading the machine.
A.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, Planning for SUSE Linux Enterprise Server
Added a section about SUSE Customer Center registration with YaST and
SUSEConnect
. See Section 1.4, “Registering SUSE Linux Enterprise Server” and Section 13.2, “Registering an Installed System” (https://bugzilla.suse.com/show_bug.cgi?id=1075996).
- Chapter 7, Cloning Disk Images
Added section about cleaning up cloned disk images, see Chapter 7, Cloning Disk Images (Fate ##321159).
- Section 14.1, “List of Optional Modules”
Added a new section listing all optional modules in Section 14.1, “List of Optional Modules” (https://bugzilla.suse.com/show_bug.cgi?id=1058076).
- Chapter 15, Installing Multiple Kernel Versions
Corrected kernel version strings in Section 15.1.1, “Automatically Deleting Unused Kernels” (https://bugzilla.suse.com/show_bug.cgi?id=1020271).
- Chapter 16, Managing Users with YaST
Removed LDAP and Kerberos authentication methods and added SSSD, see Section 16.7, “Changing the User Authentication Method” (https://bugzilla.suse.com/show_bug.cgi?id=1077112).
- Bugfixes
Added a new section listing all optional modules in Section 14.1, “List of Optional Modules” (https://bugzilla.suse.com/show_bug.cgi?id=1058076).
Added note to Section 19.2, “Online and Offline Upgrade” about upgrading SUSE Manager clients (https://bugzilla.suse.com/show_bug.cgi?id=1094593).
Fixed configuration files for recommended packages installation, see Section 21.5, “Upgrading with Zypper” and Section 21.4, “Upgrading with the Online Migration Tool (YaST)” (https://bugzilla.suse.com/show_bug.cgi?id=1088985).
Removed Certifications Module from list of available modules in Section 14.1, “List of Optional Modules”; it does not exist for SLE 12 SP2 and later (https://bugzilla.suse.com/show_bug.cgi?id=1080616).
Fixed error in upgrade paths image in Section 19.1, “Supported Upgrade Paths to SLE 12 SP4” (https://bugzilla.suse.com/show_bug.cgi?id=1077734).
Removed LDAP and Kerberos authentication methods and added SSSD, see Section 16.7, “Changing the User Authentication Method” (https://bugzilla.suse.com/show_bug.cgi?id=1077112).
Added a section about SUSE Customer Center registration with YaST and
SUSEConnect
See Section 1.4, “Registering SUSE Linux Enterprise Server” and Section 13.2, “Registering an Installed System” (https://bugzilla.suse.com/show_bug.cgi?id=1075996).On IBM Z,
/boot
must not be on RAID or LVM, see Section 6.11, “Suggested Partitioning” (https://bugzilla.suse.com/show_bug.cgi?id=1066566).Installer self-update is enabled by default, see Section 6.4, “Installer Self-Update” (https://bugzilla.suse.com/show_bug.cgi?id=1058042).
Fixed broken link in Section 4.1.1.1.3, “Network Connection” (https://bugzilla.suse.com/show_bug.cgi?id=1029132).
Corrected kernel version strings in Section 15.1.1, “Automatically Deleting Unused Kernels” (https://bugzilla.suse.com/show_bug.cgi?id=1020271).
A.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 6, Installation with YaST
In Section 6.6, “IBM IBM Z: Disk Activation”, adjusted a link to point to a more appropriate section in the Storage Administration Guide (https://bugzilla.suse.com/show_bug.cgi?id=1042060).
- Chapter 9, Preparing the Boot of the Target System
Removed all documentation about connecting to a VNC server with a Java-capable browser. Java is no longer supported by most browsers for security reasons.
Modified PXE boot to accommodate UEFI (https://bugzilla.suse.com/show_bug.cgi?id=1006558).
Added Section 9.6, “Booting from CD or USB Drive Instead of PXE”.
- Chapter 14, Installing Modules, Extensions, and Third Party Add-On Products
Moved Section 14.6, “SUSE Package Hub” from Chapter 6, Installation with YaST to this chapter.
In Section 14.5, “SUSE Software Development Kit (SDK) 12 SP4”, added information about the support status of the SDK.
In Procedure 14.1, “Installing Add-ons and Extensions from Online Channels with YaST”, mentioned new entry in YaST to directly install extensions and modules (Fate #321044).
- Chapter 18, Life Cycle and Support
In Section 18.7, “Repository Model”, updated repository model with SLE 12 SP3.
Added Section 18.5, “Generating Periodic Life Cycle Report” (Fate #322059).
In Section 18.7.3, “Module-Specific Repositories for SUSE Linux Enterprise Server”, mentioned that a certain module is not available on POWER (https://bugzilla.suse.com/show_bug.cgi?id=1048670).
In Note: Origin of Packages for SUSE Linux Enterprise 12 and Later, rephrased a sentence (https://bugzilla.suse.com/show_bug.cgi?id=1048672).
- Chapter 19, Upgrading SUSE Linux Enterprise
Added information about offline and online upgrading methods to Section 19.2, “Online and Offline Upgrade”.
Added backup of package and repository list to Section 19.3.3.1, “Listing Installed Packages and Repositories”.
Mentioned zypper and YaST as the suggested methods for Service Pack migration in Section 19.2, “Online and Offline Upgrade”.
Added Note: Amount of Packages Increases with an Update to a New Major Release (https://bugzilla.suse.com/show_bug.cgi?id=1045649).
Corrected terminology in the introduction to the chapter (https://bugzilla.suse.com/show_bug.cgi?id=1048680).
In Section 19.1, “Supported Upgrade Paths to SLE 12 SP4”, added missing version numbers (https://bugzilla.suse.com/show_bug.cgi?id=1048675).
Added Section 19.3.1, “Make Sure the Current System Is Up-To-Date” (https://bugzilla.suse.com/show_bug.cgi?id=1051670).
- Chapter 20, Upgrading Offline
Added information about migration options with SUSE Manager, see Section 20.6, “Updating via SUSE Manager” (https://bugzilla.suse.com/show_bug.cgi?id=1035716).
- Chapter 21, Upgrading Online
When upgrading with plain zypper, a solution for a kernel version conflict needs to be picked, see Section 21.6, “Upgrading with Plain Zypper” (https://bugzilla.suse.com/show_bug.cgi?id=1032595).
Automatic LUN scanning on IBM Z only works with NPIV enabled, see Section 6.6.2, “Configuring zFCP Disks”.
SCC, SMT and SUMA repositories can be used for online migration, see Section 21.2, “Service Pack Migration Workflow” (Doc Comment #32436).
- Bugfixes
In Section 6.2.2.2, “The Boot Screen on Machines Equipped with UEFI”, fixed a typo in an installation entry example (https://bugzilla.suse.com/show_bug.cgi?id=1051387).
A.5 April 2017 (Documentation Maintenance Release) #
- Chapter 4, Installation on IBM IBM Z
Mentioned possibility of using
susehmc.ins
(https://bugzilla.suse.com/show_bug.cgi?id=1009081).
- Section 18.3, “Module Life Cycles”
Added link to Module Life Cycles Web site (https://bugzilla.suse.com/show_bug.cgi?id=1014266).
- Bugfixes
Explicitly advised not to specify other repositories with the self-update parameter than the installer self-update one. In addition, specified how to enable such a repository in SMT (https://bugzilla.suse.com/show_bug.cgi?id=1015481).
A.6 November 2016 (Initial 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
The complete guide has been revised, restructured, and flattened (Fate #319115).
Chapter 5, Installation on Arm AArch64 has been added (Fate #318444).
- Chapter 3, Installation on IBM POWER
Updates and corrections on installation with Kimchi (https://bugzilla.suse.com/show_bug.cgi?id=979054).
linuxrc now suggests default values (Fate #318453).
Added documentation for installing KVM guests on IBM IBM Z (https://bugzilla.suse.com/show_bug.cgi?id=958733).
- Chapter 4, Installation on IBM IBM Z
linuxrc no longer asks for a portname (Fate #320112).
linuxrc now suggests default values (Fate #318453).
Added documentation for installing KVM guests on IBM IBM Z (https://bugzilla.suse.com/show_bug.cgi?id=958733).
- Chapter 6, Installation with YaST
Added a tip on how to access network storage to Section 6.7, “Network Settings”.
Dialog options for creating an encrypted LVM file system (Section 6.11, “Suggested Partitioning”) have changed (Fate #320418).
Added a note on
cio_ignore
to Section 6.16.1, “IBM IBM Z: IPLing the Installed System”.The
has been removed from the dialog (Fate #320448).Added Section 6.2.3.6, “Enabling the Installer Self-Update”.
zKVM machines are shut down at the end of the installation (https://bugzilla.suse.com/show_bug.cgi?id=992081).
- Chapter 18, Life Cycle and Support
Updated list of modules, see Section 18.7, “Repository Model” (Fate #320579).
- Chapter 21, Upgrading Online
Added Section 19.3.7, “Create Non-MD5 Server Certificates for Java Applications” (https://bugzilla.suse.com/show_bug.cgi?id=970153).
Added a conceptual overview and mentioned additional migration strategies (https://bugzilla.suse.com/show_bug.cgi?id=968195).
Added Section 20.7, “Updating Registration Status after Rollback” (Fate #319118).
Added Section 19.3.9, “Adjust Your SMT Client Setup” (https://bugzilla.suse.com/show_bug.cgi?id=944342).
Implemented a notice to make sure a service pack migration is not performed with insufficient disk space (Fate #317784, see Section 19.3.10, “Disk Space”).
Mentioned that during installation, an installation resource is added and removed afterward (Fate #320494).
- Bugfixes
Removed link (https://bugzilla.suse.com/show_bug.cgi?id=972355).
Added documentation for installing KVM guests on IBM IBM Z (https://bugzilla.suse.com/show_bug.cgi?id=958733).
Added note about where to place
/boot
for an LVM root file system (https://bugzilla.suse.com/show_bug.cgi?id=1000631).Added more information about rolling back a service pack (https://bugzilla.suse.com/show_bug.cgi?id=1001070).
Added recommendations for the case of running an update from within a GNOME session (https://bugzilla.suse.com/show_bug.cgi?id=1001684 ).
A.7 March 2016 (Documentation Maintenance Release) #
- Chapter 4, Installation on IBM IBM Z
Mentioned requirement for a local X server and instructions for Microsoft Windows (https://bugzilla.suse.com/show_bug.cgi?id=956059).
Renamed
zpxe.exec
tozpxe.rexx
and rephrased sentence regarding correct place (https://bugzilla.suse.com/show_bug.cgi?id=867809).Added note about z/VM 6.3 regarding installation of APAR VM65419 (https://bugzilla.suse.com/show_bug.cgi?id=958054).
- Chapter 12, Advanced Disk Setup
Distinguished between remote and local repository more clearly (https://bugzilla.suse.com/show_bug.cgi?id=956058).
Added note about reformatting partitions with
mkswap
, because initrd image cannot boot up when swap partition has changed (https://bugzilla.suse.com/show_bug.cgi?id=955822).
A.8 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 (
- Chapter 2, Installation on AMD64 and Intel 64
Removed pointers to the
boot option, which has been removed (Fate #317016).
- Chapter 4, Installation on IBM IBM Z
Added installation instruction for KVM guests (Fate #319264).
Added Section 4.2.7, “The SUSE Linux Enterprise Server Boot Procedure on IBM IBM Z”.
- Chapter 6, Installation with YaST
Added Section 6.2.3.4, “Using a Proxy for the Installation” (Fate #318488).
Added a warning on using unsigned drivers in secure boot mode to Section 6.2.2.2, “The Boot Screen on Machines Equipped with UEFI” (Fate #317593).
- Chapter 13, Installing or Removing Software
Added Section 13.3.4.1, “Handling of Package Recommendations” (Fate #318099).
- Chapter 14, Installing Modules, Extensions, and Third Party Add-On Products
Updated chapter to reflect the software changes to the former YaST
dialog (now called ) and the YaST module (Fate #318800).
- Chapter 12, Advanced Disk Setup
Mentioned that subvolumes for
/var/lib/mariadb
,/var/lib/pgsql
, and/var/lib/libvirt/images
are created with the optionno copy on write
by default to avoid extensive fragmenting with Btrfs.
- Subscription Management
The chapter about registering clients at a Subscription Management Tool server has been replaced by Configuring Clients to Use SMT.
- Part VI, “Updating and Upgrading SUSE Linux Enterprise”
Split former update chapter into several independent chapters and combined them under this new part.
Removed YaST Wagon chapter, as YaST Wagon is unsupported for SUSE Linux Enterprise Server 12 SP4.
Added new chapter: Chapter 21, Upgrading Online.
Added Section 19.3.5, “Migrate your MySQL Database” and Section 19.3.6, “Migrate your PostgreSQL Database”.
Integrated various new features: Fate #315161, Fate #318636, Fate #319128, Fate #319129, Fate #319138, Fate #319140.
- Bugfixes
Fixed path to
zpxe.exec
(https://bugzilla.suse.com/show_bug.cgi?id=937511).Added the
https
protocol to Section 4.3.3, “Specifying the Installation Source and YaST Interface” (https://bugzilla.suse.com/show_bug.cgi?id=951421).Consistent use of
yast
,yast2.ssh
,yast.ssh
for SSH based installation (https://bugzilla.suse.com/show_bug.cgi?id=956060).Consistent spelling of boot parameters (https://bugzilla.suse.com/show_bug.cgi?id=956054).
PowerKVM: virt-install does not know about SLES12 (https://bugzilla.suse.com/show_bug.cgi?id=880918).
IBM POWER: Starting an X-Server after an Upgrade (https://bugzilla.suse.com/show_bug.cgi?id=948980).
Added documentation on the boot process for IBM IBM Z (https://bugzilla.suse.com/show_bug.cgi?id=942772).
Description of encrypted
/
and/boot
on Btrfs was missing. Added an important note in Section 6.11, “Suggested Partitioning” and Section 12.1.2.1, “Btrfs Partitioning” (https://bugzilla.suse.com/show_bug.cgi?id=926951).Zypper multiversion kernels should be mentioned for SP2 Update (https://bugzilla.suse.com/show_bug.cgi?id=753809).
SLES 12 Deployment Guide errors for zPXE installations (https://bugzilla.suse.com/show_bug.cgi?id=944384).
AutoYaST hangs at "Configuring Bootloader ... 50%" with 512RAM (https://bugzilla.suse.com/show_bug.cgi?id=927237).
Netsetup Parameters Wrong (https://bugzilla.suse.com/show_bug.cgi?id=928792).
Documentation on not creating /usr as separate partition is missing (https://bugzilla.suse.com/show_bug.cgi?id=930267).
Document how to enable SELinux during install (https://bugzilla.suse.com/show_bug.cgi?id=928158).
YaST boot loader: supported scenarios needs updating clarification (https://bugzilla.suse.com/show_bug.cgi?id=939197).
A.9 February 2015 (Documentation Maintenance Release) #
- Section 6.12, “Clock and Time Zone”
With NTP disabled it is recommended to avoid writing system time to the hardware clock. Thus set
SYSTOHC=no
.- Bugfixes
Adjustments for SMT because of the switch from SUSE Customer Center to SUSE Customer Center (https://bugzilla.suse.com/show_bug.cgi?id=857639).
Section 16.3.2, “Enforcing Password Policies”: Password Settings, Expiration Date is expiring user accounts in YaST Users module (https://bugzilla.suse.com/show_bug.cgi?id=743874).
Various bugfixes for Chapter 19, Upgrading SUSE Linux Enterprise:
The named upgrade path does not work, there is no working upgrade path from SLES 11 SP3 to SLES 12 on Linux for System z (https://bugzilla.suse.com/show_bug.cgi?id=907648).
The Atomic Update (https://bugzilla.suse.com/show_bug.cgi?id=905330).
Upgrading to SLE 12 (https://bugzilla.suse.com/show_bug.cgi?id=904188).
Intermediate step: Updating SLE 11 SP2 to SLE 11 SP3 (https://bugzilla.suse.com/show_bug.cgi?id=904186).
Supported Upgrade Paths to SLE (https://bugzilla.suse.com/show_bug.cgi?id=904182).
Potentially misleading info around the 6-month overlap in support (https://bugzilla.suse.com/show_bug.cgi?id=902463).
A.10 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.
- Chapter 2, Installation on AMD64 and Intel 64
Updated system requirements.
- Chapter 3, Installation on IBM POWER
Added POWER8 to the list of supported hardware (Fate #315272).
SUSE Linux Enterprise Server 12 for POWER has moved to Little Endian. Updated affected parts of the documentation.
- Chapter 4, Installation on IBM IBM Z
Updated the list of supported platforms: Removed IBM Series z9 and z10 machines and added IBM zEnterprise BC12.
Updated the memory and disk space requirements.
Removed instructions on how to IPL from tape—this is no longer supported.
Rewrote large parts of Section 4.2.5, “Network Configuration” to remove redundant information and make it more concise.
Removed references to Token Ring, which is no longer supported (Fate #313154).
- Chapter 6, Installation with YaST
Completely rewrote the chapter because of the new installation workflow.
The installation routine now supports setting up multiple network devices during the installation (Fate #315680): Section 6.7, “Network Settings”.
The installation proposal contains a separate
/home
partition formatted with XFS (Fate #316637 and Fate #316624): Section 6.11, “Suggested Partitioning”.Removed occurrences of the YaST Repair module which has been dropped (Fate #308670).
Update repositories are added after having registered with SUSE Customer Center and can be used during installation (Fate #312012): Section 6.9, “Extension Selection”.
Extensions and modules can be added to the system during the installation (Fate #316548): Section 6.8, “SUSE Customer Center Registration”.
SUSE Linux Enterprise Desktop can be installed as an add-on on top of SUSE Linux Enterprise Server (Fate #316436): Section 6.9, “Extension Selection”.
The HW crypto stack for IBM IBM Z can be selected for installation via a pattern (Fate #316143): Section 6.15.1, “. ”
Automatically importing SSH keys from a previous installation can be disabled (Fate #314982).
- Chapter 19, Upgrading SUSE Linux Enterprise
Added new section: Section 19.2, “Online and Offline Upgrade”.
- Chapter 11, Setting Up Hardware Components with YaST
Removed the following sections as the respective YaST modules are no longer included: Hardware Information, Setting Up Graphics Card and Monitor, Mouse Model, and Setting Up a Scanner.
Removed content about mouse setup and adjusted Section 11.1, “Setting Up Your System Keyboard Layout”.
- Chapter 13, Installing or Removing Software
Completely rewrote Section 13.5, “Keeping the System Up-to-date” because of changes in the GNOME software updater.
- Chapter 14, Installing Modules, Extensions, and Third Party Add-On Products
Installing add-on products or software extensions is now also possible without access to physical media. Added the following new sections: Section 20.8, “Registering Your System” and Section 14.3, “Installing Modules and Extensions from Online Channels”. Modified Section 14.4, “Installing Extensions and Third Party Add-On Products from Media” accordingly.
- Subscription Management
For registering clients against an SMT server,
suse_register
has been replaced withSUSEConnect
(Fate #316585).
- Bugfixes
Updated section Section 13.5, “Keeping the System Up-to-date” according to http://bugzilla.suse.com/show_bug.cgi?id=839692.
Removed section Using Fingerprint Authentication. Further minor corrections and additions (http://bugzilla.suse.com/show_bug.cgi?id=857680).
Removed obsolete parameter
OsaMedium
from parmfile and Cobbler examples (http://bugzilla.suse.com/show_bug.cgi?id=860404).Added instructions on how to add secondary languages during installation (http://bugzilla.suse.com/show_bug.cgi?id=870482).
Multiversion feature (more than one kernel installed) is enabled by default (http://bugzilla.suse.com/show_bug.cgi?id=891805).
Warn about incompatible Kernel Module Packages (KPMs) (http://bugzilla.suse.com/show_bug.cgi?id=891805).