B.7. Virtual network default has not been started
- Symptom
- Normally, the configuration for a virtual network named default is installed as part of the libvirt package, and is configured to autostart when libvirtd is started.If the default network (or any other locally-created network) is unable to start, any virtual machine configured to use that network for its connectivity will also fail to start, resulting in this error message:
Virtual network default has not been started
- Investigation
- One of the most common reasons for a libvirt virtual network's failure to start is that the dnsmasq instance required to serve DHCP and DNS requests from clients on that network has failed to start.To determine if this is the cause, run
virsh net-start defaultfrom a root shell to start the default virtual network.If this action does not successfully start the virtual network, open/var/log/libvirt/libvirtd.logto view the complete error log message.If a message similar to the following appears, the problem is likely a systemwide dnsmasq instance that is already listening on libvirt's bridge, and is preventing libvirt's own dnsmasq instance from doing so. The most important parts to note in the error message arednsmasqandexit status 2:Could not start virtual network default: internal error Child process (/usr/sbin/dnsmasq --strict-order --bind-interfaces --pid-file=/var/run/libvirt/network/default.pid --conf-file= --except-interface lo --listen-address 192.168.122.1 --dhcp-range 192.168.122.2,192.168.122.254 --dhcp-leasefile=/var/lib/libvirt/dnsmasq/default.leases --dhcp-lease-max=253 --dhcp-no-override) status unexpected: exit status 2
- Solution
- If the machine is not using dnsmasq to serve DHCP for the physical network, disable dnsmasq completely.If it is necessary to run dnsmasq to serve DHCP for the physical network, edit the
/etc/dnsmasq.conffile. Add or uncomment the first line, as well as one of the two lines following that line. Do not add or uncomment all three lines:bind-interfaces interface=name_of_physical_interface listen-address=chosen_IP_address
After making this change and saving the file, restart the systemwide dnsmasq service.Next, start the default network with thevirsh net-start defaultcommand.Start the virtual machines.
