TRex Stateless GUI application provides a graphical user interface for http://trex-tgn.cisco.com.
GUI application provides capabilities to manage TRex, create different traffic profiles, run them it in TRex, create VM instructions. Also it has built-in packet crafting tool which allows to create any type of packet(it has the same limitation as Scapy python library).
TRex Port Management
GUI provides capabilities to acquire ports, run a traffic on a port, display port status and different statistic.
Dashboard with global statistics provides detailed information for each port. Such as CPU Utilization, Input/Output traffic and so on.
- Import existing YAML profiles / export them to JSON or YAML formats.
- Create a profile from scratch.
- Create one or more streams for a given profile.
- Specify profiles stream order.
- Edit existing stream properties or create new ones.
- Build a stream from existing PCAP file or from scratch (using advanced Stream builder).
- Export a stream to PCAP format.
Advanced mode with Packet Crafting Tool
Packet Crafting Tool has two main capabilities. Packet Editor and Field Engine. Packet editor allows user create and/or modify any type of packet which is supported by Scapy
Packet editor's key features:
- Specify only necessary fields
- Generate random field values
- "Lengths" and "checksums" could be automatically generated or explicitly specified.
- Ability to create TRex VM instruction from predefined template.
Field Engine tab provide to user an easy way to create TRex VM instructions in current stream.
Field Engine's key features:
- Ability to create predefined instructions from Packet Builder
- Smart variable name and packet offsets suggester.
- Integrated help for each instruction
More features and theirs description you can find on project Wiki page
Videos instructions for basic Stateless GUI features
You can find some videos about basic features in this TRex Stateless GUI - YouTube playlist.
For next release we plan to support following features:
- Per stream statistic
- Neighboring Protocol
- Traffic capturing
- Debug Hardware counters
First of all you need configured TRex core and the easiest way to get it is install TRex VM image into VirtualBox locally. Here is the manual how to install TRex VM.
- Configure VM:
- Open VM Settings -> Network -> Advanced -> Port forwarding
- Add VM port forwarding for ports: 4501(async), 4507(scapy-server)
- Update trex:
- Start VM and connect via ssh: ssh -p 3022 firstname.lastname@example.org (password: trex)
- Update TRex to the latest release
wget --no-cache http://trex-tgn.cisco.com/trex/release/latest
tar -xzvf latest
To run TRex use following cli commands: "cd /opt/trex/v2.* ; sudo ./t-rex-64 -i"
You can download Stateless GUI v3.1 released build from here.
TRex Dev team