You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by KrisSterckx <gi...@git.apache.org> on 2015/12/21 10:41:13 UTC
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
GitHub user KrisSterckx opened a pull request:
https://github.com/apache/cloudstack-docs/pull/14
Inclusion of Nuage-VSP plugin
Documentation for the 4.7.0 Nuage-VSP plugin
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/KrisSterckx/cloudstack-docs master
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/cloudstack-docs/pull/14.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #14
----
commit e1a32fbac1e66ccc8b9d44e156a8b4435bf7ba16
Author: Kris Sterckx <kr...@nuagenetworks.net>
Date: 2015-12-14T13:49:23Z
Inclusion of Nuage-VSP plugin
----
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by runseb <gi...@git.apache.org>.
Github user runseb commented on a diff in the pull request:
https://github.com/apache/cloudstack-docs/pull/14#discussion_r48714149
--- Diff: rtd/source/networking/nuage-plugin.rst ---
@@ -0,0 +1,249 @@
+.. 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.
+
+
+The Nuage VSP Plugin
+====================
+
+Introduction
+------------
+
+The Nuage VSP plugin is the Nuage Networks SDN
+implementation in CloudStack, which integrates with Release 3.2 of the
+Nuage Networks Virtualized Services Platform.
+The plugin can be used by CloudStack to leverage the scalability and rich features of Advanced SDN and to implement:
+
+* Isolated Guest Networks
+* Virtual Private Clouds (VPCs)
+* Shared Networks
+
+For more information about Nuage Networks, visit www.nuagenetworks.net.
+
+
+Features
+--------
+
+The following table lists the CloudStack network services provided by
+the Nuage VSP Plugin.
+
+.. cssclass:: table-striped table-bordered table-hover
+
++----------------------+----------------------+
+| Network Service | CloudStack version |
++======================+======================+
+| Virtual Networking | >= 4.5 |
++----------------------+----------------------+
+| VPC | >= 4.5 |
++----------------------+----------------------+
+| Source NAT | >= 4.5 |
++----------------------+----------------------+
+| Static NAT | >= 4.5 |
++----------------------+----------------------+
+| Firewall | >= 4.5 |
++----------------------+----------------------+
+| Network ACL | >= 4.5 |
++----------------------+----------------------+
+| User Data (*) | >= 4.7 |
++----------------------+----------------------+
+
+(*) Through the use of VR Provider
+
+Table: Supported Services
+
+.. note::
+ The Virtual Networking service was originally called 'Connectivity'
+ in CloudStack 4.0
+
+The following hypervisors are supported by the Nuage VSP Plugin.
+
+.. cssclass:: table-striped table-bordered table-hover
+
++--------------+----------------------+
+| Hypervisor | CloudStack version |
++==============+======================+
+| XenServer | >= 4.5 |
++--------------+----------------------+
+| VmWare ESXi | >= 4.5 |
++--------------+----------------------+
+| KVM | >= 4.7 |
++--------------+----------------------+
+
+Table: Supported Hypervisors
+
+
+Configuring the Nuage-VSP Plugin
+--------------------------------
+
+Prerequisites
+~~~~~~~~~~~~~
+
+Before building and using the Nuage plugin for ACS 4.7, verify that the platform you intend to use is supported.
+
+.. Note:: Only the release notes for Nuage VSP contain the most up-to-date information on supported versions. Please check them to verify that the information below is current.
+
+Supported Versions
+~~~~~~~~~~~~~~~~~~
+
+* Nuage VSP 3.2.R2
+* Apache CloudStack 4.7
+* Citrix XenServer 6.2
+* KVM on Enterprise Linux 7.x
+
+Required VSD Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When configuring Nuage VSP as the network service provider, Nuage VSD must be added as a CSP user, and this user must be added to the CMS group. See `Enabling the Service Provider`_.
+
+Zone Configuration
+~~~~~~~~~~~~~~~~~~
+
+Select VSP Isolation Method During Zone Creation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Nuage VSP solution is NOT supported in Basic zone provisioning mode.
+
+1. When adding a zone, the ACS administrator should select **Advanced** mode in the zone wizard.
+2. When laying out the physical network configuration during zone provisioning, the **Guest** network traffic should be put in a separate physical network of its own.
+3. This physical network carrying the **Guest** traffic should have **VSP** as the **Isolation Method**.
+
+
+Update Traffic Labels
+~~~~~~~~~~~~~~~~~~~~~
+
+**Guest Traffic Type**
+
+Select **Edit** on the **Guest** traffic type panel and update the Traffic Label:
+
+- For XenServer, use **nuageManagedNetwork** as the **XenServer Traffic Label**.
+- For KVM, use **alubr0** as the **KVM Traffic Label**.
+
+Enabling the Service Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Nuage VSP must be added to ACS as a Network Service Provider before it can be used.
+
+:Step 1: Select **Infrastructure > Zone > [zone name] > Physical Network 2 > Configure Network Service Providers > Nuage Vsp > +**, which brings up the **Add Nuage Virtualized Services Directory (VSD)** panel.
+
+:Step 2: Enter the VSD **Host Name**, **Username** and **Password** that was previously created.
+
+:Step 3: Specify the VSD API version by entering the API version in the appropriate field (format: ``v3_2``).
+
+:Step 4: *EITHER* Add **Nuage VSD** and click the **OK** button,
+
+ *OR* use API calls to configure Nuage VSP as the Network Provider; see `Nuage VSD API`_ in the Appendix of the current document.
+
+:Step 5: Go to **Infrastructure > Zones > [zone name] > Physical Network 2 > Network Service Providers > Nuage Vsp > Devices > Details** tab as shown in the figure "Enabling Nuage VSP" below. This indicates the state of Nuage VSP. Enable Nuage VSP by clicking **Enable**.
+
+:Step 6: (Optional) View the Nuage VSP status on the list of Network Service Providers on the **Infrastructure > Zones > [zone name] > Physical Network 2 > Network Service Providers** page;
+
+Network Offerings
+~~~~~~~~~~~~~~~~~
+
+There are two types of Network Offerings that can be created:
+
+- If Isolated Networks are required, then create a network offering for use with Isolated Networks.
+- If VPC deployments are required, then create a new network offering for that.
+
+Create and Enable Isolated Network Offering
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1. Select **Service Offerings > Select Offering: Network Offerings > Add network offering**.
+
+2. In the **Supported Services** field select each of the following services - DHCP, Firewall, Source NAT, Static NAT, Virtual Networking and select Nuage VSP as the Provider.
+
+3. If User Data service is desired in an Isolated Network, choose **VirtualRouter** as the User Data provider. **Per Zone** MUST be selected for the Source NAT Type for the Source NAT service.
+
+4. Click OK to create the offering.
+
+5. After the offering has been successfully created, enable it from the Service Offerings list.
+
+Create and Enable VPC Network Offering
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1. Select **Service Offerings > Select Offering**: **Network Offerings > Add network offering**.
+
+2. Select the **VPC checkbox**. In the Supported Services field, select each of the following services and then select Nuage VSP as the Provider.
+
+ * DHCP
+ * Source NAT
+ * Static NAT
+ * Virtual Networking
+
+3. (Optional) Select **VirtualRouter** as the UserData provider if password reset or metadata feature is desired.
+
+4. (Optional) If network ACL is required, select **NuageVsp** as the network ACL provider.
+
+ a) Ensure the *Persistent* checkbox is selected.
+ b) As the *Supported Source NAT Type*, select **Per Zone**.
+
+5. After the offering has been successfully created, enable it from the Service Offerings list.
+
+Dedicated Features That Come with Nuage VSP Plugin
+--------------------------------------------------
+
+Domain Template Support for CloudStack in VSP
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Overview
+~~~~~~~~
+
+VSP's CloudStack plugin can be configured to use a VSD template when instantiating domains. The parameters and abstractions contained in the template are reused every time a new domain instance is created in CloudStack, and thus all the constructs defined in the template are available to the domain.
+
+Configuration
+~~~~~~~~~~~~~
+
+Details of the global variables that have been added to support domain templates are listed below:
+
+:nuagevsp.isolatedntwk.domaintemplate.name: (Type: string) Name of the template to use for creation of domains for isolated networks.
+
+:nuagevsp.vpc.domaintemplate.name: (Type: boolean) Name of the template to use for creation of domains for VPC.
+
+To configure a domain template for use by CloudStack, use VSD to create a domain template, using the global CloudStack parameters listed above.
+
+.. Note:: There will be only a single domain instance for ``nuagevsp.vpc.domaintemplate.name``.
+
+Networks created in CloudStack will then use domain instances created from the template to which the name points.
+
+
+
+Revision History
+----------------
+
+Fiona Fincannon 21 December 2015
+
+Appendix
+--------
+Nuage VSD API
+~~~~~~~~~~~~~
+
+To add Nuage VSP as Network Service Provider,
+
+1. Add the specified network service provider:
+
+::
+
+ http://135.227.147.106:8080/client/api?command=addNetworkSer
+ viceProvider&name=NuageVsp&physicalnetworkid=87528ea5-0189-4
+ a02-92db-3d1539232e21&response=json&sessionkey=CaDCr2P1qpIqm
+ Fsr%2BmMl1T3nLzs%3D&_=1414200788068
--- End diff --
That's weird.
First what is that IP for the mgt server ? it should be more generic.
Second the networkId and session key will be different ....
I suggest giving an example with a cloud monkey CLI.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by KrisSterckx <gi...@git.apache.org>.
Github user KrisSterckx commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168614046
Hi all, @runseb
what should do I to get attention to this PR ?
Happy New Year, all !
Kris
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by runseb <gi...@git.apache.org>.
Github user runseb commented on a diff in the pull request:
https://github.com/apache/cloudstack-docs/pull/14#discussion_r48714173
--- Diff: rtd/source/networking/nuage-plugin.rst ---
@@ -0,0 +1,249 @@
+.. 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.
+
+
+The Nuage VSP Plugin
+====================
+
+Introduction
+------------
+
+The Nuage VSP plugin is the Nuage Networks SDN
+implementation in CloudStack, which integrates with Release 3.2 of the
+Nuage Networks Virtualized Services Platform.
+The plugin can be used by CloudStack to leverage the scalability and rich features of Advanced SDN and to implement:
+
+* Isolated Guest Networks
+* Virtual Private Clouds (VPCs)
+* Shared Networks
+
+For more information about Nuage Networks, visit www.nuagenetworks.net.
+
+
+Features
+--------
+
+The following table lists the CloudStack network services provided by
+the Nuage VSP Plugin.
+
+.. cssclass:: table-striped table-bordered table-hover
+
++----------------------+----------------------+
+| Network Service | CloudStack version |
++======================+======================+
+| Virtual Networking | >= 4.5 |
++----------------------+----------------------+
+| VPC | >= 4.5 |
++----------------------+----------------------+
+| Source NAT | >= 4.5 |
++----------------------+----------------------+
+| Static NAT | >= 4.5 |
++----------------------+----------------------+
+| Firewall | >= 4.5 |
++----------------------+----------------------+
+| Network ACL | >= 4.5 |
++----------------------+----------------------+
+| User Data (*) | >= 4.7 |
++----------------------+----------------------+
+
+(*) Through the use of VR Provider
+
+Table: Supported Services
+
+.. note::
+ The Virtual Networking service was originally called 'Connectivity'
+ in CloudStack 4.0
+
+The following hypervisors are supported by the Nuage VSP Plugin.
+
+.. cssclass:: table-striped table-bordered table-hover
+
++--------------+----------------------+
+| Hypervisor | CloudStack version |
++==============+======================+
+| XenServer | >= 4.5 |
++--------------+----------------------+
+| VmWare ESXi | >= 4.5 |
++--------------+----------------------+
+| KVM | >= 4.7 |
++--------------+----------------------+
+
+Table: Supported Hypervisors
+
+
+Configuring the Nuage-VSP Plugin
+--------------------------------
+
+Prerequisites
+~~~~~~~~~~~~~
+
+Before building and using the Nuage plugin for ACS 4.7, verify that the platform you intend to use is supported.
+
+.. Note:: Only the release notes for Nuage VSP contain the most up-to-date information on supported versions. Please check them to verify that the information below is current.
+
+Supported Versions
+~~~~~~~~~~~~~~~~~~
+
+* Nuage VSP 3.2.R2
+* Apache CloudStack 4.7
+* Citrix XenServer 6.2
+* KVM on Enterprise Linux 7.x
+
+Required VSD Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When configuring Nuage VSP as the network service provider, Nuage VSD must be added as a CSP user, and this user must be added to the CMS group. See `Enabling the Service Provider`_.
+
+Zone Configuration
+~~~~~~~~~~~~~~~~~~
+
+Select VSP Isolation Method During Zone Creation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Nuage VSP solution is NOT supported in Basic zone provisioning mode.
+
+1. When adding a zone, the ACS administrator should select **Advanced** mode in the zone wizard.
+2. When laying out the physical network configuration during zone provisioning, the **Guest** network traffic should be put in a separate physical network of its own.
+3. This physical network carrying the **Guest** traffic should have **VSP** as the **Isolation Method**.
+
+
+Update Traffic Labels
+~~~~~~~~~~~~~~~~~~~~~
+
+**Guest Traffic Type**
+
+Select **Edit** on the **Guest** traffic type panel and update the Traffic Label:
+
+- For XenServer, use **nuageManagedNetwork** as the **XenServer Traffic Label**.
+- For KVM, use **alubr0** as the **KVM Traffic Label**.
+
+Enabling the Service Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Nuage VSP must be added to ACS as a Network Service Provider before it can be used.
+
+:Step 1: Select **Infrastructure > Zone > [zone name] > Physical Network 2 > Configure Network Service Providers > Nuage Vsp > +**, which brings up the **Add Nuage Virtualized Services Directory (VSD)** panel.
+
+:Step 2: Enter the VSD **Host Name**, **Username** and **Password** that was previously created.
+
+:Step 3: Specify the VSD API version by entering the API version in the appropriate field (format: ``v3_2``).
+
+:Step 4: *EITHER* Add **Nuage VSD** and click the **OK** button,
+
+ *OR* use API calls to configure Nuage VSP as the Network Provider; see `Nuage VSD API`_ in the Appendix of the current document.
+
+:Step 5: Go to **Infrastructure > Zones > [zone name] > Physical Network 2 > Network Service Providers > Nuage Vsp > Devices > Details** tab as shown in the figure "Enabling Nuage VSP" below. This indicates the state of Nuage VSP. Enable Nuage VSP by clicking **Enable**.
+
+:Step 6: (Optional) View the Nuage VSP status on the list of Network Service Providers on the **Infrastructure > Zones > [zone name] > Physical Network 2 > Network Service Providers** page;
+
+Network Offerings
+~~~~~~~~~~~~~~~~~
+
+There are two types of Network Offerings that can be created:
+
+- If Isolated Networks are required, then create a network offering for use with Isolated Networks.
+- If VPC deployments are required, then create a new network offering for that.
+
+Create and Enable Isolated Network Offering
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1. Select **Service Offerings > Select Offering: Network Offerings > Add network offering**.
+
+2. In the **Supported Services** field select each of the following services - DHCP, Firewall, Source NAT, Static NAT, Virtual Networking and select Nuage VSP as the Provider.
+
+3. If User Data service is desired in an Isolated Network, choose **VirtualRouter** as the User Data provider. **Per Zone** MUST be selected for the Source NAT Type for the Source NAT service.
+
+4. Click OK to create the offering.
+
+5. After the offering has been successfully created, enable it from the Service Offerings list.
+
+Create and Enable VPC Network Offering
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1. Select **Service Offerings > Select Offering**: **Network Offerings > Add network offering**.
+
+2. Select the **VPC checkbox**. In the Supported Services field, select each of the following services and then select Nuage VSP as the Provider.
+
+ * DHCP
+ * Source NAT
+ * Static NAT
+ * Virtual Networking
+
+3. (Optional) Select **VirtualRouter** as the UserData provider if password reset or metadata feature is desired.
+
+4. (Optional) If network ACL is required, select **NuageVsp** as the network ACL provider.
+
+ a) Ensure the *Persistent* checkbox is selected.
+ b) As the *Supported Source NAT Type*, select **Per Zone**.
+
+5. After the offering has been successfully created, enable it from the Service Offerings list.
+
+Dedicated Features That Come with Nuage VSP Plugin
+--------------------------------------------------
+
+Domain Template Support for CloudStack in VSP
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Overview
+~~~~~~~~
+
+VSP's CloudStack plugin can be configured to use a VSD template when instantiating domains. The parameters and abstractions contained in the template are reused every time a new domain instance is created in CloudStack, and thus all the constructs defined in the template are available to the domain.
+
+Configuration
+~~~~~~~~~~~~~
+
+Details of the global variables that have been added to support domain templates are listed below:
+
+:nuagevsp.isolatedntwk.domaintemplate.name: (Type: string) Name of the template to use for creation of domains for isolated networks.
+
+:nuagevsp.vpc.domaintemplate.name: (Type: boolean) Name of the template to use for creation of domains for VPC.
+
+To configure a domain template for use by CloudStack, use VSD to create a domain template, using the global CloudStack parameters listed above.
+
+.. Note:: There will be only a single domain instance for ``nuagevsp.vpc.domaintemplate.name``.
+
+Networks created in CloudStack will then use domain instances created from the template to which the name points.
+
+
+
+Revision History
+----------------
+
+Fiona Fincannon 21 December 2015
+
+Appendix
+--------
+Nuage VSD API
+~~~~~~~~~~~~~
+
+To add Nuage VSP as Network Service Provider,
+
+1. Add the specified network service provider:
+
+::
+
+ http://135.227.147.106:8080/client/api?command=addNetworkSer
+ viceProvider&name=NuageVsp&physicalnetworkid=87528ea5-0189-4
+ a02-92db-3d1539232e21&response=json&sessionkey=CaDCr2P1qpIqm
+ Fsr%2BmMl1T3nLzs%3D&_=1414200788068
+
+2. Add the specified Nuage VSD:
+
+::
+
+ http://135.227.147.106:8080/client/api?command=addNuageVspDe
+ vice&physicalnetworkid=87528ea5-0189-4a02-92db-3d1539232e21&
+ hostname=135.227.210.196&username=cloudstackuser1&password=c
+ loudstackuser1&port=8443&apiversion=v3_2&retrycount=4&retryinter
+ val=60&response=json&sessionkey=CaDCr2P1qpIqmFsr%2BmMl1T3nLz
+ s%3D
--- End diff --
Same here, I'd rather see a cloudmonkey CLI...this is actually unusable for a user .IMHO
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by asfgit <gi...@git.apache.org>.
Github user asfgit closed the pull request at:
https://github.com/apache/cloudstack-docs/pull/14
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by KrisSterckx <gi...@git.apache.org>.
Github user KrisSterckx commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168938400
Thanks @nlivens and @runseb !
Additional question i have : How does this end up now at http://docs.cloudstack.apache.org/en/latest/ ?
thanks!
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by runseb <gi...@git.apache.org>.
Github user runseb commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168932762
LGTM +1 merging
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by nlivens <gi...@git.apache.org>.
Github user nlivens commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168667533
@runseb, I've handled your comments
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by terbolous <gi...@git.apache.org>.
Github user terbolous commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168939634
It is there (http://docs.cloudstack.apache.org/en/latest/networking/nuage-plugin.html) but should be linked to from the index and networking pages.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by KrisSterckx <gi...@git.apache.org>.
Github user KrisSterckx commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168966438
@terbolous OK thanks - is that something you will take up ? Thanks
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by terbolous <gi...@git.apache.org>.
Github user terbolous commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168970701
already made a PR for it :) #15
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by runseb <gi...@git.apache.org>.
Github user runseb commented on the pull request:
https://github.com/apache/cloudstack-docs/pull/14#issuecomment-168619811
@KrisSterckx I just replied with a few comments. Once addressed I can merge
Thanks for the docs
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Posted by runseb <gi...@git.apache.org>.
Github user runseb commented on a diff in the pull request:
https://github.com/apache/cloudstack-docs/pull/14#discussion_r48714090
--- Diff: rtd/source/networking/nuage-plugin.rst ---
@@ -0,0 +1,249 @@
+.. 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.
+
+
+The Nuage VSP Plugin
+====================
+
+Introduction
+------------
+
+The Nuage VSP plugin is the Nuage Networks SDN
+implementation in CloudStack, which integrates with Release 3.2 of the
+Nuage Networks Virtualized Services Platform.
+The plugin can be used by CloudStack to leverage the scalability and rich features of Advanced SDN and to implement:
+
+* Isolated Guest Networks
+* Virtual Private Clouds (VPCs)
+* Shared Networks
+
+For more information about Nuage Networks, visit www.nuagenetworks.net.
+
+
+Features
+--------
+
+The following table lists the CloudStack network services provided by
+the Nuage VSP Plugin.
+
+.. cssclass:: table-striped table-bordered table-hover
+
++----------------------+----------------------+
+| Network Service | CloudStack version |
++======================+======================+
+| Virtual Networking | >= 4.5 |
++----------------------+----------------------+
+| VPC | >= 4.5 |
++----------------------+----------------------+
+| Source NAT | >= 4.5 |
++----------------------+----------------------+
+| Static NAT | >= 4.5 |
++----------------------+----------------------+
+| Firewall | >= 4.5 |
++----------------------+----------------------+
+| Network ACL | >= 4.5 |
++----------------------+----------------------+
+| User Data (*) | >= 4.7 |
++----------------------+----------------------+
+
+(*) Through the use of VR Provider
+
+Table: Supported Services
+
+.. note::
+ The Virtual Networking service was originally called 'Connectivity'
+ in CloudStack 4.0
+
+The following hypervisors are supported by the Nuage VSP Plugin.
+
+.. cssclass:: table-striped table-bordered table-hover
+
++--------------+----------------------+
+| Hypervisor | CloudStack version |
++==============+======================+
+| XenServer | >= 4.5 |
++--------------+----------------------+
+| VmWare ESXi | >= 4.5 |
++--------------+----------------------+
+| KVM | >= 4.7 |
++--------------+----------------------+
+
+Table: Supported Hypervisors
+
+
+Configuring the Nuage-VSP Plugin
+--------------------------------
+
+Prerequisites
+~~~~~~~~~~~~~
+
+Before building and using the Nuage plugin for ACS 4.7, verify that the platform you intend to use is supported.
+
+.. Note:: Only the release notes for Nuage VSP contain the most up-to-date information on supported versions. Please check them to verify that the information below is current.
+
+Supported Versions
+~~~~~~~~~~~~~~~~~~
+
+* Nuage VSP 3.2.R2
+* Apache CloudStack 4.7
+* Citrix XenServer 6.2
+* KVM on Enterprise Linux 7.x
+
+Required VSD Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When configuring Nuage VSP as the network service provider, Nuage VSD must be added as a CSP user, and this user must be added to the CMS group. See `Enabling the Service Provider`_.
+
+Zone Configuration
+~~~~~~~~~~~~~~~~~~
+
+Select VSP Isolation Method During Zone Creation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Nuage VSP solution is NOT supported in Basic zone provisioning mode.
+
+1. When adding a zone, the ACS administrator should select **Advanced** mode in the zone wizard.
+2. When laying out the physical network configuration during zone provisioning, the **Guest** network traffic should be put in a separate physical network of its own.
+3. This physical network carrying the **Guest** traffic should have **VSP** as the **Isolation Method**.
+
+
+Update Traffic Labels
+~~~~~~~~~~~~~~~~~~~~~
+
+**Guest Traffic Type**
+
+Select **Edit** on the **Guest** traffic type panel and update the Traffic Label:
+
+- For XenServer, use **nuageManagedNetwork** as the **XenServer Traffic Label**.
+- For KVM, use **alubr0** as the **KVM Traffic Label**.
+
+Enabling the Service Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Nuage VSP must be added to ACS as a Network Service Provider before it can be used.
+
+:Step 1: Select **Infrastructure > Zone > [zone name] > Physical Network 2 > Configure Network Service Providers > Nuage Vsp > +**, which brings up the **Add Nuage Virtualized Services Directory (VSD)** panel.
+
+:Step 2: Enter the VSD **Host Name**, **Username** and **Password** that was previously created.
+
+:Step 3: Specify the VSD API version by entering the API version in the appropriate field (format: ``v3_2``).
+
+:Step 4: *EITHER* Add **Nuage VSD** and click the **OK** button,
+
+ *OR* use API calls to configure Nuage VSP as the Network Provider; see `Nuage VSD API`_ in the Appendix of the current document.
+
+:Step 5: Go to **Infrastructure > Zones > [zone name] > Physical Network 2 > Network Service Providers > Nuage Vsp > Devices > Details** tab as shown in the figure "Enabling Nuage VSP" below. This indicates the state of Nuage VSP. Enable Nuage VSP by clicking **Enable**.
+
+:Step 6: (Optional) View the Nuage VSP status on the list of Network Service Providers on the **Infrastructure > Zones > [zone name] > Physical Network 2 > Network Service Providers** page;
+
+Network Offerings
+~~~~~~~~~~~~~~~~~
+
+There are two types of Network Offerings that can be created:
+
+- If Isolated Networks are required, then create a network offering for use with Isolated Networks.
+- If VPC deployments are required, then create a new network offering for that.
+
+Create and Enable Isolated Network Offering
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1. Select **Service Offerings > Select Offering: Network Offerings > Add network offering**.
+
+2. In the **Supported Services** field select each of the following services - DHCP, Firewall, Source NAT, Static NAT, Virtual Networking and select Nuage VSP as the Provider.
+
+3. If User Data service is desired in an Isolated Network, choose **VirtualRouter** as the User Data provider. **Per Zone** MUST be selected for the Source NAT Type for the Source NAT service.
+
+4. Click OK to create the offering.
+
+5. After the offering has been successfully created, enable it from the Service Offerings list.
+
+Create and Enable VPC Network Offering
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1. Select **Service Offerings > Select Offering**: **Network Offerings > Add network offering**.
+
+2. Select the **VPC checkbox**. In the Supported Services field, select each of the following services and then select Nuage VSP as the Provider.
+
+ * DHCP
+ * Source NAT
+ * Static NAT
+ * Virtual Networking
+
+3. (Optional) Select **VirtualRouter** as the UserData provider if password reset or metadata feature is desired.
+
+4. (Optional) If network ACL is required, select **NuageVsp** as the network ACL provider.
+
+ a) Ensure the *Persistent* checkbox is selected.
+ b) As the *Supported Source NAT Type*, select **Per Zone**.
+
+5. After the offering has been successfully created, enable it from the Service Offerings list.
+
+Dedicated Features That Come with Nuage VSP Plugin
+--------------------------------------------------
+
+Domain Template Support for CloudStack in VSP
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Overview
+~~~~~~~~
+
+VSP's CloudStack plugin can be configured to use a VSD template when instantiating domains. The parameters and abstractions contained in the template are reused every time a new domain instance is created in CloudStack, and thus all the constructs defined in the template are available to the domain.
+
+Configuration
+~~~~~~~~~~~~~
+
+Details of the global variables that have been added to support domain templates are listed below:
+
+:nuagevsp.isolatedntwk.domaintemplate.name: (Type: string) Name of the template to use for creation of domains for isolated networks.
+
+:nuagevsp.vpc.domaintemplate.name: (Type: boolean) Name of the template to use for creation of domains for VPC.
+
+To configure a domain template for use by CloudStack, use VSD to create a domain template, using the global CloudStack parameters listed above.
+
+.. Note:: There will be only a single domain instance for ``nuagevsp.vpc.domaintemplate.name``.
+
+Networks created in CloudStack will then use domain instances created from the template to which the name points.
+
+
+
+Revision History
+----------------
+
+Fiona Fincannon 21 December 2015
--- End diff --
We don't keep revision history with author info in the actual doc. It's all in git.
Can you remove ?
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---