Consulter les diagnostics ArcGIS Notebook Server

ArcGIS Notebook Server propose un outil de diagnostic dont vous pouvez vous servir pour vérifier que votre machine répond à la configuration système minimale requise et que le logiciel fonctionne correctement. Si l'outil détecte un problème lors de son exécution, il indique la cause et propose une solution pour résoudre le problème.

Lorsque vous démarrez l’installation du logiciel, l’outil s’exécute automatiquement pour vérifier que votre machine répond à la configuration minimale requise. Résolvez les éventuels problèmes détectés par l’outil avant de poursuivre l’installation. Si vous rencontrez des problèmes après l’installation, exécutez l’outil pour vous aider à identifier et à diagnostiquer les problèmes.

Exécuter l’outil

L’outil de diagnostic s’exécute à partir de la ligne de commande sur l’ordinateur hébergeant ArcGIS Notebook Server.

1. Ouvrez un terminal sous l’identité de l’utilisateur propriétaire du répertoire d’installation de ArcGIS Notebook Server.

   Remarque :

   Pour que l’outil s’exécute, le propriétaire de l’installation doit posséder au moins des autorisations de lecture et d’écriture sur le répertoire /tmp sur l’ordinateur hébergeant ArcGIS Notebook Server.

2. Accédez au répertoire <ArcGIS Notebook Server installation directory>/arcgis/notebookserver/tools/.
3. Exécutez notebookserverdiag.

Interpréter les résultats du diagnostic

À la fin de l’exécution de l’outil, un rapport résumant toutes les vérifications de diagnostic du serveur effectuées est généré. Le rapport indique également si les vérifications ont déclenché un avertissement, si elles ont réussi, si elles ont échoué ou si elles ne s'appliquent pas au système.

Chaque vérification est identifiée par un code au format DIAG<number>, suivi de l’état de la vérification effectuée. Le tableau ci-dessous donne une explication de chaque vérification de diagnostic. Vous pouvez vous servir de ces informations pour analyser l’état actuel de la machine hébergeant ArcGIS Notebook Server.

Numéro de vérification	Titre de la vérification	Description
DIAG000	Vérifiez l'installation en tant qu'utilisateur racine	L’exécution d’ArcGIS Notebook Server en tant qu’utilisateur racine présente un risque de sécurité et n’est pas prise en charge. Cette vérification renvoie un échec si ArcGIS Notebook Server est installé en tant que processus racine.
DIAG001	Vérifier l’architecture 64 bits	ArcGIS Notebook Server est pris en charge sur les architectures 64 bits uniquement. Si la machine a une architecture 32 bits, cette vérification échoue. Vérifiez la configuration système requise pour savoir quels systèmes d’exploitation sont pris en charge.
DIAG002	Vérification de la version du système d’exploitation	Un avertissement s’affiche si le système d’exploitation ne correspond pas à une distribution ou version Linux prise en charge. Vérifiez la configuration système requise pour savoir quelles plateformes Linux et quelles versions des systèmes d’exploitation sont prises en charge. Si le système d’exploitation ne correspond pas à une distribution Linux prise en charge, aucune autre vérification n’est effectuée.
DIAG003	Recherche de caractères invalides dans le nom d'hôte	Les caractères valides pour le nom d’hôte de la machine ArcGIS Notebook Server incluent des caractères alphanumériques compris entre a et z, 0 et 9, le signe moins (-) et le point (.), comme l’indique la spécification RFC 952. La vérification échoue si le nom d’hôte contient un ou plusieurs caractères invalides.
DIAG004	Vérification des paquetages installés	Selon la distribution Linux utilisée, cette vérification regarde si les paquetages du système d’exploitation requis sont installés pour une bonne prise en charge d’ArcGIS Notebook Server. Si la vérification échoue, elle renvoie un avertissement qui répertorie les paquetages nécessaires à la machine qui sont absents. Vérifiez la configuration système requise pour en savoir plus.
DIAG005	Vérification des limites du système	Pour que ArcGIS Notebook Server s’exécute correctement, les limites minimales des descripteurs de fichiers pour l’utilisateur qui procède à l’installation doivent être définies sur 65535 et la limite minimale du nombre de processus doit être définie sur 25059. Cette vérification contrôle si ces limites sont définies correctement dans le fichier /etc/security/limits.conf. Si les limites sont trop basses, cette vérification échoue. Pour le vérifier, exécutez la commande suivante : ulimit -Hn -Hu ulimit -Sn -Su
DIAG009	Vérification du port HTTPS	ArcGIS Notebook Server utilise le port 11443 par défaut. Cette vérification contrôle si le port HTTPS 11443 est utilisé par un autre utilisateur ou processus. Si cette vérification renvoie un avertissement, ArcGIS Notebook Server ne fonctionnera pas correctement. Pour rectifier ce problème, ouvrez le port 11443 et redémarrez ArcGIS Notebook Server.
DIAG020	Vérifier la concordance entre le nom d’hôte et l’adresse IP	Si l’entrée du nom d’hôte de la machine est présente dans le fichier /etc/hosts et qu’elle ne correspond pas à l’adresse IP de la machine, cette vérification renvoie un avertissement. Ceci entraîne un dysfonctionnement de ArcGIS Notebook Server. Pour corriger ce problème, résolvez l’entrée du nom d’hôte et redémarrez ArcGIS Notebook Server.
DIAG024	Vérifier l’entrée du nom d’hôte dans /etc/hosts	L’entrée du nom d’hôte de la machine dans le fichier /etc/hosts doit être au format <IP> <FQDN> <Machine_name>. Mettez à jour l’entrée du nom d’hôte avant de créer votre site ArcGIS Notebook Server.
DIAG026	Vérification des processus pour les services principaux de ArcGIS Notebook Server	La vérification contrôle si tous les services principaux ont démarré après le démarrage d’ArcGIS Notebook Server. Elle renvoie un avertissement si un ou plusieurs services mémoire n’ont pas démarré. Pour rectifier ce problème, démarrez ArcGIS Notebook Server en exécutant le script startnotebookserver.sh ou redémarrez ArcGIS Notebook Server s’il est déjà en cours d’exécution.
DIAG028	Rechercher une installation de Docker valide	Cette opération permet de vérifier que la version de Docker installée sur la machine respecte la configuration système requise pour ArcGIS Notebook Server. Elle vérifie également si le compte utilisateur qui a installé ArcGIS Notebook Server est ajouté au groupe Docker pour exécuter des commandes Docker. Si cette vérification échoue, assurez-vous que la version de Docker prise en charge est installée sur la machine et que le compte utilisateur qui a installé ArcGIS Notebook Server est ajouté au groupe Docker avant de configurer votre site ArcGIS Notebook Server.
DIAG029 (introduction avec la version 10.7.1)	Vérifier l’espace disque pour /var	Cette vérification permet de s’assurer que le répertoire /var figurant sur votre machine comporte au moins 50 Go d’espace disque. Docker utilise le répertoire /var en tant que registre local pour stocker les images de conteneur. Au cours du processus de mise à niveau des versions ultérieures, de nouvelles images seront également copiées dans le répertoire /var. La configuration minimale requise de 50 Go d’espace disque disponible garantit que ces opérations se déroulement correctement. Pour changer le répertoire par défaut que Docker utilise pour stocker les images de conteneur, reportez-vous à ce processus dans le guide d’installation.