def _validateNetworkSetup(networks, bondings):
_netinfo = netinfo.NetInfo()
for network, networkAttrs in networks.iteritems():
if networkAttrs.get('remove', False):
if set(networkAttrs) - set(['remove']):
raise ConfigNetworkError(
ne.ERR_BAD_PARAMS, 'Cannot specify '
'any attribute when removing')
for bonding, bondingAttrs in bondings.iteritems():
Bond.validateName(bonding)
if 'options' in bondingAttrs:
Bond.validateOptions(bonding, bondingAttrs['options'])
if bondingAttrs.get('remove', False):
if bonding not in _netinfo.bondings:
raise ConfigNetworkError(
ne.ERR_BAD_BONDING, "Cannot remove "
"bonding %s: Doesn't exist" % bonding)
continue
nics = bondingAttrs.get('nics', None)
if not nics:
raise ConfigNetworkError(ne.ERR_BAD_PARAMS,
"Must specify nics for bonding")
if not set(nics).issubset(set(_netinfo.nics)):
raise ConfigNetworkError(ne.ERR_BAD_NIC,
"Unknown nics in: %r" % list(nics))
def validateTag(cls, tag):
try:
if not 0 <= int(tag) <= cls.MAX_ID:
raise ConfigNetworkError(
ne.ERR_BAD_VLAN, 'vlan id out of range: %r, must be '
'0..%s' % (tag, cls.MAX_ID))
except ValueError:
raise ConfigNetworkError(
ne.ERR_BAD_VLAN, 'vlan id must be a '
'number between 0 and %s' % cls.MAX_ID)
def validateOptions(cls, bonding, bondingOptions):
'Example: BONDING_OPTS="mode=802.3ad miimon=150"'
with cls._validationBond(bonding) as bond:
try:
for option in bondingOptions.split():
key, _ = option.split('=')
if not os.path.exists('/sys/class/net/%s/bonding/%s' %
(bond, key)):
raise ConfigNetworkError(
ne.ERR_BAD_BONDING, '%r is '
'not a valid bonding option' % key)
except ValueError:
raise ConfigNetworkError(
ne.ERR_BAD_BONDING, 'Error parsing '
'bonding options: %r' % bondingOptions)
def validateAddress(cls, address):
try:
socket.inet_pton(socket.AF_INET, address)
except socket.error:
raise ConfigNetworkError(
ne.ERR_BAD_ADDR, '%r is not a valid IPv4 '
'address.' % address)
def __init__(self, inet, bootproto=None, blocking=False):
if inet.address and bootproto == 'dhcp':
raise ConfigNetworkError(
ne.ERR_BAD_ADDR, 'Static and dynamic ip '
'configurations are mutually exclusive.')
self.inet = inet
self.bootproto = bootproto
self. async = bootproto == 'dhcp' and blocking
def _validateNoDirectNet(ifaces):
# validate that none of the ifaces
# is a non-VLANed network over our iface
for (iface_net, iface_vlan) in ifaces:
if iface_vlan is None:
raise ConfigNetworkError(
ne.ERR_BAD_PARAMS, 'interface %r '
'already member of network %r' % (iface, iface_net))
def _validateDelNetwork(network, vlan, bonding, nics, bridged, _netinfo):
if bonding:
if set(nics) != set(_netinfo.bondings[bonding]["slaves"]):
raise ConfigNetworkError(
ne.ERR_BAD_NIC, 'delNetwork: %s are '
'not all nics enslaved to %s' % (nics, bonding))
if bridged:
assertBridgeClean(network, vlan, bonding, nics)
def _ifup(netIf):
rc, out, err = execCmd([constants.EXT_IFUP, netIf], raw=False)
if rc != 0:
# In /etc/sysconfig/network-scripts/ifup* the last line usually
# contains the error reason.
raise ConfigNetworkError(ne.ERR_FAILED_IFUP,
out[-1] if out else '')
return rc, out, err
def main():
if len(sys.argv) <= 1:
usage()
raise ConfigNetworkError(ne.ERR_BAD_PARAMS, "No action specified")
if sys.argv[1] == 'list':
listNetworks()
return
if len(sys.argv) <= 2:
usage()
raise ConfigNetworkError(ne.ERR_BAD_PARAMS, "No action specified")
if sys.argv[1] == 'add':
bridge = sys.argv[2]
kwargs = _parseKwargs(sys.argv[3:])
if 'nics' in kwargs:
kwargs['nics'] = kwargs['nics'].split(',')
addNetwork(bridge, **kwargs)
elif sys.argv[1] == 'del':
bridge = sys.argv[2]
kwargs = _parseKwargs(sys.argv[3:])
if 'nics' in kwargs:
kwargs['nics'] = kwargs['nics'].split(',')
delNetwork(bridge, **kwargs)
elif sys.argv[1] == 'edit':
oldBridge = sys.argv[2]
newBridge = sys.argv[3]
kwargs = _parseKwargs(sys.argv[4:])
if 'nics' in kwargs:
kwargs['nics'] = kwargs['nics'].split(',')
editNetwork(oldBridge, newBridge, **kwargs)
elif sys.argv[1] == 'setup':
batchCommands, options = utils.listSplit(sys.argv[2:], '::', 1)
d = {}
for batchCommand in utils.listSplit(batchCommands, '++'):
d[batchCommand[0]] = _parseKwargs(batchCommand[1:]) or None
setupNetworks(d, **_parseKwargs(options))
elif sys.argv[1] == 'show':
bridge = sys.argv[2]
kwargs = _parseKwargs(sys.argv[3:])
showNetwork(bridge, **kwargs)
else:
usage()
raise ConfigNetworkError(ne.ERR_BAD_PARAMS, "Unknown action specified")
def __init__(self, device, tag, configurator, ipconfig=None, mtu=None):
self.validateTag(tag)
if device is None:
raise ConfigNetworkError(
ne.ERR_BAD_PARAMS, 'Missing required vlan'
' underlying device definition.')
device.master = self
self.device = device
self.tag = tag
super(Vlan, self).__init__(device.name + '.' + tag, configurator,
ipconfig, mtu)
def validateNetmask(cls, netmask):
try:
cls.validateAddress(netmask)
except ConfigNetworkError as cne:
cne.message = '%r is not a valid IPv4 netmask.' % netmask
raise
num = struct.unpack('>I', socket.inet_aton(netmask))[0]
if num & (num - 1) != (num << 1) & 0xffffffff:
raise ConfigNetworkError(
ne.ERR_BAD_ADDR, '%r is not a valid IPv4 '
'netmask.' % netmask)
def delNetwork(network,
vlan=None,
bonding=None,
nics=None,
force=False,
configurator=None,
implicitBonding=True,
_netinfo=None,
**options):
if _netinfo is None:
_netinfo = netinfo.NetInfo()
if configurator is None:
configurator = Ifcfg()
if network not in _netinfo.networks:
logging.info("Network %r: doesn't exist in libvirt database", network)
_delNonVdsmNetwork(network, vlan, bonding, nics, _netinfo,
configurator)
return
nics, vlan, bonding = _netinfo.getNicsVlanAndBondingForNetwork(network)
bridged = _netinfo.networks[network]['bridged']
logging.info("Removing network %s with vlan=%s, bonding=%s, nics=%s,"
"options=%s" % (network, vlan, bonding, nics, options))
if not utils.tobool(force):
_validateDelNetwork(network, vlan, bonding, nics, bridged, _netinfo)
netEnt = objectivizeNetwork(bridge=network if bridged else None,
vlan=vlan,
bonding=bonding,
nics=nics,
_netinfo=_netinfo,
configurator=configurator,
implicitBonding=implicitBonding)
netEnt.ip.bootproto = netinfo.getBootProtocol(netEnt.name)
# We must first remove the libvirt network and then the network entity.
# Otherwise if we first remove the network entity while the libvirt
# network is still up, the network entity (In some flows) thinks that
# it still has users and thus does not allow its removal
configurator.removeLibvirtNetwork(network)
netEnt.remove()
# We need to gather NetInfo again to refresh networks info from libvirt.
# The deleted bridge should never be up at this stage.
_netinfo = netinfo.NetInfo()
if network in _netinfo.networks:
raise ConfigNetworkError(
ne.ERR_USED_BRIDGE, 'delNetwork: bridge %s '
'still exists' % network)
def _objectivizeSlaves(cls, name, configurator, nics, mtu, _netinfo):
slaves = []
for nic in nics:
nicVlans = tuple(_netinfo.getVlansForIface(nic))
nicNet = _netinfo.getNetworkForIface(nic)
nicBond = _netinfo.getBondingForNic(nic)
if nicVlans or nicNet or nicBond and nicBond != name:
raise ConfigNetworkError(
ne.ERR_USED_NIC, 'nic %s already used by %s' %
(nic, nicVlans or nicNet or nicBond))
slaves.append(Nic(nic, configurator, mtu=mtu, _netinfo=_netinfo))
return slaves
def objectivize(cls,
name,
configurator,
options,
nics,
mtu,
_netinfo,
destroyOnMasterRemoval=None):
if name and nics: # New bonding or edit bonding.
slaves = cls._objectivizeSlaves(name, configurator, nics, mtu,
_netinfo)
if name in _netinfo.bondings:
mtu = max(netinfo.getMtu(name), mtu)
if not options:
options = _netinfo.bondings[name]['cfg'].get(
'BONDING_OPTS')
elif name in _netinfo.bondings: # Implicit bonding.
mtu = max(netinfo.getMtu(name), mtu)
slaves = [
Nic(nic, configurator, mtu=mtu, _netinfo=_netinfo)
for nic in _netinfo.getNicsForBonding(name)
]
options = _netinfo.bondings[name]['cfg'].get('BONDING_OPTS')
else:
raise ConfigNetworkError(
ne.ERR_BAD_BONDING, 'Bonding %s not specified and it is not '
'already on the system' % name)
if not slaves:
raise ConfigNetworkError(
ne.ERR_BAD_PARAMS, 'Missing required nics'
' for bonding device.')
return cls(name,
configurator,
slaves=slaves,
options=options,
mtu=mtu,
destroyOnMasterRemoval=destroyOnMasterRemoval)
def _delNonVdsmNetwork(network, vlan, bonding, nics, _netinfo, configurator):
if network in netinfo.bridges():
netEnt = objectivizeNetwork(bridge=network,
vlan=vlan,
bonding=bonding,
nics=nics,
_netinfo=_netinfo,
configurator=configurator,
implicitBonding=False)
netEnt.remove()
else:
raise ConfigNetworkError(
ne.ERR_BAD_BRIDGE, "Cannot delete network"
" %r: It doesn't exist in the system" % network)
def assertBridgeClean(bridge, vlan, bonding, nics):
ports = set(netinfo.ports(bridge))
ifaces = set(nics)
if vlan:
ifaces.add((bonding or nics[0]) + '.' + vlan)
else:
ifaces.add(bonding)
brifs = ports - ifaces
if brifs:
raise ConfigNetworkError(
ne.ERR_USED_BRIDGE, 'bridge %s has interfaces'
' %s connected' % (bridge, brifs))
def __init__(self,
name,
configurator,
ipconfig=None,
mtu=None,
_netinfo=None):
if _netinfo is None:
_netinfo = netinfo.NetInfo()
if name not in _netinfo.nics:
raise ConfigNetworkError(ne.ERR_BAD_NIC, 'unknown nic: %s' % name)
super(Nic, self).__init__(name,
configurator,
ipconfig,
mtu=max(mtu, netinfo.getMtu(name)))
def __init__(self,
address=None,
netmask=None,
gateway=None,
defaultRoute=None):
if address:
if not netmask:
raise ConfigNetworkError(
ne.ERR_BAD_ADDR, 'Must specify '
'netmask to configure ip for '
'network.')
self.validateAddress(address)
self.validateNetmask(netmask)
if gateway:
self.validateGateway(gateway)
else:
if netmask or gateway:
raise ConfigNetworkError(
ne.ERR_BAD_ADDR, 'Specified netmask '
'or gateway but not ip address.')
self.address = address
self.netmask = netmask
self.gateway = gateway
self.defaultRoute = defaultRoute
def _buildBondOptions(bondName, bondings, _netinfo):
logger = logging.getLogger("_buildBondOptions")
bond = {}
if bondings.get(bondName):
bond['nics'] = bondings[bondName]['nics']
bond['bondingOptions'] = bondings[bondName].get('options', None)
elif bondName in _netinfo.bondings:
# We may not receive any information about the bonding device if it is
# unchanged. In this case check whether this bond exists on host and
# take its parameters.
logger.debug("Fetching bond %r info", bondName)
existingBond = _netinfo.bondings[bondName]
bond['nics'] = existingBond['slaves']
bond['bondingOptions'] = existingBond['cfg'].get('BONDING_OPTS', None)
else:
raise ConfigNetworkError(
ne.ERR_BAD_PARAMS, "No bonding option given, "
"nor existing bond %s found." % bondName)
return bond
def _validateInterNetworkCompatibility(ni, vlan, iface, bridged):
"""
Verify network compatibility with other networks on iface (bond/nic).
Only following combinations allowed:
- single non-VLANed bridged network
- multiple VLANed networks (bridged/bridgeless) with only one
non-VLANed bridgeless network
"""
def _validateNoDirectNet(ifaces):
# validate that none of the ifaces
# is a non-VLANed network over our iface
for (iface_net, iface_vlan) in ifaces:
if iface_vlan is None:
raise ConfigNetworkError(
ne.ERR_BAD_PARAMS, 'interface %r '
'already member of network %r' % (iface, iface_net))
ifaces_bridgeless = tuple(ni.getBridgelessNetworksAndVlansForIface(iface))
ifaces_bridged = tuple(ni.getBridgedNetworksAndVlansForIface(iface))
# If non-VLANed bridged network exists
# we can't add nothing else
_validateNoDirectNet(ifaces_bridged)
# Multiple VLANed networks (bridged/bridgeless) with only one
# non-VLANed bridgeless network permited
if not vlan:
# Want to add non-VLANed bridgeless network,
# check whether interface already has such network.
# Only one non-VLANed bridgeless network permited
if not bridged:
_validateNoDirectNet(ifaces_bridgeless)
# Want to add non-VLANed bridged network,
# check whether interface is empty
elif ifaces_bridged or ifaces_bridgeless:
raise ConfigNetworkError(
ne.ERR_BAD_PARAMS, 'interface %r already '
'has networks' % (iface))
def setupNetworks(networks, bondings, **options):
"""Add/Edit/Remove configuration for networks and bondings.
Params:
networks - dict of key=network, value=attributes
where 'attributes' is a dict with the following optional items:
vlan=<id>
bonding="<name>" | nic="<name>"
(bonding and nics are mutually exclusive)
ipaddr="<ip>"
netmask="<ip>"
gateway="<ip>"
bootproto="..."
delay="..."
onboot="yes"|"no"
(other options will be passed to the config file AS-IS)
-- OR --
remove=True (other attributes can't be specified)
bondings - dict of key=bonding, value=attributes
where 'attributes' is a dict with the following optional items:
nics=["<nic1>" , "<nic2>", ...]
options="<bonding-options>"
-- OR --
remove=True (other attributes can't be specified)
options - dict of options, such as:
force=0|1
connectivityCheck=0|1
connectivityTimeout=<int>
Notes:
When you edit a network that is attached to a bonding, it's not
necessary to re-specify the bonding (you need only to note
the attachment in the network's attributes). Similarly, if you edit
a bonding, it's not necessary to specify its networks.
"""
logger = logging.getLogger("setupNetworks")
_netinfo = netinfo.NetInfo()
configurator = Ifcfg()
networksAdded = set()
logger.debug("Setting up network according to configuration: "
"networks:%r, bondings:%r, options:%r" %
(networks, bondings, options))
force = options.get('force', False)
if not utils.tobool(force):
logging.debug("Validating configuration")
_validateNetworkSetup(dict(networks), dict(bondings))
logger.debug("Applying...")
try:
libvirt_nets = netinfo.networks()
# Remove edited networks and networks with 'remove' attribute
for network, networkAttrs in networks.items():
if network in _netinfo.networks:
logger.debug("Removing network %r" % network)
delNetwork(network,
configurator=configurator,
force=force,
implicitBonding=False)
if 'remove' in networkAttrs:
del networks[network]
del libvirt_nets[network]
elif network in libvirt_nets:
# If the network was not in _netinfo but is in the networks
# returned by libvirt, it means that we are dealing with
# a broken network.
logger.debug('Removing broken network %r' % network)
_delBrokenNetwork(network,
libvirt_nets[network],
configurator=configurator)
if 'remove' in networkAttrs:
del networks[network]
del libvirt_nets[network]
elif 'remove' in networkAttrs:
raise ConfigNetworkError(
ne.ERR_BAD_BRIDGE, "Cannot delete "
"network %r: It doesn't exist in the "
"system" % network)
else:
networksAdded.add(network)
_handleBondings(bondings, configurator)
# We need to use the newest host info
_ni = netinfo.NetInfo()
for network, networkAttrs in networks.iteritems():
d = dict(networkAttrs)
if 'bonding' in d:
d.update(_buildBondOptions(d['bonding'], bondings, _ni))
else:
d['nics'] = [d.pop('nic')]
d['force'] = force
logger.debug("Adding network %r" % network)
addNetwork(network,
configurator=configurator,
implicitBonding=True,
**d)
if utils.tobool(options.get('connectivityCheck', True)):
logger.debug('Checking connectivity...')
if not clientSeen(
int(
options.get('connectivityTimeout',
CONNECTIVITY_TIMEOUT_DEFAULT))):
logger.info('Connectivity check failed, rolling back')
for network in networksAdded:
# If the new added network was created on top of
# existing bond, we need to keep the bond on rollback
# flow, else we will break the new created bond.
delNetwork(network,
force=True,
implicitBonding=networks[network].get('bonding')
in bondings)
raise ConfigNetworkError(ne.ERR_LOST_CONNECTION,
'connectivity check failed')
except:
configurator.rollback()
raise
def objectivizeNetwork(bridge=None,
vlan=None,
bonding=None,
bondingOptions=None,
nics=None,
mtu=None,
ipaddr=None,
netmask=None,
gateway=None,
bootproto=None,
_netinfo=None,
configurator=None,
blockingdhcp=None,
implicitBonding=None,
defaultRoute=None,
**opts):
"""
Constructs an object hierarchy that describes the network configuration
that is passed in the parameters.
:param bridge: name of the bridge.
:param vlan: vlan tag id.
:param bonding: name of the bond.
:param bondingOptions: bonding options separated by spaces.
:param nics: list of nic names.
:param mtu: the desired network maximum transmission unit.
:param ipaddr: IPv4 address in dotted decimal format.
:param netmask: IPv4 mask in dotted decimal format.
:param gateway: IPv4 address in dotted decimal format.
:param bootproto: protocol for getting IP config for the net, e.g., 'dhcp'
:param _netinfo: network information snapshot.
:param configurator: instance to use to apply the network configuration.
:param blockingdhcp: whether to acquire dhcp IP config in a synced manner.
:param implicitBonding: whether the bond's existance is tied to it's
master's.
:param defaultRoute: Should this network's gateway be set in the main
routing table?
:returns: the top object of the hierarchy.
"""
if configurator is None:
configurator = Ifcfg()
if _netinfo is None:
_netinfo = netinfo.NetInfo()
if bondingOptions and not bonding:
raise ConfigNetworkError(
ne.ERR_BAD_BONDING, 'Bonding options '
'specified without bonding')
topNetDev = None
if bonding:
topNetDev = Bond.objectivize(bonding, configurator, bondingOptions,
nics, mtu, _netinfo, implicitBonding)
elif nics:
try:
nic, = nics
except ValueError:
raise ConfigNetworkError(
ne.ERR_BAD_BONDING, 'Multiple nics '
'require a bonding device')
else:
bond = _netinfo.getBondingForNic(nic)
if bond:
raise ConfigNetworkError(
ne.ERR_USED_NIC, 'nic %s already '
'enslaved to %s' % (nic, bond))
topNetDev = Nic(nic, configurator, mtu=mtu, _netinfo=_netinfo)
if vlan:
topNetDev = Vlan(topNetDev, vlan, configurator, mtu=mtu)
if bridge:
topNetDev = Bridge(bridge,
configurator,
port=topNetDev,
mtu=mtu,
stp=opts.get('stp'),
forwardDelay=int(opts.get('forward_delay', 0)))
if topNetDev is None:
raise ConfigNetworkError(ne.ERR_BAD_PARAMS, 'Network defined without'
'devices.')
topNetDev.ip = IpConfig(inet=IPv4(ipaddr, netmask, gateway, defaultRoute),
bootproto=bootproto,
blocking=utils.tobool(blockingdhcp))
return topNetDev
def validateName(cls, name):
if not (name and len(name) <= cls.MAX_NAME_LEN
and len(set(name) & cls.ILLEGAL_CHARS) == 0
and not name.startswith('-')):
raise ConfigNetworkError(ne.ERR_BAD_BRIDGE,
"Bridge name isn't valid: %r" % name)
def addNetwork(network,
vlan=None,
bonding=None,
nics=None,
ipaddr=None,
netmask=None,
prefix=None,
mtu=None,
gateway=None,
force=False,
configurator=None,
bondingOptions=None,
bridged=True,
_netinfo=None,
qosInbound=None,
qosOutbound=None,
**options):
nics = nics or ()
if _netinfo is None:
_netinfo = netinfo.NetInfo()
bridged = utils.tobool(bridged)
if mtu:
mtu = int(mtu)
if prefix:
if netmask:
raise ConfigNetworkError(ne.ERR_BAD_PARAMS,
'Both PREFIX and NETMASK supplied')
else:
try:
netmask = netinfo.prefix2netmask(int(prefix))
except ValueError as ve:
raise ConfigNetworkError(ne.ERR_BAD_ADDR,
"Bad prefix: %s" % ve)
if not utils.tobool(force):
logging.debug('validating network...')
if network in _netinfo.networks:
raise ConfigNetworkError(ne.ERR_USED_BRIDGE,
'Network already exists')
if bonding:
_validateInterNetworkCompatibility(_netinfo, vlan, bonding,
bridged)
else:
for nic in nics:
_validateInterNetworkCompatibility(_netinfo, vlan, nic,
bridged)
logging.info(
"Adding network %s with vlan=%s, bonding=%s, nics=%s,"
" bondingOptions=%s, mtu=%s, bridged=%s, options=%s", network, vlan,
bonding, nics, bondingOptions, mtu, bridged, options)
if configurator is None:
configurator = Ifcfg()
bootproto = options.pop('bootproto', None)
defaultRoute = network == constants.MANAGEMENT_NETWORK
netEnt = objectivizeNetwork(network if bridged else None,
vlan,
bonding,
bondingOptions,
nics,
mtu,
ipaddr,
netmask,
gateway,
bootproto,
_netinfo,
configurator,
defaultRoute=defaultRoute,
**options)
netEnt.configure(**options)
configurator.configureLibvirtNetwork(network,
netEnt,
qosInbound=qosInbound,
qosOutbound=qosOutbound)
def validateName(name):
if not re.match('^bond[0-9]+$', name):
raise ConfigNetworkError(
ne.ERR_BAD_BONDING,
'%r is not a valid bonding device name' % name)
