From cc0c3680702364ad84b5ae6dae79576c7ed890da Mon Sep 17 00:00:00 2001 From: Tytus Kurek Date: Tue, 18 Feb 2025 17:25:57 +0100 Subject: [PATCH 1/4] Adding a requirement for the DHCP server --- ...hly-available-juju-controller-on-top-of-a-lxd-cluster.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst index 640a475..848c85d 100644 --- a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst +++ b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst @@ -16,6 +16,11 @@ Requirements You will need: +* one dedicated physical network with: + + * an unlimited access to the Internet + * DHCP server configured to serve LXD containers + * at least three dedicated physical machines with: * hardware specifications matching minimum hardware specifications for the *Cloud* node as documented under the :doc:`Enterprise requirements` section From d277ea0e5214ccaa14e3968a21ac35ef5648be4d Mon Sep 17 00:00:00 2001 From: Tytus Kurek Date: Thu, 20 Feb 2025 00:23:41 +0100 Subject: [PATCH 2/4] Adding changes as per reviewer's feedback --- ...able-juju-controller-on-top-of-a-lxd-cluster.rst | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst index 848c85d..0f41a12 100644 --- a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst +++ b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst @@ -18,7 +18,7 @@ You will need: * one dedicated physical network with: - * an unlimited access to the Internet + * unlimited access to the Internet * DHCP server configured to serve LXD containers * at least three dedicated physical machines with: @@ -78,6 +78,7 @@ When prompted, answer some interactive questions. Below is a sample output from .. code-block :: text + Installing LXD snap, please be patient. Would you like to use LXD clustering? (yes/no) [default=no]: yes What IP address or DNS name should be used to reach this server? [default=172.16.1.101]: 172.16.1.101 Are you joining an existing cluster? (yes/no) [default=no]: no @@ -212,11 +213,8 @@ To create a dedicated system account and to switch into it, execute the followin .. code-block :: text - sudo groupadd bootstrap - sudo useradd -m -g bootstrap -s /bin/bash bootstrap + sudo adduser bootstrap sudo usermod -a -G lxd,sudo bootstrap - sudo passwd bootstrap - sudo -i su bootstrap cd @@ -365,6 +363,10 @@ At this point you should be able to see all three containers being equally distr | juju-e4ce90-2 | RUNNING | 172.16.1.250 (eth0) | | CONTAINER | 0 | cloud-3 | +---------------+---------+---------------------+------+-----------+-----------+----------+ +.. warning :: + + To avoid an unintended change of IPs and thus, loosing connectivity with Juju controllers post-deployment, reconfigure LXD containers to use static IP addresses at this point. Use the same IPs that were assigned during bootstrap. In order to recnfigure LXD containers to use static IP addresses, refer to the `Netplan documentation `_. + Create necessary credentials for the Sunbeam client --------------------------------------------------- @@ -424,4 +426,5 @@ For example: .. code-block :: text + sunbeam prepare-node-script --bootstrap | bash -x && newgrp snap_daemon sunbeam cluster bootstrap --role control,compute,storage --controller mylxdcluster-default From 8cd758624ec11920a20205473b6119ae31e6ab47 Mon Sep 17 00:00:00 2001 From: Tytus Kurek Date: Wed, 26 Feb 2025 14:57:56 +0100 Subject: [PATCH 3/4] Fixing spell checks --- .wordlist.txt | 1 + ...highly-available-juju-controller-on-top-of-a-lxd-cluster.rst | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/.wordlist.txt b/.wordlist.txt index f012d63..c10256d 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -43,6 +43,7 @@ Mattermost MyST namespace namespaces +Netplan NodePort Numbat observability diff --git a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst index 0f41a12..56d4a69 100644 --- a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst +++ b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst @@ -365,7 +365,7 @@ At this point you should be able to see all three containers being equally distr .. warning :: - To avoid an unintended change of IPs and thus, loosing connectivity with Juju controllers post-deployment, reconfigure LXD containers to use static IP addresses at this point. Use the same IPs that were assigned during bootstrap. In order to recnfigure LXD containers to use static IP addresses, refer to the `Netplan documentation `_. + To avoid an unintended change of IPs and thus, loosing connectivity with Juju controllers post-deployment, reconfigure LXD containers to use static IP addresses at this point. Use the same IPs that were assigned during bootstrap. In order to reconfigure LXD containers to use static IP addresses, refer to the `Netplan documentation `_. Create necessary credentials for the Sunbeam client --------------------------------------------------- From 8b4cb9716d601bdb68f664172eff282c0d746374 Mon Sep 17 00:00:00 2001 From: Tytus Kurek Date: Wed, 26 Feb 2025 15:02:18 +0100 Subject: [PATCH 4/4] Fixing a link to the Netplan documentation --- ...highly-available-juju-controller-on-top-of-a-lxd-cluster.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst index 56d4a69..c5f213e 100644 --- a/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst +++ b/how-to/misc/bootstrap-highly-available-juju-controller-on-top-of-a-lxd-cluster.rst @@ -365,7 +365,7 @@ At this point you should be able to see all three containers being equally distr .. warning :: - To avoid an unintended change of IPs and thus, loosing connectivity with Juju controllers post-deployment, reconfigure LXD containers to use static IP addresses at this point. Use the same IPs that were assigned during bootstrap. In order to reconfigure LXD containers to use static IP addresses, refer to the `Netplan documentation `_. + To avoid an unintended change of IPs and thus, loosing connectivity with Juju controllers post-deployment, reconfigure LXD containers to use static IP addresses at this point. Use the same IPs that were assigned during bootstrap. In order to reconfigure LXD containers to use static IP addresses, refer to the `Netplan documentation `_. Create necessary credentials for the Sunbeam client ---------------------------------------------------