Add Data Networks Using the CLIΒΆ

If you prefer, you can add data networks using the CLI. You can set up flat, VLAN and VXLAN data networks over physical networks using the controller-0 command-line interface. The data networks provide connectivity for project networks.


Controller-0 must be installed and configured.


  • To create a data network using the CLI, use the following command.

    ~(keystone_admin)$ system datanetwork-add -d <description> -m <mtu> -p <port> -g <group> -t <ttl> -M <mode> <name> <type>



    A description of the data network.


    The MTU of the data network.


    To attach to the data network, data interfaces must be configured with an equal or larger MTU.


    The port of the data network.


    The multicast group of the data network.


    The time-to-live of the data network.


    For networks of <type> vxlan only, mode can be either dynamic or static.

    If set to dynamic, <group> must also be specified.


    The name assigned to the data network.


    The type of data network to be created (flat, vlan, or vxlan)


    vxlan is only applicable to StarlingX OpenStack.

    For example, to add a VLAN data network named datanet-a:

    ~(keystone_admin)$ system datanetwork-add datanet-a vlan
    | Property     | Value                                |
    | id           | 2                                    |
    | uuid         | 104071a4-1c26-4383-ba07-72e05316d540 |
    | name         | datanet-a                            |
    | network_type | vlan                                 |
    | mtu          | 1500                                 |
    | description  | None                                 |

    You must configure at least one data network in order to assign data interfaces to worker nodes and unlock the hosts.


For the StarlingX OpenStack application, after creating a data network of the VLAN or VXLAN type, you can assign one or more segmentation ranges consisting of a set of consecutive VLAN IDs (for VLANs) or VNIs (for VXLANs) using the openstack network segment range create command. Segmentation ranges are required in order to set up project networks.


Segmentation ranges are not required in order to attach interfaces and unlock openstack-compute labeled worker nodes.