cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From runseb <...@git.apache.org>
Subject [GitHub] cloudstack-docs pull request: Inclusion of Nuage-VSP plugin
Date Mon, 04 Jan 2016 09:22:13 GMT
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.
---

Mime
View raw message