CLI command: cluster

Syntax of the CLI command cluster

Ostatnia zmiana dla wersji: 14.2.0 (07.2026)

Nowość:

Beta Wyłącznie dla użytkowników korzystających z wersji beta::

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

Zaktualizowano do Przeprojektowanie Interfeju WWW
Command added: cluster maintainance get

notempty

Ten artykuł odnosi się do wersji beta

12.6.1 08.2023

CLI commands

The following describes commands for the Securepoint CLI.

CLI command	Output	Opis
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 Nowość od v14.2.0
	hotwire_dev ∣Ax	Specifies the interface on which the Hotwire interface is configured.
	maintenance ∣false	Gibt an, ob die UTM im Wartungsmodus (true) ist oder nicht (false)
cli> system config save name <Name der Konfiguration>		If a configuration change has been made in the CLI, it must be saved locally first. Only then is a synchronization of the cluster transferred.
cli> system config synchronize		With this command the respective start configuration can be transferred to the Cluster Partner via the Hotwire interface. The configuration from the UTM on which the command is executed is used. An article of system commands can be found here.
cli> extc value get application "securepoint_firewall" variable "UPDATE_TRIGGER_DELAY"	Value ∣2	Displays the delay in seconds before switching from primary to spare in case of an error. The default value is 2 seconds.
cli> extc value set application "securepoint_firewall" variable "UPDATE_TRIGGER_DELAY" value 2	OK	Changes the delay, for the case of an error, which is switched from the primary to the spare. The default value is 2 seconds and should not be set lower. If the appliances in the cluster have a high base load, the value can be set higher. The setting is immediately active and can be transferred to the partner via system config synchronize.
Maintenance Mode
cli> cluster maintainance get	value ----- 1 resp. value ----- 0	Outputs whether maintenance mode is active (1) or not (0)
cli> cluster maintainance set value "1" cli> system update interface	OK	Activates the maintenance mode The maintenance mode is used to switch to the spare in a controlled manner and prevents multiple switching in the case of several individual steps (update, change IP addresses etc.) The services available in maintenance mode are configured in the wizard in step 4 or under Sieć Cluster configuration Obszar Applications. The UTM is not accessible via the virtual IP in maintenance mode, but only via a fixed IP address.
cli> cluster maintainance set value "0" cli> system update interface	OK	Disables the maintenance mode
Primary cli> cluster maintainance set value "1" cli> cluster info	attribute \|value -------------+----- cluster_state\|spare sync_state \|synchronized hotwire_dev \|A2 maintainance \|true	State during the set "Maintainance Mode" on the Primary
Spare cli> cluster info	attribute \|value -------------+----- cluster_state\|primary sync_state \|synchronized hotwire_dev \|A2 maintainance \|false	State during the set "Maintenance Mode" on the Spare

CLI commands

Maintenance Mode