Vous pouvez installer Portal for ArcGIS sans faire appel à une interface utilisateur, en exécutant le programme d’installation à l’aide des paramètres de ligne de commande de Windows Installer.
Remarque :
Pour plus d’informations sur une mise à niveau vers la version 10.9, reportez-vous à la rubrique À propos de la mise à niveau de Portal for ArcGIS.
Préparation de l’installation de Portal for ArcGIS
- 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.
- Ouvrez les ports, comme expliqué dans la rubrique Ports utilisés par Portal for ArcGIS.
- Fermez toutes les applications non critiques sur le serveur.
- Exécutez les commandes d'installation comme expliqué ci-après.
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=yes
Cette 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.pdf se 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\Portal est 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 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 Le compte Portal for ArcGIS. Si vous ne définissez pas cette propriété, l’emplacement d’installation par défaut C:\arcgisportal est 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 des 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 Système local. Cette procédure s’utilise principalement 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 identifiants de connexion du 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 que les identifiants de connexion ne sont pas valides, le programme d’installation de Portal for ArcGIS affiche un message d’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 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=<mot de passe du compte>
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=<chemin complet et nom du fichier de configuration du portail>
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 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 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=<chemin complet et nom du fichier de configuration du portail>
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 .xml et le dossier spécifié doit déjà exister. Si le fichier ne possède pas d’extension .xml et 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.
Utilisation d’un 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 Portal for ArcGIS installé. Vous pouvez utiliser l’utilitaire createportal comme suit :
- Exécutez l’utilitaire createportal en 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.properties contenant les paramètres spécifiés.
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 dans le fichier createportal.properties, vous devez indiquer un caractère d’échappement devant les barres obliques inverses, par exemple C:\\arcgisportal ou \\\\<Absolute path to>\\<portal arcgisportal>.
| Option | Description |
|---|---|
-fn; --firstname | 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. |
-ln; --lastname | Nom pour un compte administrateur initial utilisé pour configurer le portail. Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets. |
-u; --username | Nom d’utilisateur pour un compte administrateur initial utilisé pour configurer le portail. Le nom d’utilisateur peut être composé des chiffres de 0 à 9, des lettres ASCII de a à z et de A à Z, et du point (.). |
-p; --password | 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 (.). |
-e; --email | Adresse électronique pour un compte administrateur initial utilisé pour configurer le portail. |
-qi; --question | 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 :
|
-qa; --answer | Réponse à la question secrète que vous avez choisie pour le paramètre -qi. Assurez-vous que les entrées à plusieurs mots sont comprises entre des guillemets. |
-d; --contentDirectory | 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 : C:\arcgisportal ou \\<Absolute path to>\<Content Directory> |
-lf; --licenseFile | Chemin d’accès au fichier de licence du portail. |
-ut; --userTypeId | 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 -ut, exécutez l’utilitaire listadministratorusertypes. Si aucun ID de type d’utilisateur n’est spécifié et que le fichier de licence du portail contient un seul type d’utilisateur compatible, celui-ci est attribué. Si le fichier de licence contient plusieurs types d’utilisateurs compatibles, un type d’utilisateur temporaire est attribué et l’administrateur initial est tenu de sélectionner un type d’utilisateur après s’être connecté. |
-f; --file | Fichier de propriétés de l’utilitaire createportal. Par défaut, le fichier createportal.properties se trouve à cet emplacement : <Portal for ArcGIS Installation Directory>/tools/createportal |
-h; --help | 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@domain.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 -ut dans l’outil createportal. Exécutez l’outil avec -la comme indiqué ci-dessous, en utilisant le fichier de licence du portail comme entrée :
<Portal for ArcGIS Installation Directory>\tools\createportal\listadministratorusertypes.bat
Exemple d’utilisation avec l’utilitaire : listadministratorusertypes.bat [-la <arg>] ou listadministratorusertypes.bat [--listadministratorusertypes <arg>]
Vous avez un commentaire à formuler concernant cette rubrique ?