Installation de Portal for ArcGIS en mode silencieux
Les étapes suivantes expliquent comment installer Portal for ArcGIS en mode silencieux.
Remarque :
Si vous procédez à la mise à niveau d’un déploiement existant, reportez-vous à la rubrique Mettre à niveau Portal for ArcGIS pour plus d’informations.
Il est possible d’installer Portal for ArcGIS sans interface utilisateur, à l’aide des paramètres de ligne de commande de Windows Installer.
Remarque :
Si vous procédez à la mise à niveau d’un déploiement existant, reportez-vous à la rubrique À propos de la mise à niveau de Portal for ArcGIS pour plus d’informations.
Préparer l’installation de Portal for ArcGIS
Avant de commencer la procédure d’installation de Portal for ArcGIS, procédez comme suit :
Vérifiez que le site respecte au minimum la configuration système requise.
Vérifiez que le site respecte la configuration système requise.
Connectez-vous à votre ordinateur en tant qu’utilisateur disposant de privilèges d’administration. Vous ne pouvez pas installer Portal for ArcGIS en tant qu’utilisateur racine.
Connectez-vous à votre ordinateur en tant qu’utilisateur disposant de privilèges d’administration.
Ouvrez les ports, comme expliqué dans la rubrique Ports utilisés par Portal for ArcGIS.
Fermez toutes les applications non critiques sur le serveur.
Téléchargez le programme d’installation de Portal for ArcGIS à partir de My Esri et accédez au dossier qui le contient. Vous pouvez également insérer le support de Portal for ArcGIS dans le lecteur approprié pour lancer automatiquement le programme d’installation.
Vous êtes maintenant prêt à installer Portal for ArcGIS.
- Exécutez les commandes d’installation comme expliqué ci-après.
Remarque :
Pour consulter la documentation d’aide dans une langue autre que l’anglais, vous devez télécharger et installer Portal for ArcGIS Help Language Pack depuis My Esri. Le module linguistique contient l’aide dans les langues suivantes : allemand, arabe, chinois (Han simplifié), coréen, espagnol, français, italien, japonais, polonais, portugais (Brésil) et russe.
Installer Portal for ArcGIS en mode silencieux sous Linux
Pour installer Portal for ArcGIS en mode silencieux sous Linux, procédez comme suit :
Lisez le contrat de licence disponible dans
<CD_ROOT or untar directory>/Documentation/EULA.pdfet acceptez-en les termes.Exécutez le fichier d’installation en mode silencieux à l’invite. Consultez l’exemple de syntaxe ci-après :
<CD_ROOT or untar directory>/Setup -m silent -l yes
Utilisation : Setup [Options]
|
Option |
Description |
|---|---|
|
|
Facultatif. Prend par défaut la valeur GUI. MODE peut prendre l’une des valeurs suivantes : |
|
|
Obligatoire pour le mode silencieux. La valeur Yes (Oui) indique que vous avez lu et accepté le Contrat principal Esri (E204, E300). Rendez-vous sur |
|
|
Le chemin Si vous pointez le programme d'installation sur le répertoire d'une installation précédente, le contenu de ce répertoire est automatiquement utilisé pour la nouvelle installation. Le contenu provenant d’installations antérieures à la version 10.2 n’est pas pris en charge. |
|
|
Le programme d’installation est exécuté en mode Commentaires. |
|
|
Affiche l’aide sur la ligne de commande et ferme l’outil. |
|
|
Affiche des exemples d’utilisation de ces options et quitte. |
Remarque :
Vous pouvez également exécuter l’utilitaire de ligne de commande createportal pour créer un portail une fois que Portal for ArcGIS a été installé.
Installation de Portal for ArcGIS en mode silencieux
Les paramètres suivants sont les paramètres de ligne de commande de Windows Installer à utiliser lors de l’installation de Portal for ArcGIS en mode silencieux. Ces commandes permettent de spécifier l’emplacement d’installation de Portal for ArcGIS ou le répertoire de contenu de votre portail.
ACCEPTEULA=yesCette propriété est requise pour accepter le contrat de licence d’utilisateur final (CLUF) pendant une installation en mode silencieux. Spécifiez yes pour accepter le CLUF et installer le logiciel. Le fait de spécifier no (non) ou d’omettre cette propriété entraînera l’échec de l’installation. Le téléchargement contient une version PDF du CLUF. Le fichier
EULA.pdfse trouve dans le dossier \Documentation.INSTALLDIR=<installation location>Cette propriété vous permet de spécifier l’emplacement d’installation de Portal for ArcGIS à partir de la ligne de commande. Si vous ne définissez pas cette propriété, l’emplacement d’installation par défaut
C:\Program Files\ArcGIS\Portalest utilisé.CONTENTDIR=<installation location content>Cette propriété vous permet de spécifier le répertoire de contenu du portail. L’emplacement que vous spécifiez doit être un répertoire local, vous ne pouvez pas choisir un répertoire de réseau partagé. La raison en est que le service Portal for ArcGIS est configuré pour s’exécuter par défaut sous le compte Local System (Système local) natif de Windows. Le compte Système local ne peut pas accéder aux emplacements réseau. Pour plus d’informations, reportez-vous à la rubrique Compte Portal for ArcGIS. Si vous ne définissez pas cette propriété, l’emplacement d’installation par défaut
C:\arcgisportalest utilisé.
Voici un exemple d’emplacement :
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes INSTALLDIR=C:\myportal CONTENTDIR=C:\arcgisportal
Configuration du compte Portal for ArcGIS au moyen de paramètres de ligne de commande
Le compte Portal for ArcGIS doit être configuré pendant la procédure d’installation de Portal for ArcGIS 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 Portal for ArcGIS 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). Cette procédure s’utilise avant tout pour accélérer l’installation de Portal for ArcGIS.
Utilisez les paramètres de ligne de commande ci-dessous pour configurer le compte Portal for ArcGIS.
Transmission directe des informations d’identification de compte Portal for ArcGIS
Attention :
Si le compte Portal for ArcGIS n’est pas défini au cours d’une installation en mode silencieux (/qb), ou si les informations d’identification ne sont pas valides, le programme d’installation de Portal for ArcGIS affiche un avertissement pendant la procédure. Vous pouvez fermer ce message en cliquant sur OK. Dans ce cas, le compte Portal for ArcGIS est défini en tant que compte Local System (Système local).
USER_NAME=<compte du système d'exploitation>
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, le compte sera créé s’il n’existe pas. 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=
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.
Des exemples sont indiqués ci-dessous.
Attention :
Les paramètres de ligne de commande respectent la casse. En cas de problème d’installation à partir de la ligne de commande, assurez-vous que la casse correspond à celle des propriétés des exemples qui suivent.
Utilisation d’un compte de domaine
<path to the Portal for ArcGIS 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 Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=myaccount PASSWORD=my.password
Utilisation d’un compte de service géré
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes MSA=TRUE USER_NAME=mydomain\mymsa
Importation des identifiants de connexion du compte Portal for ArcGIS à l’aide d’un fichier de configuration du portail
Les deux paramètres de ligne de commande suivants doivent être utilisés conjointement pour importer les identifiants de connexion du compte Portal for ArcGIS au moyen d’un fichier de configuration du portail :
ACCOUNT=UseConfigFile
Utilisez le paramètre de ligne de commande ACCOUNT exactement comme indiqué ci-dessus. Il n'existe aucune autre valeur valide pour cette propriété.
CONFIGPATH=
Utilisée conjointement à ACCOUNT=UseConfigFile, cette propriété vous permet de spécifier le fichier de configuration du portail à utiliser pour la configuration du compte Portal for ArcGIS. Les fichiers de configuration du portail sont créés par l’exportation d’un fichier de configuration du portail lors de l’installation de Portal for ArcGIS (installations antérieures ou à partir d’autres machines).
En voici un exemple :
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\portalconfigs\standardaccount.xml
Attention :
Les paramètres de ligne de commande respectent la casse. En cas de problème d’installation à partir de la ligne de commande, assurez-vous que la casse correspond à celle des propriétés des exemples qui suivent.
Exportation des identifiants de connexion du compte Portal for ArcGIS vers un fichier de configuration du portail
Remarque :
Lors de l’exportation d’un fichier de configuration du portail vers un partage réseau, le compte Local System (Système local) sur la machine sur laquelle Portal for ArcGIS est en cours d’installation doit disposer d’autorisations d’écriture sur le partage réseau. Par exemple, si vous installez Portal for ArcGIS sur un ordinateur nommé Quick, le compte Local System (Système local) sur Quick doit disposer des autorisations d’écriture sur le partage réseau. Si les autorisations ne sont pas définies, le fichier de configuration du portail peut ne pas être exporté avec succès. 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 portail localement et copiez-le sur le partage réseau.
Les deux paramètres de ligne de commande suivants doivent être utilisés conjointement pour exporter les identifiants de connexion du compte Portal for ArcGIS vers un fichier de configuration du portail :
EXPORTCONFIG=Yes
Utilisez cette propriété pour exporter les informations de compte entrées au moyen des paramètres de ligne de commande USER_NAME et PASSWORD. Les informations de compte sont stockées dans un fichier XML chiffré, appelé fichier de configuration du portail. Cette propriété prend la valeur No par défaut.
CONFIGPATH=
Utilisée conjointement à EXPORTCONFIG=Yes, cette propriété vous permet de définir le nom du fichier de configuration du portail et son emplacement de stockage. Le nom de fichier doit porter l’extension
.xmlet le dossier spécifié doit déjà exister. Si le fichier ne possède pas d’extension.xmlet si le répertoire spécifié n’existe pas, la création du fichier de configuration du portail échoue.
En voici un exemple :
<path to the Portal for ArcGIS setup download>\setup.exe /qb ACCEPTEULA=yes EXPORTCONFIG=Yes CONFIGPATH=\\networkmachine\portalconfigs\standardaccount.xml
Attention :
Les paramètres de ligne de commande respectent la casse. En cas de problème d’installation à partir de la ligne de commande, assurez-vous que la casse correspond à celle des propriétés des exemples qui suivent.
Utiliser l’utilitaire de ligne de commande createportal pour créer un portail
Vous pouvez exécuter l’utilitaire de ligne de commande createportal pour créer un portail une fois que Portal for ArcGIS a été installé. Vous pouvez utiliser l’utilitaire createportal comme suit :
Exécutez l’utilitaire
createportalen tant qu’administrateur à partir d’une invite de commande et spécifiez les paramètres prénom, nom, nom d’utilisateur, mot de passe, e-mail, question secrète, réponse et répertoire de contenu.Fournissez un fichier
createportal.propertiescontenant les paramètres spécifiés.
Pour utiliser l’utilitaire de ligne de commande createportal, exécutez le script createportal.sh avec -h ou -help comme suit :
<Portal for ArcGIS Installation Directory>/tools/createportal/createportal.sh -help
Exemple d’utilisation avec l’utilitaire : createportal.sh [-fn <arg>] [-ln <arg>] [-u <arg>] [-p <arg>] [-e <arg>] [-qi <arg>] [-qa <arg>] [-d <arg>] [ -lf <arg>] [ -ut <arg>]
Exemple d’utilisation avec un fichier : createportal.sh [-f <FILE>]
Pour utiliser l’utilitaire de ligne de commande createportal, exécutez le script createportal.bat avec -h ou -help comme suit :
<Portal for ArcGIS Installation Directory>\tools\createportal\createportal.bat -help
Exemple d’utilisation avec l’utilitaire : createportal.bat [-fn <arg>] [-ln <arg>] [-u <arg>] [-p <arg>] [-e <arg>] [-qi <arg>] [-qa <arg>] [-d <arg>] [-lf <arg>] [-ut <arg>]
Exemple d’utilisation avec un fichier : createportal.bat [-f <FILE>]
Remarque :
Lorsque vous référencez un chemin d’accès dans le fichier createportal.properties, vous devez faire précéder la barre oblique inverse d’un caractère d’échappement. Par exemple, C:\\arcgisportal ou \\\\<Absolute path to>\\<portal arcgisportal>.
|
Option |
Description |
|---|---|
|
|
Prénom pour un compte administrateur initial utilisé pour configurer le portail. Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets. |
|
|
Nom pour un compte administrateur initial utilisé pour configurer le portail. Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets. |
|
|
Nom d’utilisateur pour un compte administrateur initial utilisé pour configurer le portail. Ce nom d’utilisateur peut être composé de chiffres de 0 à 9, de lettres ASCII de a à z et de A à Z, et du point (.). |
|
|
Mot de passe pour un compte administrateur initial utilisé pour configurer le portail. Le mot de passe peut être composé des chiffres de 0 à 9, des lettres ASCII de a à z et de A à Z, et du point (.). |
|
|
Adresse électronique pour un compte administrateur initial utilisé pour configurer le portail. |
|
|
Index de la question secrète permettant de récupérer un mot de passe oublié. Les questions disponibles avec les numéros d’index respectifs sont les suivantes :
|
|
|
Réponse à la question secrète que vous avez choisie pour le paramètre Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets. |
|
|
Chemin absolu et nom du répertoire de contenu utilisé pour stocker les données hébergées sur le portail. Par défaut, le répertoire de contenu du portail est créé localement à cet emplacement :
ou
|
|
|
Chemin d’accès au fichier de licence du portail. |
|
|
ID du type d’utilisateur pour l’administrateur initial. Ce paramètre est facultatif. Pour générer une liste de types d’utilisateurs compatibles (à la disposition de votre organisation) pour le paramètre |
|
|
Fichier de propriétés de l’utilitaire Par défaut, le fichier
|
|
|
Affiche l’aide sur la ligne de commande et quitte. |
Vous trouverez ci-dessous un exemple de fichier createportal.properties :
#
# Portal for ArcGIS site creation properties
#
# First name for initial administrator account
PORTAL_ADMIN_FIRSTNAME =
# Last name for initial administrator account
PORTAL_ADMIN_LASTNAME =
# User name for initial administrator account
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_USERNAME =
# Password for primary site administrator.
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_PASSWORD =
# Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
# E-mail address for initial administrator account
# e.g username@example.com
PORTAL_ADMIN_EMAIL =
#This is the index of the secret question to retrieve a forgotten password.
#The list of questions with their respective index numbers is as follows:
#1, What city were you born in ?"
#2, What was your high school mascot?"
#3, What is your mother's maiden name?"
#4, What was the make of your first car?"
#5, What high school did you go to?"
#6, What is the last name of your best friend?"
#7, What is the middle name of your youngest sibling?"
#8, What is the name of the street on which you grew up?"
#9, What is the name of your favorite fictional character?"
#10, What is the name of your favorite pet?"
#11, What is the name of your favorite restaurant?"
#12, What is the title of your favorite book?"
#13, What is your dream job?"
#14, Where did you go on your first date?");
PORTAL_ADMIN_SECURITY_QUESTION_INDEX =
# Answer to the secret question
# e.g \"My Answer\"
PORTAL_ADMIN_SECURITY_QUESTION_ANSWER =
# Portal content directory where portal will store default and user-generated content.
# By default, the portal content directory will be created locally,
# e.g./<Portal for ArcGIS installation directory>/usr/arcgisportal.
PORTAL_CONTENT_DIRECTORY =
# The path to the portal license file
PORTAL_LICENSE_FILE =
# The ID of the user type for the Initial Administrator
PORTAL_USER_TYPE_ID =
#
# Portal for ArcGIS site creation properties
#
# First name for initial administrator account
PORTAL_ADMIN_FIRSTNAME =
# Last name for initial administrator account
PORTAL_ADMIN_LASTNAME =
# User name for initial administrator account
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_USERNAME =
# Password for primary site administrator.
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_PASSWORD =
# Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
# E-mail address for initial administrator account
# e.g username@example.com
PORTAL_ADMIN_EMAIL =
#This is the index of the secret question to retrieve a forgotten password.
#The list of questions with their respective index numbers is as follows:
#1, What city were you born in ?"
#2, What was your high school mascot?"
#3, What is your mother's maiden name?"
#4, What was the make of your first car?"
#5, What high school did you go to?"
#6, What is the last name of your best friend?"
#7, What is the middle name of your youngest sibling?"
#8, What is the name of the street on which you grew up?"
#9, What is the name of your favorite fictional character?"
#10, What is the name of your favorite pet?"
#11, What is the name of your favorite restaurant?"
#12, What is the title of your favorite book?"
#13, What is your dream job?"
#14, Where did you go on your first date?");
PORTAL_ADMIN_SECURITY_QUESTION_INDEX =
# Answer to the secret question
# e.g \"My Answer\"
PORTAL_ADMIN_SECURITY_QUESTION_ANSWER =
# Portal content directory where portal will store default and user-generated content.
# By default, the portal content directory will be created locally.
# e.g. C:\\arcgisportal, or \\\\<Absolute path to>\\<portal arcgisportal>
PORTAL_CONTENT_DIRECTORY =
# The path to the portal license file
PORTAL_LICENSE_FILE =
# The ID of the user type for the Initial Administrator
PORTAL_USER_TYPE_ID =
Avant que l’outil ne se ferme, vous recevez un message indiquant que le portail a bien été créé.
Utilisation de l’utilitaire de ligne de commande listadministratorusertypes pour identifier les types d’utilisateurs compatibles
Pour identifier les ID de types d’utilisateurs disposant d’une licence pour votre organisation et compatibles avec le rôle Administration, exécutez l’utilitaire de ligne de commande listadministratorusertypes. Cela permet de générer une liste d’entrées pour le paramètre createportal dans l’outil -ut. Exécutez l’outil avec -lf comme indiqué ci-dessous, en utilisant le fichier de licence du portail comme entrée :
<Portal for ArcGIS Installation Directory>/tools/createportal/listadministratorusertypes.sh
Exemple d’utilisation avec l’utilitaire : listadministratorusertypes.sh [-lf <arg>] ou listadministratorusertypes.sh [--listadministratorusertypes <arg>]
Configuration de la post-installation
Pour faire démarrer Portal for ArcGIS en même temps que le système d’exploitation, suivez les étapes ci-après correspondant à votre système d’exploitation.
Systèmes d’exploitation prenant en charge systemd
Si votre système d’exploitation prend en charge l’utilisation de systemd pour initialiser et gérer les processus (par exemple, si vous utilisez Red Hat 7.x), procédez comme suit pour configurer le démarrage de Portal for ArcGIS avec le système d’exploitation :
Dans un shell de commande, connectez-vous en tant qu’utilisateur racine.
Copiez le fichier d’unité
<Portal for ArcGIS installation directory>/framework/etc/arcgisportal.servicedans/etc/systemd/system.. Une fois le fichier copié, assurez-vous que les autorisations d’accès aux fichiers de/etc/systemd/system/arcgisportal.servicesont définies sur 600.Remarque :
Ce fichier est installé avec Portal for ArcGIS.
Toujours en tant qu’utilisateur racine, exécutez la commande suivante pour créer automatiquement les liens dans
/etc/systemd/system/multi-user.target.wants:# systemctl enable arcgisportal.servicePour vous assurer que le service systemd est correctement configuré, redémarrez le service et vérifiez son statut.
# systemctl stop arcgisportal.service # systemctl start arcgisportal.service # systemctl status arcgisportal.serviceRemarque :
Pour empêcher un service de produire un trop grand nombre de threads et de consommer trop de ressources système, systemd v228 et les versions ultérieures inclus dans SLES12 SP2 et versions ultérieures fixent le nombre maximum de threads pouvant être créés à 512. Les utilisateurs sur SLES12 devront peut-être activer et augmenter cette limite en cas d’utilisation intense du système. Pour activer et augmenter cette limite, en tant qu’utilisateur racine, supprimez les marques de commentaires et modifiez la ligne suivante dans le fichier d’unité arcgisportal.service avant de le déployer dans le dossier /etc/systemd/system :
# TasksMax=512Déconnectez-vous en tant qu'utilisateur racine.
Relancez le système d’exploitation et vérifiez que Portal for ArcGIS démarre correctement.
Systèmes d’exploitation prenant en charge SysV
Si votre système d’exploitation est compatible avec l’utilisation de SysV pour initialiser et gérer les processus, procédez comme suit pour configurer le démarrage de Portal for ArcGIS avec le système d’exploitation :
Dans un shell de commande, connectez-vous en tant qu’utilisateur racine.
Copiez le script shell de
<Portal for ArcGIS installation directory>/framework/etc/arcgisportalaux emplacements de distribution Linux pris en charge appropriés indiqués ci-dessous :RHEL :
/etc/rc.d/init.d/SUSE :
/etc/init.d/
Placez-vous dans le dossier init.d correct et vérifiez le script arcgisportal pour vous assurer que la racine dispose au moins d’autorisations de lecture et d’exécution.
Modifiez le script comme suit :
Mettez à jour la variable portalhome en lui affectant comme valeur le répertoire d’installation de Portal for ArcGIS. Par exemple,
/home/username/arcgis/portal.Uniquement pour RHEL, ajoutez la ligne ci-dessous juste avant
# Description: Portal for ArcGIS Service:
# chkconfig: 35 99 01
- Enregistrez les modifications apportées au script
arcgisportal.
Toujours en tant qu’utilisateur racine, exécutez les commandes suivantes pour créer automatiquement les liens dans
/etc/rc*.davec les niveaux d’exécution appropriés :RHEL :
$ chkconfig --add arcgisportal $ chkconfig arcgisportal onSUSE :
$ insserv arcgisportal $ chkconfig arcgisportal on
Déconnectez-vous en tant qu'utilisateur racine.
Relancez le système d’exploitation et vérifiez que Portal for ArcGIS démarre correctement.
<Portal for ArcGIS Installation Directory>\tools\createportal\listadministratorusertypes.bat
Exemple d’utilisation avec l’utilitaire : listadministratorusertypes.bat [-lf <arg>] ou listadministratorusertypes.bat [--listadministratorusertypes <arg>]