def test_PortMirror(self):
# create a NetworkService sliver for FABNetv6
prop = {
AmConstants.CONFIG_PROPERTIES_FILE:
'../config/net_handler_config.yml'
}
handler = NetHandler(logger=self.logger,
properties=prop,
process_lock=threading.Lock())
#
# create a network sliver for FABNetv4 and its interfaces
#
sliver = NetworkServiceSliver()
# service name (set by user) - only guaranteed unique within a slice
sliver.set_name('PortMirror-UKY')
sliver.set_type(ServiceType.PortMirror)
sliver.set_layer(NSLayer.L2)
# mirror_port is the name of the port being mirrored - actual name the way
# service definition needs it. It comes directly from ASM network service sliver
# whatever the right name is - user must to know it when creating a slice
sliver.mirror_port = "TwentyFiveGigE0/0/0/24"
# direction also comes from ASM network service sliver
sliver.mirror_direction = MirrorDirection.Both
#
# interface to which the mirrored traffic is directed to
# it is in the slice (ASM) model, the same way all other interfaces for network services are.
#
stp_to = InterfaceSliver()
stp_to.set_name('Interface_To_Which_We_Send_Mirrored_Traffic')
stp_to.set_type(InterfaceType.ServicePort)
sliver_labels = Labels(local_name='TwentyFiveGigE0/0/0/23/1',
device_name='lbnl-data-sw')
sliver_capacities = Capacities(bw=2000)
stp_to.set_labels(sliver_labels)
stp_to.set_capacities(sliver_capacities)
# create interface info object, add populated interfaces to it
ifi = InterfaceInfo()
ifi.add_interface(stp_to)
# add interface info object to sliver. All of this happens automagically normally
sliver.interface_info = ifi
# set a fake unit reservation
uid = uuid.uuid3(uuid.NAMESPACE_DNS, 'test_PortMirror')
self.unit = Unit(rid=ID(uid=str(uid)))
self.unit.set_sliver(sliver=sliver)
#
# create a service (create needs to parse out sliver information
# into exact parameters the service ansible script needs)
#
r, updated_unit = handler.create(unit=self.unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_CREATE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
time.sleep(30)
#
# delete - need to make sure the updated unit has the right info to delete the service
#
r, updated_unit = handler.delete(updated_unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_DELETE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
def test_FABNetv6(self):
# create a NetworkService sliver for FABNetv6
prop = {
AmConstants.CONFIG_PROPERTIES_FILE:
'../config/net_handler_config.yml'
}
handler = NetHandler(logger=self.logger,
properties=prop,
process_lock=threading.Lock())
#
# create a network sliver for FABNetv4 and its interfaces
#
sliver = NetworkServiceSliver()
# service name (set by user) - only guaranteed unique within a slice
sliver.set_name('L3-UKY-IPv6')
# if service name global uniqueness is a requirement use Labels.local_name for that (optional)
# e.g. concatenate name + res id (or another unique id)
# sliver.set_labels(Labels().set_fields(local_name='test-l2bridge-shortname'))
# per @xiyang he uses unit id for service name so this is not needed.
sliver.set_type(ServiceType.FABNetv6)
sliver.set_layer(NSLayer.L3)
# this is the gateway with the IP range picked for this sliver in this slice on this site
# can also be specified with ipv6/ipv6_subnet and mac is optional for both.
# Q: does that mean that the advertisement needs to maintain information about multiple
# subnet, gateway and mac tuples for each site?
sliver.set_gateway(
Gateway(
Labels(ipv6="2602:FCFB:0001::1",
ipv6_subnet="2602:FCFB:0001::/64")))
#
# create a small number of Interface slivers, set their properties and link to service
#
#
# First interface - let's assume it is SR-IOV
#
isl1 = InterfaceSliver()
# the name is normally set by FIM as '-' concatenation of service name
isl1.set_name('Interface1')
# this will be a ServicePort in the network service sliver. It is created by FIM automatically when
# the user adds a NetworkService to the ASM. The name is set by the FIM as '-' concatenation of service
# name and peer interface sliver name.
isl1.set_type(InterfaceType.ServicePort)
# since this is SR-IOV, orchestrator picks VLAN for this function based on info in advertisement
# other information is done in the same way it is done for L2 services
sliver_labels = Labels(vlan='121',
local_name='HundredGigE0/0/0/5',
device_name='uky-data-sw')
# capacities (bw in Gbps, burst size is in Mbytes) source: (b)
sliver_capacities = Capacities(bw=1)
# assign labels and capacities
isl1.set_labels(sliver_labels)
isl1.set_capacities(sliver_capacities)
#
# Second interface (let's assume this is a dedicated card)
#
isl2 = InterfaceSliver()
isl2.set_name('Interface2')
isl2.set_type(InterfaceType.ServicePort)
# Q: who and how picks the VLAN in this case? I think we discussed having an advertised pool of 'Layer 3
# vlans' which need to be kept track of and this would be one of them
# other information is done in the same way it is done for L2 services
sliver_labels = Labels(vlan='1001',
local_name='HundredGigE0/0/0/5',
device_name='uky-data-sw')
sliver_capacities = Capacities(bw=1)
isl2.set_labels(sliver_labels)
isl2.set_capacities(sliver_capacities)
# create interface info object, add populated interfaces to it
ifi = InterfaceInfo()
ifi.add_interface(isl1)
ifi.add_interface(isl2)
# add interface info object to sliver. All of this happens automagically normally
sliver.interface_info = ifi
# set a fake unit reservation
uid = uuid.uuid3(uuid.NAMESPACE_DNS, 'test_FABNetv6')
self.unit = Unit(rid=ID(uid=str(uid)))
self.unit.set_sliver(sliver=sliver)
#
# create a service (create needs to parse out sliver information
# into exact parameters the service ansible script needs)
#
r, updated_unit = handler.create(unit=self.unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_CREATE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
time.sleep(30)
#
# delete - need to make sure the updated unit has the right info to delete the service
#
r, updated_unit = handler.delete(updated_unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_DELETE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
def test_L2STS(self):
# create a NetworkService sliver for L2STS
prop = {
AmConstants.CONFIG_PROPERTIES_FILE:
'../config/net_handler_config.yml'
}
handler = NetHandler(logger=self.logger, properties=prop)
#
# create a network sliver for L2Bridge and its interfaces
#
sliver = NetworkServiceSliver()
# service name - can we use the sliver name - only guaranteed unique in the slice
sliver.set_name('L2STSServiceTest')
sliver.set_type(ServiceType.L2STS)
sliver.set_layer(NSLayer.L2)
# ERO
# first declare a path. Each path is a list of somethings. a2z and z2a maintained separately within Path
ero_path = Path()
ero_path.set_symmetric(["10.1.1.1", "10.1.1.2"])
# default is loose ERO, set strict=True if want otherwise
ero = ERO(strict=False)
ero.set(ero_path)
sliver.set_ero(ero)
#
# site A interfaces
#
stp_a1 = InterfaceSliver()
stp_a1.set_name('Interface_A1')
stp_a1.set_type(InterfaceType.ServicePort)
sliver_labels = Labels()
sliver_capacities = Capacities()
# untagged w/o vlan label set
sliver_labels.set_fields(local_name='TwentyFiveGigE0/0/0/23/1')
sliver_labels.set_fields(device_name='lbnl-data-sw')
sliver_capacities.set_fields(bw=2000)
stp_a1.set_labels(sliver_labels)
stp_a1.set_capacities(sliver_capacities)
#
# site Z interfaces
#
stp_z1 = InterfaceSliver()
stp_z1.set_name('Interface_Z1')
stp_z1.set_type(InterfaceType.ServicePort)
sliver_labels = Labels()
sliver_capacities = Capacities()
sliver_labels.set_fields(vlan='235')
sliver_labels.set_fields(local_name='HundredGigE0/0/0/13')
sliver_labels.set_fields(device_name='uky-data-sw')
sliver_capacities.set_fields(bw=1000)
stp_z1.set_labels(sliver_labels)
stp_z1.set_capacities(sliver_capacities)
stp_z2 = InterfaceSliver()
stp_z2.set_name('Interface_Z2')
stp_z2.set_type(InterfaceType.ServicePort)
sliver_labels = Labels()
sliver_capacities = Capacities()
# untagged w/o vlan label set
sliver_labels.set_fields(local_name='TwentyFiveGigE0/0/0/23/2')
sliver_labels.set_fields(device_name='uky-data-sw')
sliver_capacities.set_fields(bw=1000)
stp_z2.set_labels(sliver_labels)
stp_z2.set_capacities(sliver_capacities)
# create interface info object, add interfaces to it
ifi = InterfaceInfo()
ifi.add_interface(stp_a1)
ifi.add_interface(stp_z1)
ifi.add_interface(stp_z2)
# All of this happens automagically in FIM
sliver.interface_info = ifi
uid = uuid.uuid3(uuid.NAMESPACE_DNS, 'test_L2STS')
self.unit = Unit(rid=ID(uid=str(uid)))
self.unit.set_sliver(sliver=sliver)
#
# create a service
#
r, updated_unit = handler.create(unit=self.unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_CREATE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
time.sleep(30)
#
# delete - need to make sure the updated unit has the right info to delete the service
#
r, updated_unit = handler.delete(updated_unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_DELETE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
def test_L2Bridge(self):
# create a NetworkService sliver for L2Bridge
prop = {
AmConstants.CONFIG_PROPERTIES_FILE:
'../config/net_handler_config.yml'
}
handler = NetHandler(logger=self.logger, properties=prop)
#
# create a network sliver for L2Bridge and its interfaces
#
sliver = NetworkServiceSliver()
# service name (set by user) - only guaranteed unique within a slice
sliver.set_name('L2BridgeServiceTest')
# if service name global uniqueness is a requirement use Labels.local_name for that (optional)
# e.g. concatenate name + res id (or another unique id)
# sliver.set_labels(Labels().set_fields(local_name='test-l2bridge-shortname'))
# per @xiyang he uses unit id for service name so this is not needed.
sliver.set_type(ServiceType.L2Bridge)
sliver.set_layer(NSLayer.L2)
# Interface properties
#
# The service definitions make a distinction between interface which requires
# type = parse(InterfaceSliver.Labels.local_name)
# id = parse(InterfaceSliver.Labels.local_name)
# outervlan = InterfaceSliver.Labels.vlan
# innervlan = InterfaceSliver.Labels.inner_vlan
# bw = InterfaceSliver.Capacities.bw (0 - best-effort)
# burst size = InterfaceSliver.Capacities.burst_size
#
# and STP which in addition also requires NSO device name.
# In deep network sliver NSO Device name goes on *each* interface, then handler.create can parse
# out the interfaces and figure out which STP each interface goes with based on that.
# NSO device name = InterfaceSliver.Labels.device_name
#
# The properties of InterfaceSlivers noted above must be copied by Orchestrator from various places
# a) the switch TrunkPort port the ASM ServicePort maps to in CBM
# b) the Shared or Dedicated ASM port on the card the ServicePort peers with in ASM
# c) the Shared or Dedicated CBM port the peer ASM port maps to
# Below for each property comments indicate where they come from by a, b, c
# Orchestrator determines peer ports in ASM (between ServicePort and corresponding Shared/Dedicated card port)
# and sets nodemaps to point from ASM ServicePort to corresponding CBM TrunkPort
# as well as between Shared/Dedicated ASM port on the NIC and the corresponding CBM Shared/Dedicated port
#
# create a small number of Interface slivers, set their properties and link to service
#
isl1 = InterfaceSliver()
# the name is set by FIM as '-' concatenation of service name
isl1.set_name('Interface1')
# this will be a ServicePort in the network service sliver. It is created by FIM automatically when
# the user adds a NetworkService to the ASM. The name is set by the FIM as '-' concatenation of service
# name and peer interface sliver name.
isl1.set_type(InterfaceType.ServicePort)
sliver_labels = Labels()
sliver_capacities = Capacities()
# inner_vlan - not used for now - user would fill it in directly on the sliver Labels -
# need to discuss.
# sl1labs.set_fields(inner_vlan='3')
# vlan - source: (c)
sliver_labels.set_fields(vlan='100')
# local_name source: (a)
sliver_labels.set_fields(local_name='HundredGigE0/0/0/17')
# NSO device name source: (a) - need to find the owner switch of the network service in CBM
# and take its .name or labels.local_name
sliver_labels.set_fields(device_name='uky-data-sw')
# capacities (bw in Gbps, burst size is in Mbytes) source: (b)
sliver_capacities.set_fields(bw=1)
# assign labels and capacities
isl1.set_labels(sliver_labels)
isl1.set_capacities(sliver_capacities)
#
# Second interface (comments for field info origin omitted below)
#
isl2 = InterfaceSliver()
isl2.set_name('Interface2')
isl2.set_type(InterfaceType.ServicePort)
sliver_labels = Labels()
sliver_capacities = Capacities()
# sliver_labels.set_fields(vlan='102')
sliver_labels.set_fields(local_name='TwentyFiveGigE0/0/0/23/1')
sliver_labels.set_fields(device_name='uky-data-sw')
sliver_capacities.set_fields(bw=1)
isl2.set_labels(sliver_labels)
isl2.set_capacities(sliver_capacities)
# create interface info object, add populated interfaces to it
ifi = InterfaceInfo()
ifi.add_interface(isl1)
ifi.add_interface(isl2)
# add interface info object to sliver. All of this happens automagically normally
sliver.interface_info = ifi
# set a fake unit reservation
uid = uuid.uuid3(uuid.NAMESPACE_DNS, 'test_L2Bridge')
self.unit = Unit(rid=ID(uid=str(uid)))
self.unit.set_sliver(sliver=sliver)
#
# create a service (create needs to parse out sliver information
# into exact parameters the service ansible script needs)
#
r, updated_unit = handler.create(unit=self.unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_CREATE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
time.sleep(30)
#
# delete - need to make sure the updated unit has the right info to delete the service
#
r, updated_unit = handler.delete(updated_unit)
self.assertEqual(r[Constants.PROPERTY_TARGET_NAME],
Constants.TARGET_DELETE)
self.assertEqual(r[Constants.PROPERTY_ACTION_SEQUENCE_NUMBER], 0)
self.assertEqual(r[Constants.PROPERTY_TARGET_RESULT_CODE],
Constants.RESULT_CODE_OK)
def __init__(self, *, name: str, node_id: str = None, topo: Any,
etype: ElementType = ElementType.EXISTING,
parent_node_id: str = None,
interfaces: List[Interface] = None,
nstype: ServiceType = None, technology: str = None,
**kwargs):
"""
Don't call this method yourself, call topology.add_network_service()
node_id will be generated if not provided for experiment topologies
:param name:
:param node_id:
:param topo:
:param etype: is this supposed to exist or new should be created
:param parent_node_id: node_id of the parent Node if any (for new components)
:param interfaces: list of interface objects to connect
:param nstype: service type if new
:param technology: service technology
:param kwargs: any additional properties
"""
assert name is not None
assert topo is not None
site = None
if etype == ElementType.NEW:
# node id myst be specified for new nodes in substrate topologies
if node_id is None:
node_id = str(uuid.uuid4())
super().__init__(name=name, node_id=node_id, topo=topo)
if nstype is None:
raise TopologyException("When creating new services you must specify ServiceType")
# cant use isinstance as it would create circular import dependencies
# We do more careful checks for ExperimentTopologies, but for substrate we let things loose
if str(self.topo.__class__) == "<class 'fim.user.topology.ExperimentTopology'>" and interfaces:
sites = self.__validate_nstype_constraints(nstype, interfaces)
# if a single-site service
if len(sites) == 1:
site = sites.pop()
sliver = NetworkServiceSliver()
sliver.node_id = self.node_id
sliver.set_name(self.name)
sliver.set_type(nstype)
sliver.set_site(site)
# set based on service type
sliver.set_layer(NetworkServiceSliver.ServiceConstraints[nstype].layer)
sliver.set_technology(technology)
sliver.set_properties(**kwargs)
self.topo.graph_model.add_network_service_sliver(parent_node_id=parent_node_id, network_service=sliver)
self._interfaces = list()
if interfaces is not None and len(interfaces) > 0:
for i in interfaces:
# run through guardrails, then connect
self.__service_guardrails(sliver, i)
self.__connect_interface(interface=i)
else:
assert node_id is not None
super().__init__(name=name, node_id=node_id, topo=topo)
# check that this node exists
existing_node_id = self.topo.\
graph_model.find_node_by_name(node_name=name,
label=ABCPropertyGraph.CLASS_NetworkService)
if existing_node_id != node_id:
raise TopologyException(f'Service name {name} node id does not match the expected node id.')
# collect a list of interface nodes it attaches to
interface_list = self.topo.graph_model.get_all_ns_or_link_connection_points(link_id=self.node_id)
name_id_tuples = list()
# need to look up their names - a bit inefficient, need to think about this /ib
for iff in interface_list:
_, props = self.topo.graph_model.get_node_properties(node_id=iff)
name_id_tuples.append((props[ABCPropertyGraph.PROP_NAME], iff))
self._interfaces = [Interface(node_id=tup[1], topo=topo, name=tup[0]) for tup in name_id_tuples]