# HVM Cluster Networking

On initial cluster provisioning, OVS bridges and Libvirt Networks are created and are immediately ready for VM provisioning. However, when adding new network interfaces, you need to create networking objects in the UI manually. Currently, the HPE Morpheus VM Essentials Software Manager does not discover new interfaces that are not in netplan. You will need to ensure they are available in the `01-base.yml` netplan file, apply it, create the bonds in the `hpe-vm` tool, and then refresh the HVM Cluster through the UI. For details, refer the installation section at the beginning of this documentation repository for more information on the `hpe-vm` tool and its use.

HVM network objects are created from the Network tab of the HVM Cluster detail page (Infrastructure > Clusters, then select the HVM Cluster). Two subtabs are shown here for Routers and Networks. From a KVM perspective, OVS Bridges and Libvirt Networks (without any port groups) are created on the Routers subtab. Port Group entries are added to existing Libvirt Networks on the Networks subtab. For this reason, it is often most logical to begin creating new HVM network objects on the Routers subtab before moving onto the Networks subtab. For a higher level discussion and diagram of recommended HVM Cluster network topology and to see where these objects fit in, refer to the example network configurations in the "Getting Started" section of this user manual.

Adding Routers

1. From the Routers subtab, click + ADD, then select OVS Bridge Domain

   ![The list of router objects associated with an HVM cluster](https://support.hpe.com/hpesc/public/api/document/sd00008014en_us/GUID-BBBDCD20-D1FA-4F83-99A8-84F136F334AF-high.png)
2. On the ADD NETWORK ROUTER modal, configure the following:

   1. **GROUP:** Select "Shared" to make the router object available to all Groups or select an individual Group
   2. **NAME:** A name for the router object in HPE Morpheus VM Essentials Software
   3. **HOST BRIDGE:** Select an existing OVS bridge or choose "Create New"
   4. **BRIDGE NAME:** Shown only when opting to create a new Host Bridge. Provide a name for the new OVS bridge to be created. The bridge name value entered here will be used to identify the bridge throughout the UI while examining the created objects via a terminal session connected to the Host will show it identified by the interface name
   5. **NETWORK INTERFACE:** Shown only when opting to create a new Host Bridge. Select a network interface for the new OVS bridge. Keep in mind that currently new interfaces are not discovered automatically. See the opening paragraph of this section for more information on surfacing the new interface to the HVM Cluster

   NOTE

   By adding a router here and selecting an existing OVS bridge, a new Libvirt Network is created without any port groups but no new OVS bridge is created. When selecting "Create New" in the Host Bridge configuration field, a new OVS bridge is created and a new Libvirt Network is also created without any port groups. A free physical interface or bond must be available to create a new OVS bridge and currently these are not automatically discovered by the HVM Cluster. See the opening paragraph of this section for more information on surfacing new interfaces to the HVM Cluster. Libvirt Port Groups are created in the next section on adding networks. For a higher level discussion and diagram of recommended HVM Cluster network topology and to see where these objects fit in, refer back to the example network configurations in the "Getting Started" section of this user manual.
3. Click ADD NETWORK ROUTER

   ![Adding new router with host bridge created](https://support.hpe.com/hpesc/public/api/document/sd00008014en_us/GUID-8F3EFC34-3BE1-4E35-B563-E7168F483CC1-high.png)

Once saved, the router object is created and it appears in the list of current routers.

Adding Networks

As mentioned in the previous section, creating network objects on HVM clusters is akin to adding Libvirt Portgroups to an existing Libvirt Network. If continuing from the previous section on adding routers, the OVS bridges and Libvirt networks will be in place to add port groups (referred to as networks here in the UI).

1. From the Networks subtab, click + ADD, then select OVS Port Group

   ![The list of network objects associated with an HVM cluster](https://support.hpe.com/hpesc/public/api/document/sd00008014en_us/GUID-8A44146F-1F64-441D-A007-F3BEC320E60C-high.png)
2. On the CREATE NETWORK modal, configure the following:

   1. **GROUP:** Select "Shared" to make the router object available to all Groups or select an individual Group
   2. **NAME:** A name for the network object in HPE Morpheus VM Essentials Software
   3. **CIDR:** The CIDR range for the new network
   4. **GATEWAY:** The network gateway address
   5. **DNS PRIMARY:** The address for the primary DNS server
   6. **DNS SECONDARY:** The address for the secondary DNS server
   7. **ROUTER:** Select an existing OVS bridge. If you need to create a new OVS bridge, add a new "OVS Bridge Domain" from the Routers subtab (described above) and select "Create New" for it's "Host Bridge" field configuration. Additional details on router objects are provided above.
   8. **VLAN ID:** A VLAN ID for the Libvirt Port Group to be created
   9. **NETWORK POOL:** A typeahead field for selecting a currently-configured IP Pool
3. Click SAVE CHANGES

   ![Creating a new network object](https://support.hpe.com/hpesc/public/api/document/sd00008014en_us/GUID-6359D4EE-C3F8-431F-850D-A21F7470714E-high.png)
