diff --git a/source/adminguide/networking/manage_guest_networks.rst b/source/adminguide/networking/manage_guest_networks.rst new file mode 100644 index 0000000000..b754622d09 --- /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 c0fbe69f03..d6aa253cfc 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 444200cfc1..1a85afec4c 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” + `_. + +#. (Optional) Create a new network offering with SystemOffering + + For more information, see `“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” +`_. + +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” +`_. diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst index 402e70a456..a6dc6285db 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.