Virtual Router Service Offering

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.

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

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>`_.

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.