PrintMaster Agent on PrintMaster Docs

Agent Module Documentation

Mon, 01 Jan 0001 00:00:00 +0000

Location: agent/agent/

The agent module handles network discovery protocols, device detection, SNMP operations, and live discovery methods. It sits between the scanner (device querying) and storage (persistence) layers.

Architecture Overview

agent/
├── detect.go # Main Discover() function, IP enumeration, ARP/ICMP
├── probe.go # TCP port probing, connectivity checks
├── parse.go # SNMP PDU parsing, OID interpretation
├── snmp.go # Legacy SNMP operations (being phased out)
├── snmp_iface.go # SNMP interface definitions
├── mdns.go # mDNS/Bonjour discovery
├── ssdp.go # SSDP/UPnP discovery
├── wsdiscovery.go # WS-Discovery protocol
├── snmptraps.go # SNMP trap listener
├── llmnr.go # LLMNR name resolution
├── arp.go # ARP table reading
├── merge.go # Device data merging and deduplication
├── helpers.go # Utility functions
├── metrics.go # Performance metrics collection
├── report.go # Scan result reporting
├── types.go # Data structures (PrinterInfo, ScanMeta, etc.)
├── config.go # Configuration structures
├── diagnostics.go # Diagnostic logging and debugging
├── update.go # Device update and refresh logic
└── vendor_roots.go # Vendor OID root definitions

Discovery Methods

1. Active Network Scanning (`detect.go`)

Purpose: Enumerate IP addresses and perform liveness checks.

MIB profiles (mib_profiles/) and automation

Mon, 01 Jan 0001 00:00:00 +0000

This document describes the lightweight JSON schema used to store manufacturer MIB profiles, recommended workflow for generating profiles from collected MIB walks, and how profiles can be distributed to agents.

Schema (example keys)

vendor (string): short vendor id, e.g. “hp”
enterprise_oid (string): vendor enterprise prefix, e.g. “1.3.6.1.4.1.11”
version (string): profile version
canonical (map): semantic name -> OID (page_count, serial, supplies roots, etc.)
probes (array): recommended quick probe OIDs that are safe/cheap to GET during discovery
sample_values (map): example values to help human review and tests
notes (string): freeform notes

Storage and runtime plan

REMAINING TASKS

Mon, 01 Jan 0001 00:00:00 +0000

Remaining tasks for Printer MIB pairing & candidate workflows

Overview

This document lists remaining work items, priorities, acceptance criteria, and testing notes for the features implemented during the recent changes: pairing of list columns (name/level) from saved MIB walks, UI flow to inspect saved walks, and persisting candidate mappings.

High-level goals

Let the agent detect and present column-based consumable information (e.g. toner names and levels) from saved MIB walks.
Allow users to persist discovered column mappings into vendor candidate profiles quickly and reliably.
Provide robust normalization and tests for edge-cases across vendors.

Priority tasks

Service Mode - Quick Reference

Mon, 01 Jan 0001 00:00:00 +0000

Overview

PrintMaster Agent can run as a system service for production deployments. This ensures the agent starts automatically on boot and runs continuously in the background.

Commands

# Install service (requires admin/root)
printmaster-agent --service install

# Start service
printmaster-agent --service start

# Stop service
printmaster-agent --service stop

# Uninstall service
printmaster-agent --service uninstall

# Run in foreground (testing)
printmaster-agent --service run

# Interactive mode (default)
printmaster-agent

Platform-Specific Details

Windows

Requirements: Administrator privileges

PrintMaster Agent on PrintMaster Docs

Agent Module Documentation

Architecture Overview

Discovery Methods

1. Active Network Scanning (detect.go)

MIB profiles (mib_profiles/) and automation

REMAINING TASKS

Service Mode - Quick Reference

Overview

Commands

Platform-Specific Details

Windows

1. Active Network Scanning (`detect.go`)