wrapper.backend.socket.bind.timeout

Kompatibel :3.6.3
Editionen :Professional EditionStandard EditionCommunity Edition
Betriebssysteme :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Der Wrapper verwendet eine Backend-Verbindung (Socket oder Pipe), um mit der überwachten JVM zu kommunizieren. Diese Verbindung wird in der Regel nahezu sofort beim Start aufgebaut, bevor der Wrapper eine JVM startet.

Bei Socket-Verbindungen umfasst ein zusätzlicher Schritt das Binden an die Loopback-Adresse und einen bestimmten Port. In der Regel ist die Loopback-Adresse verfügbar, und der Wrapper wählt den ersten verfügbaren Port innerhalb des konfigurierten Bereichs. In manchen Konfigurationen wurde jedoch beobachtet, dass sich die IPv4- und/oder IPv6-Adressen vorübergehend von ihrer Netzwerkschnittstelle lösen können. Dies kann beispielsweise auftreten, wenn die Loopback-Schnittstelle von systemd-networkd verwaltet wird. Wenn systemd-networkd Konfigurationsänderungen anwendet, baut es die Schnittstellen kurzzeitig ab und konfiguriert sie neu, was in der Regel zu einer Ausfallzeit von wenigen Millisekunden führt, während der die Loopback-Adressen nicht verfügbar sind.

Ab der Wrapper-Version 3.6.3 enthält der Wrapper einen Wiederholungsmechanismus für Situationen, in denen die Adresse während des Bindens nicht verfügbar ist. Die Eigenschaft wrapper.backend.socket.bind.timeout konfiguriert die maximale Dauer in Sekunden für diesen Wiederholungsmechanismus. Wenn das Timeout abläuft, stellt der Wrapper seine Versuche ein und beendet sich.

Unter Unix beträgt der Standardwert 5 Sekunden.

Unter Windows wurden keine ähnlichen Ausfallprobleme beobachtet, daher beträgt der Standardwert 0 Sekunden, wodurch der Wiederholungsmechanismus deaktiviert wird. Dieser Wert kann jedoch bei Bedarf geändert werden.

NOTE

Wenn wrapper.backend.type auf AUTO oder SOCKET gesetzt ist und die Loopback-Adresse für SOCKET_IPv4 oder SOCKET_IPv6 nicht verfügbar ist, blockiert der Wrapper nicht bei diesem Typ. Stattdessen versucht er sofort, eine Verbindung mit dem nächsten Typ in der Fallback-Reihenfolge herzustellen: SOCKET_IPv6, dann SOCKET_IPv4, dann PIPE (falls zutreffend).

Wenn in dem aktuellen Zyklus kein Typ erfolgreich ist, startet der Wiederholungsmechanismus einen neuen Zyklus und setzt dies fort, bis ein geeigneter Typ gefunden wird oder das Timeout eintritt. Dies ermöglicht dem Wrapper eine höhere Reaktionsfähigkeit beim Start.

Es ist auch möglich, wrapper.backend.type auf einen bestimmten Typ zu setzen und diesen Fallback-Mechanismus zu deaktivieren.

Dies ist in den Protokollen zu sehen, wenn das Binden an IPv4- und IPv6-Loopback-Adressen fehlschlägt und wrapper.backend.type auf SOCKET gesetzt ist.

INFO   | 2025/08/01 18:34:40.976 | wrapperp | Could not assign a name to the socket. Waiting 5 seconds...
INFO   | 2025/08/01 18:34:41.082 | wrapperp | Backend server started with SOCKET_IPv4.

Verweis: Port