From 247ccb7b45ef442d67d38e95d1088dfe0e5a7717 Mon Sep 17 00:00:00 2001 From: Radhika PC Date: Tue, 6 Aug 2013 12:03:53 +0530 Subject: [PATCH] CLOUDSTACK-3181 and CLOUDSTACK-847 --- docs/en-US/add-ip-range.xml | 188 ++++++++++++++++++++-------------- docs/en-US/ip-vlan-tenant.xml | 2 +- 2 files changed, 113 insertions(+), 77 deletions(-) diff --git a/docs/en-US/add-ip-range.xml b/docs/en-US/add-ip-range.xml index 3912bc2815e..5759ae8f1b1 100644 --- a/docs/en-US/add-ip-range.xml +++ b/docs/en-US/add-ip-range.xml @@ -19,85 +19,121 @@ under the License. -->
- Adding Multiple IP Ranges - - The feature can only be implemented on IPv4 addresses. - + Multiple Subnets in Shared Network &PRODUCT; provides you with the flexibility to add guest IP ranges from different subnets in Basic zones and security groups-enabled Advanced zones. For security groups-enabled Advanced zones, it implies multiple subnets can be added to the same VLAN. With the addition of this feature, you will be able to add IP address ranges from the same subnet or from a different one when IP address are exhausted. This would in turn allows you to employ higher number of subnets - and thus reduce the address management overhead. - Ensure that you manually configure the gateway of the new subnet before adding the IP range. - Note that &PRODUCT; supports only one gateway for a subnet; overlapping subnets are not - currently supported. - You can also delete IP ranges. This operation fails if an IP from the remove range is in - use. If the remove range contains the IP address on which the DHCP server is running, &PRODUCT; - acquires a new IP from the same subnet. If no IP is available in the subnet, the remove - operation fails. - This feature is supported on KVM, xenServer, and VMware hypervisors. - - - Log in to the &PRODUCT; UI as an administrator or end user. - - - In the left navigation, choose Infrastructure. - - - On Zones, click View More, then click the zone to which you want to work with.. - - - Click Physical Network. - - - In the Guest node of the diagram, click Configure. - - - Click Networks. - - - Select the networks you want to work with. - - - Click View IP Ranges. - - - Click Add IP Range. - The Add IP Range dialog is displayed, as follows: - - - - - - add-ip-range.png: adding an IP range to a network. - - - - - Specify the following: - All the fields are mandatory. - - - Gateway: The gateway for the tier you create. - Ensure that the gateway is within the Super CIDR range that you specified while creating - the VPC, and is not overlapped with the CIDR of any existing tier within the VPC. - - - Netmask: The netmask for the tier you create. - For example, if the VPC CIDR is 10.0.0.0/16 and the network tier CIDR is - 10.0.1.0/24, the gateway of the tier is 10.0.1.1, and the netmask of the tier is - 255.255.255.0. - - - Start IP/ End IP: A range of IP addresses that are - accessible from the Internet and will be allocated to guest VMs. Enter the first and - last IP addresses that define a range that &PRODUCT; can assign to guest VMs . - - - - - Click OK. - - + and thus reduce the address management overhead. You can delete the IP ranges you have + added. +
+ Prerequisites and Guidelines + + + This feature can only be implemented: + + + on IPv4 addresses + + + if virtual router is the DHCP provider + + + on KVM, xenServer, and VMware hypervisors + + + + + Manually configure the gateway of the new subnet before adding the IP range. + + + &PRODUCT; supports only one gateway for a subnet; overlapping subnets are not + currently supported + + + Services, such as User Data and Reset SSH Key, runs on the primary IP of the eth0 + interface. In the case of multiple subnets, the primary IP is allocated from the first + subnet to the eth0 interface of the virtual router. If virtual router is used for + providing DNS service, &PRODUCT;adds an entry, eth0Ip data-server, in the + /etc/hosts directory of the router VM. To access the User Data and Reset + SSH Key services from any additional subnets, use data-server instead of + using the eth0 IP of the router. + For the Reset SSH Key service, the ssh-key reset script has been modified to fetch the + public key by using the name data-server instead of the eth0 IP of the + router. Therefore, if you want to implement the multiple subnet feature, update the user + VM templates with this modified ssh-key restart script. All VMs deployed prior to using + this feature will be able to use the service with the old script. Updating templates is + required only for the VMs that are deployed in the new subnet. + + +
+
+ Adding Multiple Subnets to a Shared Network + + + Log in to the &PRODUCT; UI as an administrator or end user. + + + In the left navigation, choose Infrastructure. + + + On Zones, click View More, then click the zone to which you want to work with.. + + + Click Physical Network. + + + In the Guest node of the diagram, click Configure. + + + Click Networks. + + + Select the networks you want to work with. + + + Click View IP Ranges. + + + Click Add IP Range. + The Add IP Range dialog is displayed, as follows: + + + + + + add-ip-range.png: adding an IP range to a network. + + + + + Specify the following: + All the fields are mandatory. + + + Gateway: The gateway for the tier you create. + Ensure that the gateway is within the Super CIDR range that you specified while + creating the VPC, and is not overlapped with the CIDR of any existing tier within the + VPC. + + + Netmask: The netmask for the tier you create. + For example, if the VPC CIDR is 10.0.0.0/16 and the network tier CIDR is + 10.0.1.0/24, the gateway of the tier is 10.0.1.1, and the netmask of the tier is + 255.255.255.0. + + + Start IP/ End IP: A range of IP addresses that + are accessible from the Internet and will be allocated to guest VMs. Enter the first + and last IP addresses that define a range that &PRODUCT; can assign to guest VMs + . + + + + + Click OK. + + +
diff --git a/docs/en-US/ip-vlan-tenant.xml b/docs/en-US/ip-vlan-tenant.xml index 0d7a61bdf84..d58d49be63a 100644 --- a/docs/en-US/ip-vlan-tenant.xml +++ b/docs/en-US/ip-vlan-tenant.xml @@ -19,7 +19,7 @@ under the License. -->
- Reserving Public IP Addresses and VLANs for Account + Reserving Public IP Addresses and VLANs for Accounts &PRODUCT; provides you the ability to reserve a set of public IP addresses and VLANs exclusively for an account. During zone creation, you can continue defining a set of VLANs and multiple public IP ranges. This feature extends the functionality to enable you to dedicate a