Installation de Portal for ArcGIS

La procédure suivante vous guide dans le processus d'installation de Portal for ArcGIS.

Remarque :

Si vous procédez à la mise à niveau vers 10.9.1, reportez-vous à la rubrique Mettre à niveau votre portail ArcGIS Enterprise pour plus d’informations.

Préparation de l’installation de Portal for ArcGIS

1. Vérifiez que le site respecte la configuration système requise.
2. Connectez-vous à l'ordinateur en tant qu'utilisateur disposant de privilèges d'administration. Vous ne pouvez pas installer Portal for ArcGIS en tant qu’utilisateur racine.
3. Ouvrez les ports, comme expliqué dans la rubrique Ports utilisés par Portal for ArcGIS.
4. Fermez toutes les applications non critiques sur le serveur.
5. Accédez au dossier téléchargé contenant le programme d’installation de Portal for ArcGIS ou insérez le support Portal for ArcGIS dans le lecteur approprié pour démarrer automatiquement le programme d’installation.

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

Installation de Portal for ArcGIS

1. 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.
2. Si toutes les conditions sont remplies, la boîte de dialogue Introduction s’affiche. Cliquez sur Suivant pour continuer.
3. Dans la boîte de dialogue Master Agreement (Contrat principal), lisez le contrat de licence. Si vous acceptez les termes, cliquez sur le bouton J'accepte le contrat principal, puis sur Suivant pour continuer. Dans le cas contraire, quittez le programme d'installation en cliquant sur Annuler.
4. 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 Suivant pour continuer.
5. Lisez les informations récapitulatives et cliquez sur Installer pour démarrer l'installation.
6. Une fois le processus d’autorisation terminé, cliquez sur Done (Terminé) pour quitter l’assistant.

   Remarque :

   Une fois l’installation de Portal for ArcGIS terminée, le système d’exploitation ouvre le navigateur Web par défaut à partir duquel vous allez réaliser la configuration et l’autorisation initiales de Portal for ArcGIS.

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

1. Dans un shell de commande, connectez-vous en tant qu’utilisateur racine.
2. 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 10.9.1.

3. 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

4. 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

5. Déconnectez-vous en tant qu'utilisateur racine.
6. Redémarrez le système d’exploitation et vérifiez que Portal for ArcGIS redé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.

1. Dans un shell de commande, connectez-vous en tant qu’utilisateur racine.
2. Copiez le script shell figurant dans <Portal for ArcGIS installation directory>/framework/etc/arcgisportal aux emplacements de distribution Linux pris en charge indiqués ci-dessous :
   • RHEL Server : /etc/rc.d/init.d/
   • SLES : /etc/init.d/
3. 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.
4. 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

   3. Enregistrez les modifications apportées au script arcgisportal.

5. 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

6. Déconnectez-vous en tant qu'utilisateur racine.
7. Réinitialisez le système d’exploitation et vérifiez que Portal for ArcGIS redé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 la machine du portail est dotée de plusieurs cartes NIC (Network Interface Controller)

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.

1. 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.
2. Ajoutez le texte suivant à la première ligne du fichier, puis indiquez le nom de domaine complet de l’interface prévue : hostname=interface.domain.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 que ArcGIS Server doit utiliser pour la communication réseau. La syntaxe à utiliser est hostname=<IP address>.

3. Enregistrez et fermez le fichier hostname.properties.
4. Accédez au dossier <Portal installation directory>/framework/runtime/ds/framework/etc et localisez le fichier hostidentifier.properties.
5. 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

6. Enregistrez et fermez le fichier hostidentifier.properties.
7. Redémarrez le portail à l’aide des scripts de ligne de commande stopportal.sh et startportal.sh.

   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 :

• ArcGIS Server
• ArcGIS Data Store