Paramètres avancés de ArcGIS Notebook Server

Dans la plupart des cas, les paramètres et réglages par défaut de votre site ArcGIS Notebook Server assurent des performances système appropriées. À compter de la version 10.8, ArcGIS Notebook Server Manager permet de modifier certains paramètres avancés régissant votre site et son composant Docker. Dans le cadre de l’administration, vous pouvez modifier les paramètres pour améliorer les performances système, augmenter les limites de taille ou adapter les pratiques informatiques de votre organisation. Assurez-vous d’avoir parfaitement compris chacun des réglages et les effets produits avant de modifier les valeurs par défaut.

Paramètres disponibles dans Server Manager

Il est possible d’afficher et de modifier les paramètres suivants du site dans ArcGIS Notebook Server Manager :

• Web Socket Size (MB) (Taille du socket Web [Mo]) : taille maximale (en mégaoctets) d’un paquet transmis entre le serveur et les navigateurs client via le protocole WebSocket. ArcGIS Notebook Server utilise WebSocket pour faciliter une communication bidirectionnelle efficace et sécurisée avec les clients. La valeur par défaut de cette propriété est 16 Mo. Vous pouvez être amené à élever cette limite si un notebook doit transmettre un volume de données particulièrement important au site du serveur.
• Max containers per node for interactive containers (Nombre maximal de conteneurs par nœud pour les conteneurs interactifs) : cette propriété limite le nombre de conteneurs qui peuvent être ouverts en même temps de manière interactive par machine ArcGIS Notebook Server. La valeur par défaut est de 20 conteneurs ; une fois la limite atteinte, les conteneurs supplémentaires ne peuvent pas être ouverts. Les conteneurs ouverts en mode d’exécution automatique à l’aide de l’opération executeNotebook possèdent leur propre propriété de limite et ne sont pas comptabilisés dans le cadre de cette limite. Pour gérer cette limite pour les conteneurs automatisés, consultez la propriété Nombre maximal de conteneurs par nœud pour les conteneurs automatisés.
• Idle notebook threshold (Seuil de notebooks inactifs) : cette propriété régit la fermeture des notebooks qui sont inactifs. Les notebooks ouverts mais inactifs pendant un certain laps de temps (exprimé en minutes) sont automatiquement fermés. Le noyau du notebook s’est arrêté. La valeur par défaut est 1 440 (24 heures). Vous devrez peut-être diminuer cette valeur si vous avez de nombreux auteurs et un nombre limité de ressources serveur.
• Container created threshold (Seuil de création de conteneurs) : cette propriété définit le délai pendant lequel un conteneur peut rester ouvert (nombre exprimé en minutes) sans exécuter un notebook actif. Lorsque cette valeur est atteinte, le conteneur se ferme automatiquement. La valeur par défaut est 60 minutes. Comme le seuil de notebooks inactifs, vous pouvez réduire cette valeur pour préserver les ressources.
• Max containers per node for automated containers (Nombre maximal de conteneurs par nœud pour les conteneurs automatisés) : cette propriété limite le nombre de conteneurs de notebook automatisés qui peuvent s’exécuter simultanément sur chaque machine Notebook Server et s’applique aux notebooks exécutés en tant que tâches planifiées, outils Web, webhooks ou par l’API. La valeur par défaut est de 10 conteneurs. Une fois la limite atteinte, les conteneurs supplémentaires ne peuvent pas être ouverts tant qu’une des tâches automatisées initiales n’est pas terminée sur la machine.
• Max snapshots per notebook item (Nombre maximal d’instantanés par élément de notebook) : cette propriété limite le nombre d’instantanés autorisé pour élément de notebook. La valeur par défaut est 5.

Afficher et modifier les paramètres dans Server Manager

Procédez comme suit pour accéder aux paramètres du site.

1. Connectez-vous à votre portail ArcGIS Enterprise en tant qu’administrateur et ouvrez ArcGIS Notebook Server Manager.
2. Ouvrez la page Settings (Paramètres) et cliquez sur Site.

   Si vous modifiez l’une des valeurs des paramètres, le bouton Save (Enregistrer) devient disponible.

3. Cliquez dessus pour enregistrer vos mises à jour.

Le site ArcGIS Notebook Server redémarre.

Télécharger ArcGIS Maps SDK for JavaScript dans un environnement déconnecté

Lorsque vous configurez ArcGIS Notebook Server dans un environnement dépourvu d’accès Internet, vous devez télécharger le service ArcGIS Maps SDK for JavaScript dans votre environnement déconnecté et configurer la propriété système jsapiCDN dans ArcGIS Notebook Server afin de rendre les couches à l’aide du widget cartographique dans un notebook.

Procédez comme suit pour configurer ArcGIS Maps SDK for JavaScript dans votre environnement déconnecté :

1. Téléchargez la version 4.24 de ArcGIS Maps SDK for JavaScript et déployez-la sur votre serveur Web dans l’environnement déconnecté.
2. Inscrivez les types MIME qui sont requis sur le serveur Web hébergeant l’API.
3. Vérifiez que ArcGIS Maps SDK for JavaScript est accessible depuis un navigateur dans l’environnement déconnecté avec le format d’URL suivant : https://[webserver.domain.com]/[path to v4.24 api]/init.js.

   https://webserver.domain.com/arcgis_js_v424_api/arcgis_js_api/javascript/4.24/init.js

Configurer la propriété système jsapiCDN

Pour configurer la propriété système jsapiCDN, procédez comme indiqué ci-après.

Remarque :

Vérifiez qu’aucun notebook n’est actif et utilisé avant d’effectuer cette modification, car la mise à jour des propriétés système du serveur Notebook Server a pour effet d’arrêter tous les conteneurs de notebook actifs.

1. Connectez-vous au répertoire d’administration ArcGIS Notebook Server en tant qu’administrateur.

   Le répertoire est généralement accessible à l’adresse https://notebookserver.domain.com:11443/arcgis/admin ou https://notebookserverwebadaptor.domain.com/webadaptor/admin.

2. Cliquez sur System (Système) > Properties (Propriétés).
3. Cliquez sur Update properties (Mettre à jour les propriétés).
4. Ajoutez "jsapiCDN": "https://[webserver.domain.com]/[path to v4.24]" à la fin de la liste existante des propriétés.
5. Cliquez sur Update properties (Mettre à jour les propriétés) pour enregistrer les modifications.

Tous les notebooks que vous ouvrirez à partir de maintenant utiliseront l’API JavaScript mise à jour pour le rendu du widget cartographique.