Creating and Managing Tenants
You can create and manage tenants from the Manage Tenants page.
Before you begin, make sure that you have at least one Layer 3 Fabric based data center in Network Director.
To open the Manage Tenants page:
- Open the Datacenter View in Network Director.
- Select a data center from the View pane for
which you want to create a tenant and select Overlay Networks
Builder > Manage Tenants from the Tasks pane.
The Manage Tenants page opens. Table 1 describes the fields that are displayed in the Manage Tenants page.
Table 1: Manage Tenants Field Descriptions
Name of the tenant.
Description given for the tenant.
Name of the overlay fabric.
Deployment status of the tenant. Deployment state can be one of the following:
Pending Deployment—The tenant details have been saved, but not deployed.
Deployment in progress—The tenant is being deployed on the Layer 3 Fabric.
Partially deployed—The tenant is successfully deployed on some devices and the deployment failed on the other devices.
Deployed—The tenant is successfully deployed on all devices.
Deploy failed—Deployment failed on all the devices.
Pending decommission—The tenant is deleted. There might be a slight delay for Network Director to apply the changes to the devices; the system displays this status during this time.
You can perform the following tasks from the Manage Tenants page:
Creating a Tenant
To create a tenant:
- Click Add in the Manage Tenants page.
The Create Tenant page opens.
- Enter a name and description for the tenant.
You can enter a maximum of 255 characters. Underscore is the only special character that is allowed in the name field.
- Click Overlay Fabric Name to select an overlay
fabric for the tenant.
You can also create an overlay fabric inline by clicking Create New.
To create the overlay fabric:
- Enter a name and description for the overlay fabric.
- Specify the autonomous system (AS) number for the overlay fabric.
- Specify the IP address and the subnet mask of the route reflector network address in the overlay fabric.
- Select the Layer 3 Fabric that you want to include in the overlay network from the Available list and click the arrow to add it to the overlay fabric. Network Director lists all the Layer 3 Fabrics that are part of the data center and available for assignment in the Available list.
- Click OK to create the overlay fabric. The overlay fabric is selected to be used by the tenant.
- Click Add in the Overlay Networks table to
create an overlay network for the tenant.
The Create Overlay Network for Tenant window opens.
- Enter the Virtual Extensible LAN Network Identifier (VNI)
for the VXLAN overlay network. You can also select a VLAN from the
list of existing VLANs.
VNI is a numeric value to identify a VXLAN. You can enter a number from 1 through 16777214.
- Create a VRF instance that is to be assigned to the VXLAN
overlay network or use the default VRF instance. You can also select
a VRF instance from the list of existing VRF instances.
The default VRF instance is named as
Each tenant in an overlay fabric has its own tenant-specific routing table that contains the routing information for that tenant. To separate the route of each tenant from the other network traffic and routes, the spine device in the Layer 3 Fabric creates a separate routing table for each tenant called the Virtual Routing and Forwarding (VRF) instance. A can tenant can have multiple VRF instances.
To create a new VRF instance, click Create. Specify a name, description, and loopback network address for the VRF instance and click OK.
The VRF loopback network address is a mandatory field for routing devices. You can modify the value in this field, but cannot delete it once it is deployed.
If you have mapped a VRF instance to an overlay network, for example, overlay-network1 is mapped to VRF1, you cannot modify the VRF instance for this overlay network (after it is deployed) to another VRF instance, for example, to VRF2. To map the new instance, you must delete the overlay network and re-create the overlay network.
- Specify the ID and name of the VLAN. Network Director
maps this VLAN ID to the VXLAN overlay network.
The VLAN name is auto-populated, which you can edit, if needed.
- Specify the IP address and subnet mask of the default layer 3 gateway network address. The default gateway enables the traffic to be routed between different VXLANs networks within the VRFs of the tenant.
- Click Auto Select Ports to list the ports or LAGs that are connected to the devices. You can select these ports or LAG and assign it to the overlay network.
- Click the Ports Selection tab to select the
ports that you want to be part of the overlay network.
The Ports Selection tab displays the leaf devices of Layer 3 Fabrics that are part of the overlay fabric in the data center. When you select one or more leaf devices in the left pane, the ports associated with the device are displayed in a table in the right pane.
- To preview a port selection, select a port and click Preview. You can edit the port selection listed in the preview by clicking Edit.
- Select a leaf device or devices and click Select
by Range to specify the port range that you want to include
in the overlay network. You can select the port type as Normal
Ports or Channelized Ports.
The normal ports are physical ports such as et, ge, and xe. Channelized ports are et ports that are 40-Gigabit, 100-Gigabit and can be converted to xe ports. For example, et-0/0/0 (40-Gigabit) can be converted to xe-0/0/0:0, xe-0/0/0:1, xe-0/0/0:2, xe-0/0/0:3. Similarly a 10-Gigabit and 100-Gigabit can be converted to 25-Gigabit.
You can also select multiple devices from the left pane by the Shift key pressed and selecting devices. All the ports for selected devices are listed.
- Click the LAG Selection (Multi-homed) tab to
select the link aggregation groups (LAGs) that you want to be part
of the overlay network. You can select one or more LAGs from the existing
LAGs that are created in Network Director or create and add new LAGs.
The lag you created will have a temporary system generated name with the prefix LAG; for example, LAG0 or LAG1. When you save or deploy a tenant, the available aggregate Ethernet interface name for example, ae0 or ae1 replaces this LAG name. The LAG name must be common for all the leaf devices across a host.
- To select from a list of existing LAGs, click Select Existing LAG. The LAG Selection (multi-homed) window opens. Select the LAGs that you want to include in the overlay network and click OK. Network Director adds the LAGs that you selected to the LAG Selection (multi-homed) table.
- Do the following to create a new LAG:
- Click Add in the LAG Selection (multi-homed) table. The Create LAG window opens.
- Select the Layer 3 Fabric on which you want to create the LAG.
- Click Add to specify the device and port details for the LAG. Network Director adds a row to the Device and Port details table.
- In the Device column, click and select the leaf device from which you want to select a port for the LAG.
- In the Port column, click to select the ports that you want to add to the LAG.
- Repeat steps c through e to add ports from another leaf
The Port column lists only those ports that are not part of any LAG or port selection tab.
- To remove a device and port entry from the LAG, select the row from the Device and Port details table and click Remove.
- Click OK to save the details and create the LAG. Network Director adds the LAG that you created, to the LAG Selection (multi-homed) table.
- To delete a LAG from the overlay network, select the LAG in the LAG Selection (multi-homed) table and click Delete.
- Click OK to save the details and add the overlay network for the tenant. Network Director lists the overlay network that you added in the Overlay Networks table in the Create Tenant page.
- Repeat steps 4 through 17 to add more overlay networks.
- Click Preview & Deploy to review the changes and deploy the tenant details to the overlay fabric.
Modifying a Tenant
To modify a tenant:
- Select a tenant in the Manage Tenants page and click Edit.
The Edit Tenant page appears.
- You can modify the tenant description, overlay network and its details, and the VRF details. You can also add a new overlay network by clicking Add.
- To modify the overlay network details, select the overlay
network you want to modify and click Edit.
The Edit Overlay Network for Tenant page opens.
- You can modify VNI, VLAN ID, L3 Gateway Network Address,
VLAN Name, Port Selection, and LAG Selection (multi-homed) details
and click OK. For details, see Creating a Tenant.
You cannot change a VLAN name after an overlay network is deployed.
- To edit the VRF instance details and the loopback network
address, you can either:
Click the VRF instance name in the table.
Select an overlay network and click Edit VRF Details.
The Edit VRF Instance for tenant page appears.
- Modify the description and the loopback network address
and click OK.
You can create a VRF instance while you create the overlay network (this VRF instance has the tenant scope). However, you cannot delete it directly as it might be used by other overlay networks. Therefore, to enable deleting make sure you do not map this VRF instance to the VLAN while creating the tenant. You can however, edit the details of a VRF instance. If you want to delete a VRF instance, you must first delete the deployed VLANs, to which the VRF instance is associated. After you delete these VLANs, the VRF instance is removed after you save and deploy the configuration.
Viewing Tenant Configuration Details
After you successfully deploy a tenant, you can view the configuration details of the tenant from the View Tenant Configuration page. Click the Deployed link corresponding to the tenant name under the Deployment State column in the Manage Tenant Fabrics landing page to open this page.
The View Configuration page displays the details as described in Table 2.
Table 2: View Tenant Configuration Details
Name of the overlay fabric for which the configuration details are being viewed.
Description of the overlay fabric.
Overlay Fabric Name
Device list that is mapped to the selected overlay fabric.
Click View VNI to view the VNI details of the overlay network that are mapped to the tenant. You can view the following details:
Click View VRF, to view the VRF instance configuration details that are mapped to the tenant. You can view the following details:
Note: To go back to the Overlay Network table click < Back to Overlay Networks link.
VXLAN Network identifier of the tenant.
VLAN ID of the tenant.
VLAN name of the tenant.
L3 Gateway Network Address
IP address and subnet mask of the default L3 gateway.
Port that is part of the overlay network.
Lag that is part of the overlay network
VRF instance that is assigned to the VXLAN overlay network.
Deployment status of the tenant.