Product documentation
SNMP Agent Simulator
User Guide
Simulate SNMP devices, reproduce network conditions, and automate repeatable tests. This guide covers the desktop application and Release 1 automation tools.
Browse the guide
Follow the topics in order, or search for a command, configuration field, OID, or error message.
Getting started
Using the simulator
Overview
Learn how iReasoning SNMP Agent Simulator simulates SNMPv1, SNMPv2c, and SNMPv3 devices for development, testing, and training.
Major Features
Explore SNMP device recording and replay, multiple agents, scripting, traps, and Release 1 test automation.
Graphical User Interface
Use the simulator device library, generate SNMP walk data from MIBs, and record SNMP traps through the desktop interface.
Community and Context Indexing
Configure different recorded data for SNMP communities and SNMPv3 contexts, including exact and prefix matching.
Command Line Interface
Start simulator projects and record SNMP walks and traps using the supplied command-line scripts.
Automation and testing
Automation and Repeatable Testing
Discover Release 1 automation for repeatable SNMP tests: scenarios, OID overrides, network faults, REST, Python, and reports.
Create and manage labs in the GUI
Create, import, rename and delete SNMP simulator labs with desktop icons and agent property forms.
Create and run scenarios in the GUI
Create timed SNMP scenarios with GUI forms, simulate outages, run checks and export results.
Copy commands and export standalone scenarios
Copy shell and PowerShell commands for simulator labs or export a portable standalone scenario.
Getting started
Set up Java, licensing, workspaces, and command-line tools for repeatable SNMP simulator testing.
Run your first scenario
Run an SNMP simulator scenario that changes interface status, introduces an outage, and exports JSON and JUnit reports.
Control agent state
Start, stop, pause, resume, and reset simulated SNMP agents and labs, and understand how each action affects running scenarios.
Override recorded values
Override existing SNMP OID values with typed JSON, select recording contexts, and encode counters and octet strings correctly.
Simulate faults and notifications
Model response delay, packet loss, SNMP errors, outages, and reboots, and send traps and INFORM notifications.
Write scenarios and assertions
Schedule SNMP simulator actions and check request, outage, SET, response error, trap, and INFORM counts in time windows.
Start the REST service
Start the embedded Java REST API from the desktop and control SNMP simulator labs over a LAN without private tokens.
Create and control a lab through REST
Upload recordings, create labs, control agents, run scenarios, and export reports through the SNMP simulator REST API.
Automate the workflow with Python
Use the Python SNMP simulator client to create a lab, execute a scenario, and save JSON and JUnit reports.
Operate the simulator with Claude Code
Operate the simulator with Claude Code in the iReasoning SNMP Agent Simulator user guide.
Read reports and diagnose problems
Understand SNMP scenario results, JSON and JUnit reports, event retention, and common HTTP and licensing errors.
Credentials and remote deployment
Configure credential overlays, trusted scripts, HTTPS, and container deployment for SNMP simulator automation.
Reference
Helper Functions
Reference the BeanShell helper functions for simulated uptime, SNMP variable bindings, traps, conversions, and random values.
SNMP Walk Data File
Understand the SNMP walk recording XML format, MIB values, data types, scripts, traps, and threshold rules.
Scripting Language
Learn about BeanShell scripting for SNMP simulator recordings and find the BeanShell language manual.
SNMP Trap Data File
Configure recorded SNMP traps, timestamps, destinations, and variable bindings in the SNMP trap XML data format.
Simulator Configuration
Reference SNMPv3 engine properties, trap sinks, users, groups, VACM views, and a complete simulator configuration example.
Examples
Find bundled SNMP simulator examples for context indexing, Cisco routers, Windows 2000, and multiple walk recordings.
Resources and Reference
Find the original SNMP, MIB, Java, and iReasoning reference links included in the simulator user guide.
Legal Notices
Copyright and ownership notices for the iReasoning SNMP Agent Simulator user guide.