Configurations de Chunkstore

Cette documentation décrit le fonctionnement et la configuration avancée du ChunkStore dans un environnement WRS, incluant la gestion des versions, les règles d’épinglage, le bannissement, ainsi que l’optimisation du stockage et du réseau.

Cette page explique le rôle du ChunkStore d'un WRS et la façon de le configurer depuis W360 Manager : quelles versions de masters il récupère, lesquelles il conserve et comment appliquer une configuration à un WRS.

📘

À qui s'adresse cette page ?

Aux administrateurs W360 qui gèrent un ou plusieurs WRS et veulent contrôler les versions de masters stockées localement sur ces serveurs.


1. Comprendre le ChunkStore

Qu'est-ce que le ChunkStore ?

Le ChunkStore est un composant du WRS. Il stocke les versions de vos masters et les distribue aux postes de travail du site.

Il agit comme un cache local : quand une version est déjà présente sur le WRS, les postes la chargent depuis le réseau local au lieu de la télécharger depuis le serveur upstream. Le démarrage est plus rapide et la bande passante vers l'extérieur est économisée.

Le ChunkStore suit les règles définies dans un fichier de configuration (voir la partie 2). Sans configuration adaptée, le WRS ne récupère pas automatiquement les versions de vos masters.

flowchart LR
    U["Serveur upstream<br/>(versions des masters)"]
    subgraph SITE["Site distant"]
        W["WRS<br/>ChunkStore"]
        P1["Poste de travail"]
        P2["Poste de travail"]
        P3["Poste de travail"]
    end
    U -- "Téléchargement des versions<br/>autorisées par la configuration" --> W
    W -- "Chargement local" --> P1
    W -- "Chargement local" --> P2
    W -- "Chargement local" --> P3
    U -. "Repli si la version est absente<br/>ou bannie sur le WRS" .-> P3

Le WRS sert de cache local : les postes chargent les versions depuis le site. Ils ne passent par le serveur upstream que si la version n'est pas disponible sur le WRS.

Chargement des versions

Le ChunkStore télécharge automatiquement une version demandée par un poste de travail si les deux conditions suivantes sont réunies :

  1. la version est autorisée par le fichier de configuration du ChunkStore ;
  2. la version appartient à un groupe autorisé (champ Authorized group de la configuration).
flowchart TD
    A["Un poste demande une version au WRS"] --> B{"La version est-elle<br/>déjà sur le WRS ?"}
    B -- Oui --> OK["Chargement local depuis le WRS"]
    B -- Non --> C{"Autorisée par la configuration<br/>et dans l'Authorized group ?"}
    C -- Non --> UP["Le poste charge la version<br/>depuis le serveur upstream"]
    C -- Oui --> D["Le ChunkStore télécharge la version<br/>(réutilise les blocs déjà présents)"]
    D --> E{"Téléchargement valide ?"}
    E -- Oui --> OK
    E -- "Non (ChunkMissing, hash incorrect,<br/>version vide, données corrompues)" --> BAN["Version bannie"]
    BAN --> UP

Les téléchargements se font un par un, pour ménager le disque du WRS. Le ChunkStore réutilise les blocs (chunks) déjà présents : si une nouvelle version partage des blocs avec une version stockée, seuls les blocs manquants sont téléchargés.

⚠️

Version absente

Si une version demandée n'existe pas sur la source, une erreur ChunkMissing est renvoyée. La version est alors bannie côté C4 et son téléchargement est arrêté définitivement.

Gestion des erreurs et bannissement

Le ChunkStore bannit automatiquement une version dans les cas suivants :

CasExplication
Chunks invalides ou hash incorrectLes blocs reçus ne correspondent pas à leur empreinte attendue.
Version vide (nullRaw)La version ne contient aucune donnée exploitable.
Téléchargement incomplet ou corrompuLe transfert s'est interrompu ou les données sont altérées.

Conséquence pour l'utilisateur : le poste de travail passe automatiquement sur le serveur upstream pour charger la version. Il ne voit pas d'interruption, mais le chargement est plus lent.

Lever un bannissement : vous pouvez débannir une version à la main depuis l'interface d'administration, y compris plusieurs versions à la fois.


Versions épinglées

Une version épinglée (ou « punaisée ») reste sur le ChunkStore même si elle ne respecte plus les règles de configuration : elle ne sera jamais supprimée automatiquement.

💡

Bonne pratique

Épinglez les versions critiques, par exemple une version racine (root) qui contient de nombreux blocs partagés avec les autres versions. Ces blocs restent ainsi disponibles et accélèrent le téléchargement des versions suivantes.


Gestion de la bande passante

Vous pouvez limiter la bande passante utilisée par le ChunkStore grâce à des tâches planifiées (cron), par exemple pour que les téléchargements aient lieu en dehors des heures de travail.



2. Le fichier de configuration du ChunkStore

Chaque ChunkStore peut être associé à un fichier de configuration. Ce fichier indique au WRS quelles versions récupérer et lesquelles conserver.

Les champs du fichier

ChampRôleConseil
NomIdentifie la configuration dans la liste.Choisissez un nom explicite qui indique le site ou le WRS, par exemple WRSConfig_Savigny.
GroupeGroupe auquel appartient le fichier de configuration. Le fichier ne pourra être associé qu'aux WRS de ce groupe.Choisissez exactement le même groupe que le WRS (voir l'encadré ci-dessous).
Authorized groupGroupe dont le WRS a le droit de récupérer les versions de masters. Seules les versions des masters de ce groupe (et de ses sous-groupes) sont prises en compte.Pour que le WRS récupère toutes les versions de masters de l'organisation, choisissez le groupe racine.
OptionsComportement du ChunkStore selon les tags des versions (voir ci-dessous).Activez seulement les options utiles, pour ne pas remplir le disque du WRS.
📘

Bien distinguer « Groupe » et « Authorized group »

  • Groupe sert à ranger le fichier de configuration dans votre arborescence.
  • Authorized group indique ce que le WRS a le droit de récupérer.

Si un WRS ne récupère pas les versions d'un master, vérifiez d'abord que ce master appartient bien à l'Authorized group ou à l'un de ses sous-groupes.

Règle importante : le fichier doit être dans le même groupe que le WRS

❗️

Fonctionnement actuel

Un fichier de configuration ne peut être associé à un WRS que s'il se trouve dans le même groupe que ce WRS.

Il n'est donc pas possible aujourd'hui de créer un fichier unique à la racine et de l'associer à tous les WRS de l'organisation. Il faut un fichier de configuration par groupe contenant un WRS.

flowchart TD
    R["Groupe racine"]
    R --> SA["Groupe Site A"]
    R --> SB["Groupe Site B"]

    CR["Fichier de configuration<br/>placé à la racine"]
    CA["Fichier de configuration<br/>placé dans Site A"]
    CB["Fichier de configuration<br/>placé dans Site B"]

    WA["WRS du Site A"]
    WB["WRS du Site B"]

    R -.- CR
    SA --- CA
    SA --- WA
    SB --- CB
    SB --- WB

    CA == "✅ Association possible<br/>(même groupe)" ==> WA
    CB == "✅ Association possible<br/>(même groupe)" ==> WB
    CR -. "❌ Association impossible<br/>(groupe différent)" .-> WA
    CR -. "❌ Association impossible<br/>(groupe différent)" .-> WB

À ne pas confondre : le Groupe du fichier doit être celui du WRS, alors que l'Authorized group peut tout à fait être le groupe racine. Exemple : un fichier placé dans le groupe Site A, avec le groupe racine comme Authorized group, permet au WRS du Site A de récupérer les versions de tous les masters de l'organisation.

📘

Ce fonctionnement ne correspond pas à vos usages ?

Si vous avez besoin d'une configuration commune à plusieurs WRS de groupes différents, vous pouvez envoyer une demande d'amélioration via le support. Elle sera étudiée par nos équipes.

Les options disponibles

Les options s'appliquent aux versions des masters de l'Authorized group :

OptionEffet
Supprimer les versions non taguéesLe ChunkStore supprime automatiquement les versions qui n'ont pas de tag. Les versions épinglées sont conservées.
Charger automatiquement les versions taguées rootLe ChunkStore télécharge à l'avance les versions racines.
Charger automatiquement les versions taguées prodLe ChunkStore télécharge à l'avance les versions de production.
Charger automatiquement les versions taguées pushLe ChunkStore télécharge à l'avance les versions poussées.
Charger automatiquement les versions taguées devLe ChunkStore télécharge à l'avance les versions de développement.

Vous pouvez activer ces règles temporairement, pour adapter le contenu du ChunkStore à un besoin ponctuel (par exemple précharger une nouvelle version de production avant un déploiement).

💡

Exemple de configuration courante

Pour un WRS de site qui doit servir les versions de production :

  • Authorized group : groupe racine de l'organisation ;
  • options activées : Charger automatiquement les versions root et prod ;
  • option Supprimer les versions non taguées activée pour libérer de l'espace disque.

3. Mettre en place une configuration sur un WRS

Il y a trois étapes : créer le fichier, l'associer au WRS, puis appliquer les règles.

flowchart LR
    S1["1. Créer le fichier<br/>dans le groupe du WRS"] --> S2["2. L'associer au WRS<br/>(Disk Service activé)"] --> S3["3. Appliquer les règles<br/>depuis la fiche du WRS"]

Étape 1 : créer le fichier de configuration

  1. Dans W360 Manager, ouvrez le menu Configurations de Chunkstore (1).
  2. Cliquez sur Créer (2).

Création d’un fichier de configuration
  1. Remplissez les champs Nom, Groupe et Authorized group (voir Les champs du fichier). Pour le champ Groupe, choisissez le groupe du WRS : sinon, le fichier ne sera pas proposé à l'étape 2.
  2. Cochez les options souhaitées.
  3. Cliquez sur Enregistrer.

Étape 2 : associer le fichier au WRS

  1. Ouvrez le menu Postes de travail, puis la fiche du WRS concerné.
  2. Cliquez sur Modifier pour passer en mode édition.
  3. Vérifiez que Disk Service est activé. Le champ de configuration n'apparaît que si cette option est activée.
  4. Dans le champ Configuration du Chunkstore, sélectionnez le fichier créé à l'étape 1. Seuls les fichiers du même groupe que le WRS sont proposés.
  5. Cliquez sur Enregistrer.





⚠️

Disk Service désactivé ?

Si la bascule Disk Service est désactivée, le WRS ne fait pas office de ChunkStore et le champ Configuration du Chunkstore n'est pas proposé.

Étape 3 : appliquer les règles

L'enregistrement associe le fichier au WRS, mais les règles ne sont pas appliquées tout de suite. Pour les appliquer :

  1. Revenez sur la fiche du WRS.
  2. Ouvrez le menu « … » (1).
  3. Cliquez sur Appliquer les règles de configuration du Chunkstore (2).

⚠️ Redémarrage du service

Si les règles ne sont pas prises en compte après l'application manuelle, faire un Arrêt du service et un démarrage du service Chunkstore du WRS .



4. Vérifier que la configuration fonctionne

Une fois les règles appliquées :

  • les versions correspondant aux options activées commencent à se télécharger sur le WRS, une par une ;
  • les versions non taguées sont supprimées, si l'option correspondante est activée ;
  • les postes de travail du site chargent les versions depuis le WRS.


5. Questions fréquentes

Mon WRS ne récupère pas les versions d'un master. Que vérifier ?

  1. Le WRS a-t-il bien un fichier de configuration associé (champ Configuration du Chunkstore), créé dans le même groupe que le WRS ?
  2. Le master appartient-il à l'Authorized group ou à l'un de ses sous-groupes ?
  3. Les versions portent-elles un tag correspondant aux options activées (root, prod, push, dev) ?
  4. Les règles ont-elles bien été appliquées (étape 3) ?
  5. La version est-elle bannie ? Si oui, débannissez-la depuis l'interface d'administration.

Une version importante a été supprimée du WRS. Comment l'éviter ?

Épinglez-la : une version épinglée est conservée même si elle ne respecte plus les règles de configuration.

Je ne trouve pas mon fichier dans le champ « Configuration du Chunkstore » du WRS. Pourquoi ?

Le fichier n'est sans doute pas dans le même groupe que le WRS. Modifiez le champ Groupe du fichier ou créez un fichier dans le groupe du WRS.

Puis-je créer un seul fichier à la racine pour tous mes WRS ?

Non, ce n'est pas possible aujourd'hui : un fichier ne peut être associé qu'aux WRS de son propre groupe. Il faut créer un fichier par groupe contenant un WRS. Plusieurs WRS d'un même groupe peuvent en revanche partager le même fichier.

Si ce fonctionnement ne correspond pas à vos usages, envoyez une demande d'amélioration via le support.

Le poste de travail est-il bloqué si une version est bannie sur le WRS ?

Non. Le poste passe automatiquement sur le serveur upstream pour charger la version.



Did this page help you?