You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by da...@apache.org on 2023/01/05 19:10:31 UTC

[cloudstack-documentation] branch main updated: Configurable MTU for VR (#279)

This is an automated email from the ASF dual-hosted git repository.

dahn pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git


The following commit(s) were added to refs/heads/main by this push:
     new da274aa  Configurable MTU for VR (#279)
da274aa is described below

commit da274aa1b6aaa4e93601cb6fa8dbeb08511e1b16
Author: Pearl Dsilva <pe...@gmail.com>
AuthorDate: Thu Jan 5 14:10:25 2023 -0500

    Configurable MTU for VR (#279)
    
    Co-authored-by: Abhishek Kumar <ab...@gmail.com>
---
 .../adminguide/networking/advanced_zone_config.rst | 29 ++++++++++++++++------
 .../networking/virtual_private_cloud_config.rst    | 10 +++++---
 source/installguide/configuration.rst              |  3 +++
 3 files changed, 32 insertions(+), 10 deletions(-)

diff --git a/source/adminguide/networking/advanced_zone_config.rst b/source/adminguide/networking/advanced_zone_config.rst
index db4be0d..e7937b3 100644
--- a/source/adminguide/networking/advanced_zone_config.rst
+++ b/source/adminguide/networking/advanced_zone_config.rst
@@ -49,6 +49,14 @@ configure the base guest network:
    -  **Network offering**: If the administrator has configured multiple
       network offerings, select the one you want to use for this network
 
+   - **Public MTU**: The MTU that will be configured on the public interfaces
+      of the network's VR. 
+      **NOTE:** This will not be considered for VPC network tiers, as the 
+      public MTU defined at the VPC network creation level will be considered
+
+   - **Private MTU**: The MTU that will configured on the private interface(s)
+      of the network's VR
+
    -  **External Id**: ID of the network in an external system.
  
    -  **Gateway**: The gateway that the guests instances will use.
@@ -68,8 +76,8 @@ configure the base guest network:
 #. Click OK.
 
 .. note:: 
-   In security groups-enabled Advanced zones and Basic zones, creation of
-   VPC and isolated networks are not supported.
+   * In security groups-enabled Advanced zones and Basic zones, creation of VPC and isolated networks are not supported.
+   * MTU options will be shown in the UI and considered only when zone configuration - `allow.end.users.to.specify.vr.mtu` is set to true. Maximum allowed values for public and private MTU can be controlled by zone-level configurations, `vr.public.interface.max.mtu` and `vr.private.interface.max.mtu` respectively.
 
 Configure Public Traffic in an Advanced Zone
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -141,6 +149,12 @@ Configuring a Shared Guest Network
    -  **Network Offering**: If the administrator has configured multiple
       network offerings, select the one you want to use for this
       network.
+   
+   - **Public MTU**: The MTU that will be configured on the public interfaces
+      of the network's VR. This MTU will considered for redundant VRs 
+
+   - **Private MTU**: The MTU that will configured on the private interface(s)
+      of the network's VR
 
    -  **Associated Network**: The L2 or Isolated network this network is
       associated to. This network will use same VLAN as associated network.
@@ -172,11 +186,12 @@ Configuring a Shared Guest Network
 #. Click OK to confirm.
 
    .. note::
-      End users (not administrator) can only use the network
-      offerings with specifyvlan is false. Please create a network offering
-      with specifyvlan is false to enable this for end users. See
-      `“Creating a New Network Offering”
-      <networking.html#creating-a-new-network-offering>`_.
+      * End users (not administrator) can only use the network
+        offerings with specifyvlan is false. Please create a network offering
+        with specifyvlan is false to enable this for end users. See
+        `“Creating a New Network Offering”
+        <networking.html#creating-a-new-network-offering>`_.
+      * MTU options will be shown in the UI and considered only when zone configuration - `allow.end.users.to.specify.vr.mtu` is set to true. Maximum allowed values for public and private MTU can be controlled by zone-level configurations, `vr.public.interface.max.mtu` and `vr.private.interface.max.mtu` respectively.
 
 
 .. |addguestnetwork.png| image:: /_static/images/add-guest-network.png
diff --git a/source/adminguide/networking/virtual_private_cloud_config.rst b/source/adminguide/networking/virtual_private_cloud_config.rst
index d927746..d274717 100644
--- a/source/adminguide/networking/virtual_private_cloud_config.rst
+++ b/source/adminguide/networking/virtual_private_cloud_config.rst
@@ -215,11 +215,15 @@ addresses in the form of a Classless Inter-Domain Routing (CIDR) block.
    -  **IPv6 DNS**: A set of custom IPv6 DNS that will be used by this VPC. If not provided then IPv6 DNS specified for the zone will be used. Available only when the selected VPC offering is IPv6 enabled and supports DNS service.
 
 
+   - **Public MTU**: The MTU to be configured on the public interfaces of the 
+      VPC network's VR
+
 #. Click OK.
 
-.. note:: 
-   In security groups-enabled Advanced zones and Basic zones, creation of
-   VPC and isolated networks are not supported.
+.. note::
+   * In security groups-enabled Advanced zones and Basic zones, creation of
+     VPC and isolated networks are not supported.
+   * Public MTU option will be shown in the UI and considered only when zone configuration - `allow.end.users.to.specify.vr.mtu` is set to true. Maximum allowed value for public MTU can be controlled by zone-level configuration - `vr.public.interface.max.mtu`.
 
 Adding Tiers
 ~~~~~~~~~~~~
diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst
index 35e9e58..0643b1f 100644
--- a/source/installguide/configuration.rst
+++ b/source/installguide/configuration.rst
@@ -1679,6 +1679,9 @@ the global configuration settings.
 
 #. In the Actions column, click the Edit icon to modify a value.
 
+   .. note::
+      Local configuration parameters will default to global configuration value when an explicit value is not set for them. Reset action for local configurations will also update their value to global configuration value.
+
 
 Granular Global Configuration Parameters
 ----------------------------------------