Aller au contenu principal

Démarrage rapide sous Windows

Cet article installe Clustron Zaris sur un hôte Windows, puis crée un store auquel vous pouvez vous connecter. L'installateur met en place le service de gestion (Management Service), la console web et les modules PowerShell ; vous activez ensuite un espace de travail, créez un store et vous connectez. Tout s'exécute sur une seule machine, et l'API cliente est la même que celle utilisée par tous les autres modes.

remarque

Le mode in-process ne nécessite aucune installation. Si vous voulez seulement un store à l'intérieur de votre application .NET, suivez plutôt Exécuter in-process.

Prérequis​

Vous avez besoin d'une machine Windows avec des privilèges administratifs. L'installateur enregistre des services et ouvre des ports de pare-feu, il doit donc être exécuté en tant qu'administrateur.

1. Télécharger et extraire​

Téléchargez le package Windows depuis la page de téléchargements Clustron :

https://clustron.io/install/

Le package est nommé avec la version de la release, par exemple :

clustron-zaris-2.0.0-win-x64.zip

Extrayez le ZIP dans un dossier de votre choix, par exemple C:\clustron.

2. Exécuter l'installateur en tant qu'administrateur​

Dans le dossier extrait, exécutez install.cmd en tant qu'administrateur. Faites un clic droit sur install.cmd et choisissez Exécuter en tant qu'administrateur, ou exécutez-le depuis un terminal administrateur :

.\install.cmd
attention

L'installateur doit être exécuté en tant qu'administrateur. Sans privilèges administratifs, l'installation échoue.

Ceci enregistre le service de gestion sur le port 7801, la console web sur le port 7810 et les modules PowerShell utilisés pour gérer les stores.

3. Créer un store​

Pour créer un store, vous connectez d'abord un espace de travail au service de gestion et l'activez, puis vous créez le store. La création d'un store ne peut pas avoir lieu avant qu'un espace de travail ne soit actif.

D'abord, pointez un espace de travail vers le service de gestion local et activez-le :

# Point a workspace at the local Management Service and activate it
New-ZrWorkspace -Name local -Managers "localhost:7801" -Activate

Créez ensuite le store. En mode superviseur, le service de gestion fork les processus de nœud pour vous. BaseClusterPort et BaseClientPort sont requis ; BaseClientPort est le port auquel votre application se connecte :

# Create the store (supervisor mode forks the node processes).
# BaseClusterPort/BaseClientPort are REQUIRED. BaseClientPort is what your app connects to.
New-ZrStore -Name orders -ReplicationFactor 2 `
  -BaseClusterPort 7811 -BaseClientPort 7861

L'accent grave (`) à la fin de la première ligne est la continuation de ligne PowerShell.

astuce

Vous pouvez faire la même chose dans la console web à l'adresse http://localhost:7810. Ajoutez le service de gestion dans l'interface et créez le store depuis là — aucune cmdlet nécessaire.

4. Se connecter​

Connectez un client au store sur son port client :

zaris://localhost:7861/orders

Ce que vous venez de faire​

Vous avez installé Zaris sous Windows, activé un espace de travail contre le service de gestion local, créé un store et vous y êtes connecté. À partir d'ici, vous pouvez exploiter le store depuis PowerShell ou la console web, ou vous y connecter depuis vos applications .NET.

Étapes suivantes​