Installer Portal for ArcGIS

La procédure suivante vous guide dans le processus d’installation de Portal for ArcGIS. Avant de démarrer, il est important de déterminer l’URL de votre organisation.

Remarque :

Si vous procédez à la mise à niveau d’une installation existante, reportez-vous à la rubrique Mettre à niveau 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.
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.

Remarque :

Depuis ArcGIS Enterprise 11.3, le paquetage auto-extractible Portal for ArcGIS est composé de deux fichiers portant les extensions .exe et .exe.001. Pour extraire le paquetage, vérifiez que les deux fichiers se trouvent bien dans le même dossier.

Vous êtes maintenant prêt à installer Portal for ArcGIS.

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

Pour installer Portal for ArcGIS à partir de l’interface utilisateur de l’installation, procédez comme suit :

Exécutez le programme d’installation à partir du dossier téléchargé ou du support d’installation de Portal for ArcGIS. Le programme d’installation commence par vérifier les conditions préalables à remplir pour l’installation et l’utilisation de Portal for ArcGIS. Si votre système ne remplit pas les conditions préalables, suivez les instructions contenues dans la boîte de dialogue pour résoudre les éventuels problèmes. Pour en savoir plus, reportez-vous à la rubrique Vérification des diagnostics du portail à l’aide de l’outil de diagnostic.
Exécutez le programme d’installation à partir du dossier téléchargé ou du support d’installation de Portal for ArcGIS, puis cliquez sur Next (Suivant).
Si toutes les conditions préalables sont remplies, la boîte de dialogue Introduction s’affiche. Cliquez sur Suivant pour continuer.
Lisez le contrat principal, acceptez-le et cliquez sur Next (Suivant) ou quittez l’assistant si vous n’êtes pas d’accord avec les conditions.
Dans la boîte de dialogue Master Agreement (Contrat principal), lisez le contrat de licence. Si vous acceptez les termes, cliquez sur le bouton I accept the master agreement (J’accepte le contrat principal), puis sur Next (Suivant) pour continuer. Dans le cas contraire, quittez le programme d’installation en cliquant sur Cancel (Annuler).
Indiquez le répertoire d’installation de Portal for ArcGIS, puis cliquez sur Next (Suivant). Le répertoire d’installation de Portal for ArcGIS correspond aux composants logiciels du portail.
Dans la boîte de dialogue Choose Install Folder (Choisir un dossier d’installation), indiquez l’emplacement de l’installation. Si vous pointez le programme d’installation sur un répertoire de portail antérieur, le contenu de ce répertoire est utilisé automatiquement pour la nouvelle installation. Le contenu provenant d’installations antérieures à la version 10.2 n’est pas pris en charge. Cliquez sur Next (Suivant) pour continuer.
Spécifiez le répertoire de contenu du portail. Le répertoire de contenu stocke le contenu installé avec le portail ainsi que le contenu généré par les utilisateurs.
- Une fois l’installation terminée, vous pouvez changer le compte utilisé pour exécuter Portal for ArcGIS. Pour plus d’informations sur le compte et la manière de le changer, reportez-vous à la rubrique Compte Portal for ArcGIS.
- Si Portal for ArcGIS a déjà été installé, vous pouvez uniquement choisir d’utiliser le répertoire de contenu existant s’il s’agit d’un répertoire local. Si le répertoire existant provient d’une localisation de réseau partagée, vous ne pouvez pas le spécifier dans le programme d’installation. Vous pouvez toutefois configurer votre portail pour qu’il utilise le répertoire de contenu existant après l’installation. Pour en savoir plus, reportez-vous à la rubrique Modifier le répertoire de contenu du portail.
Lisez les informations récapitulatives et cliquez sur Install (Installer) pour démarrer l’installation.
Une fois le processus d’installation terminé, cliquez sur Done (Terminé) pour quitter le programme d’installation.

Remarque :

Une fois que l’installation de Portal for ArcGIS est terminée, le navigateur Web par défaut du système d’exploitation s’ouvre pour que vous puissiez réaliser la configuration et l’autorisation initiales de Portal for ArcGIS.
Indiquez le compte que Portal for ArcGIS doit utiliser pour exécuter diverses fonctions en complément du portail. Deux options vous sont proposées : Specify the account name and password (Indiquez le nom de compte et le mot de passe) et I have a configuration file with the account information generated by a previous run of this setup (Je possède un fichier de configuration avec des informations de compte générées par une exécution précédente du programme d’installation).
- L’option Specify the account name and password (Spécifiez le nom du compte et le mot de passe) vous permet de spécifier directement le nom du compte et le mot de passe. Le compte utilisé peut être un compte local, un compte de domaine ou un compte de service géré. Le compte que vous spécifiez n’a pas besoin de faire partie du groupe des administrateurs dans Windows. Si vous utilisez un compte de service géré, le compte doit déjà être configuré sur votre machine. Si vous utilisez un compte du système d’exploitation local, le compte est créé automatiquement s’il n’existe pas. Le nom par défaut du compte est arcgis. La stratégie de mot de passe pour ce compte dépend de votre système d’exploitation et de la stratégie de sécurité de l’organisation, et non du programme d’installation de Portal for ArcGIS. Pour plus d’informations, reportez-vous à la rubrique Compte Portal for ArcGIS.
  
  Remarque :
  
  Dans le cas de systèmes de production, il est recommandé d’utiliser un compte préexistant qui figure dans votre domaine ou dans Active Directory et qui est conforme à la stratégie de sécurité de votre organisation. La création d’un compte local pendant l’installation permet avant tout d’accélérer l’installation de Portal for ArcGIS.
  
  Si vous indiquez un compte de domaine, il doit déjà exister dans le domaine et être saisi au format suivant : mydomain\domainaccount.
- Si vous disposez d’un fichier de configuration du portail généré lors d’une exécution précédente du programme d’installation de Portal for ArcGIS, sélectionnez l’option I have a configuration file with the account information generated by a previous run of this setup (Je possède un fichier de configuration avec des informations de compte générées par une exécution précédente du programme d’installation). Accédez à l’emplacement du fichier de configuration du portail. Le compte Portal for ArcGIS est automatiquement configuré avec les informations de compte contenues dans le fichier de configuration.
Cliquez sur Next (Suivant) > Install (Installer).
À la fin de l’installation, cliquez sur Finish (Terminer).
Vous devez également installer Portal for ArcGIS Web Styles pour utiliser un ensemble complet de symbologie 3D à partir de Scene Viewer. Pour plus d’informations, reportez-vous à la rubrique Configuration requise pour Scene Viewer.

Configuration de la postinstallation

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 est compatible avec l’utilisation de systemd pour initialiser et gérer les processus (par exemple, si vous utilisez Red Hat Enterprise Linux (RHEL) Server 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.service dans /etc/systemd/system.. Une fois le fichier copié, assurez-vous que les autorisations d’accès aux fichiers de /etc/systemd/system/arcgisportal.service sont 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.service

Pour 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.service

Déconnectez-vous en tant qu’utilisateur racine.
Relancez le système d’exploitation et vérifiez que Portal for ArcGIS démarre correctement.

Remarque :

La version de systemd (v228 et versions ultérieures) incluse dans SUSE Linux Enterprise Server (SLES) 12 SP2 et versions ultérieures fixe à 512 le nombre maximal de threads qu’il est possible de créer. Les utilisateurs sur SLES 12 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 vers le dossier /etc/systemd/system : # TasksMax=512

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/arcgisportal aux emplacements de distribution Linux pris en charge appropriés indiqués ci-dessous :
- RHEL Server : /etc/rc.d/init.d/
- SLES : /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 :
1. 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.
2. Uniquement pour RHEL Server, ajoutez la ligne ci-dessous juste avant # Description: Portal for ArcGIS Service :
# chkconfig: 35 99 01
1. 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*.d avec les niveaux d’exécution appropriés :
- RHEL :
```
$ chkconfig --add arcgisportal
$ chkconfig arcgisportal on
```
- SUSE :
```
$ 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.

Si vous rencontrez une erreur lors de l’installation

Si vous rencontrez une erreur lors de l’installation, vous pouvez consulter les journaux pour faciliter sa résolution. Commencez par déterminer si vous pouvez accéder au répertoire Portal for ArcGIS. Si vous le pouvez, interrogez les journaux et consultez les messages. Si vous ne pouvez pas, consultez les messages des journaux sur le disque. Pour consulter les journaux sur le disque, accédez au répertoire des journaux et ouvrez le fichier journal le plus récent (par exemple, <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20150101.095803-8596-0.0.log). Si cela est nécessaire, vous pouvez partager ces informations avec le support technique Esri.

Si vous rencontrez une erreur lors de l’installation, vous pouvez consulter les journaux pour faciliter sa résolution. Commencez par déterminer si vous pouvez accéder au répertoire Portal for ArcGIS. Si vous le pouvez, interrogez les journaux et consultez les messages. Si vous ne pouvez pas, consultez les messages des journaux sur le disque. Pour consulter les journaux sur le disque, accédez au répertoire des journaux et ouvrez le fichier journal le plus récent (par exemple, C:\arcgisportal\logs\<machine name>\portal\portal-20150101.095803-8596-0.0.log). Si cela est nécessaire, vous pouvez partager ces informations avec le support technique Esri.

Si la machine du portail est dotée de plusieurs cartes NIC

Si la machine du portail est dotée de plusieurs cartes NIC ou entrées DNS

ArcGIS Enterprise peut être déployé sur des machines dotées de plusieurs cartes NIC (contrôleur d’interface réseau) ou de plusieurs entrées (appelées aussi enregistrements) dans un serveur DNS. Si vous avez installé Portal for ArcGIS sur ce type de machine, vous pouvez juger utile d’identifier l’adresse IP ou le nom d’hôte que le portail doit utiliser pour la communication réseau. Pour ce faire, mettez à jour un fichier existant et ajoutez un nouveau fichier dans le répertoire d’installation du portail, qui est par défaut /home/User/arcgis/portal.

Attention :

Effectuez cette procédure immédiatement après l’installation, avant de créer le compte d’administrateur initial et le site du portail.

Connectez-vous à la machine sur laquelle Portal for ArcGIS est installé. Accédez au dossier <Portal installation directory>/framework/etc. Créez un fichier nommé hostname.properties, avec les autorisations appropriées, dans ce dossier.
Connectez-vous à la machine sur laquelle Portal for ArcGIS est installé. Accédez au dossier <Portal installation directory>\framework\etc. Créez un fichier nommé hostname.properties, avec les autorisations appropriées, dans ce dossier.
Ajoutez le texte suivant à la première ligne du fichier, puis indiquez le nom de domaine complet de l’interface prévue : hostname=interface.example.com. Par exemple, dans le cas où vous disposez d’une machine avec deux cartes NIC ou entrées DNS (1 et 2) et que les noms de domaine de leur interface deviennent P1.mycompany.com et P2.mycompany.com, si vous souhaitez que Portal for ArcGIS utilise la seconde interface pour la communication réseau, ajoutez ce texte au fichier hostname.properties : hostname=P2.mycompany.com.

Remarque :

Dans certains cas, par exemple, lorsqu’un nom d’hôte est identique pour plusieurs interfaces, vous devez plutôt spécifier l’adresse IP de l’interface qu’ArcGIS Server doit utiliser pour les communications réseau. Cette syntaxe est hostname=<IP address>.
Enregistrez et fermez le fichier hostname.properties.
Accédez au dossier <Portal installation directory>/framework/runtime/ds/framework/etc et cherchez le fichier hostidentifier.properties.
Accédez au dossier <Portal installation directory>\framework\runtime\ds\framework\etc et cherchez le fichier hostidentifier.properties.
Ouvrez le fichier dans un éditeur de texte. Supprimez la marque de commentaire # de la propriété hostidentifier, puis définissez la propriété sur l’adresse IP de la carte NIC ou de l’entrée DNS que le portail doit utiliser pour la communication réseau. Par exemple, si vous voulez désigner l’adresse IP 12.34.56.189, la ligne doit indiquer ce qui suit :

hostidentifier=12.34.56.189
Enregistrez et fermez le fichier hostidentifier.properties.
Redémarrez le portail à l’aide des scripts de ligne de commande stopportal.sh et startportal.sh.
Redémarrez le service Portal for ArcGIS sous Windows.

Remarque :

Lorsque vous mettez à niveau votre portail vers une version plus récente, la mise à niveau rétablit le contenu par défaut de ce fichier hostidentifier.properties. Vous devez à nouveau ajouter l’adresse IP appropriée une fois la mise à niveau terminée.

Si nécessaire, suivez les étapes indiquées pour configurer d’autres composants logiciels ArcGIS Enterprise sur des machines comportant plusieurs cartes NIC ou plusieurs entrées DNS, par exemple :