Wechseln zu:Navigation, Suche
Wiki








































Syntax des CLI-Befehls cluster

Letzte Anpassung zur Version: 12.6.1

Neu:
Zuletzt aktualisiert: 
    07.2024
notempty
Dieser Artikel bezieht sich auf eine Beta-Version
Aufruf: UTM-IP:Port oder UTM-URL:Port
Port wie unter Netzwerk / Servereinstellungen / Webserver konfiguriert
Default-Port: 11115
z.B.: https://utm.ttt-point.de:11115
Default: https://192.168.175.1:11115
Extras CLI


CLI Befehle

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

CLI Befehl Ausgabe Beschreibung
cli> cluster info
cluster_state
∣master
backup
 none
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
sync_state
∣synchronized
pending
 error
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
∣ethx
Gibt das Interface an, auf dem das Hotwire Interface konfiguriert ist.
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
Master
cli> cluster info
attribute    |value
-------------+-----
cluster_state|backup
sync_state   |synchronized
hotwire_dev  |eth2 
maintainance |true 
Zustand während des gesetzten Maintainance Mode auf der Primary
Spare
cli> cluster info
attribute    |value
-------------+-----
cluster_state|master
sync_state   |synchronized
hotwire_dev  |eth2 
maintainance |false
Zustand während des gesetzten Maintenance Mode auf der Spare