Skip to content

HewlettPackard/PacketRusher

Repository files navigation

PacketRusher

PacketRusher Logo


Description

PacketRusher is a tool, based upon my5G-RANTester, dedicated to the performance testing and automatic validation of 5G Core Networks using simulated UE (user equipment) and gNodeB (5G base station).

If you have questions or comments, feel free to open an issue.

PacketRusher borrows libraries and data structures from the free5gc project.

Features

  • Simulate multiple UEs and gNodeB from a single tool
    • We tested up to 10k UEs!
  • Supports both N2 (NGAP) and N1 (NAS) interfaces for stress testing
  • --pcap parameter to capture pcap of N1/N2 traffic
  • Implements main control plane procedures:
    • UE attach/detach (registration/identity request/authentification/security mode) procedures
    • Create/Delete PDU Sessions, up to 15 PDU Sessions per UE
    • Xn handover: UE handover between simulated gNodeB (PathSwitchRequest)
    • N2 handover: UE handover between simulated gNodeB (HandoverRequired)
    • UE Enter/Exit CM-IDLE procedures (Service Request)
    • GUTI Re-registration
    • Supports 5G roaming: Tested with new open5gs/open5gs#2194 Roaming feature
  • Implements high-performant N3 (GTP-U) interface
    • Generic tunnel supporting all kind of traffic (TCP, UDP, Video…)
      • We tested iperf3 traffic, and Youtube traffic through PacketRusher
      • We roughly reach 5 GB/s per UE, which is more than what a real UE can achieve.
  • Integrated all-in-one mocked 5GC/AMF for PacketRusher's integration testing

Installation

Quick start guide

The following is a quick start guide, for more details on the installation, configuration or usage, you may refer to the wiki.

Requirements