Vérifier les diagnostics d’ArcGIS Notebook Server

Cette rubrique n’est pas pertinente pour les déploiements Windows.

Cette rubrique n’est pas pertinente pour les déploiements Linux.

ArcGIS Notebook Server propose un outil de diagnostic que vous pouvez utiliser 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

Vous allez exécuter l’outil de diagnostic à partir de la ligne de commande sur la machine hébergeant ArcGIS Notebook Server.

1. Ouvrez un terminal en tant qu’utilisateur propriétaire du répertoire d’installation d’ArcGIS Notebook Server.

   Remarque :

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

2. Localisez le 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érifier l’installation en tant qu’utilisateur racine	L’exécution d’ArcGIS Notebook Server en tant qu’utilisateur racine constitue un risque de sécurité et n’est pas prise en charge. Cette vérification renvoie un échec si elle détecte qu’ArcGIS Notebook Server a été installé par un utilisateur 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érifier 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 sont les caractères alphanumériques (a–z et 0–9), le signe moins (-) et le point (.), comme indiqué dans la spécification RFC 952. La vérification échoue si le nom d’hôte contient un ou plusieurs caractères invalides.
DIAG004	Vérifier les paquetages installés	Selon la distribution Linux utilisée, cette vérification contrôle que 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érifier les limites du système	Pour qu’ArcGIS Notebook Server s’exécute correctement, les limites minimales des descripteurs de fichier pour l’utilisateur qui procède à l’installation doivent être définies sur 65535 et le nombre minimal de processus doit être défini 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érifier le port HTTPS	ArcGIS Notebook Server utilise par défaut le port 11443. 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 corriger 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. Dans ce cas, ArcGIS Notebook Server ne fonctionnera pas correctement. Pour résoudre ce problème, corrigez l’entrée de nom d’hôte et redémarrez ArcGIS Notebook Server.
DIAG024	Vérifier l’entrée de 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 de nom d’hôte avant de créer le site ArcGIS Notebook Server.
DIAG026	Vérification des processus pour les services principaux d’ArcGIS Notebook Server	La vérification contrôle que tous les services principaux ont été démarrés une fois ArcGIS Notebook Server démarré. Elle renvoie un avertissement si un ou plusieurs services mémoire n’ont pas démarré. Pour résoudre 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.