LAN Tornado Agent: Network Traffic Generation User Manual

LAN Tornado Agent: Network Traffic Generation User Manual Introduction

The LAN Tornado Agent is a high-performance network testing tool designed to generate controlled network traffic. This manual provides the technical steps required to configure, execute, and manage traffic generation sessions using the command-line interface (CLI) and configuration files. System Prerequisites

Before deploying the agent, ensure your test environment meets the following specifications:

Operating System: Linux (Ubuntu 20.04 LTS or later recommended) or Windows Server 2019+

Privileges: Root or administrative access required for raw socket manipulation

Network Interface: Dedicated Gigabit Ethernet (GbE) or 10GbE Network Interface Card (NIC)

Dependencies: libpcap (Linux) or Npcap (Windows) installed and updated Installation and Setup Linux Deployment Download the latest binary package.

Extract the archive to your preferred directory:tar -xvf lan-tornado-agent.tar.gz

Navigate to the directory and grant executable permissions:chmod +x lan-tornado-agent Windows Deployment Download the executable installer. Run the installer as an Administrator.

Ensure the option to add LAN Tornado to the system PATH is selected. Configuration File Structure

The agent utilizes a JSON-based configuration file (config.json) to define the parameters of the traffic generation session.

{ “agent_settings”: { “interface”: “eth0”, “log_level”: “info” }, “traffic_profile”: { “protocol”: “UDP”, “source_ip”: “192.168.1.50”, “destination_ip”: “192.168.1.100”, “destination_port”: 5001, “packet_size_bytes”: 1400, “bandwidth_mbps”: 500, “duration_seconds”: 300 } } Use code with caution. Parameter Reference

interface: The identifier of the local network adapter used to inject traffic. protocol: The transport layer protocol (TCP, UDP, or RAW).

packet_size_bytes: Total size of each generated frame, including headers (range: 64 to 1518 bytes).

bandwidth_mbps: Target transmission speed. Set to 0 for maximum available throughput. duration_seconds: Total runtime of the test execution. Executing Traffic Generation

The agent is controlled entirely via terminal commands. Run all commands from an elevated prompt. Start a Session

To initialize traffic generation using a predefined configuration file, execute:sudo ./lan-tornado-agent –config config.json Direct CLI Overrides

You can bypass the configuration file by passing parameters directly to the CLI binary:sudo ./lan-tornado-agent –interface eth0 –target 192.168.1.100 –port 5001 –bandwidth 100 Stopping a Session

To terminate an active load test safely before the configured duration expires, issue a standard interrupt signal:Ctrl + C Monitoring and Verification

During execution, the agent outputs real-time performance metrics to the console every second. Key metrics include: Tx_Rate (Mbps): Current outbound bandwidth. Pps: Total packets transmitted per second.

Err: Number of transmission errors or dropped frames encountered by the socket layer.

A final summary report is automatically saved to session_summary.log upon completion of the test. To help tailor this manual further, please let me know:

What specific protocol features (like multicast or custom payloads) do you need to document?