Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All
     

    Related Documentation

     

    Using the Contrail and VMWare vCenter User Interfaces to Configure and Manage the Network

    Starting with Contrail Release 2.20, you can install Contrail to work with the VMware vCenter Server in various vSphere environments and use the Contrail user interface and the vCenter user interface to configure and manage the integrated Contrail system.

    Overview: User Interfaces for Contrail Integration with VMware vCenter

    This topic shows how to use the Contrail user interface and the vCenter user interface to configure and manage features of a Contrail VMware integrated system.

    The two user interfaces are available after installing the integrated Contrail system, see Installing Contrail with VMware vCenter.

    When Contrail is integrated with VMware vCenter, the following two user interfaces are used to manage and configure features of the system.

    1. Contrail administration user interface (Contrail UI).
    2. Contrail vCenter user interface (vCenter UI).

    Contrail User Interface

    The Contrail UI is an administrator’s user interface. It provides a view of all components managed by the Contrail controller.

    To log in to the Contrail UI, use your Contrail server main IP address URL as follows:

              http://<Contrail IP>:8143

    Then log in using your registered Contrail account administrator credentials.

    Contrail vCenter User Interface

    The Contrail vCenter user interface (vCenter UI) is a subset of the Contrail administration UI. The Contrail vCenter UI provides a view of all of the virtual components within a Contrail vCenter project. 

    To access the log in page for the Contrail vCenter UI, use your Contrail IP address URL as follows:

             http://<Contrail URL>:8143/vcenter

    Then use the vCenter registered account log in name and password to access the Contrail vCenter UI, as in the following.

    Upon successful login, the Contrail vCenter user interface appears, as in the following example.

    Feature Configuration for Contrail vCenter

    This section shows how to use the Contrail UI and the Contrail vCenter UI to configure features for the Contrail vCenter integrated system.

    Creating a Virtual Network

    This section describes how to create a virtual network using the Contrail UI and the Contrail vCenter UI.

    Create Virtual Network – Contrail UI

    After logging in to the Contrail UI, click Configure > Networking > Networks to access the Networks screen.

    At Networks, click the Create (+, plus icon) button to access the Create Network window.

    Complete the fields in the Create Network screen. Provide a Primary VLAN value and a Secondary VLAN value as part of a Private VLAN configuration. Private VLAN pairs are configured on a Distributed Virtual Switch. Select the values for the Primary and Secondary VLANs from one of the configured, isolated private-vlan pairs.

    The following figure shows the creation of a virtual network named Green-VN.

    Click the Save button to create the virtual network.

    The virtual network just created (Green-VN) is displayed with its details, as in the following figure.

    Create Virtual Networks – Contrail vCenter UI

    You can also create a virtual network in the vCenter UI, and view and manage it from either the vCenter UI or the Contrail UI.

    In vCenter, a virtual network is called a port group, which is part of a distributed switch.

    Log in to the vCenter client UI (http://<Contrail URL>:8143/vcenter).

    To start creating a virtual network (distributed port group), click the distributed virtual switch (dvswitch) on the left panel.

    The following figure shows the demo_dvswitch has been selected for this example.

    To create a virtual network (vCenter port group), at the bottom of the screen, click Create a new port group.

    When you click Create a new port group, the Create Distributed Port Group window appears, as in the following figure.

    Enter the name of the virtual network. Select the VLAN type, then select other details for the selected VLAN type.  

    The following figure shows the Create Distributed Port Group window with the example creation of a virtual network named Red-VN, with a Private VLAN and isolated private VLAN ports 102, 103.

    Click Next when finished.

    The Ready to Complete screen appears (see the following figure), displaying the details entered for the virtual network (distributed port group).

    If changes are needed, click the Back button. If the details are correct, click the Finish button to verify the port group details and complete its creation.

    Next, create IP pools for the virtual network port group. Click the datacenter name in the left side panel, then click the IP Pools tab.

    The following figure shows the IP Pools tab for the datacenter named demo_dc.

    Near the top of the IP Tools screen, click Add to open the New IP Pool Properties window, as in the following figure.  The IP Pool Properties window has several tabs across the upper area. Ensure the IPv4 tab is selected, and enter a name for the IP pool, then enter the IP pool IPv4 details, including subnet, gateway, and ranges. Click the check box to Enable IP Pool.

    On the New IP Pool Properties window, click the Associations tab to select the networks that should use the IP pool you are creating. This tab enables you to associate the IP pool with the port group.

    The following figure of the Associations tab shows that the IP pool being created should be associated with the virtual network port group named Red-VN.

    Click OK when finished.

    To verify that the virtual network is created and visible to Contrail, in the Contrail UI, go to Configure > Networking > Networks to display Contrail network information. 

    The virtual network just created (Red-VN in this example) appears in the Networks window, see the following.

    Delete Virtual Network – Contrail UI

    It is possible to delete a virtual network in either the Contrail UI or in the vCenter UI. This section shows how to delete a virtual network in the Contrail UI.

    In the Contrail UI, go to Configure > Networking > Networks to display Contrail network information.

    Click the check box to select the network you want to delete, then click the Delete Virtual Networks (trash icon) button.

    A Confirm window pops up. Click the Confirm button to delete the selected network.

    Delete Virtual Networks – vCenter UI

    You can also delete a virtual network from the vCenter UI.  From the vCenter UI, in the left side panel, right-click the port-group (virtual-network) you want to delete.  In the menu popup, select Delete to delete the selected port group. An example is shown in the following.

    When deleting a port group (virtual network) using the vCenter UI, you must also delete the IP pool associated with the port group. Select the IP Pools tab, and right click the name of the IP pool associated with the port group being deleted. From the popup menu, select Remove to delete the IP pool.

    The following shows the deletion of the ip-pool-for-Red-VN from the vCenter UI.

    Creating a Virtual Machine

    Use the vCenter client interface to create a virtual machine for your VMware vCenter Contrail integrated system. This section describes how to create a virtual machine using a virtual machine template from the vCenter client interface.

    Create a Virtual Machine – vCenter UI

    From the vCenter UI, select the virtual machine template from the left side panel. At the bottom of the right side screen, click Deploy to a new virtual machine.

    The following image shows the user has selected the vm-template-ubuntu-12.04.2.

    The Deploy Template Name and Location window appears, as in the following. Specify a name for the virtual machine and select the datacenter on which the virtual machine is to be spawned.

    When finished, click the Next button.

    In the Host/Cluster screen that appears, as in the following, select the cluster on which to spawn the virtual machine.

    When finished, click the Next button.

    On the Specify a Specific Host screen that appears, as in the following, select the ESXi host on which to spawn the virtual machine.

    When finished, click the Next button.

    On the Storage screen, select the destination storage location for the virtual machine.

    When finished, click the Next button.

    On the Guest Customization screen, the typical selection is Do not customize. Click the Do not customize button.

    When finished, click the Next button.

    On the Ready to Complete screen, review all of the virtual machine definitions that you have selected for the template.

    If all selections are correct, click the Finish button to spawn the virtual machine.

    To complete the settings for the virtual machine, from the main screen of the vCenter UI, from the left column select the virtual machine to be edited, then click Edit virtual machine settings.

    The Virtual Machine Properties window appears, as in the following, where you can update the virtual machine properties.

    Click the Hardware tab on the Virtual Machine Properties window, and click Add to add an NIC and select the appropriate network. Click the check box to Connect at power on.See the following example figure.

    When finished, click OK.

    You are returned to the main vCenter UI screen. On the Getting Started tab, as in the following, click the task Power on the virtual machine. The virtual machine launches.

    Once the virtual machine is launched, you can view it from the Contrail UI. Go to Monitor > Networking > Instances. You should see the virtual machine listed on the Instances Summary screen, as in the following.

    You can also see real time running information for the virtual machine at the vCenter UI. Select the Console tab for the virtual machine to view real time information, including ping statistics, as in the following.

    Configuring the vCenter Network in Contrail UI

    The following items can be configured for the vCenter network by using the Contrail UI.

    • Network policy is configured by using the Contrail UI.
    • Security policy is configured by using the Contrail UI.
    • Public network, floating IP pool, and floating-ips are configured using the Contrail Administrator UI.

      When a user configures a virtual network using the administrator UI, the network is a Contrail-only network. No resources are consumed on vCenter to implement this type of network. The user can configure a floating-ip pool on the network; allocate floating-ips, and associate floating IPs to virtual machine interfaces (ports).

     

    Related Documentation

     

    Modified: 2015-09-02