Skip to content

Commit add6e76

Browse files
tahliartahliar
committed
Add installation overview (WIP)
1 parent a9283e3 commit add6e76

2 files changed

Lines changed: 122 additions & 25 deletions

File tree

‎xml/ha_installation_overview.xml‎

Lines changed: 121 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -16,35 +16,132 @@
1616
<info>
1717
<abstract>
1818
<para>
19-
You can also use a combination of both setup methods, for example: set up one node with YaST cluster and then use one of the bootstrap scripts to integrate more nodes (or vice versa).
19+
This chapter shows an overview of the steps required to set up a working and supported &ha; cluster. It includes all of the options for a full cluster. If you want to start with a basic two-node cluster with only the default options, see <xref linkend="article-installation"/>.
2020
</para>
2121
</abstract>
2222
<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
2323
<dm:bugtracker></dm:bugtracker>
2424
<dm:translation>yes</dm:translation>
2525
</dm:docmanager>
2626
</info>
27-
<para>
28-
If you are setting up a &ha; cluster with &productnamereg; for the first time, the
29-
easiest way is to start with a basic two-node cluster. You can also use the
30-
two-node cluster to run some tests. Afterward, you can add more
31-
nodes by cloning existing cluster nodes with &ay;. The cloned nodes will
32-
have the same packages installed and the same system configuration as the
33-
original ones.
34-
</para>
35-
36-
<sect1 xml:id="sec-ha-installation-workflow-options">
37-
<title>Workflow options</title>
38-
<para>
39-
40-
</para>
41-
</sect1>
42-
43-
<sect1 xml:id="sec-ha-installation-preconfig-options">
44-
<title>Preconfiguration options</title>
45-
<para>
46-
47-
</para>
48-
</sect1>
49-
27+
<orderedlist>
28+
<title>Overview of installing a &ha; cluster</title>
29+
<listitem>
30+
<para>
31+
<xref linkend="cha-ha-requirements"/>
32+
</para>
33+
</listitem>
34+
<listitem>
35+
<para>
36+
You can set up the cluster with either the &rootuser; user or a user with <command>sudo</command> privileges. Review <xref linkend="cha-ha-log-in"/> to determine the appropriate user for your requirements.
37+
</para>
38+
</listitem>
39+
<listitem>
40+
<para>
41+
Install the &ha; extension and packages on the nodes as described in <xref linkend="cha-ha-install"/>.
42+
</para>
43+
</listitem>
44+
<listitem>
45+
<para>
46+
Set up the cluster on the nodes. You can use either of the following methods:
47+
</para>
48+
<itemizedlist>
49+
<listitem>
50+
<para>
51+
<xref linkend="cha-ha-bootstrap-install"/>
52+
</para>
53+
</listitem>
54+
<listitem>
55+
<para>
56+
<xref linkend="cha-ha-ycluster"/>
57+
</para>
58+
</listitem>
59+
</itemizedlist>
60+
<para>
61+
You can also use a combination of both setup methods. For example, you could set up one node with the &yast; cluster module and then use the bootstrap scripts to integrate more nodes (or vice versa).
62+
</para>
63+
<para>
64+
The following table shows the components that are configured by each method:
65+
</para>
66+
<informaltable>
67+
<tgroup cols="3">
68+
<colspec colname="c1" colwidth="33%"/>
69+
<colspec colname="c2" colwidth="33%"/>
70+
<colspec colname="c3" colwidth="34%"/>
71+
<thead>
72+
<row>
73+
<entry>Component</entry>
74+
<entry>Bootstrap script</entry>
75+
<entry>&yast; cluster module</entry>
76+
</row>
77+
</thead>
78+
<tbody>
79+
<row>
80+
<entry>Firewall ports</entry>
81+
<entry>Yes</entry>
82+
<entry>Yes</entry>
83+
</row>
84+
<row>
85+
<entry>Passwordless SSH</entry>
86+
<entry>Yes</entry>
87+
<entry>No; configure before setup</entry>
88+
</row>
89+
<row>
90+
<entry>&csync;</entry>
91+
<entry>Yes</entry>
92+
<entry>Yes</entry>
93+
</row>
94+
<row>
95+
<entry>&corosync;</entry>
96+
<entry>Yes</entry>
97+
<entry>Yes</entry>
98+
</row>
99+
<row>
100+
<entry>&stonith; (node fencing)</entry>
101+
<entry>Optional (SBD only)</entry>
102+
<entry>No; configure after setup</entry>
103+
</row>
104+
<row>
105+
<entry>&qdevice;</entry>
106+
<entry>Optional</entry>
107+
<entry>Optional</entry>
108+
</row>
109+
</tbody>
110+
</tgroup>
111+
</informaltable>
112+
</listitem>
113+
<listitem>
114+
<para>
115+
Add more nodes. After setting up the initial cluster, you can clone nodes for mass deployment as described in <xref linkend="sec-ha-installation-autoyast"/>.
116+
</para>
117+
</listitem>
118+
<listitem>
119+
<para>
120+
To be supported, a &sleha; cluster <emphasis>must</emphasis> have &stonith; (node fencing) enabled. A node fencing mechanism can be one of the following:
121+
</para>
122+
<itemizedlist>
123+
<listitem>
124+
<para>
125+
A physical device (a power switch). To configure the cluster to use physical &stonith; devices, see <xref linkend="cha-ha-fencing"/>.
126+
</para>
127+
</listitem>
128+
<listitem>
129+
<para>
130+
SBD (&stonith; Block Device) in combination with a watchdog. To configure SBD devices and the watchdog, see <xref linkend="cha-ha-storage-protect"/>.
131+
</para>
132+
<tip role="compact">
133+
<para>
134+
Optionally, you can configure SBD during the cluster setup with the bootstrap scripts (but not &yast;). In this case, you should set up shared storage and the watchdog <emphasis>before</emphasis> you initialize the cluster.
135+
</para>
136+
</tip>
137+
</listitem>
138+
</itemizedlist>
139+
</listitem>
140+
<listitem>
141+
<para>
142+
Configure other things you declined to do before, e.g. QDevice
143+
<xref linkend="cha-ha-qdevice"/>
144+
</para>
145+
</listitem>
146+
</orderedlist>
50147
</chapter>

‎xml/ha_log_in.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@
6969
<term>A user with <command>sudo</command> privileges (with SSH agent forwarding)</term>
7070
<listitem>
7171
<para>
72-
You can use SSH forwarding to pass your local SSH keys to the cluster nodes.
72+
You can use SSH agent forwarding to pass your local SSH keys to the cluster nodes.
7373
This can be useful if you need to avoid storing SSH keys on the nodes, but requires
7474
additional configuration on your local machine and on the cluster nodes.
7575
</para>

0 commit comments

Comments
 (0)