Zum Hauptinhalt springen

Überblick über den Administrationsleitfaden

Zwei Wege, Zaris zu administrieren

Jede operative Aufgabe in diesem Leitfaden lässt sich über PowerShell (die Zr*-AdminShell-Cmdlets) oder die Web-Konsole ausführen. Jede Aufgabenseite zeigt beides nebeneinander in den Tabs PowerShell / Web Console — wählen Sie den bevorzugten, er bleibt seitenübergreifend ausgewählt. Einiges gilt nur für eine der beiden Oberflächen; das ist jeweils gekennzeichnet.

Dieser Leitfaden zeigt Ihnen, wie Sie Clustron-Zaris-Stores mit dem PowerShell-Modul AdminShell erstellen, betreiben und verwalten. Er behandelt die alltäglichen operativen Aufgaben: Verbindung zu Managern herstellen, Stores erstellen und starten, über mehrere Nodes hinweg betreiben, Ports verstehen sowie einen laufenden Cluster überwachen und Fehler beheben.

Ein Store ist eine verteilte Key/Value-Datenbank aus einem oder mehreren Nodes. Sie administrieren einen Store über Manager — Dienste der Steuerungsebene, die die Nodes erstellen und starten, stoppen und deren Status melden. Sie bearbeiten Node-Konfigurationsdateien nie direkt; Sie geben Cmdlets aus, und die Manager wenden die Änderung im gesamten Cluster an.

Der Administrations-Workflow​

Die Verwaltung eines Stores folgt immer derselben Reihenfolge. Jeder Schritt baut auf dem vorherigen auf.

  1. Aktivieren Sie einen Workspace mit New-ZrWorkspace <name> @('host:7801') -Activate (oder Use-ZrWorkspace für einen bereits vorhandenen). Ohne -Activate wird der Workspace nur gespeichert, aber nicht aktiv gesetzt. Damit richten Sie alle anderen Admin-Cmdlets auf die Manager des Clusters aus.
  2. Erstellen Sie den Store mit New-ZrStore. Dies registriert die Node-Topologie, startet aber nichts.
  3. Starten Sie den Store mit Start-ZrStore. Dies startet die Nodes und bildet den Cluster.
  4. Prüfen und überwachen Sie mit Get-ZrStore und Watch-ZrStoreMetrics.
  5. Stoppen Sie den Store mit Stop-ZrStore, wenn Sie ihn nicht mehr benötigen.

Manager und Nodes​

Clustron trennt die Steuerungsebene von der Datenebene.

  • Ein Manager läuft auf jedem Server, lauscht auf dem Management-Port (Standard 7801) und steuert die Stores auf diesem Server. Er erstellt, startet und stoppt Nodes und meldet deren Status.
  • Ein Node (auch Store-Instanz genannt) ist ein laufender Prozess, der Daten hält und sich mit den anderen Nodes des Stores abstimmt. Jeder Node lauscht auf einem eigenen Cluster-Port und Client-Port.
Server
├── Manager (7801)
└── Node(s) (cluster port + client port each)

Pro Server läuft ein Manager. In einem Cluster, der sich über mehrere Server erstreckt, verbinden Sie sich mit allen Managern gleichzeitig, damit jede administrative Änderung konsistent im gesamten Cluster angewendet wird.

Die AdminShell-Cmdlets​

Sie administrieren Zaris mit dem PowerShell-Modul Clustron.Zaris.AdminShell. Importieren Sie es einmal pro Sitzung:

Import-Module Clustron.Zaris.AdminShell

Die Kern-Cmdlets entsprechen direkt dem obigen Workflow.

CmdletZweck
New-ZrWorkspace <name> @('host:7801') -ActivateEinen Workspace erstellen und aktivieren, der auf einen oder mehrere Manager zielt (-Activate macht ihn zum Ziel der Sitzung; ohne wird er nur gespeichert)
Use-ZrWorkspaceEinen bestehenden Workspace reaktivieren oder ihm beitreten
New-ZrStoreEinen Store und seine Node-Topologie erstellen
Start-ZrStoreAlle Nodes eines Stores oder einen benannten Node starten
Stop-ZrStoreAlle Nodes eines Stores oder einen benannten Node stoppen
Get-ZrStoreStore-Status, Node-Anzahl und Zustand melden
Watch-ZrStoreMetricsLive-Durchsatz und -Latenz pro Node anzeigen

Topologien mit einem und mit mehreren Servern​

Sie können Zaris auf einem Server oder über viele hinweg betreiben. Die gewählte Topologie bestimmt, wie Sie -PartitionsPerNode und -ReplicationFactor beim Erstellen des Stores festlegen.

  • Ein Server, mehrere Nodes. Ein Manager betreibt mehrere Node-Prozesse auf derselben Maschine, gesteuert mit -PartitionsPerNode (und dem Replikationsfaktor). Verwenden Sie dies für Entwicklung und Tests.
  • Mehrere Server. Auf jedem Server läuft ein Manager, und jeder Server betreibt seinen Anteil der Partitionen und Replicas. Verwenden Sie dies für Produktion, höhere Kapazität und Ausfallsicherheit.

Beide Modelle werden ausführlich unter Multi-Node-Konfiguration behandelt.

Ports im Überblick​

Ein Zaris-Server teilt den Bereich 7801–7899 in drei Bereiche auf, einen pro Verkehrsart. Der Installer öffnet den gesamten Bereich in der lokalen Firewall.

  • Management (7801–7810) — Administratoren, die Manager-zu-Manager-Steuerungsebene und die Web-Konsole (7810).
  • Cluster (7811–7850) — Node-zu-Node-Koordination und Datenbewegung, ab -BaseClusterPort (Standard 7811).
  • Client (7861–7899) — hier verbinden sich Anwendungen und die ClientShell, ab -BaseClientPort (Standard 7861).

Die vollständigen Bereiche und Firewall-Hinweise finden Sie unter Ports und Netzwerk.

Nächste Schritte​