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 5580610987 for ; Tue, 8 Oct 2013 19:29:05 +0000 (UTC) Received: (qmail 24693 invoked by uid 500); 8 Oct 2013 19:27:30 -0000 Delivered-To: apmail-cloudstack-commits-archive@cloudstack.apache.org Received: (qmail 24551 invoked by uid 500); 8 Oct 2013 19:27:25 -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 24178 invoked by uid 99); 8 Oct 2013 19:27:14 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 08 Oct 2013 19:27:14 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id 8FA2C912FE8; Tue, 8 Oct 2013 19:27:07 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: ke4qqq@apache.org To: commits@cloudstack.apache.org Date: Tue, 08 Oct 2013 19:27:57 -0000 Message-Id: <78d04a06fc084f1e9a0947b5b5c9e886@git.apache.org> In-Reply-To: <10a2402bd76a487daf6b925f5230a8e3@git.apache.org> References: <10a2402bd76a487daf6b925f5230a8e3@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [53/70] moving nicira docs to their own directory http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-provider.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-provider.xml b/nicira/en-US/plugin-niciranvp-provider.xml new file mode 100644 index 0000000..8694478 --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-provider.xml @@ -0,0 +1,36 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + +
+ Enabling the service provider + The Nicira NVP provider is disabled by default. Navigate to the "Network Service Providers" configuration of the physical network with the STT isolation type. Navigate to the Nicira NVP provider and press the "Enable Provider" button. + CloudStack 4.0 does not have the UI interface to configure the Nicira NVP plugin. Configuration needs to be done using the API directly. + + + + + + nvp-physical-network-stt.png: a screenshot of an enabled Nicira NVP provider + + + +
\ No newline at end of file http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-revisions.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-revisions.xml b/nicira/en-US/plugin-niciranvp-revisions.xml new file mode 100644 index 0000000..b58d333 --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-revisions.xml @@ -0,0 +1,59 @@ + + +%BOOK_ENTITIES; +]> + + + + + Revision History + + + + 0-0 + Wed Oct 03 2012 + + Hugo + Trippaers + hugo@apache.org + + + + Documentation created for 4.0.0-incubating version of the NVP Plugin + + + + + 1-0 + Wed May 22 2013 + + Hugo + Trippaers + hugo@apache.org + + + + Documentation updated for &PRODUCT; 4.1.0 + + + + + + http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-tables.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-tables.xml b/nicira/en-US/plugin-niciranvp-tables.xml new file mode 100644 index 0000000..615f349 --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-tables.xml @@ -0,0 +1,106 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + +
+ Database tables + The following tables are added to the cloud database for the Nicira NVP Plugin + + nicira_nvp_nic_map + + + + id + auto incrementing id + + + logicalswitch + uuid of the logical switch this port is connected to + + + logicalswitchport + uuid of the logical switch port for this nic + + + nic + the &PRODUCT; uuid for this nic, reference to the nics table + + + +
+ + + external_nicira_nvp_devices + + + + id + auto incrementing id + + + uuid + UUID identifying this device + + + physical_network_id + the physical network this device is configured on + + + provider_name + NiciraNVP + + + device_name + display name for this device + + + host_id + reference to the host table with the device configuration + + + +
+ + + nicira_nvp_router_map + + + + id + auto incrementing id + + + logicalrouter_uuid + uuid of the logical router + + + network_id + id of the network this router is linked to + + + +
+ + + nicira_nvp_router_map is only available in &PRODUCT; 4.1 and above + + +
\ No newline at end of file http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-troubleshooting.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-troubleshooting.xml b/nicira/en-US/plugin-niciranvp-troubleshooting.xml new file mode 100644 index 0000000..02b0655 --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-troubleshooting.xml @@ -0,0 +1,28 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + + + Troubleshooting the Nicira NVP Plugin + + + + http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-ui.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-ui.xml b/nicira/en-US/plugin-niciranvp-ui.xml new file mode 100644 index 0000000..8b1bbad --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-ui.xml @@ -0,0 +1,26 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + +
+ Configuring the Nicira NVP plugin from the UI + In CloudStack 4.1.0-incubating the Nicira NVP plugin and its resources can be configured in the infrastructure tab of the UI. Navigate to the physical network with STT isolation and configure the network elements. The NiciraNvp is listed here. +
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-usage.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-usage.xml b/nicira/en-US/plugin-niciranvp-usage.xml new file mode 100644 index 0000000..9f04c38 --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-usage.xml @@ -0,0 +1,33 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + + + Configuring the Nicira NVP Plugin + + + + + + + http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-uuidreferences.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-uuidreferences.xml b/nicira/en-US/plugin-niciranvp-uuidreferences.xml new file mode 100644 index 0000000..cb5f1ca --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-uuidreferences.xml @@ -0,0 +1,30 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + +
+ UUID References + The plugin maintains several references in the &PRODUCT; database to items created on the NVP Controller. + Every guest network that is created will have its broadcast type set to Lswitch and if the network is in state "Implemented", the broadcast URI will have the UUID of the Logical Switch that was created for this network on the NVP Controller. + The Nics that are connected to one of the Logical Switches will have their Logical Switch Port UUID listed in the nicira_nvp_nic_map table + All devices created on the NVP Controller will have a tag set to domain-account of the owner of the network, this string can be used to search for items in the NVP Controller. + +
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-vpc.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-vpc.xml b/nicira/en-US/plugin-niciranvp-vpc.xml new file mode 100644 index 0000000..a43c5fa --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-vpc.xml @@ -0,0 +1,30 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + + + Using the Nicira NVP plugin with VPC + + + + + + http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-vpcfeatures.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-vpcfeatures.xml b/nicira/en-US/plugin-niciranvp-vpcfeatures.xml new file mode 100644 index 0000000..a8d8194 --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-vpcfeatures.xml @@ -0,0 +1,28 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + +
+ Supported VPC features + The Nicira NVP plugin supports &PRODUCT; VPC to a certain extent. Starting with &PRODUCT; version 4.1 VPCs can be deployed using NVP isolated networks. + It is not possible to use a Nicira NVP Logical Router for as a VPC Router + It is not possible to connect a private gateway using a Nicira NVP Logical Switch +
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-vpcnetworkoffering.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-vpcnetworkoffering.xml b/nicira/en-US/plugin-niciranvp-vpcnetworkoffering.xml new file mode 100644 index 0000000..141006e --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-vpcnetworkoffering.xml @@ -0,0 +1,81 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + +
+ VPC Network Offerings + The VPC needs specific network offerings with the VPC flag enabled. Otherwise these network offerings are identical to regular network offerings. To allow VPC networks with a Nicira NVP isolated network the offerings need to support the Virtual Networking service with the NiciraNVP provider. + In a typical configuration two network offerings need to be created. One with the loadbalancing service enabled and one without loadbalancing. + + VPC Network Offering with Loadbalancing + + + + Service + Provider + + + + + VPN + VpcVirtualRouter + + + DHCP + VpcVirtualRouter + + + DNS + VpcVirtualRouter + + + Load Balancer + VpcVirtualRouter + + + User Data + VpcVirtualRouter + + + Source NAT + VpcVirtualRouter + + + Static NAT + VpcVirtualRouter + + + Post Forwarding + VpcVirtualRouter + + + NetworkACL + VpcVirtualRouter + + + Virtual Networking + NiciraNVP + + + +
+ +
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/en-US/plugin-niciranvp-vpcoffering.xml ---------------------------------------------------------------------- diff --git a/nicira/en-US/plugin-niciranvp-vpcoffering.xml b/nicira/en-US/plugin-niciranvp-vpcoffering.xml new file mode 100644 index 0000000..292621e --- /dev/null +++ b/nicira/en-US/plugin-niciranvp-vpcoffering.xml @@ -0,0 +1,38 @@ + + +%BOOK_ENTITIES; + +%xinclude; +]> + +
+ VPC Offering with Nicira NVP + To allow a VPC to use the Nicira NVP plugin to provision networks, a new VPC offering needs to be created which allows the Virtual Networking service to be implemented by NiciraNVP. + This is not currently possible with the UI. The API does provide the proper calls to create a VPC offering with Virtual Networking enabled. However due to a limitation in the 4.1 API it is not possible to select the provider for this network service. To configure the VPC offering with the NiciraNVP provider edit the database table 'vpc_offering_service_map' and change the provider to NiciraNvp for the service 'Connectivity' + It is also possible to update the default VPC offering by adding a row to the + 'vpc_offering_service_map' with service 'Connectivity' and provider 'NiciraNvp' + + + + + + nvp-physical-network-stt.png: a screenshot of the mysql table. + + + When creating a new VPC offering please note that the UI does not allow you to select a VPC offering yet. The VPC needs to be created using the API with the offering UUID. +
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/nicira/publican.cfg ---------------------------------------------------------------------- diff --git a/nicira/publican.cfg b/nicira/publican.cfg new file mode 100644 index 0000000..2e3696d --- /dev/null +++ b/nicira/publican.cfg @@ -0,0 +1,28 @@ +# Publican configuration file for CloudStack Complete Documentation Set +# Contains all technical docs except release notes +# Config::Simple 4.58 +# Tue May 29 00:57:27 2012 +# +# 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. + +xml_lang: en-US +type: Book +docname: CloudStack_Nicira_NVP_Guide +brand: cloudstack +chunk_first: 1 +chunk_section_depth: 1 +condition: install http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/0808f4ba/publican-plugin-niciranvp.cfg ---------------------------------------------------------------------- diff --git a/publican-plugin-niciranvp.cfg b/publican-plugin-niciranvp.cfg deleted file mode 100644 index 2e3696d..0000000 --- a/publican-plugin-niciranvp.cfg +++ /dev/null @@ -1,28 +0,0 @@ -# Publican configuration file for CloudStack Complete Documentation Set -# Contains all technical docs except release notes -# Config::Simple 4.58 -# Tue May 29 00:57:27 2012 -# -# 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. - -xml_lang: en-US -type: Book -docname: CloudStack_Nicira_NVP_Guide -brand: cloudstack -chunk_first: 1 -chunk_section_depth: 1 -condition: install