E Documentation Updates #
This chapter lists content changes for this document.
This manual was updated on the following dates:
Section E.3, “December 2018 (Initial Release of SUSE Linux Enterprise High Availability 12 SP4)”
Section E.4, “October 2018 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP3)”
Section E.5, “July 2018 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP3)”
Section E.6, “September 2017 (Initial Release of SUSE Linux Enterprise High Availability 12 SP3)”
Section E.7, “April 2017 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP2)”
Section E.8, “March 2017 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP2)”
Section E.9, “November 2016 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP2)”
Section E.10, “November 2016 (Initial Release of SUSE Linux Enterprise High Availability 12 SP2)”
Section E.11, “December 2015 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP1)”
Section E.12, “December 2015 (Initial Release of SUSE Linux Enterprise High Availability 12 SP1)”
Section E.13, “October 2014 (Initial Release of SUSE Linux Enterprise High Availability 12)”
E.1 2020 (Documentation Maintenance Update for SUSE Linux Enterprise High Availability 12 SP4) #
- Bugfixes
Add Procedure 24.3, “Performing a Cluster-wide Fresh Installation of a New Service Pack” for customers who prefer a fresh installation even for moving to the next service pack (Fate #325878).
E.2 2019 (Documentation Maintenance Update for SUSE Linux Enterprise High Availability 12 SP4) #
- Bugfixes
In Section 10.5, “Calculation of Timeouts”, corrected the formula for timeout calculation in Example 10.1 (https://bugzilla.suse.com/show_bug.cgi?id=1131440).
In Chapter 4, Using the YaST Cluster Module, mentioned that the RRP mode
active
is deprecated (https://bugzilla.suse.com/show_bug.cgi?id=1121869).In Section 19.2.4, “Scenario: cLVM With DRBD”, removed the option
become-primary-on
from the example DRBD configuration (https://bugzilla.suse.com/show_bug.cgi?id=1131776).
E.3 December 2018 (Initial Release of SUSE Linux Enterprise High Availability 12 SP4) #
- Bugfixes
Turned content of Example 9.3, “Configuration of a Kdump Device” into a procedure and added a step to rebuild
initrd
(https://bugzilla.suse.com/show_bug.cgi?id=1118238).In Section 7.1, “crmsh—Overview”, mentioned that we omit the host name in the interactive crm prompts in the documentation, unless you need to run the command on a specific node in the cluster (https://bugzilla.suse.com/show_bug.cgi?id=1103828).
Fixed errors and line breaks in commands (http://bugzilla.suse.com/show_bug.cgi?id=1103846, http://bugzilla.suse.com/show_bug.cgi?id=1103843).
In Section 23.9, “Rebooting a Cluster Node While In Maintenance Mode”, specified how to recognize DLM resources (doc comment #38758).
In Section 6.3, “Hawk2 Overview: Main Elements”, mentioned that Hawk2 now displays
guest nodes
, too (Fate #324581).Fixed several typos in links, names, packages, and terms (https://bugzilla.suse.com/show_bug.cgi?id=1098429, https://bugzilla.suse.com/show_bug.cgi?id=1108586, https://bugzilla.suse.com/show_bug.cgi?id=1108604, https://bugzilla.suse.com/show_bug.cgi?id=1108624).
E.4 October 2018 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP3) #
- Bugfixes
In Chapter 18, DRBD, added Section 18.6, “Using Resource-Level Fencing” (https://bugzilla.suse.com/show_bug.cgi?id=1095374).
Fixed several typos (https://bugzilla.suse.com/show_bug.cgi?id=1107588, https://bugzilla.suse.com/show_bug.cgi?id=1108279, https://bugzilla.suse.com/show_bug.cgi?id=1108287, https://bugzilla.suse.com/show_bug.cgi?id=1108626, https://bugzilla.suse.com/show_bug.cgi?id=1108313).
Corrected or removed outdated links (https://bugzilla.suse.com/show_bug.cgi?id=1107878, https://bugzilla.suse.com/show_bug.cgi?id=1108603, https://bugzilla.suse.com/show_bug.cgi?id=1108644, https://bugzilla.suse.com/show_bug.cgi?id=1108641).
E.5 July 2018 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP3) #
- General Changes to this Guide
Completely revised Chapter 10, Storage Protection and SBD and moved it to a different place in the book.
Added Chapter 23, Executing Maintenance Tasks. Moved respective sections from Chapter 5, Configuration and Administration Basics, Chapter 6, Configuring and Managing Cluster Resources with Hawk2, and Chapter 7, Configuring and Managing Cluster Resources (Command Line) there. The new chapter gives an overview of different options the cluster stack provides for executing maintenance tasks.
- Bugfixes
In Section 19.2, “Configuration of cLVM”, added that
use_lvmetad
must be set to zero when using cLVM (https://bugzilla.suse.com/show_bug.cgi?id=1057178).In Section 23.2, “Different Options for Maintenance Tasks”, clarified the difference between setting a resource to
is-managed=false
and setting it to maintenance mode (https://bugzilla.suse.com/show_bug.cgi?id=1070040).In Section 16.1, “Features and Benefits”, added a note to clarify support status of OCFS2 (https://bugzilla.suse.com/show_bug.cgi?id=1074694).
In Section 10.10.1, “Configuring an sg_persist Resource”, clarified SCSI Disk Compatibility of
sg_persist
, removed the OCFS2 primitive and updated the procedure (https://bugzilla.suse.com/show_bug.cgi?id=1063875).In Procedure 24.1, “Upgrading from Product Version 11 to 12: Cluster Offline Upgrade”, corrected a command and added a missing step (https://bugzilla.suse.com/show_bug.cgi?id=1046594).
In Section 19.2.2, “Scenario: Configuring Cmirrord”, corrected timings and intervals for
clvmd
primitive (https://bugzilla.suse.com/show_bug.cgi?id=985590).In Procedure 10.2, “Loading the Softdog Kernel Module”, corrected command about loading the softdog module to be consistent with the Installation and Setup Quick Start (https://bugzilla.suse.com/show_bug.cgi?id=1090169).
In Procedure 4.2, “Defining the First Communication Channel (Unicast)”, removed one step and replaced a screenshot that shows the unicast configuration with YaST cluster (https://bugzilla.suse.com/show_bug.cgi?id=1094218).
Moved the maintenance topic to Chapter 23, Executing Maintenance Tasks. This new chapter also mentions the implications of taking down a cluster node and gives more detailed information about the variety of options that Pacemaker offers for doing maintenance work (https://bugzilla.suse.com/show_bug.cgi?id=1080869).
In Chapter 21, Samba Clustering, renamed resource groups, clones, colocations and order constraints to match the Naming Conventions for the documentation (https://bugzilla.suse.com/show_bug.cgi?id=1016758).
Added Chapter 15, Distributed Lock Manager (DLM). Moved some content there that was formerly distributed across the Administration Guide. Added information about the protocols that DLM can use (https://bugzilla.suse.com/show_bug.cgi?id=1089339).
In Chapter 9, Fencing and STONITH, improved the description of resource level fencing (https://bugzilla.suse.com/show_bug.cgi?id=1067076).
In Chapter 5, Configuration and Administration Basics, added use case scenarios and quorum determination (https://bugzilla.suse.com/show_bug.cgi?id=1088466).
In Section 10.8, “Setting Up Diskless SBD”, added a sentence to clarify that diskless SBD does not require a STONITH SBD resource (https://bugzilla.suse.com/show_bug.cgi?id=1102199).
E.6 September 2017 (Initial Release of SUSE Linux Enterprise High Availability 12 SP3) #
- General Changes to this Guide
Configuration changes for
corosync
(that cannot gracefully be reloaded withcorosync-cfgtool -R
), and any configuration changes tosbd
require restart of thecorosync
service for the changes to take effect. Restarting thepacemaker
service is not enough in those cases.However, for any changes to
/etc/sysconfig/pacemaker
, restarting thepacemaker
service is sufficient (https://bugzilla.suse.com/show_bug.cgi?id=1050371, https://bugzilla.suse.com/show_bug.cgi?id=1052088).- Chapter 6, Configuring and Managing Cluster Resources with Hawk2
Updated the chapter (including all screenshots) to reflect the software changes in Hawk2. The main changes have taken place in the Section 6.8, “Monitoring Clusters”.
view, described in- Chapter 11, Access Control Lists
Described how to enable the use of ACLs with Hawk2 in Section 11.2, “Enabling Use of ACLs in Your Cluster”. Added Section 11.4, “Configuring ACLs with Hawk2”.
- Bugfixes
In Chapter 3, Installing SUSE Linux Enterprise High Availability and Chapter 4, Using the YaST Cluster Module, added missing reference to the Installation and Setup Quick Start (doc comments #33439 and #33430).
In Procedure 4.3, “Defining a Redundant Communication Channel”, removed misleading information (https://bugzilla.suse.com/show_bug.cgi?id=1026391).
In Section 5.5.6, “Placing Resources Based on Their Load Impact”, mentioned different resource agents for Xen and
libvirt
(https://bugzilla.suse.com/show_bug.cgi?id=932825).In Section 5.6.2, “Managing Services on Remote Nodes with
pacemaker_remote
”, corrected node limit for Corosync membership (https://bugzilla.suse.com/show_bug.cgi?id=1022226).In Section 23.2, “Different Options for Maintenance Tasks”, mentioned corner-cases for resources that depend on Pacemaker and Corosync services (https://bugzilla.suse.com/show_bug.cgi?id=1039922).
In Section 13.3, “Configuring Load Balancing with HAProxy”, clarified configuration of HAProxy and procedure (https://bugzilla.suse.com/show_bug.cgi?id=1027630).
Updated Section 16.6, “Configuring OCFS2 Resources With Hawk2” to match the latest Hawk2 version (https://bugzilla.suse.com/show_bug.cgi?id=1040504).
In Procedure 17.4, “Mounting a GFS2 Volume with the Cluster Manager”, added a missing backslash to a command (https://bugzilla.suse.com/show_bug.cgi?id=1055941).
In Section 18.3.3, “Initializing and Formatting DRBD Resource”, clarified on which nodes to execute the commands (https://bugzilla.suse.com/show_bug.cgi?id=1040722).
In Section 18.7, “Testing the DRBD Service”, added missing DRBD resources (https://bugzilla.suse.com/show_bug.cgi?id=971420).
In Section 19.2.2, “Scenario: Configuring Cmirrord”, fixed a typo and enhanced a procedure (https://bugzilla.suse.com/show_bug.cgi?id=1031261).
In Chapter 20, Cluster Multi-device (Cluster MD), updated commands to create clustered MD devices by specifying the full path to the device (https://bugzilla.suse.com/show_bug.cgi?id=1048082).
In Section 20.1, “Conceptual Overview”, mentioned that each disk needs to be accessible by Cluster MD on each node (https://bugzilla.suse.com/show_bug.cgi?id=938502).
In Section 20.2, “Creating a Clustered MD RAID Device”, mentioned that Cluster MD only supports version 1.2 metadata (https://bugzilla.suse.com/show_bug.cgi?id=1031833). Clarified how to check if the DLM resource node is up and running (https://bugzilla.suse.com/show_bug.cgi?id=1040297).
In Section 10.4, “Number of SBD Devices”, extended description about diskless SBD.
In Procedure 10.3, “Initializing the SBD Devices”, specified the relationship between timeout values (https://bugzilla.suse.com/show_bug.cgi?id=1042204).
In Section 22.2, “Setting Up ReaR and Your Backup Solution” and Section 22.1.6, “Limitations with Btrfs”, described different ReaR configuration files (https://bugzilla.suse.com/show_bug.cgi?id=1040371).
E.7 April 2017 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP2) #
- General Changes
Added a new guide, Pacemaker Remote, available at https://www.suse.com/documentation/sle-ha-12. It explains the setup of a cluster with virtual guest nodes or remote nodes, managed by
pacemaker_remote
. Remote in this context does not mean physical distance, but “non-membership” of a cluster.
E.8 March 2017 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP2) #
- General Changes to this Guide
Prefer
ocf:heartbeat:clvm
overocf:lvm2:clvmd
/ocf:lvm2:cmirrord
(http://bugzilla.suse.com/show_bug.cgi?id=1030841).- Bugfixes
Added note about software watchdog limitation to Procedure 10.2, “Loading the Softdog Kernel Module” (https://bugzilla.suse.com/show_bug.cgi?id=1029857).
E.9 November 2016 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP2) #
- Bugfixes
Updated home page entry for OCFS2 (https://bugzilla.suse.com/show_bug.cgi?id=981498).
Added timeouts for monitoring operation in resource configuration for OCFS2, GFS2 and cLVM (default values as set by the
ha-cluster-bootstrap
scripts, https://bugzilla.suse.com/show_bug.cgi?id=981518).Updated screenshots and slightly adjusted text according to minor user interface changes https://bugzilla.suse.com/show_bug.cgi?id=981495).
Fixed wrong device name in command (https://bugzilla.suse.com/show_bug.cgi?id=992757).
In Chapter 9, Fencing and STONITH, corrected and amended the configuration example for Kdump and enhanced the description of what Kdump does (https://bugzilla.suse.com/show_bug.cgi?id=1007422).
E.10 November 2016 (Initial Release of SUSE Linux Enterprise High Availability 12 SP2) #
- General Changes to this Guide
Numerous small fixes and additions to the documentation, based on technical feedback.
The former chapter Installation and Basic Setup has been restructured:
The chapter has been renamed Using the YaST Cluster Module.
How to manually install SUSE Linux Enterprise High Availability and how to automatically set up a cluster with the bootstrap scripts has moved into the new Installation and Setup Quick Start (Fate#320823).
The section Mass Deployment with AutoYaST has been moved to the new chapter Chapter 3, Installing SUSE Linux Enterprise High Availability.
The chapter Configuring and Managing Cluster Resources (Web Interface) (Hawk version 1) has been removed from the documentation. Hawk2 is documented in Chapter 6, Configuring and Managing Cluster Resources with Hawk2.
The parameter no-quorum-policy=ignore has been replaced with no-quorum-policy=stop as the first one is no longer recommended (https://bugzilla.suse.com/show_bug.cgi?id=981650).
Updated STONITH resource configurations that contained a monitoring operation with
start-delay
. To prevent double fencing in 2-node clusters, use the parameterpcmk_delay_max
instead (https://bugzilla.suse.com/show_bug.cgi?id=990213).The e-mail address for documentation feedback has changed to
doc-team@suse.com
.
- Chapter 1, Product Overview
Mentioned that 32-node limit can be extended by using
pacemaker_remote
(https://bugzilla.suse.com/show_bug.cgi?id=981590).- Chapter 2, System Requirements and Recommendations
Clarified node count recommendation (https://bugzilla.suse.com/show_bug.cgi?id=981646).
- Chapter 3, Installing SUSE Linux Enterprise High Availability
New chapter. See also General Changes to this Guide.
- Chapter 4, Using the YaST Cluster Module
Completely revised. See also General Changes to this Guide.
All screenshots have been updated.
- Chapter 24, Upgrading Your Cluster and Updating Software Packages
Added entries for upgrading to SUSE Linux Enterprise High Availability 12 SP2.
Mentioned that Hawk2 shows a warning if the upgrade is incomplete (Fate#320759).
- Chapter 7, Configuring and Managing Cluster Resources (Command Line)
Added Section 7.4.1, “Loading Cluster Resources from a File” (Fate#320389).
Added Section 7.5.1, “Showing Cluster Resources” (Fate#320401).
- Chapter 6, Configuring and Managing Cluster Resources with Hawk2
Mentioned that Hawk is replaced with Hawk2 after upgrading the system to SUSE Linux Enterprise High Availability 12 SP2 (Fate#320560).
Lots of minor adjustments because of updates in the Web interface.
Added Using Maintenance Mode.
Added Section 6.9, “Using the Batch Mode” (Fate#317834, Fate#318298, Fate#318314, Fate#317834).
Added Section 6.6.8, “Configuring Placement of Resources Based on Load Impact” (Fate#318317, Fate#320420).
Added Section 6.5.1, “Showing the Current Cluster Configuration (CIB)” (Fate#319665).
Added Section 6.7.1, “Editing Resources and Groups” (Fate#318316, Fate#318318).
Made Section 6.8, “Monitoring Clusters” more prominent by moving it up one level.
Updated all screenshots.
- Chapter 18, DRBD
Added Section 18.5, “Creating a Stacked DRBD Device” (Fate#321013).
Documented supported migration to DRBD 9 in Section 18.4, “Migrating from DRBD 8 to DRBD 9” (Fate#320399).
Adapted documentation to new configuration format in DRBD 9 (Fate#980842)
Fixed several bugs (https://bugzilla.suse.com/show_bug.cgi?id=975587, https://bugzilla.suse.com/show_bug.cgi?id=980822, https://bugzilla.suse.com/show_bug.cgi?id=980825, https://bugzilla.suse.com/show_bug.cgi?id=980835, https://bugzilla.suse.com/show_bug.cgi?id=980842, https://bugzilla.suse.com/show_bug.cgi?id=980861, https://bugzilla.suse.com/show_bug.cgi?id=980863, https://bugzilla.suse.com/show_bug.cgi?id=981765, https://bugzilla.suse.com/show_bug.cgi?id=981766, https://bugzilla.suse.com/show_bug.cgi?id=981768, https://bugzilla.suse.com/show_bug.cgi?id=981776, https://bugzilla.suse.com/show_bug.cgi?id=990585).
- Chapter 20, Cluster Multi-device (Cluster MD)
New chapter.
- Chapter 10, Storage Protection and SBD
Reworked Procedure 10.1, “Loading the Correct Kernel Module” (https://bugzilla.suse.com/show_bug.cgi?id=967795).
Removed the
-S
option (not mandatory) in variable SBD_OPTS of/etc/sysconfig/sbd
(https://bugzilla.suse.com/show_bug.cgi?id=971040).
- Chapter 21, Samba Clustering
Fixed typo in package name tdb-tools (https://bugzilla.suse.com/show_bug.cgi?id=981512), directory and resource names (https://bugzilla.suse.com/show_bug.cgi?id=981889).
- Chapter 22, Disaster Recovery with Relax-and-Recover (ReaR)
Added note about known incompatibilities.
Added information on support for UEFI systems (Fate#319332).
- Appendix A, Troubleshooting
- Appendix D, Running Cluster Reports Without
root
Access - Bugfixes
Fixed typos in commands or names (https://bugzilla.suse.com/show_bug.cgi?id=981494, https://bugzilla.suse.com/show_bug.cgi?id=981749, https://bugzilla.suse.com/show_bug.cgi?id=981751, https://bugzilla.suse.com/show_bug.cgi?id=981753, https://bugzilla.suse.com/show_bug.cgi?id=981759, https://bugzilla.suse.com/show_bug.cgi?id=982504, https://bugzilla.suse.com/show_bug.cgi?id=983220.
E.11 December 2015 (Maintenance Update of SUSE Linux Enterprise High Availability 12 SP1) #
- General
Added a chapter for Hawk version 2: Chapter 6, Configuring and Managing Cluster Resources with Hawk2.
E.12 December 2015 (Initial Release of SUSE Linux Enterprise High Availability 12 SP1) #
- General
Updated some links to external documentation sources (doc comment #26851).
Updated the screenshots.
Add-ons provided by SUSE have been renamed to modules and extensions. The manuals have been updated to reflect this change.
crm_report
andhb_report
have been replaced withcrm report
(https://bugzilla.suse.com/show_bug.cgi?id=950483). Adjusted the manuals accordingly (https://bugzilla.suse.com/show_bug.cgi?id=938427.Numerous small fixes and additions to the manual based on technical feedback.
- Chapter 2, System Requirements and Recommendations
Rephrased sentence about STONITH devices to include not only physical devices but also STONITH mechanism like watchdog (doc comment #27070).
- Installation and Basic Setup
The example setup files for multicast and unicast setup have moved to
/usr/share/doc/packages/corosync
(https://bugzilla.suse.com/show_bug.cgi?id=938305).The procedure Automatically Setting Up the First Node mentions that
ha-cluster-init
lets you also configure a virtual IP address for Hawk (Fate#318549).
- Chapter 24, Upgrading Your Cluster and Updating Software Packages
Moved chapter from appendix to Part I, “Installation and Setup” for better visibility.
Completely revised Section 24.2, “Upgrading your Cluster to the Latest Product Version”.
Added terms
rolling upgrade
andoffline migration
to Section 24.1, “Terminology”.Inserted overview of Supported Upgrade Paths for SLE HA and SLE HA Geo.
- Chapter 5, Configuration and Administration Basics
Added note about restrictions for constraints and certain types of resources (https://bugzilla.suse.com/show_bug.cgi?id=927423).
Modified paragraph about calculating probing timeouts to make it more clear and moved it to section Section 5.4, “Resource Monitoring”.
- Chapter 7, Configuring and Managing Cluster Resources (Command Line)
Added new Section 7.1.5, “Using crmsh's Cluster Scripts” (Fate#318211).
- Chapter 9, Fencing and STONITH
Removed cloning of STONITH resources from examples as this is no longer needed (https://bugzilla.suse.com/show_bug.cgi?id=870963).
Removed some STONITH devices that are for testing purposes only (https://bugzilla.suse.com/show_bug.cgi?id=921019).
Removed
external/kdumpcheck
resource agent and added example configuration for thefence_kdump
resource agent instead (Fate#317135).Mentioned available packages for STONITH resource agents:
cluster-glue
andfence-agents
(https://bugzilla.suse.com/show_bug.cgi?id=920980).Added
crm ra list stonith
as another command to list supported STONITH devices.
- Chapter 11, Access Control Lists
Added Configuring ACLs with Hawk2.
Updated chapter according to the new ACL features that become available after upgrading the CIB validation version. For details, see Note: Upgrading the CIB Syntax Version.
If you have upgraded from a former SUSE Linux Enterprise High Availability version and kept your former CIB version, refer to the Access Control List chapter in the Administration Guide for SUSE Linux Enterprise High Availability 11 SP3. It is available from http://www.suse.com/documentation/.
- Chapter 13, Load Balancing
Added reference to load balancing strategies (https://bugzilla.suse.com/show_bug.cgi?id=938345).
Added additional paragraph about IPVS and KTCPVS. Added link to LVS Knowledge Base (https://bugzilla.suse.com/show_bug.cgi?id=938330).
Removed deprecated parameter contimeout (https://bugzilla.suse.com/show_bug.cgi?id=938357).
- Chapter 16, OCFS2
Fixed logical error between Configuring a DLM Resource and Procedure 16.4, “Mounting an OCFS2 Volume with the Cluster Resource Manager” (https://bugzilla.suse.com/show_bug.cgi?id=938543).
- Chapter 18, DRBD
Revised procedure in Section 18.3.3, “Initializing and Formatting DRBD Resource” to add information about how to speed up the initial synchronization (Fate#317940).
Clarified sentence about automatic LVM filter adjustment in Procedure 18.2, “Using YaST to Configure DRBD” (Fate#317957).
Mentioned how to remove stale cache entries with YaST's DRBD module (Fate#318555).
Mentioned the Firewall port in YaST's DRBD module (Fate#318391).
Reflected changes of DRBD packages (Fate#938292).
- Chapter 19, Cluster Logical Volume Manager (cLVM)
Fixed typo in configuration file name:
/etc/iscsi/iscsid.conf
instead of/etc/iscsi/iscsi.conf
(https://bugzilla.suse.com/show_bug.cgi?id=938669).Adjusted title of a YaST element in Procedure 19.4, “Configuring iSCSI Targets (SAN)” (https://bugzilla.suse.com/show_bug.cgi?id=938679).
Corrected step in Procedure 19.5, “Configuring iSCSI Initiators”: Only establish a connection to the targets of the necessary portals, fixed typos in node names (https://bugzilla.suse.com/show_bug.cgi?id=938681).
- Chapter 10, Storage Protection and SBD
Restructured chapter and added new sections: Conceptual Overview and Section 10.3, “Requirements”.
Added note about STONITH configuration for 2-node clusters.
Mentioned minimum allowed value for the emulated watchdog in Procedure 10.3, “Initializing the SBD Devices” and Section 10.5, “Calculation of Timeouts”.
Added new procedure about how to determine the right watchdog module in Procedure 10.1, “Loading the Correct Kernel Module”.
Added note about how to ensure SBD has started on all nodes (https://bugzilla.suse.com/show_bug.cgi?id=938491).
- Chapter 21, Samba Clustering
Added reference to shared storage (https://bugzilla.suse.com/show_bug.cgi?id=921265).
- Chapter 22, Disaster Recovery with Relax-and-Recover (ReaR)
Completely revised and updated the chapter.
- Appendix A, Troubleshooting
Added new Section A.5, “History” (Fate#318500).
- Appendix D, Running Cluster Reports Without
root
Access New appendix (Fate#314907).
- Bugfixes
Fixed typos in commands (https://bugzilla.suse.com/show_bug.cgi?id=907118, https://bugzilla.suse.com/show_bug.cgi?id=921229, https://bugzilla.suse.com/show_bug.cgi?id=921234, https://bugzilla.suse.com/show_bug.cgi?id=921237, https://bugzilla.suse.com/show_bug.cgi?id=938340, https://bugzilla.suse.com/show_bug.cgi?id=938334, https://bugzilla.suse.com/show_bug.cgi?id=938486, https://bugzilla.suse.com/show_bug.cgi?id=938487, https://bugzilla.suse.com/show_bug.cgi?id=938490, https://bugzilla.suse.com/show_bug.cgi?id=938515).
Fixed three identically described hyperlinks in (https://bugzilla.suse.com/show_bug.cgi?id=868143).
Fixed name for logical volume (https://bugzilla.suse.com/show_bug.cgi?id=920990).
Fixed name of resource agent (https://bugzilla.suse.com/show_bug.cgi?id=921004).
Mentioned YaST option to open a port in the firewall (https://bugzilla.suse.com/show_bug.cgi?id=921016).
Adjusted the device names (https://bugzilla.suse.com/show_bug.cgi?id=921022 and https://bugzilla.suse.com/show_bug.cgi?id=921022).
Updated how to file service requests (https://bugzilla.suse.com/show_bug.cgi?id=882059).
Fixed example for Xen resource (https://bugzilla.suse.com/show_bug.cgi?id=932828).
Fixed indentation in screen (https://bugzilla.suse.com/show_bug.cgi?id=932294).
Fixed wording (https://bugzilla.suse.com/show_bug.cgi?id=938291).
Removed duplicated entries (https://bugzilla.suse.com/show_bug.cgi?id=938313, https://bugzilla.suse.com/show_bug.cgi?id=938332, https://bugzilla.suse.com/show_bug.cgi?id=938536).
Mentioned default value for keyword
locking_type
in/etc/lvm/lvm.conf
(https://bugzilla.suse.com/show_bug.cgi?id=938526).Fixed errors in
crm script
commands (https://bugzilla.suse.com/show_bug.cgi?id=938358).Fixed path name for STONITH plug-ins (https://bugzilla.suse.com/show_bug.cgi?id=952815).
E.13 October 2014 (Initial Release of SUSE Linux Enterprise High Availability 12) #
- General
Adjusted section Automatic Cluster Setup (ha-cluster-bootstrap) because of the renaming of the bootstrap scripts
sleha-init
,sleha-join
, andsleha-remove
toha-cluster-init
,ha-cluster-join
, andha-cluster-remove
, respectively. Also the location of the log file has changed from/var/log/sleha-bootstrap.log
to/var/log/ha-cluster-bootstrap.log
(http://bugzilla.suse.com/show_bug.cgi?id=853772).Replaced any occurrence of
chkconfig
andrc*
commands with systemd equivalents (http://bugzilla.suse.com/show_bug.cgi?id=853533).Introduced a consistent naming scheme for cluster names, node names, cluster resources, and constraints and applied it to the documentation. See Appendix B, Naming Conventions. (Fate#314938).
Removed Pacemaker GUI and any references pointing to it (Fate#312948, https://bugzilla.suse.com/show_bug.cgi?id=853508).
Replaced OpenAIS with Corosync (https://bugzilla.suse.com/show_bug.cgi?id=853507, https://bugzilla.suse.com/show_bug.cgi?id=853556).
Removed all occurrences of the following parameters as they are obsolete:
default-resource-stickiness
,is-managed-default
, anddefault-action-timeout
.Removed any occurrences of
o2cb
resources as the respective resource agent is now obsolete.Improved the consistency of crm shell examples.
Adjusted changed package names throughout the whole manual (Fate#314807).
Removed list of resource agents from the appendix.
Moved documentation for Geo Clustering for SUSE Linux Enterprise High Availability into a separate document (Fate#316121). See the new Geo Clustering for SUSE Linux Enterprise High Availability Geo Clustering Quick Start, available from http://www.suse.com/documentation/.
Removed Example of Setting Up a Simple Testing Resource from the appendix as this can be done now by the Hawk wizard.
Changed terminology for
master-slave
resources, which are now calledmulti-state
resources in the upstream documentation.Updated the screenshots.
Mentioned both
hb_report
andcrm_report
as command line tools for creating detailed cluster reports.Numerous small fixes and additions to the manual based on technical feedback.
- Chapter 1, Product Overview
Changed terminology from multi-site clusters to geographically dispersed (or Geo) clusters for consistency reasons.
Added section about availability of SUSE Linux Enterprise High Availability and Geo Clustering for SUSE Linux Enterprise High Availability as extensions: Section 1.1, “Availability as a Module or Extension”.
- Chapter 2, System Requirements and Recommendations
Restructured contents.
Mentioned how to create a cluster report when using a non-standard SSH port (Fate#314906). See SSH.
- Installation and Basic Setup
Updated section Manual Cluster Setup (YaST) to reflect the software changes to the YaST cluster module.
Csync2 also accepts a combination of host name and IP address for each cluster node. See Section 4.7, “Transferring the Configuration to All Nodes” (Fate#314956).
Section 3.2, “Mass Installation and Deployment with AutoYaST” mentions the option to clone DRBD settings via AutoYaST (Fate#315128).
The procedure Automatically Setting Up the First Node mentions the
-t
option forha-cluster-init
to perform additional cluster configurations based on templates (https://bugzilla.suse.com/show_bug.cgi?id=821123).
- Chapter 24, Upgrading Your Cluster and Updating Software Packages
Added definition of terms: Section 24.1, “Terminology”.
Added new subsection to Section 24.2, “Upgrading your Cluster to the Latest Product Version”.
Added Section 24.3, “Updating Software Packages on Cluster Nodes”.
- Chapter 5, Configuration and Administration Basics
Section 5.2.3, “Global Option
stonith-enabled
” mentions policy change in DLM services when the global cluster optionstonith-enabled
is set tofalse
(Fate#315195).Section 5.5.7, “Grouping Resources by Using Tags” describes a new option to group conceptually related resources, without creating any colocation or ordering relationship between them (Fate#315101).
Section 5.5.1.1, “Resource Sets” explains the concept of resource sets as an alternative format for defining constraints. As of SUSE Linux Enterprise High Availability 12, resource sets can now also be used within location constraints (whereas they could formerly only be used within colocation and ordering constraints).
Restructured Section 23.2, “Different Options for Maintenance Tasks” to also cover the option of setting a whole cluster to maintenance mode (https://bugzilla.suse.com/show_bug.cgi?id=829864).
Added attributes for
pacemaker_remote
service to Section 5.3.6, “Resource Options (Meta Attributes)” and added new section: Section 5.6, “Managing Services on Remote Hosts” (https://bugzilla.suse.com/show_bug.cgi?id=853535).Added new resource agent classes to Section 5.3.2, “Supported Resource Agent Classes”:
systemd
,service
, andnagios
(https://bugzilla.suse.com/show_bug.cgi?id=853520).Updated Section 5.6.1, “Monitoring Services on Remote Hosts with Monitoring Plug-ins” to reflect the package name changes from
nagios-plugins
andnagios-plugins-metadata
tomonitoring-plugins
andmonitoring-plugins-metadata
, respectively (Fate#317780).
- Chapter 7, Configuring and Managing Cluster Resources (Command Line)
Added Section 7.4.5.3, “Collocating Sets for Resources Without Dependency” (Fate#314917).
Added a section about the health status (Fate#316464): Section 7.5.7, “Getting Health Status”.
Added a section about tagging resources (Fate#315101): Section 7.5.6, “Grouping/Tagging Resources”.
Updated overview section about tab completion and getting help (https://bugzilla.suse.com/show_bug.cgi?id=853643).
- Chapter 11, Access Control Lists
Restructured chapter.
Added Configuring ACLs with Hawk2.
- Chapter 13, Load Balancing
Restructured chapter and added Section 13.3, “Configuring Load Balancing with HAProxy”.
- Chapter 16, OCFS2
Added Section 16.6, “Configuring OCFS2 Resources With Hawk2” (Fate#316322).
Procedure 16.2, “Creating and Formatting an OCFS2 Volume”: Fixed https://bugzilla.suse.com/show_bug.cgi?id=853631.
Table 16.2, “Important OCFS2 Parameters”: Fixed https://bugzilla.suse.com/show_bug.cgi?id=883550.
Re-sorted some procedures and sections (https://bugzilla.suse.com/show_bug.cgi?id=894158).
- Chapter 17, GFS2
New chapter.
- Chapter 18, DRBD
Removed table DRBD RPM packages from Section 18.2, “Installing DRBD Services”, as all former packages are now contained in the
drbd
package.
- Chapter 19, Cluster Logical Volume Manager (cLVM)
Described option
mirrored
in a clustered environment (Fate#314367): Section 19.2.2, “Scenario: Configuring Cmirrord”.
- Chapter 10, Storage Protection and SBD
Added Section 10.10.1, “Configuring an sg_persist Resource” (Fate#312345).
Setting Up the Watchdog: Added note about watchdog and other software that accesses the watchdog timer (https://bugzilla.suse.com/show_bug.cgi?id=891340).
Setting Up the Watchdog: Added how to load the watchdog driver at boot time (https://bugzilla.suse.com/show_bug.cgi?id=892344).
Procedure 10.7, “Configuring the Cluster to Use SBD”: Added advice about length of
stonith-timeout
in relation tomsgwait
timeout (https://bugzilla.suse.com/show_bug.cgi?id=891346).Adjusted Starting the SBD Daemon (https://bugzilla.suse.com/show_bug.cgi?id=891499).
- Chapter 21, Samba Clustering
Documented separate Samba and Winbind resources (Fate#316336): Procedure 21.1, “Setting Up a Basic Clustered Samba Server”.
Adjusted several sections and procedures according to https://bugzilla.suse.com/show_bug.cgi?id=886095.
Procedure 21.1, “Setting Up a Basic Clustered Samba Server”: Fixed https://bugzilla.suse.com/show_bug.cgi?id=886082.
- Chapter 22, Disaster Recovery with Relax-and-Recover (ReaR)
Adjusted chapter to reflect update to latest stable ReaR version (Fate#316508).
Updated example screen of
/etc/rear/local.conf
(https://bugzilla.suse.com/show_bug.cgi?id=885881).Fixed minor problems (https://bugzilla.suse.com/show_bug.cgi?id=878054).
Removed any occurrence of
rear-SUSE
and configuration file/etc/rear/site.conf
.
- Appendix A, Troubleshooting
Mentioned how to create a cluster report when using a non-standard SSH port (Fate#314906). See How can I create a report with an analysis of all my cluster nodes?.
- HA OCF Agents
This chapter has been removed. The latest information about the OCF resource agents can be viewed in the installed system as described in Section 7.1.3, “Displaying Information about OCF Resource Agents”.
- Appendix B, Naming Conventions
New appendix explaining naming scheme.