Skip to content

Commit b6b8c27

Browse files
committed
Automatic rebuild after doc-sleha commit d2e7725af01a83f2941dc0205904e67f1f17a36a
1 parent 59fd186 commit b6b8c27

90 files changed

Lines changed: 379 additions & 240 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.

SLEHA15SP4/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 SP4</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 SP4"/>
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 SP4"/>
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 SP4"/>
@@ -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": [
@@ -288,11 +288,12 @@
288288
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
289289
key.</p></li><li class="step"><p>Replace <code class="filename">/etc/hawk/hawk.pem</code> with the
290290
certificate that Hawk2 should present.</p></li><li class="step"><p>
291+
Change ownership of the files to <code class="literal">root:haclient</code>
292+
and make the files accessible to the group:
293+
</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>
294+
<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>
291295
Restart the Hawk2 services to reload the new certificate:
292-
</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>
293-
Change ownership of the files to <code class="literal">root:haclient</code>
294-
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>
295-
<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>
296+
</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>
296297
Use the command <code class="command">crm cluster run</code> for this task. For example:
297298
</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>
298299
INFO: [alice]

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

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

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

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

SLEHA15SP4/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>

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

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

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

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -355,7 +355,8 @@
355355
details, see <a class="xref" href="cha-ha-monitor-clusters.html#sec-conf-hawk2-manage-monitor-status" title="11.1.1. Monitoring a single cluster">Section 11.1.1, “Monitoring a single cluster”</a>. If
356356
your cluster includes <code class="literal">guest nodes</code> (nodes that run
357357
the <code class="literal">pacemaker_remote</code> daemon), they are displayed, too.
358-
358+
<em><span class="remark">taroth 2018-10-30: check and probably mention in more detail in
359+
'sec.conf.hawk2.manage.monitor.status' for next revision</span></em>
359360
The screen refreshes in near real-time: any status changes for nodes
360361
or resources are visible almost immediately.
361362
</p></li><li class="listitem"><p>
@@ -365,7 +366,8 @@
365366
<a class="xref" href="cha-ha-monitor-clusters.html#sec-conf-hawk2-manage-monitor-dash" title="11.1.2. Monitoring multiple clusters">Section 11.1.2, “Monitoring multiple clusters”</a>. If your cluster
366367
includes <code class="literal">guest nodes</code> (nodes that run
367368
the <code class="literal">pacemaker_remote</code> daemon), they are displayed, too.
368-
The screen
369+
<em><span class="remark">taroth 2018-10-30: check and probably mention in more detail in
370+
'sec.conf.hawk2.manage.monitor.status' for next revision</span></em>The screen
369371
refreshes in near real-time: any status changes for nodes or resources
370372
are visible almost immediately.
371373
</p></li></ul></div></dd><dt id="id-1.4.4.3.6.7.4.2.2"><span class="term"><span class="guimenu">Troubleshooting</span>
@@ -433,7 +435,8 @@
433435
</p><p>
434436
To display a short description of the parameter on the right-hand side of
435437
the screen, hover your mouse over a parameter.
436-
438+
<em><span class="remark">taroth 2017-08-10: this does no longer seem to be the case
439+
@ayoub: are those descriptions gone on purpose?</span></em>
437440
</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>
438441
Check the values for <span class="guimenu">no-quorum-policy</span> and
439442
<span class="guimenu">stonith-enabled</span> and adjust them, if necessary:
@@ -882,7 +885,7 @@
882885
recommended to indent lines that belong to a certain subcommand to improve
883886
readability.
884887
</p><p>To use this script, use one of the following methods:</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">crm -f example.cli</code>
885-
<code class="prompt root"># </code><code class="command">crm &lt; example.cli</code></pre></div></section><section class="sect2" id="sec-ha-manual-config-clusterscripts" data-id-title="Using crmshs cluster scripts"><div class="titlepage"><div><div><div class="title-container"><h3 class="title"><span class="title-number-name"><span class="title-number">5.5.5 </span><span class="title-name">Using <code class="systemitem">crmsh</code>'s cluster scripts</span></span> <a title="Permalink" class="permalink" href="cha-ha-config-basics.html#sec-ha-manual-config-clusterscripts">#</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_config_cli.xml" title="Edit source document"> </a></div></div></div></div></div><p>Collecting information from all cluster nodes and deploying any
888+
<code class="prompt root"># </code><code class="command">crm &lt; example.cli</code></pre></div></section><section class="sect2" id="sec-ha-manual-config-clusterscripts" data-id-title="Using crmshs cluster scripts"><div class="titlepage"><div><div><div class="title-container"><h3 class="title"><span class="title-number-name"><span class="title-number">5.5.5 </span><span class="title-name">Using <code class="systemitem">crmsh</code>'s cluster scripts</span></span> <a title="Permalink" class="permalink" href="cha-ha-config-basics.html#sec-ha-manual-config-clusterscripts">#</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_config_cli.xml" title="Edit source document"> </a></div></div></div></div></div><p class="remark"><em><span class="remark">toms 2015-10-14: FATE#318211</span></em></p><p>Collecting information from all cluster nodes and deploying any
886889
changes is a key cluster administration task. Instead of performing
887890
the same procedures manually on different nodes (which is error-prone),
888891
you can use the <code class="systemitem">crmsh</code> cluster scripts.
@@ -948,7 +951,7 @@
948951
with <code class="command">crm status</code>:</p><div class="verbatim-wrap"><pre class="screen"><code class="prompt root"># </code><code class="command">crm status</code>
949952
[...]
950953
Clone Set: c-sysadmin [sysadmin]
951-
Started: [ alice bob ]</pre></div></section></section><section class="sect2" id="sec-ha-manual-config-template" data-id-title="Using configuration templates"><div class="titlepage"><div><div><div class="title-container"><h3 class="title"><span class="title-number-name"><span class="title-number">5.5.6 </span><span class="title-name">Using configuration templates</span></span> <a title="Permalink" class="permalink" href="cha-ha-config-basics.html#sec-ha-manual-config-template">#</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_config_cli.xml" title="Edit source document"> </a></div></div></div></div></div><div id="id-1.4.4.3.7.13.3" data-id-title="Deprecation notice" class="admonition note normal"><img class="symbol" alt="Note" title="Note" src="static/images/icon-note.svg"/><div class="admon-title">Note: Deprecation notice</div><p>The use of configuration templates is deprecated and will
954+
Started: [ alice bob ]</pre></div></section></section><section class="sect2" id="sec-ha-manual-config-template" data-id-title="Using configuration templates"><div class="titlepage"><div><div><div class="title-container"><h3 class="title"><span class="title-number-name"><span class="title-number">5.5.6 </span><span class="title-name">Using configuration templates</span></span> <a title="Permalink" class="permalink" href="cha-ha-config-basics.html#sec-ha-manual-config-template">#</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_config_cli.xml" title="Edit source document"> </a></div></div></div></div></div><p class="remark"><em><span class="remark">toms 2015-10-14: will be replaced by the crm cluster scripts</span></em></p><div id="id-1.4.4.3.7.13.3" data-id-title="Deprecation notice" class="admonition note normal"><img class="symbol" alt="Note" title="Note" src="static/images/icon-note.svg"/><div class="admon-title">Note: Deprecation notice</div><p>The use of configuration templates is deprecated and will
952955
be removed in the future. Configuration templates will be replaced
953956
by cluster scripts, see <a class="xref" href="cha-ha-config-basics.html#sec-ha-manual-config-clusterscripts" title="5.5.5. Using crmsh's cluster scripts">Section 5.5.5, “Using <code class="systemitem">crmsh</code>'s cluster scripts”</a>.
954957
</p></div><p>

SLEHA15SP4/html/SLE-HA-administration/cha-ha-drbd.html

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,8 @@
141141
</p><p>
142142
The following procedures assume that the cluster nodes use the TCP port <code class="literal">7788</code>.
143143
Make sure this port is open in your firewall.
144-
</p></div><p>
144+
</p></div><p class="remark"><em><span class="remark">toms 2014-02-13: phil: perhaps the example should be changed to
145+
use an LV instead;band eg. "nfs" instead of "r0".</span></em></p><p>
145146
To set up DRBD, perform the following procedures:
146147
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
147148
<a class="xref" href="cha-ha-drbd.html#sec-ha-drbd-prepare" title="23.3.1. Preparing your system to use DRBD">Section 23.3.1, “Preparing your system to use DRBD”</a>
@@ -312,7 +313,7 @@
312313
Configuration</span> › <span class="guimenu">Booting</span> as it is
313314
(by default it is <code class="literal">off</code>); do not change that as
314315
Pacemaker manages this service.
315-
</p></li><li class="step"><p>If you have a firewall running, enable <span class="guimenu">Open Port in
316+
</p></li><li class="step"><em><span class="remark">toms 2015-09-29: FATE#318391</span></em><p>If you have a firewall running, enable <span class="guimenu">Open Port in
316317
Firewall</span>.</p></li><li class="step"><p>Go to the <span class="guimenu">Resource Configuration</span> entry.
317318
Select <span class="guimenu">Add</span> to create a new resource (see
318319
<a class="xref" href="cha-ha-drbd.html#fig-ha-drbd-yast-resconfig" title="Resource configuration">Figure 23.2, “Resource configuration”</a>).
@@ -352,7 +353,7 @@
352353
and finish with <span class="guimenu">Save</span>.
353354
</p></li><li class="step"><p>Close the resource configuration with <span class="guimenu">Ok</span>
354355
and <span class="guimenu">Finish</span>.
355-
</p></li><li class="step"><p>If you use LVM with DRBD, it is necessary to change some options
356+
</p></li><li class="step"><em><span class="remark">toms 2015-09-30: FATE#317957</span></em><p>If you use LVM with DRBD, it is necessary to change some options
356357
in the LVM configuration file (see the <span class="guimenu">LVM
357358
Configuration</span> entry). This change can be done by the
358359
YaST DRBD module automatically.

0 commit comments

Comments
 (0)