Ce chapitre décrit l'administration de DIVAnet.
DIVAnetAdmin est un outil de ligne de commande simple présentant des options pour administrer DIVAnet. Cet utilitaire ne peut être exécuté que sur le serveur sur lequel les services ClientAdapter et DbSync s'exécutent.
Pour démarrer l'utilitaire, ouvrez une fenêtre de commande et accédez au sous-répertoire Program/divanet/bin depuis le répertoire de base DIVAnet. Entrez l'une des commandes suivantes pour lancer l'utilitaire :
Windows :
DIVAnetAdmin.bat ClientAdapterWebUrl DbSyncWebUrl
Linux :
DIVAnetAdmin.sh ClientAdapterWebUrl DbSyncWebUrl
Remarque :
Si vous n'indiquez pas les arguments d'URL, l'utilitaire suppose que les services ClientAdapter et DbSync s'exécutent en local et vous invite à spécifier les ports des services ClientAdapter et DbSync.Le Tableau 6-1 présente les options DIVAnetAdmin, sélectionnables dans un système de menu.
Tableau 6-1 Options DIVAnetAdmin
| Catégorie | Option | Description |
|---|---|---|
|
Synchronisation de la base de données d'actifs |
List Synced Sites |
Génère la liste des sites dans lesquels les informations d'actif sont en cours de synchronisation. Elle affiche également le statut de synchronisation de chaque site. Si un site est dans un état de synchronisation initiale, le pourcentage de progression est également affiché. |
|
Synchronisation de la base de données d'actifs |
Resync a Site |
Resynchronise tous les enregistrements d'objet à partir d'un site particulier pour la base de données DIVAnet. Attention: cette option supprimera tous les enregistrements d'actif dans la base de données DIVAnet (pour le site sélectionné) avant de les resynchroniser. |
|
Synchronisation de la base de données d'actifs |
Resync an Object |
Met à jour tous les enregistrements d'objet pour un objet donné sur un site spécifique. Ne synchronise pas les suppressions. |
|
Connexions API |
List API Connection |
Liste toutes les connexions API DIVAnet client, y compris celles en mode direct. |
|
Connexions API |
End API Connection |
Fournit une option pour mettre fin à une connexion API donnée, identifiée par un ID. |
|
Reload Workflow Profiles |
Reload Workflow Profiles |
Cette option provoque le rechargement de tous les profils de workflow. Elle recharge également toutes les règles d'accès qui sont définies. Si des règles d'accès sont définies, cette option requiert un accès à l'opération ChangeConfig. |
|
Paramètres de site |
Show Site Parameters |
Cette option affiche les paramètres de site DIVA, notamment le nombre de demandes en file d'attente pour le site, le nombre de demandes (envoyées par DIVAnet) s'exécutant sur chaque site, la date de la dernière communication avec le site et les paramètres de limitation. |
|
Paramètres de site |
Set Site Parameters |
Cette option permet à l'utilisateur de définir les paramètres de limitation DIVA :
Si des règles d'accès sont définies, cette option requiert un accès à l'opération ChangeConfig. |
|
Statistiques d'exécution |
Show Runtime Stats: ClientAdapter |
Cette option affiche des statistiques d'exécution utiles pour le service ClientAdapter. |
|
Statistiques d'exécution |
Show Runtime Stats: DbSync |
Cette option affiche des statistiques d'exécution utiles pour le service DbSync. |
|
Niveau de journalisation |
Set Log Level: ClientAdapter |
Cette option répertorie le niveau de journalisation des services ClientAdapter et permet de le modifier de façon dynamique (les valeurs valides sont ERROR, WARN, INFO, DEBUG, TRACE). |
|
Niveau de journalisation |
Set Log Level: DbSync |
Cette option répertorie le niveau de journalisation des services DbSync et permet de le modifier de façon dynamique (les valeurs valides sont ERROR, WARN, INFO, DEBUG, TRACE). |
DIVAnet crée les types de fichiers journaux suivants :
Journaux de suivi : situés dans le répertoire de base DIVAnet, dans le sous-dossier Program/log/divanet. Chacun des services DIVAnet (ManagerAdapter, DbSync et ClientAdapter) crée son propre sous-dossier sous le dossier Program/log/divanet et génère ses fichiers journaux dans ce sous-répertoire.
Journaux de service de wrapper : ces journaux consignent des messages liés au démarrage et à l'arrêt du service Windows. C'est l'emplacement à consulter si le service ne démarre pas correctement. Ces journaux figurent dans le répertoire de base DIVAnet, dans le sous-dossier Program/log/divanet. Ils seront nommés de la même façon que le fichier Wrapper.conf mais avec une extension de nom de fichier .log (par exemple, ManagerAdapterWrapper.log).
Journaux de GUI : les erreurs survenant dans DIVAnetUI s'afficheront sur l'ordinateur client, pas du côté serveur. Ces journaux figurent dans le sous-dossier Program/log/divanet/gui.
DIVAnet regroupe les journaux âgés de plus d'une heure en fichiers zip et conserve les journaux pendant deux jours pour consultation.
Les sections suivantes traitent de la mise en file d'attente et du traitement des demandes DIVAnet.
DIVAnet peut accepter davantage de demandes que les systèmes DIVArchive en aval ne peuvent en traiter en les plaçant dans des files d'attente. DIVAnet applique un nombre maximal de demandes pouvant être mises en file d'attente et (ou) en cours d'exécution en interne (la valeur par défaut est 5000), à l'aide du paramètre GlobalDivanetRequestLimit. DIVAnet commencera à rejeter les demandes si cette limite est atteinte. Le service DIVAnet ClientAdapter gère une file d'attente pour chaque site. Vous pouvez configurer DIVAnet pour alimenter les sites lentement ou pour envoyer toutes les demandes à la fois aux sites (où elles seront probablement mises en file d'attente par DIVArchive).
Si une demande est mise en file d'attente pour un système DIVArchive et que le système DIVA est redémarré, toutes les demandes en cours d'exécution seront arrêtées. DIVAnet se comporte différemment, en stockant chaque demande dans une base de données. Si le service ClientAdapter est redémarré, DIVAnet lit les demandes en attente et en cours d'exécution et les relance. Toutefois, toutes les demandes ne sont pas redémarrées de cette façon. Par exemple, les demandes de suppression ne seront jamais relancées après le redémarrage du service. S'il n'est pas souhaitable de récupérer les demande lors du démarrage, le paramètre ClientAdapter AbortAllOnStartup peut être défini pour mettre fin à toutes les demandes dans la file d'attente au démarrage.
Par défaut, DIVAnet enverra une centaine de demandes à un site avant de s'arrêter et d'attendre que l'une des demandes se termine. Le paramètre qui contrôle la limite est SubmittedThrottleThreshold ; il est configurable dans le service ClientAdapter sur une base par site. Il peut également être modifié au moment de l'exécution via l'utilitaire DIVAnetAdmin. En outre, DIVAnet peut limiter les demandes en fonction du nombre total de demandes en cours d'exécution sur un site DIVArchive (à l'aide du paramètre TotalThrottleThreshold). Vous pouvez définir le paramètre sur -1 pour indiquer qu'aucune limitation ne doit être effectuée. Vous pouvez également régler la valeur sur 0, pour indiquer qu'aucune demande de la file d'attente ne doit être envoyée à DIVArchive. Cela peut être utile dans certains cas.
Si une demande DIVAnet est mise en file d'attente pour un site donné pendant plus de quelques secondes, DIVAnetUI affichera la position de la demande dans la file d'attente. Si une autre demande est mise en file d'attente avec une priorité supérieure à la première, elle aura une position plus élevée dans la file d'attente. Si la demande échoue et est retentée, elle sera de nouveau mise en file d'attente (et aura une accélération de priorité car elle est dans le système depuis plus longtemps).
Certaines demandes peuvent faire l'objet de nouvelles tentatives automatiquement dans DIVAnet. Les demandes de copie, de restauration, de restauration de fichiers partielles et de suppression peuvent être retentées. Les demandes de restauration et de restauration de fichiers partielle peuvent être retentées selon un nombre de fois configurable, alors que les demandes de copie et de suppression sont retentées en fonction d'un intervalle de temps configurable. Les nouvelles tentatives peuvent être spécifiées par profil de workflow et peuvent être modifiées au moment de l'exécution sans redémarrage du service ClientAdapter (pour plus d'informations, voir Configuration des profils de workflow).
Si un site est indisponible et que des demandes sont en file d'attente pour ce site, DIVAnet attendra quelques minutes (SiteDownRequeueWaitMins) que le site soit de nouveau opérationnel. Si cette période s'écoule et que de nouvelles tentatives sont configurées, DIVAnet tentera de relancer la demande, éventuellement sur un autre site. Si les nouvelles tentatives ne sont pas configurées, la demande prendra fin.