Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WIP: Expand non-quick installation content #410

Draft
wants to merge 39 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
f73583f
Remove installation content from admin guide
tahliar Sep 14, 2023
9eb85ac
Add initial skeleton of full install guide
tahliar Sep 14, 2023
6b583b6
Move Architecture section above Benefits
tahliar Nov 9, 2023
f74a2c5
Move storage config examples into the architecture section
tahliar Nov 9, 2023
9f3e56f
Remove xref to the glossary
tahliar Nov 9, 2023
de27d8b
Move Architecture back to the end of the chapter
tahliar Nov 9, 2023
3830285
Add 'Starting the' to 'YaST Cluster module'
tahliar Nov 10, 2023
a21c4d0
Add (empty) new chapter files
tahliar Jan 24, 2024
4805b2a
Move autoyast to new Add Nodes chapter
tahliar Jan 24, 2024
843df98
Moving some things around
tahliar Jan 31, 2024
0693f98
Add watchdog procedures
tahliar Jan 31, 2024
ab84656
Add crm cluster join procedure
tahliar Feb 7, 2024
2ebbeb9
Add inital crm cluster init section
tahliar Feb 8, 2024
d23a938
Add autoyast note to pattern installation procedure
tahliar Feb 15, 2024
d1ffb86
Started expanding the crm cluster init section
tahliar Feb 16, 2024
bee8575
Add new metadata from PR#371
tahliar Apr 24, 2024
6cfa3e7
Fix command prompts in Logging In
tahliar May 29, 2024
c85cb1a
Change admin guide authentication section title
tahliar May 29, 2024
a8dab51
Move log in steps to a new section
tahliar May 30, 2024
dc14179
Move crm cluster join to bootstrap chapter
tahliar Jun 3, 2024
8af6a49
Split csync section to flow better in yast chapter
tahliar Jun 4, 2024
c4b3d15
Update to latest metadata
tahliar Jul 12, 2024
25ecc09
Change title
tahliar Jul 12, 2024
cd20db3
Typo
tahliar Aug 28, 2024
a795331
alice -> node1
tahliar Aug 28, 2024
b232248
Clarify node login
tahliar Aug 29, 2024
6a703bc
Add more info about starting the init script
tahliar Aug 30, 2024
6c885c4
Further expand crm cluster init procedure
tahliar Sep 6, 2024
5dc8088
Fill out crm cluster init more
tahliar Sep 10, 2024
1a31940
Move hacluster password warning earlier
tahliar Sep 10, 2024
c5bc6b8
Move back to Admin Guide
tahliar Sep 13, 2024
438571d
Remove duplicate Hawk2 procedure
tahliar Sep 20, 2024
8bd8a5e
Add section for crm cluster remove
tahliar Oct 2, 2024
49bddec
Fix help command
tahliar Oct 3, 2024
ed313d3
Fix pattern name
tahliar Oct 3, 2024
41cfc37
Move installation overview ahead of system requirements
tahliar Oct 9, 2024
79f6ac1
Add yast cluster qdevice section
tahliar Oct 10, 2024
904883e
Make crmsh SSH procedure more findable
tahliar Oct 11, 2024
91baf0c
Add procedure for corosync stage of crm cluster init
tahliar Oct 14, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added images/src/png/yast_cluster_qdevice.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions xml/book_administration.xml
Original file line number Diff line number Diff line change
Expand Up @@ -62,9 +62,13 @@
<title>Installation and setup</title>
<info/>
<xi:include href="ha_concepts.xml"/>
<xi:include href="ha_installation_overview.xml"/>
<xi:include href="ha_requirements.xml"/>
<xi:include href="ha_log_in.xml"/>
<xi:include href="ha_install.xml"/>
<xi:include href="ha_bootstrap_install.xml"/>
<xi:include href="ha_yast_cluster.xml"/>
<xi:include href="ha_autoyast_deploy.xml"/>
</part>

<!-- ===================================================================== -->
Expand Down
148 changes: 148 additions & 0 deletions xml/ha_autoyast_deploy.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,148 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="urn:x-suse:xslt:profiling:docbook51-profile.xsl"
type="text/xml"
title="Profiling step"?>
<!DOCTYPE chapter
[
<!ENTITY % entities SYSTEM "generic-entities.ent">
%entities;
]>

<!--trichardson 2024-06-03: sec- instead of cha- to avoid changing existing IDs-->
<chapter xml:id="sec-ha-installation-autoyast" xml:lang="en"
xmlns="http://docbook.org/ns/docbook" version="5.1"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Deploying nodes with &ay;</title>
<info>
<abstract>
<para>
After you have installed and set up a two-node cluster, you can extend the
cluster by cloning existing nodes with &ay; and adding the clones to the cluster.
</para>
<para>&ay; uses profiles that contains installation and configuration data.
A profile tells &ay; what to install and how to configure the installed system to
get a ready-to-use system in the end. This profile can then be used
for mass deployment in different ways (for example, to clone existing cluster nodes).
</para>
<para>
For detailed instructions on how to use &ay; in various scenarios, see the
<link xlink:href="https://documentation.suse.com/sles-15/html/SLES-all/book-autoyast.html">
&ayguide; for &sls; &productnumber;</link>.
</para>
</abstract>
<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker></dm:bugtracker>
<dm:translation>yes</dm:translation>
</dm:docmanager>
</info>



<important>
<title>Identical hardware</title>
<para>
<xref linkend="pro-ha-installation-clone-node"/> assumes you are rolling
out &productname; &productnumber; to a set of machines with identical hardware
configurations.
</para>
<para>
If you need to deploy cluster nodes on non-identical hardware, refer to the
&deploy; for &sls; &productnumber;,
chapter <citetitle>Automated Installation</citetitle>, section
<citetitle>Rule-Based Autoinstallation</citetitle>.
</para>
</important>

<procedure xml:id="pro-ha-installation-clone-node">
<title>Cloning a cluster node with &ay;</title>
<step>
<para>
Make sure the node you want to clone is correctly installed and
configured. For details, see the &haquick; or
<xref linkend="cha-ha-ycluster"/>.
</para>
</step>
<step>
<para>
Follow the description outlined in the &sle;
&productnumber; &deploy; for simple mass
installation. This includes the following basic steps:
</para>
<substeps performance="required">
<step>
<para>
Creating an &ay; profile. Use the &ay; GUI to create and modify
a profile based on the existing system configuration. In &ay;,
choose the <guimenu>&ha;</guimenu> module and click the
<guimenu>Clone</guimenu> button. If needed, adjust the configuration
in the other modules and save the resulting control file as XML.
</para>
<para>
If you have configured DRBD, you can select and clone this module in
the &ay; GUI, too.
</para>
</step>
<step>
<para>
Determining the source of the &ay; profile and the parameter to
pass to the installation routines for the other nodes.
</para>
</step>
<step>
<para>
Determining the source of the &sls; and &productname;
installation data.
</para>
</step>
<step>
<para>
Determining and setting up the boot scenario for autoinstallation.
</para>
</step>
<step>
<para>
Passing the command line to the installation routines, either by
adding the parameters manually or by creating an
<filename>info</filename> file.
</para>
</step>
<step>
<para>
Starting and monitoring the autoinstallation process.
</para>
</step>
</substeps>
</step>
</procedure>

<para>
After the clone has been successfully installed, execute the following
steps to make the cloned node join the cluster:
</para>

<procedure xml:id="pro-ha-installation-clone-start">
<title>Bringing the cloned node online</title>
<step>
<para>
Transfer the key configuration files from the already configured nodes
to the cloned node with &csync; as described in
<xref linkend="sec-ha-installation-setup-csync2"/>.
</para>
</step>
<step>
<para>
To bring the node online, start the cluster services on the cloned
node as described in <xref linkend="sec-ha-installation-start"/>.
</para>
</step>
</procedure>

<para>
The cloned node now joins the cluster because the
<filename>/etc/corosync/corosync.conf</filename> file has been applied to
the cloned node via &csync;. The CIB is automatically synchronized
among the cluster nodes.
</para>

</chapter>
Loading