Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

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:

  1. Open the Datacenter View in Network Director.
  2. 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

    Field

    Description

    Tenant Name

    Name of the tenant.

    Description

    Description given for the tenant.

    Overlay Name

    Name of the overlay fabric.

    Deployment State

    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:

  1. Click Add in the Manage Tenants page.

    The Create Tenant page opens.

  2. 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.

  3. 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:

    1. Enter a name and description for the overlay fabric.
    2. Specify the autonomous system (AS) number for the overlay fabric.
    3. Specify the IP address and the subnet mask of the route reflector network address in the overlay fabric.
    4. 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.
    5. Click OK to create the overlay fabric. The overlay fabric is selected to be used by the tenant.
  4. Click Add in the Overlay Networks table to create an overlay network for the tenant.

    The Create Overlay Network for Tenant window opens.

  5. 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.

  6. 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 default_tenant-name.

    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.

    Note

    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.

    Note

    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.

  7. 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.

  8. 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.
  9. 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.
  10. 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.

  11. To preview a port selection, select a port and click Preview. You can edit the port selection listed in the preview by clicking Edit.
  12. 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.

    Note

    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.

  13. 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.Note

    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.

  14. 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.
  15. Do the following to create a new LAG:
    1. Click Add in the LAG Selection (multi-homed) table. The Create LAG window opens.
    2. Select the Layer 3 Fabric on which you want to create the LAG.
    3. Click Add to specify the device and port details for the LAG. Network Director adds a row to the Device and Port details table.
    4. In the Device column, click and select the leaf device from which you want to select a port for the LAG.
    5. In the Port column, click to select the ports that you want to add to the LAG.
    6. Repeat steps c through e to add ports from another leaf device.

      The Port column lists only those ports that are not part of any LAG or port selection tab.

    7. To remove a device and port entry from the LAG, select the row from the Device and Port details table and click Remove.
    8. 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.
  16. To delete a LAG from the overlay network, select the LAG in the LAG Selection (multi-homed) table and click Delete.
  17. 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.
  18. Repeat steps 4 through 17 to add more overlay networks.
  19. Click Preview & Deploy to review the changes and deploy the tenant details to the overlay fabric.

Modifying a Tenant

To modify a tenant:

  1. Select a tenant in the Manage Tenants page and click Edit.

    The Edit Tenant page appears.

  2. 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.
  3. 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.

  4. 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.Note

    You cannot change a VLAN name after an overlay network is deployed.

  5. 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.

  6. Modify the description and the loopback network address and click OK.Note

    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

Field

Description

Tenant Name

Name of the overlay fabric for which the configuration details are being viewed.

Description

Description of the overlay fabric.

Overlay Fabric Name

Device list that is mapped to the selected overlay fabric.

View VNI

Click View VNI to view the VNI details of the overlay network that are mapped to the tenant. You can view the following details:

  • Ports selection, that are part of the overlay network.

  • Lag selection (multi-homed), that are part of the overlay network

View VRF

Click View VRF, to view the VRF instance configuration details that are mapped to the tenant. You can view the following details:

  • Devices—Devices that are mapped to the tenant.

  • Element—Name of the VRF instance mapped to the tenant.

  • Configurations—Configuration details of the VRF instance for the selected device.

  • Status—Deployment status of the tenant.

  • Message—The error message if any.

Note: To go back to the Overlay Network table click < Back to Overlay Networks link.

VNI

VXLAN Network identifier of the tenant.

VLAN ID

VLAN ID of the tenant.

VLAN Name

VLAN name of the tenant.

L3 Gateway Network Address

IP address and subnet mask of the default L3 gateway.

Ports

Port that is part of the overlay network.

LAGs

Lag that is part of the overlay network

VRF Instance

VRF instance that is assigned to the VXLAN overlay network.

Status

Deployment status of the tenant.

Related Documentation