From af88b2b76679b4b4826a79042b0e96bc607a526e Mon Sep 17 00:00:00 2001 From: Stefano David Date: Wed, 15 Oct 2025 11:59:27 +0200 Subject: [PATCH 1/3] [ZTD-1448] fix server name for Directory Server Role --- .../scenarios/redundantwithusermailreplica/ur-installation.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst b/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst index 056733ca6..43d223419 100644 --- a/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst +++ b/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst @@ -110,12 +110,13 @@ You need also to add variable to existing groups. #masterDirectoryServers group [masterDirectoryServers] srv1.example.com ldap_role=master - srv2.example.com ldap_role=mmr + srv3.example.com ldap_role=mmr #. The ``dbsConnectorServers`` group must be filled out. DB Connectors will be moved from the Postgres Node to both Mailstore & Provisioning Nodes, because at least one of them must always be available at anytime and provide |ur|. + .. code:: console #dbsConnectorServers group From 7579aea503201e7e13e4beb471f5b6538fb533c3 Mon Sep 17 00:00:00 2001 From: Stefano David Date: Wed, 15 Oct 2025 12:01:09 +0200 Subject: [PATCH 2/3] [ZTD-1448] add missing carbonio-patroni installation command --- .../ur-installation.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst b/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst index 43d223419..372e0f8fd 100644 --- a/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst +++ b/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst @@ -150,15 +150,21 @@ Install PostgreSQL HA PostgreSQL uses HAProxy to add load balancing, health checks, and more. The HAProxy installation has been automated with Ansible and is included in the ``carbonio_patroni`` playbook. First, install the -PstgreSQL replica +PostgreSQL replica .. code:: console # ansible-playbook -i inventory zxbot.carbonio_patroni.carbonio_replica_postgres_install -This task also move DB Connectors from the PostgreSQL Node to db -connector Nodes, if needed, as defined on the inventory file. This -setup allows Db Connectors to connect to an available PostgreSQL Node +Then install ``carbonio_patroni`` + +.. code:: console + + # ansible-playbook -i inventory zxbot.carbonio_patroni.carbonio_patroni_install + +This task also moves DB Connectors from the PostgreSQL Node to DB +Connectors Node, if needed, as defined on the inventory file. This +setup allows DB Connectors to connect to an available PostgreSQL Node managed by Patroni. Install Multi Master LDAP From 2e4c2c0e6780b54fee61d46c3d7bf9cd692ce21d Mon Sep 17 00:00:00 2001 From: Stefano David Date: Wed, 15 Oct 2025 12:38:11 +0200 Subject: [PATCH 3/3] [ZTD-1448] add warning for Directory Replica --- .../standard-installation.rst | 15 ++++++++++----- .../ur-installation.rst | 8 ++++---- 2 files changed, 14 insertions(+), 9 deletions(-) diff --git a/source/carbonio/install/scenarios/redundantwithusermailreplica/standard-installation.rst b/source/carbonio/install/scenarios/redundantwithusermailreplica/standard-installation.rst index 64bdab9bd..ce470eaf4 100644 --- a/source/carbonio/install/scenarios/redundantwithusermailreplica/standard-installation.rst +++ b/source/carbonio/install/scenarios/redundantwithusermailreplica/standard-installation.rst @@ -5,11 +5,16 @@ =========================================== The |ur| setup for |product| builds on the **Scenario -Redundant**. Therefore, it is essential to have a working installation -of that Scenario before starting to deploy the |ur| setup: if you do -not have it yet, please refer to the installation procedure of the -:ref:`scenario-redundant`, then you can proceed to the next -section, :ref:`rur-inst`. +Redundant**. Therefore, it is essential to have an installation of +that Scenario before starting to deploy the |ur| setup: if you do not +have it yet, please refer to the installation procedure of the +:ref:`scenario-redundant`, then you can proceed to the next section, +:ref:`rur-inst`. + +.. warning:: Since the Directory Replica is not needed in this + Scenario, when installing the initial **Scenario Redundant**, you + should empty the block ``[replicaDirectoryServers]`` from the + inventory file. Differences with Scenario Redundant =================================== diff --git a/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst b/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst index 372e0f8fd..18161fa81 100644 --- a/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst +++ b/source/carbonio/install/scenarios/redundantwithusermailreplica/ur-installation.rst @@ -21,7 +21,7 @@ Ansible's Control Node and of the following items: .. code:: console # ansible-galaxy collection install zxbot.carbonio_kafka - # ansible-galaxy collection install zxbot.carbonio_patroni + # ansible-galaxy collection install zxbot.carbonio_patroni # ansible-galaxy collection install zxbot.carbonio_ldap Prepare inventory @@ -42,7 +42,7 @@ To configure the inventory for |rur| installation, you will need to add new groups and add specific variables to the :file:`inventory` file. Please read the following advises if you plan to add the |ur| infrastructure to different Node than the one we will use in the -remainder of the scenario. +remainder of the scenario. .. card:: Guidelines for Components in |ur| Configuration @@ -65,11 +65,11 @@ remainder of the scenario. deployment. The two new groups to add at the bottom of the file are: - + #. ``kafka`` group, which will point to the Nodes where :command:`kafka` will be installed: these are the three Cluster Nodes. To each Node, add the ``broker_id`` variable with a - different value: + different value: .. code:: text