Aller au contenu principal

Présentation du guide d'administration

Deux façons d'administrer Zaris

Chaque tâche opérationnelle de ce guide peut être pilotée depuis PowerShell (les cmdlets AdminShell Zr*) ou la console web. Chaque page de tâche présente les deux, côte à côte, dans des onglets PowerShell / console web — choisissez celui que vous préférez, il reste sélectionné d'une page à l'autre. Quelques éléments ne s'appliquent qu'à une seule interface, et ils sont signalés.

Ce guide vous montre comment créer, exécuter et gérer des stores Clustron Zaris depuis le module PowerShell AdminShell. Il couvre les tâches opérationnelles du quotidien : se connecter aux managers, créer et démarrer des stores, s'exécuter sur plusieurs nœuds, comprendre les ports, ainsi que surveiller et dépanner un cluster en production.

Un store est une base de données clé-valeur distribuée composée d'un ou plusieurs nœuds. Vous administrez un store via des managers — des services du plan de contrôle qui créent les nœuds et les démarrent, les arrêtent et en rendent compte. Vous ne modifiez jamais directement les fichiers de configuration des nœuds ; vous émettez des cmdlets, et les managers appliquent le changement à travers le cluster.

Le flux de travail administratif​

La gestion d'un store suit toujours le même ordre. Chaque étape dépend de la précédente.

  1. Activez un espace de travail avec New-ZrWorkspace <name> @('host:7801') -Activate (ou Use-ZrWorkspace pour un espace qui existe déjà). Sans -Activate, l'espace de travail est seulement enregistré, pas rendu actif. Cela pointe toutes les autres cmdlets d'administration vers les managers du cluster.
  2. Créez le store avec New-ZrStore. Cela enregistre la topologie des nœuds mais ne démarre rien.
  3. Démarrez le store avec Start-ZrStore. Cela lance les nœuds et forme le cluster.
  4. Vérifiez et surveillez avec Get-ZrStore et Watch-ZrStoreMetrics.
  5. Arrêtez le store avec Stop-ZrStore lorsque vous n'en avez plus besoin.

Managers et nœuds​

Clustron sépare le plan de contrôle du plan de données.

  • Un manager s'exécute sur chaque serveur, écoute sur le port de gestion (par défaut 7801) et contrôle les stores de ce serveur. Il crée, démarre et arrête les nœuds, et rend compte de leur état.
  • Un nœud (aussi appelé instance de store) est un processus en cours d'exécution qui détient les données et se coordonne avec les autres nœuds du store. Chaque nœud écoute sur son propre port cluster et port client.
Server
  ├── Manager (7801)
  └── Node(s) (cluster port + client port each)

Un manager s'exécute par serveur. Dans un cluster qui s'étend sur plusieurs serveurs, vous vous connectez à tous les managers en même temps afin que chaque changement administratif soit appliqué de façon cohérente à travers l'ensemble du cluster.

Les cmdlets AdminShell​

Vous administrez Zaris avec le module PowerShell Clustron.Zaris.AdminShell. Importez-le une fois par session :

Import-Module Clustron.Zaris.AdminShell

Les cmdlets principales correspondent directement au flux de travail ci-dessus.

CmdletObjectif
New-ZrWorkspace <name> @('host:7801') -ActivateCréer et activer un espace de travail ciblant un ou plusieurs managers (-Activate en fait la cible de la session ; omettez-le pour seulement enregistrer)
Use-ZrWorkspaceRéactiver ou rejoindre un espace de travail existant
New-ZrStoreCréer un store et sa topologie de nœuds
Start-ZrStoreDémarrer tous les nœuds d'un store, ou un nœud nommé
Stop-ZrStoreArrêter tous les nœuds d'un store, ou un nœud nommé
Get-ZrStoreRendre compte de l'état du store, du nombre de nœuds et de la santé
Watch-ZrStoreMetricsAfficher le débit et la latence en direct par nœud

Topologies à serveur unique et à serveurs multiples​

Vous pouvez exécuter Zaris sur un seul serveur ou sur plusieurs. La topologie que vous choisissez détermine la façon dont vous définissez -PartitionsPerNode et -ReplicationFactor lors de la création du store.

  • Serveur unique, plusieurs nœuds. Un manager exécute plusieurs processus de nœud sur la même machine, contrôlés avec -PartitionsPerNode (et le facteur de réplication). Utilisez cela pour le développement et les tests.
  • Serveurs multiples. Un manager s'exécute sur chaque serveur, et chaque serveur exécute sa part des partitions et des réplicas. Utilisez cela pour la production, une capacité supérieure et la tolérance aux pannes.

Les deux modèles sont traités en détail dans Configuration multi-nœuds.

Les ports en un coup d'œil​

Un serveur Zaris divise la plage 7801–7899 en trois intervalles, un par type de trafic. L'installateur ouvre toute la plage dans le pare-feu local.

  • Gestion (7801–7810) — les administrateurs, le plan de contrôle manager-à-manager et la console web (7810).
  • Cluster (7811–7850) — la coordination nœud-à-nœud et le déplacement de données, à partir de -BaseClusterPort (par défaut 7811).
  • Client (7861–7899) — là où les applications et le ClientShell se connectent, à partir de -BaseClientPort (par défaut 7861).

Voir Ports et réseau pour les plages complètes et les recommandations de pare-feu.

Étapes suivantes​