Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
147 changes: 75 additions & 72 deletions source/_includes/_admincli/removeserver.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,11 @@ section, you need to:
#. Take note of the FQDN of the Node to be removed, because it will
be needed. It will be denoted as ``serverHostname`` in the procedure

#. in case you remove a Proxy Component or a Mailstore & Provisioning Component,
check that the Preview Component is correctly configured. See Section
:ref:`memcached-proxy` and :ref:`memcached-mp`, respectively, for
directions.
..
#. in case you remove a Proxy Component or a Mailstore & Provisioning Component,
check that the Preview Component is correctly configured. See Section
:ref:`memcached-proxy` and :ref:`memcached-mp`, respectively, for
directions.

Node Removal
============
Expand Down Expand Up @@ -96,110 +97,112 @@ remove more than one Node, execute the following steps for each Node.
Node is not part of the |product| infrastructure anymore. You can
now power off the Node and decommission it.

.. _memcached-proxy:
..
.. _memcached-proxy:

Configuration Fix for Proxy Removal
===================================
Configuration Fix for Proxy Removal
===================================

In case you are removing from the infrastructure a Node which installs
a Proxy, you need to adjust a configuration file on the Preview Node.
In case you are removing from the infrastructure a Node which installs
a Proxy, you need to adjust a configuration file on the Preview Node.

This is required by the **memcached** configuration that supports the
Preview Component and consists of replacing a configuration value with the
IP address of the new Proxy Component.
This is required by the **memcached** configuration that supports the
Preview Component and consists of replacing a configuration value with the
IP address of the new Proxy Component.

The procedure is slight different if you if you replace an
existent Proxy with a new one or simply decommission one Proxy
but keep an existing one (or more that one).
The procedure is slight different if you if you replace an
existent Proxy with a new one or simply decommission one Proxy
but keep an existing one (or more that one).

.. card:: Replace a Proxy Node
.. card:: Replace a Proxy Node

Supposing that the IP of the decommissioned Proxy Node is
**172.16.0.12**, and the new one is **172.16.0.73**, you need to
change in file :file:`/etc/carbonio/preview/config.ini` the line
Supposing that the IP of the decommissioned Proxy Node is
**172.16.0.12**, and the new one is **172.16.0.73**, you need to
change in file :file:`/etc/carbonio/preview/config.ini` the line

.. code-block:: ini
.. code-block:: ini

memcached_server_full_path_urls = 172.16.0.12:11211
memcached_server_full_path_urls = 172.16.0.12:11211

into
into

.. code-block:: ini
.. code-block:: ini

memcached_server_full_path_urls = 172.16.0.73:11211
memcached_server_full_path_urls = 172.16.0.73:11211

.. card:: Do not replace a Proxy Node
.. card:: Do not replace a Proxy Node

In case you decommission a Proxy Node without replacing it, you
still need to edit file :file:`/etc/carbonio/preview/config.ini`,
but you need to delete the IP of the decommissioned Proxy Node, for
example (assuming you are decommissioning **172.16.0.12**)
In case you decommission a Proxy Node without replacing it, you
still need to edit file :file:`/etc/carbonio/preview/config.ini`,
but you need to delete the IP of the decommissioned Proxy Node, for
example (assuming you are decommissioning **172.16.0.12**)

.. code-block:: ini
.. code-block:: ini

memcached_server_full_path_urls = 172.16.0.12:11211,172.16.0.22:11211
memcached_server_full_path_urls = 172.16.0.12:11211,172.16.0.22:11211

becomes
becomes

.. code-block:: ini
.. code-block:: ini

memcached_server_full_path_urls = 172.16.0.22:11211
memcached_server_full_path_urls = 172.16.0.22:11211

Please refer to Section :ref:`conf-memcached` in Preview Component's
installation for details.
Please refer to Section :ref:`conf-memcached` in Preview Component's
installation for details.

.. _memcached-mp:
..
.. _memcached-mp:

Configuration Fix for Mailstore & Provisioning Removal
======================================================
Configuration Fix for Mailstore & Provisioning Removal
======================================================

In case you are removing from the infrastructure a Node which installs
a Mailstore & Provisioning, you need to adjust a configuration file on
the Preview Node.
In case you are removing from the infrastructure a Node which installs
a Mailstore & Provisioning, you need to adjust a configuration file on
the Preview Node.

This is required by the **memcached** configuration that supports the
Mailstore & Provisioning Component and consists of replacing a
configuration value with the IP address of the new Mailstore &
Provisioning Component.
This is required by the **memcached** configuration that supports the
Mailstore & Provisioning Component and consists of replacing a
configuration value with the IP address of the new Mailstore &
Provisioning Component.

The procedure is slight different if you if you replace an existent
Mailstore & Provisioning with a new one or simply decommission one
Mailstore & Provisioning but keep an existing one (or more that one).
The procedure is slight different if you if you replace an existent
Mailstore & Provisioning with a new one or simply decommission one
Mailstore & Provisioning but keep an existing one (or more that one).

.. card:: Replace a Mailstore & Provisioning Node
.. card:: Replace a Mailstore & Provisioning Node

Supposing that the IP of the decommissioned Mailstore &
Provisioning Node is **172.16.0.13**, and the new one is
**172.16.0.58**, you need to change in file
:file:`/etc/carbonio/preview/config.ini` the line
Supposing that the IP of the decommissioned Mailstore &
Provisioning Node is **172.16.0.13**, and the new one is
**172.16.0.58**, you need to change in file
:file:`/etc/carbonio/preview/config.ini` the line

.. code-block:: ini
.. code-block:: ini

nginx_lookup_server_full_path_urls = https://172.16.0.13:7072
nginx_lookup_server_full_path_urls = https://172.16.0.13:7072

into
into

.. code-block:: ini
.. code-block:: ini

nginx_lookup_server_full_path_urls = https://172.16.0.58:7072
nginx_lookup_server_full_path_urls = https://172.16.0.58:7072

.. card:: Do not replace a Mailstore & Provisioning Node
.. card:: Do not replace a Mailstore & Provisioning Node

In case you decommission a Mailstore & Provisioning Node without
replacing it, you still need to edit file
:file:`/etc/carbonio/preview/config.ini`, but you need to delete
the IP of the decommissioned Mailstore & Provisioning Node, for
example (assuming you are decommissioning **172.16.0.13**)
In case you decommission a Mailstore & Provisioning Node without
replacing it, you still need to edit file
:file:`/etc/carbonio/preview/config.ini`, but you need to delete
the IP of the decommissioned Mailstore & Provisioning Node, for
example (assuming you are decommissioning **172.16.0.13**)

.. code-block:: ini
.. code-block:: ini

nginx_lookup_server_full_path_urls = https://172.16.0.13:7072,https://172.16.0.23:7072
nginx_lookup_server_full_path_urls = https://172.16.0.13:7072,https://172.16.0.23:7072

becomes
becomes

.. code-block:: ini
.. code-block:: ini

nginx_lookup_server_full_path_urls = https://172.16.0.23:7072
nginx_lookup_server_full_path_urls = https://172.16.0.23:7072

Please refer to Section :ref:`conf-memcached` in Preview Component's
installation for details.
Please refer to Section :ref:`conf-memcached` in Preview Component's
installation for details.
25 changes: 0 additions & 25 deletions source/_includes/_installation/_components/memcached.rst

This file was deleted.

13 changes: 0 additions & 13 deletions source/carbonio-ce/architecture/components/component-preview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,16 +35,3 @@ Pending setups
--------------

.. include:: /_includes/_installation/pset.rst

.. _conf-memcached:

Configure Memcached
-------------------

.. include:: /_includes/_installation/_components/memcached.rst

.. note:: In case you have multiple Mailstore & Provisioning or Proxy Nodes,
add all of them as a comma-separated list, for example::

nginx_lookup_server_full_path_urls = https://172.16.0.13:7072,https://172.16.0.23:7072
memcached_server_full_path_urls = 172.16.0.12:11211,172.16.0.22:11211
48 changes: 24 additions & 24 deletions source/carbonio/admincli/administration/changeip.rst
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,8 @@ configuration, keeping in mind that:
follow the instructions in both Sections, :ref:`ip-change-net` and
:ref:`ip-change-mta`

In all cases, execute also the tasks listed in Sections
:ref:`ip-change-pv` and :ref:`ip-change-vs`.
In all cases, execute also the tasks listed in Section
:ref:`ip-change-vs`.

.. _ip-change-net:

Expand Down Expand Up @@ -118,38 +118,38 @@ Finally, Restart |product|

zextras$ zmcontrol restart

..
.. _ip-change-pv:

.. _ip-change-pv:
Modify Preview Component Configuration
--------------------------------------

Modify Preview Component Configuration
--------------------------------------
Edit file :file:`/etc/carbonio/preview/config.ini` and replace the
values of variables **nginx_lookup_servers_full_path_urls** and
**memcached_server_full_path_urls** with the new IP address
(**192.168.10.50**) ones.

Edit file :file:`/etc/carbonio/preview/config.ini` and replace the
values of variables **nginx_lookup_servers_full_path_urls** and
**memcached_server_full_path_urls** with the new IP address
(**192.168.10.50**) ones.
.. code-block:: ini

.. code-block:: ini

nginx_lookup_server_full_path_urls = https://192.168.10.50:7072
memcached_server_full_path_urls = 192.168.10.50:11211
nginx_lookup_server_full_path_urls = https://192.168.10.50:7072
memcached_server_full_path_urls = 192.168.10.50:11211

In case you have multiple Proxy Nodes, add the IP addresses of all
Proxy Nodes as a comma-separated list, for example (assuming
**192.168.10.51** is the second Proxy Node's IP).
In case you have multiple Proxy Nodes, add the IP addresses of all
Proxy Nodes as a comma-separated list, for example (assuming
**192.168.10.51** is the second Proxy Node's IP).

.. note:: In case you have a Multi-Server infrastructure, replace the
192.168.10.50 IP address in the snippets below with the correct IP
addresses, corresponding to the Proxy Node's IP address(es).
.. note:: In case you have a Multi-Server infrastructure, replace the
192.168.10.50 IP address in the snippets below with the correct IP
addresses, corresponding to the Proxy Node's IP address(es).

.. code-block:: ini
.. code-block:: ini

nginx_lookup_server_full_path_urls = https://192.168.10.50:7072,https://192.168.10.51:7072
memcached_server_full_path_urls = 192.168.10.50:11211,192.168.10.51:11211
nginx_lookup_server_full_path_urls = https://192.168.10.50:7072,https://192.168.10.51:7072
memcached_server_full_path_urls = 192.168.10.50:11211,192.168.10.51:11211

.. seealso::
.. seealso::

More information in Section :ref:`conf-memcached`
More information in Section :ref:`conf-memcached`

.. _ip-change-vs:

Expand Down
13 changes: 0 additions & 13 deletions source/carbonio/architecture/components/component-preview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,16 +35,3 @@ Pending setups
--------------

.. include:: /_includes/_installation/pset.rst

.. _conf-memcached:

Configure Memcached
-------------------

.. include:: /_includes/_installation/_components/memcached.rst

.. note:: In case you have multiple Mailstore & Provisioning or Proxy Nodes,
add all of them as a comma-separated list, for example::

nginx_lookup_server_full_path_urls = https://172.16.0.13:7072,https://172.16.0.23:7072
memcached_server_full_path_urls = 172.16.0.12:11211,172.16.0.22:11211
16 changes: 2 additions & 14 deletions source/carbonio/install/scenarios/fullsmall/manual.rst
Original file line number Diff line number Diff line change
Expand Up @@ -253,13 +253,7 @@ MTA/Proxy Node

.. _fms2-step6:

.. dropdown:: Step 6: Enable ``memcached``

.. include:: /_includes/_installation/_components/memcached-enable.rst

.. _fsm2-step7:

.. dropdown:: Step 7: Complete Installation
.. dropdown:: Step 6: Complete Installation

After the successful package installation, start all |product|
services by executing
Expand Down Expand Up @@ -503,13 +497,7 @@ Collaboration Node

.. _fsm4-step7:

.. dropdown:: Step 7: Configure ``memcached``

.. include:: /_includes/_installation/_components/memcached.rst

.. _fsm4-step8:

.. dropdown:: Step 8: Complete Installation
.. dropdown:: Step 7: Complete Installation

After the successful package installation, start all |product|
services by executing
Expand Down
8 changes: 1 addition & 7 deletions source/carbonio/install/scenarios/fullstandard/manual.rst
Original file line number Diff line number Diff line change
Expand Up @@ -718,13 +718,7 @@ Docs and Preview Node

.. _st6-step6:

.. dropdown:: Step 6: Configure ``memcached``

.. include:: /_includes/_installation/_components/memcached.rst

.. _st7-step7:

.. dropdown:: Step 7: Complete Installation
.. dropdown:: Step 6: Complete Installation

After the successful package installation, start all |product|
services by executing
Expand Down
4 changes: 1 addition & 3 deletions source/carbonio/install/scenarios/single/manual.rst
Original file line number Diff line number Diff line change
Expand Up @@ -133,11 +133,9 @@ repositories.

.. _n1-s7:

.. dropdown:: Step 7: Enable and configure ``memcached``
.. dropdown:: Step 7: Enable ``memcached``

.. include:: /_includes/_installation/_components/memcached-enable.rst

.. include:: /_includes/_installation/_components/memcached.rst

.. _n1-s8:

Expand Down