Return-Path: X-Original-To: apmail-cloudstack-commits-archive@www.apache.org Delivered-To: apmail-cloudstack-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 33C1C1055D for ; Wed, 10 Apr 2013 22:25:56 +0000 (UTC) Received: (qmail 49201 invoked by uid 500); 10 Apr 2013 22:25:44 -0000 Delivered-To: apmail-cloudstack-commits-archive@cloudstack.apache.org Received: (qmail 49169 invoked by uid 500); 10 Apr 2013 22:25:44 -0000 Mailing-List: contact commits-help@cloudstack.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cloudstack.apache.org Delivered-To: mailing list commits@cloudstack.apache.org Received: (qmail 48640 invoked by uid 99); 10 Apr 2013 22:25:44 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 10 Apr 2013 22:25:44 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id C6E89880094; Wed, 10 Apr 2013 22:25:43 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: prachidamle@apache.org To: commits@cloudstack.apache.org Date: Wed, 10 Apr 2013 22:26:23 -0000 Message-Id: <7116726cf693410b9e695ba28c835ad9@git.apache.org> In-Reply-To: <4511f15a80314d38b78b57fcb124932d@git.apache.org> References: <4511f15a80314d38b78b57fcb124932d@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [42/54] [abbrv] git commit: updated refs/heads/affinity_groups to 6ec7e25 CLOUDSTACK-809 Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/5e445f9d Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/5e445f9d Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/5e445f9d Branch: refs/heads/affinity_groups Commit: 5e445f9dd71233638fedeb91ba36aecaae769e8e Parents: 38a8db9 Author: radhikap Authored: Wed Apr 10 17:24:50 2013 +0530 Committer: radhikap Committed: Wed Apr 10 17:26:38 2013 +0530 ---------------------------------------------------------------------- docs/en-US/added-API-commands-4.2.xml | 19 ++++--- docs/en-US/multiple-ip-nic.xml | 79 ++++++--------------------- 2 files changed, 30 insertions(+), 68 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cloudstack/blob/5e445f9d/docs/en-US/added-API-commands-4.2.xml ---------------------------------------------------------------------- diff --git a/docs/en-US/added-API-commands-4.2.xml b/docs/en-US/added-API-commands-4.2.xml index 3b765f2..4bec148 100644 --- a/docs/en-US/added-API-commands-4.2.xml +++ b/docs/en-US/added-API-commands-4.2.xml @@ -22,17 +22,22 @@ Added API Commands in 4.2 - addIpToNic (Adds an IP address to the NIC from the guest subnet. The request parameters - are: nicid, ipaddress) + addIpToNic + Adds an IP address to the NIC from the guest subnet. The request parameters are: nicid, + ipaddress. + The response parameters are: nicid, ipaddress, networkid - removeIpFromNic (Removes the reserved IP for the NIC. The request parameters is: - id) + removeIpFromNic + Removes the reserved IP for the NIC. The request parameters is: id. + The response parameters are: true, false - listNics (Lists the NIC details of the user VM; the API response also contains the - Secondary IP addresses of the NIC. The request parameters are: nicid, - virtualmachineid) + listNics + Lists the NIC details of the user VM; the API response also contains the Secondary IP + addresses of the NIC. The request parameters are: nicid, virtualmachineid. + The response parameters are: id, ipaddress, secondaryips, gateway, netmask, macaddr, + broadcasturi, isolationuri, isdefault, http://git-wip-us.apache.org/repos/asf/cloudstack/blob/5e445f9d/docs/en-US/multiple-ip-nic.xml ---------------------------------------------------------------------- diff --git a/docs/en-US/multiple-ip-nic.xml b/docs/en-US/multiple-ip-nic.xml index fb9a331..561ba07 100644 --- a/docs/en-US/multiple-ip-nic.xml +++ b/docs/en-US/multiple-ip-nic.xml @@ -21,27 +21,32 @@ -->
Configuring Multiple IP Addresses on a Single NIC - &PRODUCT; now provides you the ability to associate multiple private IP addresses per NIC. - This feature is supported on all the network configurations—Basic, Advanced, and VPC. - Security Groups, Static NAT and Port forwarding services are supported on these additional IPs. - In addition to the primary IP, you can assign additional IPs to the guest VM NIC. Up to 256 IP - addresses are allowed per NIC. + &PRODUCT; now provides you the ability to associate multiple private IP addresses per guest + VM NIC. This feature is supported on all the network configurations—Basic, Advanced, and + VPC. Security Groups, Static NAT and Port forwarding services are supported on these additional + IPs. In addition to the primary IP, you can assign additional IPs to the guest VM NIC. Up to 256 + IP addresses are allowed per NIC. As always, you can specify an IP from the guest subnet; if not specified, an IP is - automatically picked up from the guest subnet. You can view the IPs and associated NICs - for each VMs on the UI. You can apply NAT on these additional guest IPs by using firewall + automatically picked up from the guest VM subnet. You can view the IPs associated with for each + guest VM NICs on the UI. You can apply NAT on these additional guest IPs by using firewall configuration in the &PRODUCT; UI. You must specify the NIC to which the IP should be associated. This feature is supported on XenServer, KVM, and VMware hypervisors. + + You need to configure the secondary IP address on the guest VM. &PRODUCT; will + not configure the acquired IP address on the VM. Ensure that you assign IPs to NIC each + time the VM reboots. + Some of the use cases are described below: - Building network appliances: Network appliances, such as firewalls and load - balancers, generally work best when they have access to multiple IP addresses on the - network interface. + Building network appliances: Network appliances, such as firewalls and load balancers, + generally work best when they have access to multiple IP addresses on the network + interface. - Moving private IP addresses between interfaces or instances. Applications that are - bound to specific IP addresses can be moved between instances. + Moving private IP addresses between interfaces or instances. Applications that are bound + to specific IP addresses can be moved between instances. Hosting multiple SSL Websites on a single instance. You can install multiple SSL @@ -74,55 +79,7 @@
-
- API Changes - The following APIs have been added: - - - - - Parameter Name - Description - Request Parameter - Response Parameter - - - - - addIpToNic - Adds an IP address to the NIC from the guest subnet. - - nicid - (optional) ipaddress - - nicid - ipaddress - networkid - - - removeIpFromNic - Removes the reserved IP for the NIC. - - id - - true - false - - - listNics - Lists the NIC details of the user VM; the API response also contains - the Secondary IP addresses of the NIC. - - virtualmachineid - (optional) nicid - - Lists the NIC details including secondary IP address - - - - -
-
+
Port Forwarding and StaticNAT Services Changes Because multiple IPs can be associated per NIC, you are allowed to select a desired IP for the Port Forwarding and StaticNAT services. The default is the primary IP. To enable this