Quelltext der Seite UTM/CLI/Cluster 08.2023

{{Archivhinweis|UTM/CLI/Cluster|pre=12.6.1}}
{{Set_lang}}

{{#vardefine:headerIcon|spicon-utm}}

{{var	| display
		| CLI-Befehl: cluster
		| CLI command: cluster }}
{{var	| head
		| Syntax des CLI-Befehls ''cluster''
		| Syntax of the CLI command ''cluster'' }}
{{var	| CLI-Befehle
		| CLI Befehle
		| CLI commands }}
{{var	| cli-befehle--desc
		| Im folgenden werden Befehle für die Securepoint CLI beschrieben.
		| The following describes commands for the Securepoint CLI. }}
{{var	| cli-befehl
		| CLI Befehl
		| CLI command }}
{{var	| Ausgabe
		| Ausgabe
		| Output }}
{{var	| cli--cluster-info--desc
		| Der Cluster State gibt an wer im Cluster gerade Master oder Backup ist oder ob der Cluster überhaupt aktiv ist. Die Ausgabe bezieht sich immer auf die Maschine, auf der dieser Befehl ausführt wird.
		| The cluster state indicates who in the cluster is currently master or backup or whether the cluster is active at all. The output always refers to the machine on which this command is executed. }}
{{var	| cli--sync-state
		| Gibt an, in welchem Zustand sich die Konfiguration befindet. Dabei bedeutet ''synchronized'', das sie auf beiden UTMS des Clusters gleich ist. Der Zustand „pending“ bedeutet, die UTMs haben einen unterschiedlichen Stand. In beiden Fällen können die Mitglieder miteinander kommunizieren. Der Zustand „error“ weist darauf hin das sie keine Daten austauschen können. Das könnte der Fall sein, wenn kein Hotwire Interface konfiguriert ist, die Verkabelung nicht korrekt ist, die SSH Keys nicht ausgetauscht wurden, oder falsche SSH Keys verwendet werden.
		| Indicates the status of the configuration. ''Synchronized'' means that it is the same on both UTMs of the cluster. The state "pending" means that the UTMs have a different state. In both cases the members can communicate with each other. The state "error" shows that they cannot exchange data. This could be the case if no hotwire interface is configured, the wiring is not correct, the SSH keys have not been exchanged, or the wrong SSH keys are used. }}
{{var	| cli--hotwire
		| Gibt das Interface an, auf dem das Hotwire Interface konfiguriert ist.
		| Specifies the interface on which the Hotwire interface is configured. }}
{{var	| cli--config-save
		| Falls in der CLI eine Konfigurationsänderung durchgeführt wurde, muss diese erst lokal gespeichert werden. Erst dann wird eine Synchronisierung des Clusters übertragen.
		| 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. }}
{{var	| cli--config-sync
		| Durch diesen Befehl kann die jeweilige Start-Konfiguration über die Hotwire Schnittstelle an den Cluster Partner übertragen werden. <br> {{Hinweis-box||g}} Dabei wird die Konfiguration von der UTM verwendet, auf der der Befehl ausgeführt wird.<br> {{Hinweis-box||gr}}Ein Artikel zu den ''system''-Befehlen findet sich [[UTM/CLI/System | hier]].
		| With this command the respective start configuration can be transferred to the Cluster Partner via the Hotwire interface.<br> {{Hinweis-box||g}} The configuration from the UTM on which the command is executed is used.<br> {{Hinweis-box||gr}} An article of ''system'' commands can be found [[UTM/CLI/System | here]]. }}
{{var	| cli--value-get
		| Zeigt den Delay in Sekunden an, bevor im Fehlerfall, von Master auf Backup geschaltet wird. Der Standardwert ist 2 Sekunden.
		| Displays the delay in seconds before switching from master to backup in case of an error. The default value is 2 seconds. }}
{{var	| cli--value-set
		| Verändert den Delay, für den Fehlerfall, das von Master auf Backup 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. <br> {{Hinweis-box||g}} Die Einstellung ist sofort aktiv und kann via ''system config synchronize'' auf den Partner übertragen werden.
		| Changes the delay, for the case of an error, which is switched from master to backup. 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. <br>{{Hinweis-box||g}} The setting is immediately active and can be transferred to the partner via ''system config synchronize''. }}
{{var	| Wartungsmodus
		| Wartungsmodus
		| Maintenance Mode }}
{{var	| CLI-Wartungsmodus aktivieren--desc
		| Aktiviert den Wartungsmodus<br>
* 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 {{Menu|Netzwerk|Clusterkonfiguration|Anwendungen}} konfiguriert
* Die UTM ist im Wartungsmodus nicht über die virtuelle IP sondern nur über eine feste IP-Adresse erreichbar 
		| Activates the maintenance mode<br>
* 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 {{Menu|Network|Cluster configuration|Applications}}.
* The UTM is not accessible via the virtual IP in maintenance mode, but only via a fixed IP address. }}
{{var	| CLI-Wartungsmodus deaktivieren--desc
		| Deaktiviert den Wartungsmodus
		| Disables the maintenance mode }}
{{var	| Zustand Wartungsmodus Master--desc
		| Zustand während des gesetzten "Maintainance Mode" auf der '''Master'''
		| State during the set "Maintainance Mode" on the '''Master''' }}
{{var	| Zustand Wartungsmodus Spare--desc
		| Zustand während des gesetzten "Maintenance Mode" auf der '''Spare'''
		| State during the set "Maintenance Mode" on the '''Spare''' }}

----
{{var	| 
		| 
		|  }}

{{var	| neu--Verweis system
		| Verweis auf die [[#system-Befehl | ''system''-Befehle]]
		| Reference to the [[#system-Befehl | ''system'' commands]] }}

</div><noinclude>{{Select_lang}}{{TOC2}}
{{Header|08.2023|
* {{#var:neu--Verweis system}}
||{{Menu|Extras|CLI}}
}}
----
</noinclude>


=== {{#var:CLI-Befehle}} ===
<div class="Einrücken">
{{#var:cli-befehle--desc}}
</div>

{| class="sptable2 pd5 Einrücken"
|-
! style="min-width: 180px;" | {{#var:cli-befehl}} !! style="min-width: 225px;" | {{#var:Ausgabe}} !! {{#var:desc}}
|-
| rowspan="3" | {{code|cli>&ensp;'''cluster info'''|boldcode}} || {{code|{{td|cluster_state| &#8739;master<br>&ensp;''backup<br>&ensp;none''|w=110px}} }} || {{#var:cli--cluster-info--desc}}
|-
| style="width: 240px;" | {{code|{{td|sync_state | &#8739;synchronized<br>&ensp;''pending<br>&ensp;error''|w=110px}} }} || {{#var:cli--sync-state}}
|-
| {{code|{{td|hotwire_dev | &#8739;eth''x''|w=110px}} }} || {{#var:cli--hotwire}}
|-
| {{code|cli&gt;&ensp;'''system config save name &lt;Name der Konfiguration&gt;'''|boldcode inline-block}} || || {{#var:cli--config-save}}
|-
| <span id=system-Befehl></span> {{code|cli&gt;&ensp;'''system config synchronize'''|boldcode inline-block}} || || {{#var:cli--config-sync}}
|-
| {{code|cli&gt;&ensp;'''extc value get application "securepoint_firewall" variable "UPDATE_TRIGGER_DELAY"'''|boldcode inline-block}} || {{code| Value &#8739;2}} || {{#var:cli--value-get}}
|-
| {{code|cli&gt;&ensp;'''extc value set application "securepoint_firewall" variable "UPDATE_TRIGGER_DELAY" value 2'''|boldcode inline-block}} || {{code|OK}} || {{#var:cli--value-set}}
|- class="Leerzeile"
| 
==== {{#var:Wartungsmodus}} ====
|-
| class=mw23 | {{code|cli&gt; '''cluster maintainance''' set value "'''1'''" <br>cli&gt; system update interface|boldcode inline-block}} || {{code|OK}} || {{#var:CLI-Wartungsmodus aktivieren--desc}}
|-
| {{code|cli&gt; '''cluster maintainance''' set value "'''0'''" <br>cli&gt; system update interface|boldcode inline-block}} 
| {{code|OK}} || {{#var:CLI-Wartungsmodus deaktivieren--desc}}
|-
| <i class="host utm">Master</i><br> {{code|cli&gt; '''cluster info'''|boldcode inline-block}} ||<pre>attribute    |value
-------------+-----
cluster_state|backup
sync_state   |synchronized
hotwire_dev  |eth2 
maintainance |true </pre> 
| {{#var:Zustand Wartungsmodus Master--desc}}
|-
| <i class="host utm">Spare</i><br>{{code|cli&gt; '''cluster info'''|boldcode inline-block}} 
| <pre>attribute    |value
-------------+-----
cluster_state|master
sync_state   |synchronized
hotwire_dev  |eth2 
maintainance |false</pre>
| {{#var:Zustand Wartungsmodus Spare--desc}}
|}