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.8.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 cela est 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 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 navigateur web par défaut du système d’exploitation s’ouvre pour réaliser la configuration et l’autorisation initiales de Portal for ArcGIS.

7. Vous devez également installer la configuration Web Styles (Styles Web) 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 que Portal for ArcGIS démarre avec le système d’exploitation, suivez les étapes correspondant à votre système d’exploitation ci-dessous.

Systèmes d'exploitation prenant en charge systemd

Si votre système d’exploitation prend en charge ’'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.

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é, vérifiez que les autorisations du fichier de /etc/systemd/system/arcgisportal.service sont définies sur 600.

   Remarque :

   Ce fichier est installé avec Portal for ArcGIS 10.8.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 :

systemd v228 et les versions ultérieures inclus dans SLES12 SP2 et versions ultérieures fixent le nombre maximal 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 vers le dossier /etc/systemd/system : # TasksMax=512

Systèmes d'exploitation prenant en charge SysV

Si votre système d’exploitation prend en charge d’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 : /etc/rc.d/init.d/
   • SUSE : /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, ajoutez la ligne ci-dessous juste avant # Description: Portal for ArcGIS Service :

      # chkconfig: 35 99 01

   3. Enregistrez les mises à jour 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 accéder aux 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). Vous pouvez également partager ces informations avec le support technique Esri, si cela est nécessaire.

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 une machine de ce type, vous pouvez 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, et indiquez le nom de domaine complet de l’interface prévue : hostname=interface.domain.com. Par exemple, si vous disposez d’une machine avec deux cartes NIC ou des entrées DNS (1 et 2), les noms de domaine de ces interfaces deviennent P1.mycompany.com et P2.mycompany.com. Si vous voulez 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 le même pour plusieurs interfaces, vous devez plutôt spécifier l’adresse IP de l’interface que vous souhaitez que ArcGIS Server utilise pour la communication réseau. Cette syntaxe 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 le fichier hostidentifier.properties.
5. Ouvrez le fichier dans un éditeur de texte. Supprimez la marque de commentaire # de la propriété hostidentifier et 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éinitialise ce fichier hostidentifier.properties sur son contenu par défaut. Vous devez à nouveau ajouter l’adresse IP appropriée une fois la mise à niveau terminée.

Si nécessaire, suivez les étapes 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