E Documentation Updates #
This chapter lists content changes for this document.
This manual was updated on the following dates:
E.1 2019 (Documentation Maintenance Update of SUSE Linux Enterprise High Availability Extension 12 SP3) #
- Bugfixes
Turned content of Example 10.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 11.5, “Calculation of Timeouts”, corrected the formula for timeout calculation in Example 11.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 21.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.2 October 2018 (Maintenance Update of SUSE Linux Enterprise High Availability Extension 12 SP3) #
- Bugfixes
In Chapter 20, DRBD, added Section 20.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 links and 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.3 July 2018 (Maintenance Update of SUSE Linux Enterprise High Availability Extension 12 SP3) #
- General Changes to this Guide
Completely revised Chapter 11, Storage Protection and SBD and moved it to a different place in the book.
Added chapter Chapter 16, Executing Maintenance Tasks. Moved respective sections from Chapter 6, Configuration and Administration Basics, Chapter 7, Configuring and Managing Cluster Resources with Hawk2, and Chapter 8, 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 21.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 16.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 18.1, “Features and Benefits”, added a note to clarify support status of OCFS2 (https://bugzilla.suse.com/show_bug.cgi?id=1074694).
In Section 11.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 5.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 21.2.2, “Scenario: Configuring Cmirrord”, corrected timings and intervals for
clvmd
primitive (https://bugzilla.suse.com/show_bug.cgi?id=985590).In Procedure 11.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 16, 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 23, 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 17, 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 10, Fencing and STONITH, improved the description of resource level fencing (https://bugzilla.suse.com/show_bug.cgi?id=1067076).
In Chapter 6, Configuration and Administration Basics, added use case scenarios and quorum determination (https://bugzilla.suse.com/show_bug.cgi?id=1088466).
In Section 11.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).
In Chapter 16, Executing Maintenance Tasks, added information on how to reboot a cluster node: Procedure 16.1, “Manually Rebooting a Cluster Node” and Section 16.9, “Rebooting a Cluster Node While In Maintenance Mode” (https://bugzilla.suse.com/show_bug.cgi?id=1080869).
E.4 September 2017 (Initial Release of SUSE Linux Enterprise High Availability Extension 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 7, 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 7.8, “Monitoring Clusters”.
view, described in- Chapter 12, Access Control Lists
Described how to enable the use of ACLs with Hawk2 in Section 12.2, “Enabling Use of ACLs in Your Cluster”. Added Section 12.4, “Configuring ACLs with Hawk2”.
- Bugfixes
In Chapter 3, Installing the High Availability Extension 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 6.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 6.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 16.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 14.3, “Configuring Load Balancing with HAProxy”, clarified configuration of HAProxy and procedure (https://bugzilla.suse.com/show_bug.cgi?id=1027630).
Updated Section 18.6, “Configuring OCFS2 Resources With Hawk2” to match the latest Hawk2 version (https://bugzilla.suse.com/show_bug.cgi?id=1040504).
In Procedure 19.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 20.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 20.7, “Testing the DRBD Service”, added missing DRBD resources (https://bugzilla.suse.com/show_bug.cgi?id=971420).
In Section 21.2.2, “Scenario: Configuring Cmirrord”, fixed a typo and enhanced a procedure (https://bugzilla.suse.com/show_bug.cgi?id=1031261).
In Chapter 22, 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 22.1, “Conceptual Overview”, mentioned that each disk has to be accessible by Cluster MD on each node (https://bugzilla.suse.com/show_bug.cgi?id=938502).
In Section 22.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 11.4, “Number of SBD Devices”, extended description about diskless SBD.
In Procedure 11.3, “Initializing the SBD Devices”, specified the relationship between timeout values (https://bugzilla.suse.com/show_bug.cgi?id=1042204).
In Section 24.2, “Setting Up Rear and Your Backup Solution” and Section 24.1.6, “Limitations with Btrfs”, described different Rear configuration files (https://bugzilla.suse.com/show_bug.cgi?id=1040371).
E.5 April 2017 (Maintenance Update of SUSE Linux Enterprise High Availability Extension 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.6 March 2017 (Maintenance Update of SUSE Linux Enterprise High Availability Extension 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 11.2, “Loading the Softdog Kernel Module” (https://bugzilla.suse.com/show_bug.cgi?id=1029857).
E.7 November 2016 (Maintenance Update of SUSE Linux Enterprise High Availability Extension 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 10, 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.8 November 2016 (Initial Release of SUSE Linux Enterprise High Availability Extension 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 the High Availability Extension 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 the High Availability Extension.
The chapter Configuring and Managing Cluster Resources (Web Interface) (Hawk version 1) has been removed from the documentation. Hawk2 is documented in Chapter 7, 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 the High Availability Extension
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 5, Upgrading Your Cluster and Updating Software Packages
Added entries for upgrading to SUSE Linux Enterprise High Availability Extension 12 SP2.
Mentioned that Hawk2 shows a warning if the upgrade is incomplete (Fate#320759).
- Chapter 8, Configuring and Managing Cluster Resources (Command Line)
Added Section 8.4.1, “Loading Cluster Resources from a File” (Fate#320389).
Added Section 8.5.1, “Showing Cluster Resources” (Fate#320401).
- Chapter 7, Configuring and Managing Cluster Resources with Hawk2
Mentioned that Hawk is replaced with Hawk2 after upgrading the system to SUSE Linux Enterprise High Availability Extension 12 SP2 (Fate#320560).
Lots of minor adjustments because of updates in the Web interface.
Added Using Maintenance Mode.
Added Section 7.9, “Using the Batch Mode” (Fate#317834, Fate#318298, Fate#318314, Fate#317834).
Added Section 7.6.8, “Configuring Placement of Resources Based on Load Impact” (Fate#318317, Fate#320420).
Added Section 7.5.1, “Showing the Current Cluster Configuration (CIB)” (Fate#319665).
Added Section 7.7.1, “Editing Resources and Groups” (Fate#318316, Fate#318318).
Made Section 7.8, “Monitoring Clusters” more prominent by moving it up one level.
Updated all screenshots.
- Chapter 20, DRBD
Added Section 20.5, “Creating a Stacked DRBD Device” (Fate#321013).
Documented supported migration to DRBD 9 in Section 20.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 22, Cluster Multi-device (Cluster MD)
New chapter.
- Chapter 11, Storage Protection and SBD
Reworked Procedure 11.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 23, 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 24, Disaster Recovery with Rear (Relax-and-Recover)
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.9 December 2015 (Maintenance Update of SUSE Linux Enterprise High Availability Extension 12 SP1) #
- General
Added a chapter for Hawk version 2: Chapter 7, Configuring and Managing Cluster Resources with Hawk2.
E.10 December 2015 (Initial Release of SUSE Linux Enterprise High Availability Extension 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 5, Upgrading Your Cluster and Updating Software Packages
Moved chapter from appendix to Part I, “Installation, Setup and Upgrade” for better visibility.
Completely revised Section 5.2, “Upgrading your Cluster to the Latest Product Version”.
Added terms
rolling upgrade
andoffline migration
to Section 5.1, “Terminology”.Inserted overview of Supported Upgrade Paths for SLE HA and SLE HA Geo.
- Chapter 6, 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 6.4, “Resource Monitoring”.
- Chapter 8, Configuring and Managing Cluster Resources (Command Line)
Added new Section 8.1.5, “Using crmsh's Cluster Scripts” (Fate#318211).
- Chapter 10, 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 12, 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 Extension version and kept your former CIB version, refer to the Access Control List chapter in the Administration Guide for SUSE Linux Enterprise High Availability Extension 11 SP3. It is available from http://www.suse.com/documentation/.
- Chapter 14, 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 18, OCFS2
Fixed logical error between Configuring a DLM Resource and Procedure 18.4, “Mounting an OCFS2 Volume with the Cluster Resource Manager” (https://bugzilla.suse.com/show_bug.cgi?id=938543).
- Chapter 20, DRBD
Revised procedure in Section 20.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 20.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 21, 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 21.4, “Configuring iSCSI Targets (SAN)” (https://bugzilla.suse.com/show_bug.cgi?id=938679).
Corrected step in Procedure 21.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 11, Storage Protection and SBD
Restructured chapter and added new sections: Conceptual Overview and Section 11.3, “Requirements”.
Added note about STONITH configuration for 2-node clusters.
Mentioned minimum allowed value for the emulated watchdog in Procedure 11.3, “Initializing the SBD Devices” and Section 11.5, “Calculation of Timeouts”.
Added new procedure about how to determine the right watchdog module in Procedure 11.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 23, Samba Clustering
Added reference to shared storage (https://bugzilla.suse.com/show_bug.cgi?id=921265).
- Chapter 24, Disaster Recovery with Rear (Relax-and-Recover)
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 pathname for STONITH plug-ins (https://bugzilla.suse.com/show_bug.cgi?id=952815).
E.11 October 2014 (Initial Release of SUSE Linux Enterprise High Availability Extension 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 Extension into a separate document (Fate#316121). See the new Geo Clustering for SUSE Linux Enterprise High Availability Extension 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 Extension and Geo Clustering for SUSE Linux Enterprise High Availability Extension as extensions: Section 1.1, “Availability as 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.5, “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 5, Upgrading Your Cluster and Updating Software Packages
Added definition of terms: Section 5.1, “Terminology”.
Added new subsection to Section 5.2, “Upgrading your Cluster to the Latest Product Version”.
Added Section 5.3, “Updating Software Packages on Cluster Nodes”.
- Chapter 6, Configuration and Administration Basics
Section 6.2.3, “Global Option
stonith-enabled
” mentions policy change in DLM services when the global cluster optionstonith-enabled
is set tofalse
(Fate#315195).Section 6.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 6.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 Extension 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 16.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 Table 6.1, “Options for a Primitive Resource” and added new section: Section 6.6, “Managing Services on Remote Hosts” (https://bugzilla.suse.com/show_bug.cgi?id=853535).Added new resource agent classes to Section 6.3.2, “Supported Resource Agent Classes”:
systemd
,service
, andnagios
(https://bugzilla.suse.com/show_bug.cgi?id=853520).Updated Section 6.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 8, Configuring and Managing Cluster Resources (Command Line)
Added Section 8.4.5.3, “Collocating Sets for Resources Without Dependency” (Fate#314917).
Added a section about the health status (Fate#316464): Section 8.5.7, “Getting Health Status”.
Added a section about tagging resources (Fate#315101): Section 8.5.6, “Grouping/Tagging Resources”.
Updated overview section about tab completion and getting help (https://bugzilla.suse.com/show_bug.cgi?id=853643).
- Chapter 12, Access Control Lists
Restructured chapter.
Added Configuring ACLs with Hawk2.
- Chapter 14, Load Balancing
Restructured chapter and added Section 14.3, “Configuring Load Balancing with HAProxy”.
- Chapter 18, OCFS2
Added Section 18.6, “Configuring OCFS2 Resources With Hawk2” (Fate#316322).
Procedure 18.2, “Creating and Formatting an OCFS2 Volume”: Fixed https://bugzilla.suse.com/show_bug.cgi?id=853631.
Table 18.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 19, GFS2
New chapter.
- Chapter 20, DRBD
Removed table DRBD RPM packages from Section 20.2, “Installing DRBD Services”, as all former packages are now contained in the
drbd
package.
- Chapter 21, Cluster Logical Volume Manager (cLVM)
Described option
mirrored
in a clustered environment (Fate#314367): Section 21.2.2, “Scenario: Configuring Cmirrord”.
- Chapter 11, Storage Protection and SBD
Added Section 11.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 11.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 23, Samba Clustering
Documented separate Samba and Winbind resources (Fate#316336): Procedure 23.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 23.1, “Setting Up a Basic Clustered Samba Server”: Fixed https://bugzilla.suse.com/show_bug.cgi?id=886082.
- Chapter 24, Disaster Recovery with Rear (Relax-and-Recover)
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 8.1.3, “Displaying Information about OCF Resource Agents”.
- Appendix B, Naming Conventions
New appendix explaining naming scheme.