This is an automated email from the ASF dual-hosted git repository.
sureshanaparti pushed a commit to branch 4.16
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.16 by this push:
new ba58176 Virtual Router Service Offering (#157)
ba58176 is described below
commit ba58176f1f1698cacbf12219a28d1308741b703c
Author: Wei Zhou <[email protected]>
AuthorDate: Mon Feb 14 11:25:33 2022 +0100
Virtual Router Service Offering (#157)
* Add header for router service offering
* Add content
* update
Co-authored-by: Wei Zhou <[email protected]>
Co-authored-by: dahn <[email protected]>
Co-authored-by: sureshanaparti
<[email protected]>
---
.../networking/manage_guest_networks.rst | 44 +++++++++++++++++++
source/adminguide/networking_and_traffic.rst | 2 +
source/adminguide/service_offerings.rst | 50 ++++++++++++++++++++++
source/installguide/configuration.rst | 1 +
4 files changed, 97 insertions(+)
diff --git a/source/adminguide/networking/manage_guest_networks.rst
b/source/adminguide/networking/manage_guest_networks.rst
new file mode 100644
index 0000000..b754622
--- /dev/null
+++ b/source/adminguide/networking/manage_guest_networks.rst
@@ -0,0 +1,44 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+
+Editing, Restarting, and Removing a Guest Network
+--------------------------------------------------
+
+.. note:: Ensure that all the VMs are removed before you remove a guest
network.
+
+#. Log in to the CloudStack UI as an administrator or end user.
+
+#. In the left navigation, choose Network.
+
+#. In the Select view, select Guest networks.
+
+ All the guest networks that you have created for the account are listed in
the
+ page.
+
+#. Select the guest network you want to work with.
+
+#. In the Details tab, click the "Delete Network" button
+
+ You can also remove the guest network by using the remove button in the
Quick
+ View.
+
+ You can edit the name, description, network offering, CIDR, network domain
of a
+ guest network. To do that, click the "Edit" button.
+
+ To restart a guest network, click the "Restart network" button. Please note
+ all services provided by this network will be interrupted. When you enable
"Clean up",
+ the virtual routers of guest network will be destroyed and new virtual
routers will
+ be provisioned.
diff --git a/source/adminguide/networking_and_traffic.rst
b/source/adminguide/networking_and_traffic.rst
index c0fbe69..d6aa253 100644
--- a/source/adminguide/networking_and_traffic.rst
+++ b/source/adminguide/networking_and_traffic.rst
@@ -29,6 +29,8 @@ providing networking features for guest traffic.
.. include:: networking/advanced_zone_config.rst
+.. include:: networking/manage_guest_networks.rst
+
.. include:: networking/multiple_guest_networks.rst
.. include:: networking/ip_reservation_in_guest_networks.rst
diff --git a/source/adminguide/service_offerings.rst
b/source/adminguide/service_offerings.rst
index 444200c..1a85afe 100644
--- a/source/adminguide/service_offerings.rst
+++ b/source/adminguide/service_offerings.rst
@@ -721,3 +721,53 @@ default system offering used for System VMs.
#. Destroy the existing CPVM or SSVM offerings and wait for them to be
recreated. The new CPVM or SSVM are configured with the new offering.
+
+
+Changing the Default System Offering for Virtual Routers
+---------------------------------------------------
+
+As a CloudStack administrator, you can change the default system
+offering used for Virtual Routers.
+
+#. Create a new system service offering
+
+ For more information, see `“Creating a New System Offering”
+ <service_offerings.html#creating-a-new-system-service-offering>`_.
+
+#. (Optional) Create a new network offering with SystemOffering
+
+ For more information, see `“Creating a New Network Offering”
+ <networking.html#creating-a-new-network-offering>`_.
+
+#. (Optional) Change account setting
+
+ You can change the default system offering for Virtual Routers of a
particular
+ account by changing the account's setting "router.service.offering" to the
uuid
+ of the system offering.
+
+ For more information, see `“Setting Local Configuration Parameters”
+
<../installguide/configuration.html#setting-local-configuration-parameters>`_.
+
+#. (Optional) Change global configuration
+
+ You can change the default system offering for Virtual Routers of all
accounts
+ by changing the global configuration "router.service.offering" to the uuid
of the system offering.
+
+ For more information, see `“Setting Global Configuration Parameters”
+
<../installguide/configuration.html#setting-global-configuration-parameters>`_.
+
+When you create a network, the virtual routers will use the system offering in
their Network Offering.
+If it is not set, the virtual routers will use the system offering in the
account setting.
+If the account setting is not set, the virtual routers will use the system
offering set in the global configuration.
+If the global configuration is not set, the virtual routers will use the
default system offering for virtual
+routers ("System Offering For Software Router" or "System Offering For
Software Router - Local Storage").
+
+You can update an existing network to a new network offering. The new virtual
routers will use the
+new system offering set in the Network Offering, account setting or global
configuration.
+For more information, see `“Changing the Network Offering on a Guest Network”
+<networking_and_traffic.html#changing-the-network-offering-on-a-guest-network>`_.
+
+You can restart the network with cleanup. The new virtual routers, created
after the restart, will use
+the new system offering, set in the Network Offering, account setting or
global configuration.
+For more information, see `“Editing, Restarting, and Removing a Guest Network”
+<networking_and_traffic.html#editing-restarting-and-removing-a-guest-network>`_.
diff --git a/source/installguide/configuration.rst
b/source/installguide/configuration.rst
index 402e70a..a6dc628 100644
--- a/source/installguide/configuration.rst
+++ b/source/installguide/configuration.rst
@@ -1619,6 +1619,7 @@ account remote.access.vpn.client.iprange
The range o
account allow.public.user.templates If false,
users will not be able to create public templates.
account use.system.public.ips If true
and if an account has one or more dedicated public IP ranges, IPs are
acquired from the system pool after all the
IPs dedicated to the account have been consumed.
account use.system.guest.vlans If true
and if an account has one or more dedicated guest VLAN ranges, VLANs are
allocated from the
system pool after all the VLANs
dedicated to the account have been consumed.
+account router.service.offering Uuid of
the service offering used by virtual routers; if NULL - system offering will be
used
cluster cluster.storage.allocated.capacity.notificationthreshold The
percentage, as a value between 0 and 1, of allocated storage utilization
above which alerts are sent that the
storage is below the threshold.
cluster cluster.storage.capacity.notificationthreshold The
percentage, as a value between 0 and 1, of storage utilization above which
alerts are sent that the available storage is below
the threshold.
cluster cluster.cpu.allocated.capacity.notificationthreshold The
percentage, as a value between 0 and 1, of cpu utilization above which alerts
are sent that the available CPU is below the
threshold.
