Watchdoc - Domaine - Créer et géer un domaine (master/slave)

Etapes

Pour mettre en œuvre un domaine comprenant un serveur master et d'autres serveurs :

1. installez Watchdoc sur le serveur

2. déclarez le serveur en tant que master (ce qui entraîne la création du du domaine)

3. enregistrez les autres serveurs du domaine.

Vous pouvez compléter cette installation en activant la configuration centralisée :

4. activez la configuration centralisée

5. activez le mode de synchronisation.

Accéder à l'interface de gestion du domaine

Depuis le serveur auquel vous souhaitez attribuer le rôle de master,

1. accédez à l'interface d'administration de Watchdoc en tant qu'adminitrateur ;

2. depuis le Menu principal, cliquez sur Configuration avancée ;

3. dans l'interface Configuration avancée, cliquez sur Gestion du domaine :
   
   

Déclarer le serveur master

Un serveur master peut être déclaré depuis l'interface d'administration de Watchdoc (Gestion du domaine).
De fait, déclarer un serveur comme master revient à déclarer conjointement le domaine dont il est le master.
Si le nombre de serveurs master et de domaines à créer est important, il est également possible de les déclarer à l'aide de l'outil en ligne de commande WCLI (Watchdoc Command in Line).
L'outil WCLI peut être lancé depuis le serveur à déclarer, mais peut aussi être lancé de n'importe quel autre serveur Watchdoc, pour peu qu'il existe une connectivité réseau entre le service Watchdoc cible et l'outil de commande.

Déclarer le master depuis Watchdoc

1. Depuis l'interface Gestion du domaine, cliquez sur Créer un domaine en tant que master;

2. dans l'interface Créer un domaine, saisissez :

   • Identifiant : l'adresse IP du serveur master ;

   • Nom : le nom du serveur qui servira à l'identifier dans Watchdoc ;

   • Description : un complément d'information permettant d'identifier le serveur si nécessaire :
     

      

     

     
     

3. Cliquez sur Créer pour valider la création du domaine et de son serveur master.

Déclarer le master depuis WCLI

1. à l'aide de l'outil de commande, placez-vous dans le répertoire d'installation de Watchdoc^® : cd "\Program Files\Doxense\Watchdoc"

2. lancez ensuite la commande de création du Master (en respectant la casse) :
   
   WCLI CREATEMASTER /master=adresse /password=mot_de_passe_de_maintenance

   

   Dans cette commande, la valeur adresse peut être représentée sous les formes suivantes :

   • une adresse IP (ex: 10.10.0.110)

   • un hostname (ex: printserver1)

   • un FQDN (ex: printserver1.doxense.local)

   • une URI (ex: https://printserver1:5753/watchdoc/server)

    

3. vérifiez que vous recevez le message de confirmation suivant :
   

Vérifier le statut du serveur master

1. Dans le Menu principal de Watchdoc^®, le nouveau statut du serveur s'affiche :
   
   

2. dans l'interface de Gestion du domaine, les informations et les certificats du domaine s'affichent :
   
   
   

→ Vous pouvez compléter les informations du serveur master, mais aussi ajouter d'autres serveurs dans le domaine.

Déclarer les autres serveurs Watchdoc

Déclarer les autres serveurs depuis Watchdoc

Une fois le master déclaré et le domaine créé, vous pouvez l'enrichir d'autres serveurs :

1. dans l'interface Gestion du domaine, section Liste des serveurs, cliquez sur Ajouter un serveur slave ;

2. dans l'interface d'ajout, indiquez l'adresse et le port du serveur à ajouter (port du service DSP) ;

3. cliquez sur Ajouter pour valider l'ajout du serveur slave :
   
   
   

 

N.B. : cette configuration peut aussi être effectuée depuis l'interface d'administration du serveur slave.

Déclarer les serveurs à l'aide de WCLI

1. Avec l'outil en ligne de commande, placez-vous dans le dossier d'installation de Watchdoc;

2. lancez la commande d'enregistrement du serveur dans le domaine (en respectant la casse) :

   WCLI CREATESLAVE /master=server_master /slave=server_watchdoc /password=mot_de_passe_de_maintenance

3. vérifiez que vous recevez le message de confirmation suivant :
   
   

 

Vérifier l'ajout des autres serveurs dans le domaine

1. Dans le Menu principal de Watchdoc, le nouveau statut du serveur s'affiche :
   
   

2. dans l'interface de Gestion du domaine, les autres serveurs s'ajoutent dans la liste des serveurs, sous le serveur master.
   

Supprimer (déclasser) un serveur Master

Ponctuellement, il peut être nécessaire de déclasser un serveur master, c'est-à-dire lui enlever son rôle de master.

Déclasser un serveur master est une opération dont les conséquences sont importantes, notamment pour les autres serveurs qui en dépendent. 

Cette opération doit être réalisée à l'aide de WCLI.

1. à l'aide de l'outil de commande, placez-vous dans le répertoire d'installation de Watchdoc : cd "\Program Files\Doxense\Watchdoc" ;

2. lancez la commande permettant d'arrêter le serveur : >net stop watchdoc

3. lorsque le service est arrêté, lancez la commande permettant de déclasser le serveur : >wcli SINGLEIFY /force

4. confirmez votre demande de déclassement par "y" ;

è l'outil procède au déclassement du master : il vous informe que le serveur est devenu "single master" et vous rend la main. 

5. lancez la commande permettant de redémarrer le serveur : > net start watchdoc:
   
   

   
   

è une fois Watchdoc redémarré, vérifiez dans Gestion du domaine que le serveur n'a plus le rôle de master. 

Sortir un serveur du domaine

Ponctuellement, il peut être nécessaire de supprimer un serveur esclave (slave), ce qui oblige à casser le lien qui le relie au serveur master (maître).

Cette opération doit être réalisée à l'aide de WCLI :

1. à l'aide de l'outil de commande, lancez WCLI : cd "\Program Files\Doxense\Watchdoc\wcli.exe" ;

2. lancez la commande permettant de sortir le serveur du domaine : removeslave /slave=DNS_SLAVE /domain=DOMAIN_ID
   
   

3. une fois le serveur esclave devenu simple (single) serveur, vous pouvez le supprimer.

è vérifiez dans Gestion du domaine que le serveur ne figure plus dans la liste des serveurs slaves du domaine.