Skip To Content

Consulter les diagnostics ArcGIS Notebook Server

ArcGIS Notebook Server comprend un outil de diagnostic que vous pouvez utiliser pour vous assurer que votre machine répond à la configuration 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 depuis le compte de l’utilisateur qui possède le 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. 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 utiliser ces informations pour analyser l’état actuel de la machine qui héberge ArcGIS Notebook Server.

Numéro de vérificationTitre de la vérificationDescription
DIAG000

Vérifiez l'installation en tant qu'utilisateur racine

L’exécution de 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 uniquement sur les architectures 64 bits. 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 de 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 ce contrôle 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érifier les 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 de 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.