New and Changed Information
The following table provides an overview of the significant changes up to this current release. The table does not provide an exhaustive list of all changes or of the new features up to this release.
Cisco APIC Release Version |
Feature |
Description |
---|---|---|
Release 3.1(1) |
Red Hat Virtualization |
Integration of Red Hat Virtualization into the Cisco Application Centric Infrastructure (ACI) is supported. |
Cisco ACI with Red Hat Virtualization
The Application Policy Infrastructure Controller (APIC) integrates with Red Hat Virtualization (formerly Red Hat Enterprise Virtualization) and enhances the network management capabilities of the platform.
Red Hat Virtualization includes the following elements that integrate with the Cisco Application Centric Infrastructure (ACI):
-
Red Hat Virtualization Host—This is based on Red Hat Enterprise Linux (RHEL 7 operating system). It is built on the Kernel-based Virtual Machine (KVM) hypervisor technology native to Red Hat Enterprise Linux.
-
Red Hat Enterprise Virtualization Manager—This is a centralized virtualization management engine based on RHEL and JBoss.
Key Red Hat concepts include Cluster—a collection of hosts—and Data Center—a collection of clusters. A host may have multiple virtual machines (VMs). Clusters are a migration domain: VMs can be migrated to any host within a cluster but not to other clusters.
Logical networks are defined at the Data Center Level. A logical network in Red Hat Virtualization is implemented using a bridge. The bridge may be a Linux bridge or Open vSwitch (OVS) bridge.
The concept of endpoint groups (EPGs) in Cisco ACI maps to Logical Network in Red Hat Virtualization.
Note |
Cisco Application Policy Infrastructure Controller (APIC) requires an account to access the Red Hat Virtualization Manager. See the section Red Hat Administrator Access Requirements in this guide for the minimum required privileges. |
Software Compatibility
Cisco APIC 3.1(1) and later releases support Red Hat Virtualization. Always check the Cisco APIC Release Notes on Cisco.com for compatibility information.
We recommend that you use Red Hat Virtualization Manager 4.1.6 and later with Cisco APIC.
Cisco ACI and Red Hat Terminology
Some terminology differs between Cisco ACI and Red Hat. The following table lists differences to be aware of.
Cisco ACI Terms |
Red Hat Terms |
---|---|
VM controller |
Red Hat Virtualization Manager |
Endpoint group (EPG) |
Logical Network |
Workflow for Red Hat Virtualization Installation
To install Red Hat Virtualization for use in the Cisco ACI, perform a series of steps on Cisco APIC and the Red Hat Virtualization Manager.
-
Perform the following tasks on Red Hat Virtualization Manager:
-
Create a data center.
-
Create storage domains.
-
Create clusters.
-
Attach Red Hat Virtualization hosts to the clusters.
-
-
Perform the following tasks on Cisco APIC:
-
Create a Red Hat Virtualization domain and associate it with a VLAN pool and Red Hat Virtualization Manager credentials.
See the Cisco APIC GUI, NX-OS style CLI, and REST API procedures for creating a Red Hat VMM domain in this guide.
-
Create a Red Hat controller with a name and IP address and data center name, and then associate credentials to the controller.
See the Cisco APIC GUI, NX-OS style CLI, and REST API procedures for creating a Red Hat VMM domain in this guide.
Cisco APIC now connects to the Red Hat Virtualization Manager and pulls information from it. The information consists of all the inventory of the data center associated with the domain, clusters, hosts, and VMs in the data center.
-
Create the following:
-
An attachable entity profile.
-
Interface and switch profiles as well as interface policy groups.
We recommend Link Aggregation Control Protocol (LACP) policy for link redundancy to the RHV servers.
-
A tenant and an application profile for the tenant
See the Cisco APIC Basic Configuration Guide for information about tenant configuration.
-
EPGs, associating them to a bridge domain
See the Cisco APIC Basic Configuration Guide for information about EPG configuration.
-
-
Associate the configured AEP with the policy group used for interfaces connecting RHV hosts and with the RHV VMM domain.
-
Associate the EPGs to a Red Hat domain with resolution immediacy as pre-provision.
See the section VMM Domain Profile Creation in this guide.
Note
Only EPGs with pre-provision resolution immediacy can be associated with Red Hat VMM domains.
Cisco APIC creates networks on Red Hat Virtualization Manager. They have the name of tenant|application profile|epg for a given data center associated with the Red Hat Virtualization domain on APIC. These are pushed to the Red Hat Virtualization host.
-
-
Perform the following tasks on Red Hat Virtualization Manager:
-
When an EPG is mapped to RHV VMM domain, APIC creates a corresponding label on RHV Manager. Associate the label with the physical NICs of the hosts on the RHV clusters.
-
Attach the vNICs of the VMs on the hosts to the desired logical network. The VM vNIC will appear as an endpoint connected to that EPG on the fabric.
-
VMM Domain Profile Creation
You can create a VMM domain profile with the Cisco APIC GUI, NX-OS style CLI, or REST API. However, before you create a VMM domain profile, ensure that you understand the workflow and have fulfilled the prerequisites.
Prerequisites for Creating a VMM Domain Profile
To configure a VMM domain profile, you must meet the following prerequisites:
-
All fabric nodes are discovered and configured.
-
Inband (inb) or out-of-band (oob) management has been configured on the Cisco APIC.
-
Red Hat Virtualization Manager is installed, configured, and reachable through the inb/oob management network.
-
You have the administrator/root credentials to Red Hat Virtualization Manager.
-
You have configured a DNS policy for the Cisco APIC if you plan to reference the Red Hat Virtualization Manager by hostname rather than an IP address.
-
You have enough VLAN IDs; if you do not, ports EPGs might report that no encapsulation is available.
Create a Red Hat Domain for Red Hat Virtualization Using the Cisco APIC GUI
Before you can install Red Hat Virtualization, you must create a Red Hat domain for it in Cisco APIC. This section describes how to create a Red Hat domain profile using the Cisco APIC GUI.
Procedure
Step 1 |
Log in to Cisco APIC. |
Step 2 |
Go to . |
Step 3 |
In the Inventory navigation pane, expand the VMM Domains folder, right-click the Red Hat folder, and then choose Create Red Hat Domain. |
Step 4 |
In the Create Red Hat Domain dialog box, complete the following steps: |
Create a VMM Domain Profile Using the NX-OS Style CLI
Procedure
Step 1 |
In the CLI, enter configuration mode: Example:
|
Step 2 |
Create a domain by entering the command rhev-domain domain name delimiter custom delimiter: Example: The string
delimiter custom delimiter sets a delimiter for EPGs in Red Hat Virtualization Manager, where EPGs are called networks. Setting a delimiter is optional for Red Hat Virtualization Manager 4.1.6 or later but is required for earlier versions.
If you use Red Hat Virtualization Manager 4.1.6 or later, you can enter one of the following characters: |, ~, !, @, ^, +, =, or _. If you do not enter a symbol, the system uses the default | delimiter in EPG (network) names, for example: t1|a1|e1. If you use a version of Red Hat Virtualization Manager earlier than 4.1.6, only the _ character is supported for the delimiter. |
Step 3 |
Associate a domain with a VLAN pool by entering the command vlan-domain member VLAN pool name: Example:
|
Step 4 |
Associate a domain with a controller by entering the command rhev controller I.P datacenter datacenter name: Example:
|
Step 5 |
Provide credentials for the Red Hat controller by entering the command username username: Example:
|
What to do next
-
List Red Hat domains:
apic1# show redhat domain Faults: Grouped by severity (Critical, Major, Minor, Warning) Domain Encap EPGs Faults ------------------------- -------- ----- --------------- sample unknown 0 0,0,1,0
-
Display information about a particular Red Hat domain:
apic1# show redhat domain name <domainName> e.g.: Domain Name : sample Virtual Switch Mode : rhev Number of EPGs : 1 Faults by Severity : 0, 0, 1, 0 rhev: Faults: Grouped by severity (Critical, Major, Minor, Warning) rhev Type Datacenter Status ESXs VMs Faults -------------------- -------- -------------------- -------- ----- ----- --------------- Controller IP rhev mininet online 3 2 0,0,1,0
Create a VMM Domain Profile Using the REST API
Before you can install Red Hat Virtualization, you must create a VMM domain for it in Cisco APIC. This section describes how to create a VMM domain profile using REST API.
Procedure
Step 1 |
Create a VLAN pool: Example:
|
Step 2 |
Create the Red Hat VMM domain and associate it with the VLAN pool and the Red Hat controller: Example:
|
EPG-to-VMM Domain Association
After you create a Red Hat VMM domain and EPGs, you associate the EPGs to the VMM domain. You can do so through the Cisco APIC GUI, the NX-OS style CLI, or REST API.
Prerequisites for EPG-to-VMM Domain Association
Before you associate an EPG to the VMM domain, you must perform the following tasks:
-
Create a VMM domain.
-
Create at least one EPG.
Associate an EPG with the VMM Domain Using the GUI
Use the Cisco APIC GUI to associate an EPG to the VMM domain.
Procedure
Step 1 |
Log in to the Cisco APIC. |
||
Step 2 |
Choose Tenants and then choose the tenant with the EPG you want to associate with the VMM domain. |
||
Step 3 |
In the left navigation pane, expand the following: The Application Profiles folder, the application profile, the Application EPGs folder, the application EPG that you want to associate with the VMM domain. |
||
Step 4 |
Right-click Domains (VMs and Bare-Metals) and then choose Add VMM Domain Association. |
||
Step 5 |
In the Add VMM Domain Association dialog box, from the VMM Domain Profile drop-down list, choose the VMM domain. |
||
Step 6 |
In the Deploy Immediacy area, accept the default On Demand or Immediate. You cannot change the value for Resolution Immediacy, which is set to Pre-provision; this is required for EPGs associated with Red Hat VMM domains. |
||
Step 7 |
(Optional) In the Delimiter field, enter one of the following symbols: |, ~, !, @, ^, +, or = to choose a delimiter for EPGs in the RHVM, where EPGs are called networks. If you do not enter a symbol, the system uses the default | delimiter in EPG (network) names, for example:t1|a1|e1. |
||
Step 8 |
In the Port Encap field, Enter a VLAN value that is part of one of the static VLAN blocks associated with the VMM domain. When you manually configure the Port Encap value on a VMM domain for an EPG, the VLAN ID must belong to a static VLAN block within a dynamic VLAN pool. |
||
Step 9 |
Click Submit.
|
||
Step 10 |
Repeat this procedure once for every other EPG that you want to associate with the VMM domain. |
Associate an EPG with the VMM Domain Using the NX-OS Style CLI
Use the Cisco APIC GUI to associate an EPG to the VMM domain.
Procedure
Step 1 |
Associate an EPG with a VMM domain: Example:
|
Step 2 |
Verify the association: Example:
|
Create an EPG and Associate It with the VMM Domain Using REST API
Use REST API to associate an EPG to the VMM domain.
Procedure
Create an EPG and associate it with the Red Hat VMM domain. Example:Example:
|
Red Hat Administrator Access Requirements
Cisco APIC need an account to access the Red Hat Virtualization Manager and configure the Red Hat VMM configuration and send API commands. This section lists the minimum privileges that are required for the Cisco APIC account dedicated to Red Hat integration to work.
- Login Permissions
- Network Configuration
-
-
Create
-
Edit Properties
-
Delete
-
Assign Network to Cluster
:
-