Nutzer-Workflow

Typischer End-to-End-Ablauf für einen Agent-Administrator, von der Anmeldung bis zum laufenden Betrieb.

1. Login

Aufruf der Weboberfläche (/) leitet auf /login/ um. Das Login-Formular schickt die Zugangsdaten per POST /j_security_check.

  • Passwort wird optional mit dem Digest aus /json/backend/hmac.js als MD5-HMAC verschlüsselt (j_passwordtype=hmac), Fallback ist plain.
  • Erfolgsantwort: {"success":true,"message":"/index.html"} + Session-Cookie AGENTSESSIONID.
  • Danach lädt der Client Berechtigungen (/json/backend/getLogin) und Agent-Identität (/json/system/agentInfo).
2. Netzwerk und SNMP einrichten

Vor der ersten Suche werden Proxy, ICMP-/SNMP-Threads sowie Community-Strings konfiguriert.

  • Netzwerk-Parameter: /json/system/networkConfig
  • SNMP-Profile / Versionen: /json/system/snmpConfig, /json/master/enums/snmpVersions
  • Optional: IP-Range-Liste importieren (/json/system/importIpRangeList)
3. Geräte-Discovery

Ein Netzwerk-Scan wird per POST /json/network/runNetworkScan angestoßen. Gefundene Geräte tauchen unter /json/devices/foundPrintDevicesPaging und /json/devices/foundOtherDevicesPaging auf.

  • Einzelgerät hinzufügen: POST /json/devices/addDevice
  • Bulk-Import: POST /json/devices/importDeviceList
  • SNMP-Walk manuell auslösen: POST /json/agentsData/doWalk
4. Gruppen, Standorte, Empfänger

Geräte werden in Gerätegruppen und Standorten organisiert; Benachrichtigungs-Empfänger werden separat oder aus Gerätegruppen abgeleitet.

  • Gerätegruppen: /json/devices/deviceGroups
  • Empfängergruppen aus Gerätegruppen: POST /json/master/contacts/createRecipientGroupsFromDeviceGroups
  • Standorte / Kunden / Logins: /json/master/contacts/locations|customer|client|logins
5. Schwellenwerte und Alerts

Toner-Nachbestellung folgt konfigurierbaren Schwellenwerten (Prozentwerte für Mono, Color, Fuser, Waste, OPC etc.). Alarmregeln stecken in Alert-Sets.

  • Schwellen: /json/system/tonerThresholds
  • Alert-Sets: /json/system/alertSets, /json/system/alertSetEntries
  • Event-Verhalten: /json/system/eventConfig
6. Überwachung im Betrieb

Der Agent liest zyklisch Zählerstände und Füllstände. Ergebnisse laufen in Statistiken, Alerts und Tickets.

  • Zähler-Historie: /json/statistics/counterHistory|counterDaily|counterHourly
  • Füllstände: /json/statistics/levelHistory|levelGraphicalHistory
  • Alerts: /json/statistics/alertHistory
  • Aufträge: /json/statistics/getOrders|orderHistory
  • Tickets als HTML: /json/statistics/getHTMLTicket?agentId=…
7. Wartung

Regelmäßige oder anlassbezogene Wartungsaktionen laufen über den Systembereich.

  • Backup starten: POST /json/system/runBackup
  • Update einspielen: POST /json/system/loadUpdate
  • Zertifikate: /json/system/generateCert|uploadCert
  • Service-Neustart: POST /json/system/restartService
  • Log-Ansicht: /json/system/getLog?logfile=full