Skip to content

Commit 59fd186

Browse files
committed
Automatic rebuild after doc-sleha commit 27613539c2ba688d28e450d446fb2fd9897163d6
1 parent 3c5ef20 commit 59fd186

90 files changed

Lines changed: 327 additions & 209 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

SLEHA15SP5/html/SLE-HA-administration/app-ha-troubleshooting.html

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
22
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>Troubleshooting | Administration Guide | SLE HA 15 SP5</title><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"/><link rel="stylesheet" type="text/css" href="static/css/style-new.css"/>
33
<link rel="schema.dc" href="http://purl.org/dc/elements/1.1/"/><link rel="schema.dcterms" href="http://purl.org/dc/terms/"/>
4-
<meta name="dcterms.modified" content="2025-11-19"/><meta name="dcterms.created" content="2025-11-19"/><meta name="title" content="Troubleshooting | SLE HA 15 SP5"/>
4+
<meta name="dcterms.modified" content="2026-03-19"/><meta name="dcterms.created" content="2026-03-19"/><meta name="title" content="Troubleshooting | SLE HA 15 SP5"/>
55
<meta name="description" content="Strange problems may occur that are not easy to understand, especially when starting to experiment with High Availability. However, there are several util…"/>
66
<meta name="product-name" content="SUSE Linux Enterprise High Availability"/>
77
<meta name="product-number" content="15 SP5"/>
@@ -42,9 +42,9 @@
4242
}
4343
],
4444

45-
"dateModified": "2025-11-19T00:00+02:00",
45+
"dateModified": "2026-03-19T00:00+02:00",
4646

47-
"datePublished": "2025-11-19T00:00+02:00",
47+
"datePublished": "2026-03-19T00:00+02:00",
4848

4949

5050
"about": [
@@ -286,11 +286,12 @@
286286
Certificate Authority, CA):</p><div class="procedure"><div class="procedure-contents"><ol class="procedure" type="1"><li class="step"><p>Replace <code class="filename">/etc/hawk/hawk.key</code> with the private
287287
key.</p></li><li class="step"><p>Replace <code class="filename">/etc/hawk/hawk.pem</code> with the
288288
certificate that Hawk2 should present.</p></li><li class="step"><p>
289+
Change ownership of the files to <code class="literal">root:haclient</code>
290+
and make the files accessible to the group:
291+
</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">chown root:haclient /etc/hawk/hawk.key /etc/hawk/hawk.pem</code>
292+
<code class="prompt root"># </code><code class="command">chmod 640 /etc/hawk/hawk.key /etc/hawk/hawk.pem</code></pre></div></li><li class="step"><p>
289293
Restart the Hawk2 services to reload the new certificate:
290-
</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">systemctl restart hawk-backend hawk</code></pre></div></li></ol></div></div><p>
291-
Change ownership of the files to <code class="literal">root:haclient</code>
292-
and make the files accessible to the group:</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">chown root:haclient /etc/hawk/hawk.key /etc/hawk/hawk.pem</code>
293-
<code class="prompt root"># </code><code class="command">chmod 640 /etc/hawk/hawk.key /etc/hawk/hawk.pem</code></pre></div></dd></dl></div></section><section class="sect1" id="sec-ha-troubleshooting-misc" data-id-title="Miscellaneous"><div class="titlepage"><div><div><div class="title-container"><h2 class="title"><span class="title-number-name"><span class="title-number">A7 </span><span class="title-name">Miscellaneous</span></span> <a title="Permalink" class="permalink" href="app-ha-troubleshooting.html#sec-ha-troubleshooting-misc">#</a></h2><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_troubleshooting.xml" title="Edit source document"> </a></div></div></div></div></div><div class="variablelist"><dl class="variablelist"><dt id="id-1.4.7.3.9.2.1"><span class="term">How can I run commands on all cluster nodes?</span></dt><dd><p>
294+
</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">systemctl restart hawk-backend hawk</code></pre></div></li></ol></div></div></dd></dl></div></section><section class="sect1" id="sec-ha-troubleshooting-misc" data-id-title="Miscellaneous"><div class="titlepage"><div><div><div class="title-container"><h2 class="title"><span class="title-number-name"><span class="title-number">A7 </span><span class="title-name">Miscellaneous</span></span> <a title="Permalink" class="permalink" href="app-ha-troubleshooting.html#sec-ha-troubleshooting-misc">#</a></h2><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_troubleshooting.xml" title="Edit source document"> </a></div></div></div></div></div><div class="variablelist"><dl class="variablelist"><dt id="id-1.4.7.3.9.2.1"><span class="term">How can I run commands on all cluster nodes?</span></dt><dd><p>
294295
Use the command <code class="command">crm cluster run</code> for this task. For example:
295296
</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">crm cluster run "ls -l /etc/corosync/*.conf"</code>
296297
INFO: [alice]

SLEHA15SP5/html/SLE-HA-administration/bk02ape.html

Lines changed: 2 additions & 2 deletions
Large diffs are not rendered by default.

SLEHA15SP5/html/SLE-HA-administration/book-administration.html

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

SLEHA15SP5/html/SLE-HA-administration/cha-ha-agents.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,7 @@
205205
outlines the different OCF return codes. It also shows the type of
206206
recovery the cluster will initiate when the respective error code is
207207
received.
208-
</p><div class="table" id="id-1.4.4.8.5.7" data-id-title="OCF return codes"><div class="title-container"><div class="table-title-wrap"><div class="table-title"><span class="title-number-name"><span class="title-number">Table 10.2: </span><span class="title-name">OCF return codes </span></span><a title="Permalink" class="permalink" href="cha-ha-agents.html#id-1.4.4.8.5.7">#</a></div></div><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_error_codes.xml" title="Edit source document"> </a></div></div><div class="table-contents"><table style="border-collapse: collapse; border-top: 1px solid ; border-bottom: 1px solid ; border-left: 1px solid ; border-right: 1px solid ; "><colgroup><col class="1"/><col class="2"/><col class="3"/><col class="4"/></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; ">
208+
</p><p class="remark"><em><span class="remark">taroth 2010-03-07: DEVs, please check if the information in the table is still valid</span></em></p><div class="table" id="id-1.4.4.8.5.7" data-id-title="OCF return codes"><div class="title-container"><div class="table-title-wrap"><div class="table-title"><span class="title-number-name"><span class="title-number">Table 10.2: </span><span class="title-name">OCF return codes </span></span><a title="Permalink" class="permalink" href="cha-ha-agents.html#id-1.4.4.8.5.7">#</a></div></div><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_error_codes.xml" title="Edit source document"> </a></div></div><div class="table-contents"><table style="border-collapse: collapse; border-top: 1px solid ; border-bottom: 1px solid ; border-left: 1px solid ; border-right: 1px solid ; "><colgroup><col class="1"/><col class="2"/><col class="3"/><col class="4"/></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; ">
209209
<p>
210210
OCF Return Code
211211
</p>

SLEHA15SP5/html/SLE-HA-administration/cha-ha-concepts.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,8 @@
9999
</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>
100100
Active/active configurations
101101
</p></li><li class="listitem"><p>
102-
102+
<em><span class="remark">toms 2018-09-20: Explain the meaning of these abbreviations
103+
(from Lars):</span></em>
103104
Active/passive configurations: N+1, N+M, N to 1, N to M
104105
</p></li><li class="listitem"><p>
105106
Hybrid physical and virtual clusters, allowing virtual servers to be

SLEHA15SP5/html/SLE-HA-administration/cha-ha-config-basics.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -432,7 +432,8 @@
432432
</p><p>
433433
To display a short description of the parameter on the right-hand side of
434434
the screen, hover your mouse over a parameter.
435-
435+
<em><span class="remark">taroth 2017-08-10: this does no longer seem to be the case
436+
@ayoub: are those descriptions gone on purpose?</span></em>
436437
</p><div class="figure" id="id-1.4.4.3.6.8.4.3.4"><div class="figure-contents"><div class="mediaobject"><a href="images/hawk2-cluster-config.png"><img src="images/hawk2-cluster-config.png" width="100%" alt="Hawk2—cluster configuration" title="Hawk2—cluster configuration"/></a></div></div><div class="title-container"><div class="figure-title-wrap"><div class="figure-title"><span class="title-number-name"><span class="title-number">Figure 5.1: </span><span class="title-name">Hawk2—cluster configuration </span></span><a title="Permalink" class="permalink" href="cha-ha-config-basics.html#id-1.4.4.3.6.8.4.3.4">#</a></div></div><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_config_hawk2.xml" title="Edit source document"> </a></div></div></div></li><li class="step"><p>
437438
Check the values for <span class="guimenu">no-quorum-policy</span> and
438439
<span class="guimenu">stonith-enabled</span> and adjust them, if necessary:

SLEHA15SP5/html/SLE-HA-administration/cha-ha-lb.html

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,9 @@
104104
</p><p>
105105
High availability is provided by detecting node or service failures and
106106
reconfiguring the whole virtual server system appropriately, as usual.
107-
</p><p>
107+
</p><p class="remark"><em><span class="remark">Most of the following items are taken from FATE#316459. Not
108+
sure if this is really correct. Needs technical proofreading by an
109+
expert.</span></em></p><p>
108110
There are several load balancing strategies. Here are some Layer 4
109111
strategies, suitable for Linux Virtual Server:
110112
</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="formalpara-title">Round robin. </span>
@@ -496,7 +498,11 @@
496498
servers that you want to use as backup for the load balancer. You can
497499
synchronize the configuration file with Csync2 as described in
498500
<a class="xref" href="cha-ha-ycluster.html#sec-ha-installation-setup-csync2" title="4.7. Transferring the configuration to all nodes">Section 4.7, “Transferring the configuration to all nodes”</a>.
499-
</p></li></ul></div></section></section><section class="sect1" id="sec-ha-lb-haproxy" data-id-title="Configuring load balancing with HAProxy"><div class="titlepage"><div><div><div class="title-container"><h2 class="title"><span class="title-number-name"><span class="title-number">17.3 </span><span class="title-name">Configuring load balancing with HAProxy</span></span> <a title="Permalink" class="permalink" href="cha-ha-lb.html#sec-ha-lb-haproxy">#</a></h2><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_lb_haproxy.xml" title="Edit source document"> </a></div></div></div></div></div><p>
501+
</p></li></ul></div></section></section><section class="sect1" id="sec-ha-lb-haproxy" data-id-title="Configuring load balancing with HAProxy"><div class="titlepage"><div><div><div class="title-container"><h2 class="title"><span class="title-number-name"><span class="title-number">17.3 </span><span class="title-name">Configuring load balancing with HAProxy</span></span> <a title="Permalink" class="permalink" href="cha-ha-lb.html#sec-ha-lb-haproxy">#</a></h2><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_lb_haproxy.xml" title="Edit source document"> </a></div></div></div></div></div><p class="remark"><em><span class="remark">
502+
This is a straightforward explanation how to set up a HA openSUSE
503+
13.1 http load balancer, but not using SLE HA tools, but plain
504+
vanilla openSUSE with vi.
505+
</span></em></p><p>
500506
The following section gives an overview of the HAProxy and how to
501507
set up on High Availability. The load balancer distributes all requests to its
502508
back-end servers. It is configured as active/passive, meaning if one
@@ -523,7 +529,7 @@
523529
</p></li><li class="step"><p>
524530
Create the file <code class="filename">/etc/haproxy/haproxy.cfg</code> with the
525531
following contents:
526-
</p><div class="verbatim-wrap"><pre class="screen">global <span class="callout" id="co-ha-lb-global">1</span>
532+
</p><em><span class="remark">toms 2014-09-17: Not sure about all the options.</span></em><div class="verbatim-wrap"><pre class="screen">global <span class="callout" id="co-ha-lb-global">1</span>
527533
maxconn 256
528534
daemon
529535

SLEHA15SP5/html/SLE-HA-administration/cha-ha-ocfs2.html

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -387,7 +387,9 @@
387387
resource. If you use the wizard, you still need to create an SBD
388388
partition on the shared storage and configure a STONITH resource as
389389
described in <a class="xref" href="cha-ha-ocfs2.html#pro-ocfs2-stonith" title="Configuring a STONITH resource">Procedure 21.1, “Configuring a STONITH resource”</a>.
390-
</p><p>
390+
</p><p class="remark"><em><span class="remark">taroth 2014-08-15: todo for next release: unify manual configuration
391+
and configuration via Hawk (use same resources, same options
392+
etc.), filed https://bugzilla.novell.com/show_bug.cgi?id=892116 for this</span></em></p><p>
391393
Using the OCFS2 template in the Hawk2 <span class="guimenu">Setup
392394
Wizard</span> also leads to a slightly different resource
393395
configuration than the manual configuration described in

SLEHA15SP5/html/SLE-HA-administration/cha-ha-rear.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -186,12 +186,12 @@
186186
with their original file size. Therefore, it is impossible to
187187
restore the snapshots as they have been before on the original
188188
system.
189-
</p></dd><dt id="id-1.4.5.10.3.8.3.3"><span class="term">Your SLE system needs matching ReaR configuration</span></dt><dd><p>
189+
</p></dd><dt id="id-1.4.5.10.3.8.3.3"><span class="term">Your SLE system needs matching ReaR configuration</span></dt><dd><p class="remark"><em><span class="remark">toms 2018-04-18: See https://github.com/rear/rear/issues/1368#issuecomment-302410707</span></em></p><p>
190190
For example, the setups in SLE12 GA, SLE12 SP1, and SLE12 SP2 have several
191191
incompatible Btrfs default structures. As such, it is
192192
crucial to use a matching ReaR configuration file. See the example
193193
files <code class="filename">/usr/share/rear/conf/examples/SLE12*-btrfs-example.conf</code>.
194-
194+
<em><span class="remark">toms 2018-04-18: https://github.com/rear/rear/issues/1368#issuecomment-302410707</span></em>
195195
</p></dd></dl></div></section><section class="sect2" id="sec-ha-rear-concept-scenarios" data-id-title="Scenarios and backup tools"><div class="titlepage"><div><div><div class="title-container"><h3 class="title"><span class="title-number-name"><span class="title-number">27.1.7 </span><span class="title-name">Scenarios and backup tools</span></span> <a title="Permalink" class="permalink" href="cha-ha-rear.html#sec-ha-rear-concept-scenarios">#</a></h3><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_rear.xml" title="Edit source document"> </a></div></div></div></div></div><p>
196196
ReaR can create a disaster recovery system (including a system-specific
197197
recovery installer) that can be booted from a local medium (like a hard

SLEHA15SP5/html/SLE-HA-administration/cha-ha-samba.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -239,7 +239,7 @@
239239
ip:1 (ocf:heartbeat:IPaddr2): Started factory-1</pre></div></li><li class="step"><p>
240240
Test from a client machine. On a Linux client, run the following
241241
command to see if you can copy files from and to the system:
242-
</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">smbclient //192.168.2.222/myshare</code></pre></div></li></ol></div></div></section><section class="sect1" id="sec-ha-samba-ad" data-id-title="Joining an Active Directory domain"><div class="titlepage"><div><div><div class="title-container"><h2 class="title"><span class="title-number-name"><span class="title-number">26.3 </span><span class="title-name">Joining an Active Directory domain</span></span> <a title="Permalink" class="permalink" href="cha-ha-samba.html#sec-ha-samba-ad">#</a></h2><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_samba.xml" title="Edit source document"> </a></div></div></div></div></div><p>
242+
</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">smbclient //192.168.2.222/myshare</code></pre></div></li></ol></div></div></section><section class="sect1" id="sec-ha-samba-ad" data-id-title="Joining an Active Directory domain"><div class="titlepage"><div><div><div class="title-container"><h2 class="title"><span class="title-number-name"><span class="title-number">26.3 </span><span class="title-name">Joining an Active Directory domain</span></span> <a title="Permalink" class="permalink" href="cha-ha-samba.html#sec-ha-samba-ad">#</a></h2><div class="icons"><a target="_blank" class="icon-reportbug" title="Report an issue"> </a><a target="_blank" class="icon-editsource" href="https://github.com/SUSE/doc-sleha/edit/main/xml/ha_samba.xml" title="Edit source document"> </a></div></div></div></div></div><p class="remark"><em><span class="remark">toms 2013-04-02: Needs changes</span></em></p><p>
243243
Active Directory (AD) is a directory service for Windows server systems.
244244
</p><p>
245245
The following instructions outline how to join a CTDB cluster to an

0 commit comments

Comments
 (0)