fabric-facility-ports

Instructions

When invoked, generate code for inter-testbed connectivity and traffic monitoring. Two main capabilities:

1. Facility Ports — Connect FABRIC to external testbeds (Chameleon, CloudLab) via L2 or L3
2. Port Mirroring — Mirror traffic from one interface to a listener node for analysis

Help the user set up the right connectivity and generate complete code.

API Reference

Adding a Facility Port

facility_port = slice.add_facility_port(
    name: str,       # Facility port name (e.g., 'Chameleon-TACC')
    site: str,       # FABRIC site where the port is located
    vlan: str,       # VLAN ID from external testbed (as string)
) -> Component

Available Facility Ports

Name	Site	External Testbed
Chameleon-TACC	TACC	Chameleon at TACC
Chameleon-StarLight	STAR	Chameleon at Chicago
Utah-Cloudlab-Powder	UTAH	CloudLab/Powder at Utah

Listing Facility Ports

fablib.list_facility_ports()

Port Mirroring

pmnet = slice.add_port_mirror_service(
    name: str,                       # Service name
    mirror_interface_name: str,      # Peer port name to mirror
    receive_interface: Interface,    # Listener interface
    mirror_interface_vlan: str = None,  # Optional VLAN filter
    mirror_direction: str = 'both',    # 'rx', 'tx', or 'both'
)

Getting Peer Port Info

mirror_port_name = node.get_interfaces()[0].get_peer_port_name()
mirror_port_vlan = node.get_interfaces()[0].get_peer_port_vlan()

Patterns

L2 Connection to Chameleon

from fabrictestbed_extensions.fablib.fablib import FablibManager
from ipaddress import IPv4Address, IPv4Network

fablib = FablibManager()

fabric_site = "TACC"
facility_port = "Chameleon-TACC"
network_vlan = "3100"  # VLAN from Chameleon network

subnet = IPv4Network("192.168.100.0/24")
available_ips = list(subnet.hosts())

slice = fablib.new_slice(name="chameleon-l2")

# Create L2 network
net = slice.add_l2network(name="inter-testbed-net", subnet=subnet)

# FABRIC node
node = slice.add_node(name="fabric-node", site=fabric_site, cores=4, ram=16, disk=50)
node_iface = node.add_component(model="NIC_Basic", name="nic1").get_interfaces()[0]
node_iface.set_mode("config")
net.add_interface(node_iface)

# Facility port
fp = slice.add_facility_port(name=facility_port, site=fabric_site, vlan=network_vlan)
fp_iface = fp.get_interfaces()[0]
fp_iface.set_mode("manual")
net.add_interface(fp_iface)

slice.submit()