Installer ArcGIS Notebook Server en mode silencieux

Vous pouvez installer et autoriser ArcGIS Notebook Server à l’aide des paramètres de ligne de commande au lieu d’utiliser l’assistant d’installation.

Conseil :

Le mode d’installation que vous choisissez détermine le mode de désinstallation par défaut. Par exemple, si vous procédez à une installation en mode silencieux à partir de la ligne de commande, par défaut, la désinstallation depuis la ligne de commande s’effectue en mode silencieux.

Avant d’installer ArcGIS Notebook Server, vérifiez la configuration système requise.

Remarque :

Les paramètres de ligne de commande respectent la casse. Si l’installation ne fonctionne pas, vérifiez que la casse correspond à chaque propriété comme illustré dans les exemples de code ci-dessous.

Préparer l’installation d’ArcGIS Notebook Server

Avant de poursuivre l’installation, procédez comme suit :

Connectez-vous à My Esri et procurez-vous les fichiers nécessaires : Vous devez disposer des éléments suivants :
- Le fichier de téléchargement du logiciel ArcGIS Notebook Server
- Fichier d’autorisation
- Une ou deux images de conteneur Docker en fonction de votre licence Ces images de conteneur contiennent tous les composants nécessaires à l’exécution d’ArcGIS Notebooks. Pour en savoir plus, reportez-vous à la rubrique Moteurs de conteneurisation et ArcGIS Notebook Server.
Vérifiez que chacune des machines sur lesquelles vous allez installer ArcGIS Notebook Server satisfait à la configuration système requise.
Modifiez le pare-feu de chaque machine afin de permettre la communication sur le port 11443 utilisé par ArcGIS Notebook Server.

Spécifier l’emplacement d’installation

Par défaut, ArcGIS Notebook Server est installé dans C:\Program Files\ArcGIS\NotebookServer\.

Utilisez la propriété INSTALLDIR pour définir un autre emplacement d’installation pour ArcGIS Notebook Server, s’il y a lieu. Si vous n’exécutez pas cette commande, l’emplacement par défaut est utilisé.

<setup directory>\setup.exe /qb INSTALLDIR=C:\NotebookServer ACCEPTEULA=yes

Assurez-vous que l’utilisateur dispose d’autorisations complètes pour accéder au répertoire d’installation d’ArcGIS Notebook Server. Le compte d’utilisateur qui a permis d’installer ArcGIS Notebook Server est celui qui est utilisé pour exécuter le logiciel.

Configurer le compte Windows

Le compte ArcGIS Notebook Server doit être configuré si le logiciel est installé en mode silencieux. Pour les systèmes de production, nous vous recommandons de désigner un compte préexistant qui réside dans votre domaine ou dans Active Directory et qui est conforme à la stratégie de sécurité de votre organisation.

Si le compte ArcGIS Notebook Server n’est pas configuré à l’aide de paramètres de ligne de commande pendant l’installation en mode silencieux, le compte est défini en tant que compte Local System (Système local).

Pour configurer le compte, utilisez les paramètres de ligne de commande suivants.

Transmettre directement les identifiants de connexion d’un compte

Attention :

Si le compte ArcGIS Notebook Server n’est pas défini pendant une installation en mode silencieux (/qb) ou si les identifiants de connexion ne sont pas valides, le programme d’installation affiche un message d’avertissement au cours de l’installation. Vous pouvez fermer ce message en cliquant sur OK. Dans ce cas, le compte ArcGIS Notebook Server est défini en tant que compte Local System (Système local).

USER_NAME=<operating system account>

Le compte peut être un compte de domaine ou un compte local. Si vous utilisez un compte de domaine, il doit déjà exister. Si vous utilisez un compte local, il est créé au besoin. Si le compte n’est pas valide, un message s’affiche pendant l’installation pour indiquer que le compte ou le mot de passe est incorrect.
MSA=TRUE

Ce paramètre ne doit être utilisé qu’avec un compte de service géré. Un compte de service géré doit déjà exister dans votre domaine. N’utilisez pas ce paramètre avec un compte local ou un compte de domaine avec un mot de passe. Un compte de service géré n’utilise pas le paramètre PASSWORD.
PASSWORD=<account password>

Il s’agit du mot de passe du compte spécifié pour le paramètre USER_NAME. Si le mot de passe n’est pas valide, un message s’affiche pendant l’installation pour indiquer que le compte ou le mot de passe est incorrect.

Reportez-vous aux exemples ci-après.

Utilisation d’un compte de domaine

<path to the ArcGIS Notebook Server setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=mydomain\mydomainaccount PASSWORD=my.password

Utilisation d’un compte local nouveau ou existant

<path to the ArcGIS Notebook Server setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=myaccount PASSWORD=my.password

Utilisation d’un compte de service géré

<path to the ArcGIS Notebook Server setup download>\setup.exe /qb ACCEPTEULA=yes MSA=TRUE USER_NAME=mydomain\mymsa

Importer les identifiants de connexion de compte depuis un fichier

Vous pouvez également utiliser un fichier de configuration de serveur pour importer les identifiants de connexion de votre compte Windows. Les fichiers de configuration de serveur peuvent être exportés lors de l’installation d’ArcGIS Notebook Server et utilisés dans des installations ultérieures. Pour importer les identifiants de connexion d’un fichier de configuration du serveur existant, définissez les deux paramètres suivants :

ACCOUNT : si vous importez les identifiants de connexion à partir d’un fichier, définissez ce paramètre sur UseConfigFile (en respectant parfaitement la casse). Il n’existe aucune autre valeur valide pour ce paramètre.
CONFIGPATH : spécifiez le chemin et le nom complets du fichier de configuration de serveur que vous utilisez.

<setup directory>\setup.exe /qb ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\serverconfigs\standardaccount.xml ACCEPTEULA=yes

Exporter des informations d’identification vers un fichier de configuration de serveur

Vous pouvez exporter les informations d’identification de compte utilisées dans l’installation ArcGIS Notebook Server actuelle pour les utiliser dans une future installation. Le fichier de configuration de serveur qui a été créé est un fichier .xml chiffré.

Lors de l’exportation d’un fichier de configuration du serveur vers un partage réseau, le compte Local System (Système local) sur l’ordinateur sur lequel ArcGIS Notebook Server est en cours d’installation doit disposer des autorisations d’écriture sur le partage réseau. Par exemple, si vous installez ArcGIS Notebook Server sur une machine nommée Turing, le compte Local System (Système local) sur Turing doit disposer d’autorisations en écriture sur le partage réseau. Si les autorisations ne sont pas définies, le fichier de configuration du serveur peut ne pas être exporté avec succès.

Remarque :

Si vous n'êtes pas sûr de la façon de définir les autorisations pour le partage réseau, contactez l'administrateur système ou exportez le fichier de configuration du serveur localement et copiez-le sur le partage réseau.

Utilisez les deux paramètres de ligne de commande suivants pour exporter les identifiants de connexion du compte ArcGIS Notebook Server dans un fichier de configuration de serveur :

EXPORTCONFIG : définissez ce paramètre sur Yes pour exporter les informations de compte définies pour les paramètres USER_NAME et PASSWORD dans un fichier de configuration de serveur. Ce paramètre est défini sur No par défaut.
CONFIGPATH : spécifiez le chemin et le nom complets du fichier de configuration de serveur que vous souhaitez créer, y compris l’extension de fichier .xml. Le dossier spécifié doit déjà exister.

Ajoutez votre compte utilisateur de système d’exploitation (le compte utilisé pour installer ArcGIS Notebook Server) à un groupe Unix appelé docker. Ce processus est documenté sur le site web de Docker.

Remarque :

L’installation d’ArcGIS Notebook Server avec le compte racine n’est pas prise en charge.

Installer ArcGIS Notebook Server en mode silencieux à partir de la ligne de commande

Pour installer ArcGIS Notebook Server en mode silencieux à partir de la ligne de commande, procédez comme suit.

Par défaut, ArcGIS Notebook Server est installé dans ${HOME}/arcgis/notebookserver.

Ouvrez une interface de commande (shell) en tant qu’utilisateur appelé à exécuter ArcGIS Notebook Server. Accédez au répertoire dans lequel vous avez téléchargé le fichier tar.gz d’ArcGIS Notebook Server à partir de My Esri.
Décompressez le fichier tar.gz avec la commande suivante :

tar -xvzf ArcGIS_Notebook_Server_Linux_<version>.tar.gz
Accédez au répertoire de décompression du fichier, puis à l’emplacement <untar directory>/Documentation/EULA.pdf. Lisez l’accord de licence.

À partir du répertoire, exécuter l’installation en mode silencieux et autorisez-la à l’aide d’un fichier .prvc. La syntaxe est la suivante :

<untar directory>/Setup -m silent -l yes -a <full path to .prvc file>

Les paramètres de l’outil de ligne de commande sont les suivants :


Le paramètre	Description
`-m; --mode MODE`	(Facultatif) Mode d’installation : `silent` ou `GUI`. La valeur par défaut est `GUI`.
`-l; --license-agreement CHOICE`	Obligatoire pour le mode silencieux ; `yes` ou no. La valeur Oui indique que vous avez lu et accepté le contrat principal Esri (E204, E300). Vous pouvez consulter l’accord à tout moment.
`-a; --authorization-file PATH_TO_FILE`	(Facultatif) chemin absolu vers le fichier d’autorisation ou d’approvisionnement fourni par Esri. Si cette option n’est pas utilisée, vous devez autoriser le logiciel après l’installation, comme indiqué à la section suivante.
`-d; --directory DIRECTORY`	(Facultatif) Par défaut, ArcGIS Notebook Server est installé dans votre répertoire $. DIRECTORY spécifie un répertoire d’installation différent. Le chemin `/arcgis/notebookserver/` est ajouté au répertoire d'installation. Le nom du répertoire d’installation doit être en lettres minuscules. Pour les exemples et les données fournis avec l'installation, le chemin d'accès aux données doit être indiqué en lettres minuscules.
`-v; --verbose`	(Facultatif) Exécuter le programme d’installation en mode Commentaires.
`-h; --help`	Affiche l’aide sur la ligne de commande et quitte.
`-e; --examples`	Affiche des exemples d’utilisation de chaque option et quitte.

Modifiez les privilèges de votre système d’exploitation pour permettre à systemd d’initialiser et de gérer des processus dans ArcGIS Notebook Server. Cela permet au service de démarrer immédiatement au démarrage de l’ordinateur.
1. Sur un terminal, connectez-vous en tant qu’utilisateur racine.
2. Copiez le fichier d’unité <ArcGIS Notebook Server install directory>/framework/etc/scripts/agsnotebook.service dans /etc/systemd/system. Modifiez les autorisations du fichier déplacé de 700 à 600.
3. Toujours en tant qu’utilisateur racine, exécutez la commande suivante :
# systemctl enable agsnotebook.service
1. Redémarrez le service systemd et examinez-en le statut pour vérifier il est correctement configuré :
```
   # systemctl stop agsnotebook.service
   # systemctl start agsnotebook.service
   # systemctl status agsnotebook.service
```
1. Déconnectez-vous en tant qu'utilisateur racine.
2. Relancez le système d’exploitation et vérifiez qu’ArcGIS Notebook Server démarre correctement.

Autoriser le logiciel en mode silencieux

Si vous n’avez pas autorisé votre logiciel pendant l’installation, exécutez SoftwareAuthorization.exe avec la syntaxe suivante pour autoriser ArcGIS Notebook Server en mode silencieux. Avant d’exécuter le fichier, vous devez disposer de toutes les informations utilisateur dans le fichier d’autorisation ou d’approvisionnement.

Si vous disposez d’un fichier d’autorisation et que votre ordinateur est connecté à Internet :

<ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /S /Ver <Version> /LIF <full path and name of authorization file>

Si vous n’avez pas autorisé votre logiciel pendant l’installation, exécutez l’autorisation du logiciel avec la syntaxe suivante pour autoriser ArcGIS Notebook Server en mode silencieux. Exécutez la commande suivante pour afficher toutes les options d’autorisation :

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

Autoriser dans un environnement déconnecté

Vous pouvez autoriser ArcGIS Notebook Server dans un environnement déconnecté au moyen d’un fichier d’approvisionnement (.prvc). Pendant la procédure, un fichier à transmettre à Esri est généré afin de finaliser la procédure.

À l’invite, exécutez la commande fournie ci-dessous une fois l’installation d’ArcGIS Notebook Server terminée.

<ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>
Une fois le fichier contenant les informations en sortie créé, procédez de l’une des manières suivantes :
- Accédez au site Esri en libre-service. Suivez les instructions à l’écran pour charger votre fichier contenant les informations d’autorisation, puis téléchargez votre fichier d’autorisation .ecp.
- Envoyez le fichier d’informations d’autorisation par courrier électronique à l’adresse authorize@esri.com. Esri vous adressera le fichier d’autorisation .ecp par retour dans un message électronique.
Une fois que vous avez reçu votre fichier d’autorisation .ecp en suivant l’une des deux méthodes ci-dessus, exécutez de nouveau le script authorizeSoftware pour le traiter et terminer le processus d’autorisation du serveur :

<ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .ecp file>

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware -f <full path to the .ecp file>

Répétez ce processus pour chaque machine sur laquelle vous souhaitez installer ArcGIS Notebook Server.

Après avoir installé tous les logiciels, configurez ArcGIS Notebook Server après l’installation et créez votre site de serveur. Il existe une option permettant de créer le site à l’aide de l’utilitaire de ligne de commande createsite.