You can view the settings; only an Admin can change them.
Settings apply as soon as you save, without restarting the gateway. Only a change of a server's
connection settings (enable/disable, port, ASDU sizes, serial line) restarts that one server; you are
asked first if connected masters would have to reconnect. k, w and t0-t3 apply to open connections.
IEC 60870-5-104 (TCP)
Applies immediately (no restart): connected masters that are no longer allowed are disconnected. This computer (localhost) is always allowed.
Off (default): every connected master receives its own copy of every event. On: the masters of one group share one event buffer; only the connection that sent STARTDT last receives data, the others of the group stay in STOPDT standby and take over without losing events. Applies immediately; masters whose group changes are disconnected once and reconnect.
One group per line (or separated by ;): an optional name, '=', then the master IP addresses separated by commas. A master can be in one group only and must be an allowed master.
Off (default): masters connect without encryption on the TCP port above. On: a second listener on the TLS port accepts encrypted connections (TLS 1.2/1.3) with the server certificate below. The plain port stays available unless you switch it off, so masters can be moved to TLS one at a time. Allowed masters, connection limit, redundancy groups and the event buffer are shared by both listeners. Switching TLS or a listener on/off or changing the TLS port restarts the IEC 104 server; certificate settings apply to the next connections without a restart (to renew a certificate, replace the file and save).
19998 per IEC 62351-3.
Untick for TLS-only operation.
A master is accepted when its certificate is issued by the trusted CA or its thumbprint is listed (at least one of the two is needed). Revocation lists are not checked.
IEC 60870-5-101 (Serial)
Balanced mode
Command Options (shared 104/101)
Select-before-operate: the execute must follow the select within this time (1-60 s). Applies to the next command.
Default pulse times (10-60000 ms) for mappings with "pulse commands" or separate open/close outputs that don't set their own.
ASDU Parameters (shared 104/101)
APCI Parameters (IEC 104 timeouts)
Time tags and clock synchronization
Setting the clock needs the service's administrator rights (Windows) or CAP_SYS_TIME (Linux). Leave it off when the computer uses NTP.
Events and energy counters
Events kept while no master is connected (oldest dropped when full). Changing it restarts the IEC 101 link only.
Freeze and send all integrated totals every n seconds (0 = only on counter interrogation).
Off (default): buffered events are lost when the service stops. On: the events waiting for a master (IEC 104 buffer and redundancy groups, IEC 101 class 1) are written to event-buffer.db in the data folder every second and delivered to the first master after a restart or power loss. At most the last second of events (and events sent but not yet acknowledged) can be lost. Applies immediately; switching it off deletes the saved events.
Buffered events older than this are discarded (0 = keep them; the buffer size still limits them). Applies only while the event buffer is saved to disk.
Device communication status points
A status point is a single point (M_SP_NA_1) per device at the CA/IOA entered in the device: ON while the device answers, OFF when it is offline (connection or poll cycle failed), invalid (IV) while it is not polled (disabled). It is sent spontaneously on change and included in interrogation. Off by default; a device needs a status IOA and its status point set to "on" or "gateway default". Applies immediately.
Historian Settings
Default: 72h (3 days). Max: 8760h (1 year)
Alerts (webhook / syslog)
Off by default. When on, the events ticked below are sent over the channels switched on below. Sending never slows down the gateway: alerts are queued and delivered in the background, failed webhook calls are retried. Applies when you save.
Events
0-86400. At most one alert of the same kind about the same device / master / server within this time; the ones in between are counted and mentioned in the next alert. Also at most 30 alerts a minute in total.
Webhook
http:// or https:// only, no user name or password in the URL. Body: {"event", "severity", "time", "message", "details", "gateway", "suppressed"}. Redirects are not followed.
Stored encrypted (Windows), never shown again and never exported.
Signature: sha256=HMAC(secret, X-MaxIEC-Timestamp + "." + body). Header: e.g. Authorization with the secret "Bearer abc...", or X-Api-Key.
0-10, after 2, 4, 8 ... s (at most 60 s). Network errors, timeouts, HTTP 408, 429 and 5xx are retried.
The test alert uses the saved settings (save first) and is sent even while "Send alerts" is off.
Recent deliveries
Time
Event
Channel
Result
Message
No alerts sent yet.
Users, audit log and metrics
Off by default: only the admin account exists, as before. On: add users on the Users page with the role Viewer (sees everything, changes nothing), Operator (Viewer + enable/disable devices, clear traffic logs, re-apply saved settings, re-check the license) or Admin (everything). The admin account stays and is always an Admin. Switching it off signs the other users out (they are kept).
Off by default (also available without multi-user mode). Records who did what, when and from which address: logins (also failed ones), logouts, setting changes (which settings, never passwords or secrets), device / mapping changes, imports and exports, license activation, user management, and every IEC command received (CA, IOA, type, value, result, master). Stored in audit.db; see Audit log.
1-3650 days (default 90) and 1000-1000000 entries (default 100000); older entries are deleted once an hour.
Off by default (the address then doesn't exist). On: Prometheus scrapes http(s)://<gateway>:<dashboard port>/metrics with the header Authorization: Bearer <token> (bearer_token / authorization in the scrape config). Metrics: gateway up, version, uptime, license and bridging state, per-device poll success/failure, response time and online state, IEC 104 connections and IEC 101 link, events sent / buffered / dropped, commands received / succeeded / failed, TLS handshake failures, alert counters.
Dashboard address (web)
Applied without restarting the gateway; your browser is sent to the new address.
Configuration Import / Export
Export or import device and mapping configurations as JSON.
About
Max IEC Gateway Version: -
Update Available! Version is available.
Download Now