# dirmgr/slamd architecture

> Architecture diagram of the GitHub repository dirmgr/slamd, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dirmgr/slamd
- Repository: https://github.com/dirmgr/slamd

## Overview

SLAMD is a distributed load-generation and performance-analysis system. Its principal workflow is to configure and schedule a job through the web interface, distribute execution across client processes, exercise a target service, and collect statistics for review and export. The implementation also supports client-manager-controlled client creation, resource monitoring, job groups, scripted/custom jobs, and several protocol families. The README documents the product workflow; sampled source and the SOURCE INDEX support selected internal links, while unsampled subsystem wiring is left out rather than inferred.

Main entry points: [`src/com/slamd/job/JobClass.java`](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/job/JobClass.java) (Job classes), [`src/com/slamd/admin/AdminServlet.java`](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/admin/AdminServlet.java) (Web administration), [`src/com/slamd/server/SLAMDServer.java`](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/SLAMDServer.java) (SLAMD server), [`src/com/slamd/client/Client.java`](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/client/Client.java) (Load client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Administration"]
  node_web["Web administration<br/>[AdminServlet.java]"]
  node_access["Access control<br/>[AccessManager.java]"]
  node_database[("SLAMD database<br/>[SLAMDDB.java]")]
end

subgraph group_control["Job control"]
  node_server["SLAMD server<br/>[SLAMDServer.java]"]
  node_scheduler["Job scheduler<br/>[Scheduler.java]"]
  node_clientlistener["Client listener"]
  node_managerlistener["Manager listener"]
  node_managerconnection["Manager connection"]
end

subgraph group_runtime["Execution"]
  node_clientmanager["Client manager<br/>[ClientManager.java]"]
  node_client["Load client<br/>[Client.java]"]
  node_job["Job runtime<br/>[Job.java]"]
end

subgraph group_results["Measurement and results"]
  node_monitor["Resource monitors"]
  node_stats["Statistics<br/>[StatTracker.java]"]
  node_realtime["Live statistics"]
  node_reports["Result reports"]
end

subgraph group_extensions["Jobs and integrations"]
  node_jobclass["Job classes<br/>[JobClass.java]"]
  node_ldapjobs["LDAP workloads"]
  node_otherjobs["Other workloads"]
  node_scripting["Scripted jobs"]
end

node_operator(("Operator"))
node_target(("Target service"))

node_operator -->|"configures jobs"| node_web
node_web -->|"schedules jobs"| node_scheduler
node_web -->|"creates database"| node_database
node_web -.->|"checks permissions"| node_access
node_server -.->|"accepts clients"| node_clientlistener
node_server -->|"accepts managers"| node_managerlistener
node_managerlistener -->|"registers connection"| node_managerconnection
node_managerconnection -->|"controls instances"| node_clientmanager
node_scheduler -->|"dispatches jobs"| node_client
node_client -->|"creates and starts"| node_job
node_job -->|"runs job threads"| node_jobclass
node_jobclass -->|"specialized workloads"| node_ldapjobs
node_jobclass -->|"specialized workloads"| node_otherjobs
node_jobclass -->|"supports custom jobs"| node_scripting
node_ldapjobs -->|"generates LDAP load"| node_target
node_otherjobs -->|"tests services"| node_target
node_client -->|"collects statistics"| node_stats
node_jobclass -->|"reports live stats"| node_realtime
node_realtime -->|"sends statistics"| node_server
node_monitor -->|"sends measurements"| node_server
node_stats -.->|"supplies results"| node_reports
node_operator -->|"reviews results"| node_reports

click node_web "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/admin/AdminServlet.java"
click node_access "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/admin/AccessManager.java"
click node_database "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/db/SLAMDDB.java"
click node_server "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/SLAMDServer.java"
click node_scheduler "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/Scheduler.java"
click node_clientlistener "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/ClientListener.java"
click node_managerlistener "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/ClientManagerListener.java"
click node_managerconnection "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/ClientManagerConnection.java"
click node_clientmanager "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/clientmanager/ClientManager.java"
click node_client "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/client/Client.java"
click node_job "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/job/Job.java"
click node_jobclass "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/job/JobClass.java"
click node_ldapjobs "https://github.com/dirmgr/slamd/tree/master/src/com/slamd/jobs/ldap"
click node_otherjobs "https://github.com/dirmgr/slamd/tree/master/src/com/slamd/jobs"
click node_scripting "https://github.com/dirmgr/slamd/tree/master/src/com/slamd/scripting"
click node_monitor "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/resourcemonitor/ResourceMonitorClient.java"
click node_stats "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/stat/StatTracker.java"
click node_realtime "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/stat/RealTimeStatReporter.java"
click node_reports "https://github.com/dirmgr/slamd/blob/master/src/com/slamd/report/ReportGenerator.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_access,node_database toneBlue
class node_server,node_scheduler,node_clientlistener,node_managerlistener,node_managerconnection toneAmber
class node_clientmanager,node_client,node_job toneMint
class node_monitor,node_stats,node_realtime,node_reports toneRose
class node_jobclass,node_ldapjobs,node_otherjobs,node_scripting,node_operator,node_target toneIndigo
```

## Components

### Administration

- [Web administration](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/admin/AdminServlet.java): `src/com/slamd/admin/AdminServlet.java`
- [Access control](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/admin/AccessManager.java): `src/com/slamd/admin/AccessManager.java`
- [SLAMD database](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/db/SLAMDDB.java): `src/com/slamd/db/SLAMDDB.java`

### Job control

- [SLAMD server](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/SLAMDServer.java): `src/com/slamd/server/SLAMDServer.java`
- [Job scheduler](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/Scheduler.java): `src/com/slamd/server/Scheduler.java`
- [Client listener](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/ClientListener.java): `src/com/slamd/server/ClientListener.java`
- [Manager listener](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/ClientManagerListener.java): `src/com/slamd/server/ClientManagerListener.java`
- [Manager connection](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/server/ClientManagerConnection.java): `src/com/slamd/server/ClientManagerConnection.java`

### Execution

- [Client manager](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/clientmanager/ClientManager.java): `src/com/slamd/clientmanager/ClientManager.java`
- [Load client](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/client/Client.java): `src/com/slamd/client/Client.java`
- [Job runtime](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/job/Job.java): `src/com/slamd/job/Job.java`

### Measurement and results

- [Resource monitors](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/resourcemonitor/ResourceMonitorClient.java): `src/com/slamd/resourcemonitor/ResourceMonitorClient.java`
- [Statistics](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/stat/StatTracker.java): `src/com/slamd/stat/StatTracker.java`
- [Live statistics](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/stat/RealTimeStatReporter.java): `src/com/slamd/stat/RealTimeStatReporter.java`
- [Result reports](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/report/ReportGenerator.java): `src/com/slamd/report/ReportGenerator.java`

### Jobs and integrations

- [Job classes](https://github.com/dirmgr/slamd/blob/master/src/com/slamd/job/JobClass.java): `src/com/slamd/job/JobClass.java`
- [LDAP workloads](https://github.com/dirmgr/slamd/tree/master/src/com/slamd/jobs/ldap): `src/com/slamd/jobs/ldap`
- [Other workloads](https://github.com/dirmgr/slamd/tree/master/src/com/slamd/jobs): `src/com/slamd/jobs`
- [Scripted jobs](https://github.com/dirmgr/slamd/tree/master/src/com/slamd/scripting): `src/com/slamd/scripting`

### Other components

- **Operator**
- **Target service**

## Connections

- Operator → Web administration: configures jobs (evidence: `README.md`)
- Web administration → Job scheduler: schedules jobs (evidence: `README.md`)
- Web administration → SLAMD database: creates database (evidence: `README.md`)
- Web administration → Access control: checks permissions (evidence: `src/com/slamd/admin/AccessManager.java`)
- SLAMD server → Client listener: accepts clients (evidence: `src/com/slamd/server/SLAMDServer.java`)
- SLAMD server → Manager listener: accepts managers (evidence: `src/com/slamd/server/ClientManagerListener.java`)
- Manager listener → Manager connection: registers connection (evidence: `src/com/slamd/server/ClientManagerListener.java`)
- Manager connection → Client manager: controls instances (evidence: `src/com/slamd/server/ClientManagerConnection.java`)
- Job scheduler → Load client: dispatches jobs (evidence: `README.md`)
- Load client → Job runtime: creates and starts (evidence: `src/com/slamd/client/Client.java`)
- Job runtime → Job classes: runs job threads (evidence: `src/com/slamd/job/JobClass.java`)
- Job classes → LDAP workloads: specialized workloads (evidence: `README.md`)
- Job classes → Other workloads: specialized workloads (evidence: `README.md`)
- Job classes → Scripted jobs: supports custom jobs (evidence: `README.md`)
- LDAP workloads → Target service: generates LDAP load (evidence: `README.md`)
- Other workloads → Target service: tests services (evidence: `README.md`)
- Load client → Statistics: collects statistics (evidence: `src/com/slamd/client/Client.java`)
- Job classes → Live statistics: reports live stats (evidence: `src/com/slamd/job/JobClass.java`)
- Live statistics → SLAMD server: sends statistics (evidence: `src/com/slamd/stat/RealTimeStatReporter.java`)
- Resource monitors → SLAMD server: sends measurements (evidence: `README.md`)
- Statistics → Result reports: supplies results
- Operator → Result reports: reviews results (evidence: `README.md`)
