diff --git a/doc/source/dist_cloud/kubernetes/index-dist-cloud-kub-95bef233eef0.rst b/doc/source/dist_cloud/kubernetes/index-dist-cloud-kub-95bef233eef0.rst index d901b7fe2..95407f9bb 100644 --- a/doc/source/dist_cloud/kubernetes/index-dist-cloud-kub-95bef233eef0.rst +++ b/doc/source/dist_cloud/kubernetes/index-dist-cloud-kub-95bef233eef0.rst @@ -197,6 +197,17 @@ Distributed Cloud System Controller GEO Redundancy overview-of-distributed-cloud-geo-redundancy configure-distributed-cloud-system-controller-geo-redundancy-e3a31d6bf662 +----------------------------- +Management Network Parameters +----------------------------- + +.. toctree:: + :maxdepth: 1 + + manage-subcloud-management-network-parameters-ffde7da356dc + manage-management-network-parameters-for-a-standalone-aiosx-18c7aaace64d + + -------- Appendix -------- diff --git a/doc/source/dist_cloud/kubernetes/manage-management-network-parameters-for-a-standalone-aiosx-18c7aaace64d.rst b/doc/source/dist_cloud/kubernetes/manage-management-network-parameters-for-a-standalone-aiosx-18c7aaace64d.rst new file mode 100644 index 000000000..917b312a8 --- /dev/null +++ b/doc/source/dist_cloud/kubernetes/manage-management-network-parameters-for-a-standalone-aiosx-18c7aaace64d.rst @@ -0,0 +1,58 @@ +.. WARNING: Add no lines of text between the label immediately following +.. and the title. + +.. _manage-management-network-parameters-for-a-standalone-aiosx-18c7aaace64d: + +============================================================ +Manage Management Network Parameters for a Standalone AIO-SX +============================================================ + +.. rubric:: |context| + +You can change the management IP addresses for a standalone |AIO-SX|. + +.. rubric:: |prereq| + +Ensure that the host has been backed up, in case a system recovery is required. + + +Change the Network Parameters of the Management Network for Standalone AIO-SX Only +---------------------------------------------------------------------------------- + +This task is required only if the management network need to be changed for a +standalone |AIO-SX|. + +.. rubric:: |proc| + +#. Lock the controller. + + .. code-block:: none + + system host-lock controller-0 + +#. Obtain the UUID of the management pool. + + .. code-block:: none + + system addrpool-list + +#. Modify the management address pool. + + For example: + + .. code-block:: none + + system addrpool-modify $UUID \ + --network 192.168.207.0 \ + --prefix 24 \ + --floating-address 192.168.207.2 \ + --controller0-address 192.168.207.3 \ + --controller1-address 192.168.207.4 \ + --gateway-address 192.168.207.1 \ + --ranges 192.168.207.1-192.168.207.50 + +#. Unlock the controller. + + .. code-block:: none + + system host-unlock controller-0 diff --git a/doc/source/dist_cloud/kubernetes/manage-subcloud-management-network-parameters-ffde7da356dc.rst b/doc/source/dist_cloud/kubernetes/manage-subcloud-management-network-parameters-ffde7da356dc.rst new file mode 100644 index 000000000..e02fd7509 --- /dev/null +++ b/doc/source/dist_cloud/kubernetes/manage-subcloud-management-network-parameters-ffde7da356dc.rst @@ -0,0 +1,99 @@ +.. WARNING: Add no lines of text between the label immediately following +.. and the title. + +.. _manage-subcloud-management-network-parameters-ffde7da356dc: + +============================================= +Manage Subcloud Management Network Parameters +============================================= + +You can change the management IP addresses for an |AIO-SX| subcloud. + +.. rubric:: |prereq| + +- Ensure that the subcloud has been backed up, in case a subcloud system + recovery is required. + +- Ensure that the system time between system controllers and the subclouds + are synchronized. + + .. code-block:: none + + ~(keystone_admin)]$ date -u + + If the time is not correct either on the system controllers or the + subclouds, check the ``clock_synchronization`` configuration on the system. + + .. code-block:: none + + ~(keystone_admin)]$ system host-show controller-0 + + Check the |NTP| server configuration or |PTP| server configuration sections + to correct the system time based on the system's ``clock_synchronization`` + configuration (|NTP| or |PTP|). + +Change the Network Parameters of the Management Network for AIO-SX Subcloud Only +-------------------------------------------------------------------------------- + +This task is required only if the management network needs to be changed for an +|AIO-SX| subcloud. + +.. rubric:: |proc| + +#. Lock the controller. + + .. code-block:: none + + system host-lock controller-0 + +#. Obtain the UUID of the management pool. + + .. code-block:: none + + system addrpool-list + +#. Modify the management address pool. + + For example: + + .. code-block:: none + + system addrpool-modify \ + --network 192.168.103.0 \ + --prefix 26 \ + --floating-address 192.168.103.2 \ + --controller0-address 192.168.103.3 \ + --controller1-address 192.168.103.4 \ + --gateway-address 192.168.103.1 \ + --ranges 192.168.103.1-192.168.103.50 + +#. Unlock the controller. + + .. code-block:: none + + system host-unlock controller-0 + +#. Wait for the subcloud to recover and to have all alarms cleared. + +#. On the system controller, perform the following: + + #. Unmanage the subcloud. + + .. code-block:: none + + ~(keystone_admin)]$ dcmanager subcloud unmanage + + #. Update the subcloud with the new subnet parameters. + + For example: + + .. code-block:: none + + ~(keystone_admin)]$ dcmanager subcloud update --management-subnet 192.168.103.0/26 --management-gateway-ip 192.168.103.1 --management-start-ip 192.168.103.2 --management-end-ip 192.168.103.5 --bootstrap-address 10.33.1.3 + + + #. Manage the subcloud. + + .. code-block:: none + + ~(keystone_admin)]$ dcmanager subcloud manage