CLI-Befehl: cluster

Syntax des CLI-Befehls cluster

Letzte Anpassung zur Version: 14.2.0 (06.2026)

Neu:

Beta Nur für Teilnehmer am Beta-Channel:

Umbenennung der ~~master~~ in Primary
Geänderte Rückgabewerte bei cluster info

Aktualisierung zum Redesign des Webinterfaces
Befehl ergänzt: cluster maintainance get

notempty

Dieser Artikel bezieht sich auf eine Beta-Version

12.6.1 08.2023

CLI Befehle

Im folgenden werden Befehle für das Securepoint CLI beschrieben.

CLI Befehl	Ausgabe	Beschreibung
cli> cluster info	attribute \|value -------------+----- cluster_state\|primary sync_state \|synchronized hotwire_dev \|A2 maintainance \|false	Cluster Status Meldungen der aktuellen UTM
	cluster_state ∣primary spare disabled	Gibt an welche Rolle eine UTM im Cluster gerade hat: Primary: Gerät ist die aktive Cluster-UTM Spare: Gerät ist die passive Cluster-UTM (Backup bzw. Hot-Standby) disabled: Es ist kein Cluster konfiguriert notempty Rückgabewerte geändert ab v14.2.0
	sync_state ∣synchronized pending error disabled	Gibt an, in welchem Zustand sich die Konfiguration befindet. synchronized: Die Konfiguration ist auf beiden UTMS des Clusters gleich pending: Die Konfiguration der UTMs haben einen unterschiedlichen Stand. In beiden Fällen können die Mitglieder miteinander kommunizieren. error: Die beiden UTMs können keine Daten austauschen Das könnte z.B. der Fall sein, wenn kein Hotwire Interface konfiguriert ist, die Verkabelung nicht korrekt ist, falsche SSH Keys verwendet oder nicht ausgetauscht wurden oder falls die Gegenstelle offline bzw. down ist disabled: Es ist kein Cluster konfiguriert notempty Neu ab v14.2.0
	hotwire_dev ∣Ax	Gibt das Interface an, auf dem das Hotwire Interface konfiguriert ist.
	maintenance ∣false	Gibt an, ob die UTM im Wartungsmodus (true) ist oder nicht (false)
cli> system config save name <Name der Konfiguration>		Falls in der CLI eine Konfigurationsänderung durchgeführt wurde, muss diese erst lokal gespeichert werden. Erst dann wird eine Synchronisierung des Clusters übertragen.
cli> system config synchronize		Durch diesen Befehl kann die jeweilige Start-Konfiguration über die Hotwire Schnittstelle an den Cluster Partner übertragen werden. Dabei wird die Konfiguration von der UTM verwendet, auf der der Befehl ausgeführt wird. Ein Artikel zu den system-Befehlen findet sich hier.
cli> extc value get application "securepoint_firewall" variable "UPDATE_TRIGGER_DELAY"	Value ∣2	Zeigt den Delay in Sekunden an, bevor im Fehlerfall, von der Primary-UTM auf die Spare-UTM geschaltet wird. Der Standardwert ist 2 Sekunden.
cli> extc value set application "securepoint_firewall" variable "UPDATE_TRIGGER_DELAY" value 2	OK	Verändert den Delay, für den Fehlerfall, das von der Primary auf die Spare geschaltet wird. Der Standardwert ist 2 Sekunden und sollte nicht niedriger eingestellt werden. Falls die Appliances im Cluster eine hohe Grundlast haben sollten, kann der Wert höher eingestellt werden. Die Einstellung ist sofort aktiv und kann via system config synchronize auf den Partner übertragen werden.
Wartungsmodus
cli> cluster maintainance get	value ----- 1 bzw. value ----- 0	Gibt aus ob der Wartungsmodus aktiv ist (1) oder nicht (0)
cli> cluster maintainance set value "1" cli> system update interface	OK	Aktiviert den Wartungsmodus Der Wartungsmodus dient dazu, kontrolliert auf die Spare umzuschalten und verhindert mehrfaches Umschwenken bei mehreren Einzelschritten (Update, IP-Adressen ändern etc.) Die im Wartungsmodus zur Verfügung stehenden Dienste werden im Assistenten im Schritt 4 bzw. unter Netzwerk Clusterkonfiguration Bereich Anwendungen konfiguriert Die UTM ist im Wartungsmodus nicht über die virtuelle IP sondern nur über eine feste IP-Adresse erreichbar
cli> cluster maintainance set value "0" cli> system update interface	OK	Deaktiviert den Wartungsmodus
Primary cli> cluster maintainance set value "1" cli> cluster info	attribute \|value -------------+----- cluster_state\|spare sync_state \|synchronized hotwire_dev \|A2 maintainance \|true	Zustand während des gesetzten Maintainance Mode auf der Primary
Spare cli> cluster info	attribute \|value -------------+----- cluster_state\|primary sync_state \|synchronized hotwire_dev \|A2 maintainance \|false	Zustand während des gesetzten Maintenance Mode auf der Spare

CLI Befehle

Wartungsmodus