Installation de Insights in ArcGIS Enterprise

Pour installer et configurer ArcGIS Insights in ArcGIS Enterprise, vous devez disposer de privilèges élevés dans un environnement de déploiement.

Pour procéder à l’installation, il est nécessaire d’avoir installé au moins Portal for ArcGIS et ArcGIS Server, soit sur la même machine, soit séparément dans un environnement distribué. Un déploiement de base complet de ArcGIS Enterprise est requis pour utiliser Insights in ArcGIS Enterprise.

Le programme d’installation détecte si Portal for ArcGIS ou ArcGIS Server est installé sur votre machine, puis installe la fonctionnalité Insights appropriée. Si ni Portal for ArcGIS, ni ArcGIS Server ne sont détectés, le programme se ferme.

Remarque :

Pour un déploiement sur une seule machine, vous n’avez besoin d’exécuter l’installation qu’une seule fois. Si votre Portal for ArcGIS est configuré en haute disponibilité, vous devez exécuter le programme d’installation sur les deux machines du portail. Si votre serveur d’hébergement est un site à plusieurs ordinateurs, vous devez exécuter le programme d’installation sur tous les ordinateurs figurant sur le site du serveur d’hébergement.

Windows

Référez-vous aux sections suivantes pour procéder au téléchargement, à l’installation et à la désinstallation de Insights sous Windows :

• Télécharger le paquetage d’installation
• Exécuter le programme d’installation
• Installer le paquetage d’aide (facultatif)
• Désinstaller Insights in ArcGIS Enterprise

Télécharger le paquetage d’installation

Le programme d’installation Insights in ArcGIS Enterprise compte deux fonctionnalités d’installation :

• Application client Insights sur Portal for ArcGIS
• ArcGIS Server de Insights

Procédez comme suit pour télécharger le paquetage d’installation pour Windows :

1. Connectez-vous au site My Esri à l’aide du compte Esri associé à votre numéro de client.
2. Accédez à My Organization (Mon organisation) et cliquez sur Downloads (Téléchargements).

   Tous les téléchargements logiciels qui vous sont disponibles (en fonction de votre numéro de client) sont affichés.

3. Recherchez ArcGIS Insights parmi les produits.

   La dernière version du logiciel est sélectionnée par défaut. Consultez la rubrique Compatibilité avec ArcGIS Enterprise pour connaître les versions compatibles avec votre déploiement.

4. Modifiez le numéro de version, si nécessaire, puis cliquez sur View Downloads (Afficher les téléchargements).
5. Dans la boîte de dialogue Download (Téléchargement), examinez les informations de version et de langue. Modifiez la langue de téléchargement, si nécessaire.
6. Dans l’onglet Download Components (Télécharger les composants), sous le menu Product Components (Composants produit), recherchez ArcGIS Insights (Windows).
7. Cliquez sur Télécharger.

   Le paquetage d’installation est téléchargé et enregistré dans le répertoire par défaut de votre navigateur (par exemple, Téléchargements).

   Si vous souhaitez consulter l’aide installée dans une langue prise en charge autre que l’anglais, vous devez également télécharger et installer le module linguistique de l’aide.

8. Facultatif : sur l’onglet Download Components (Télécharger les composants), sous le menu Language Packs (Modules linguistiques), localisez ArcGIS Insights (Windows) Help Language Pack (ArcGIS Insights (Windows) - Module linguistique de l’aide) et cliquez sur Download (Télécharger).

Vous êtes maintenant prêt à exécuter le programme d’installation

Exécuter le programme d’installation

Remarque :

Les connexions SharePoint, OneDrive, et Jupyter Kernel Gateway sont activées par défaut. Vous avez la possibilité de désactiver ces connexions pour votre organisation au cours du processus d’installation.

Vous êtes inscrit par défaut au programme d’amélioration de l’expérience des utilisateurs Esri lorsque vous installez Insights. Vous avez la possibilité de désactiver la participation à ce programme au cours du processus d’installation.

Pour plus d’informations, reportez-vous à la rubrique « Comment le programme d’amélioration de l’expérience des utilisateurs Esri fonctionne-t-il pour ArcGIS Insights ? ».

Pour exécuter le programme d’installation, procédez comme suit dans Windows :

1. Accédez à l’emplacement du fichier d’installation téléchargé, puis double-cliquez sur le fichier setup.exe.
2. Pendant l’installation, vous serez invité à lire l’accord de licence et à l’accepter ou à quitter l’assistant si vous n’êtes pas d’accord avec les termes de cet accord.
3. Facultatif : dans la boîte de dialogue Security Settings (Paramètres de sécurité), décochez les cases correspondant aux connexions SharePoint, OneDrive, et Jupyter Kernel Gateway pour les désactiver, si cela est nécessaire pour votre organisation.
4. Facultatif : dans la boîte de dialogue Ready to Install the Program (L’installation du programme peut commencer), désélectionnez Click here to participate in the Esri User Experience Improvement Program (Cliquez ici pour participer au programme d’amélioration de l’expérience de l’utilisateur Esri). (Recommandé) pour désactiver la participation au programme d’amélioration de l’expérience des utilisateurs Esri. La participation au programme est recommandée afin d’aider à améliorer l’expérience utilisateur.
5. Cliquez sur Installer.
   Le programme d’installation détecte le composant ArcGIS Enterprise sur votre ordinateur (Portal for ArcGIS, ArcGIS Server ou les deux) et installe les fonctionnalités appropriées.

   Remarque :

   Portal for ArcGIS et ArcGIS Server redémarreront automatiquement dans le cadre du processus d’installation.

Si vous travaillez dans un environnement distribué, répétez les étapes d’installation jusqu’à ce que le client soit installé sur l’ordinateur de votre portail (ou deux ordinateurs dans un déploiement haute disponibilité) et que le composant serveur (contenant les services Insights) soit installé sur chaque ordinateur ArcGIS Server du site ArcGIS Server.

Remarque :

Il est important d’exécuter les étapes d’installation à la fois sur les ordinateurs du portail et serveur dans le cadre d’un environnement distribué. Si les installations ne sont pas exécutées sur tous les ordinateurs, Insights ne s’installe pas correctement.

Les répertoires d’installation par défaut sont les suivants :

• C:\Program Files\ArcGIS\Portal\apps pour l’application client du portail
• C:\Program Files\ArcGIS\Server pour le composant serveur

Installer le paquetage d’aide (facultatif)

Insights in ArcGIS Enterprise inclut l’accès à l’aide de référence hors connexion (installée). L’aide en anglais est installée avec le programme d’installation de Insights in ArcGIS Enterprise. Il est possible d’installer un module linguistique séparément pour permettre l’accès à l’aide installée dans toutes les langues prises en charge.

Pour installer le module linguistique de l’aide de référence, procédez comme suit :

1. Accédez à l’emplacement du fichier d’installation du module linguistique téléchargé, puis double-cliquez sur le fichier ArcGIS_Insights_Help_LP_Windows.exe.

   Si le fichier d’installation ne se trouve pas sur votre ordinateur, suivez l’étape 8 de la procédure indiquée dans Télécharger le paquetage d’installation.

2. Suivez les invites du programme d’installation pour exécuter l’installation.

Désinstaller Insights in ArcGIS Enterprise

Pour désinstaller Insights sous Windows, procédez comme suit :

1. Ouvrez Control Panel (Panneau de configuration) et cliquez sur Programs and Features (Programmes et fonctionnalités).
2. Dans la liste Programs (Programmes), sélectionnez la version de Insights in ArcGIS Enterprise qui est installée sur votre ordinateur.
3. Sélectionnez Uninstall/Change (Désinstaller/Modifier) pour désinstaller Insights in ArcGIS Enterprise.

   Remarque :

   Portal for ArcGIS et ArcGIS Server redémarreront automatiquement dans le cadre du processus de désinstallation.

4. Si vous travaillez dans un environnement distribué, répétez les étapes de la procédure de désinstallation sur tous les ordinateurs exécutant Portal for ArcGIS et ArcGIS Server.

Linux

Référez-vous aux sections suivantes pour procéder au téléchargement, à l’installation et à la désinstallation de Insights sous Linux :

• Télécharger le paquetage d’installation
• Exécuter le programme d’installation
• Installer le paquetage d’aide (facultatif)
• Désinstaller Insights in ArcGIS Enterprise

Télécharger le paquetage d’installation

Le paquetage d’installation contient les fichiers clés suivants :

• Insights-<version-number>.portal.tgz : le client Web Insights de votre portail.
• Insights-<version-number>.server.tgz : les services Insights requis pour votre site ArcGIS Server.
• Insights-Setup.sh : le script d’environnement d’exécution qui exécute une installation en mode silencieux du client Web et des services Web susmentionnés.

1. Connectez-vous au site My Esri à l’aide du compte Esri associé à votre numéro de client.
2. Accédez à My Organization (Mon organisation) et cliquez sur Downloads (Téléchargements).

   Tous les téléchargements logiciels qui vous sont disponibles (en fonction de votre numéro de client) sont affichés.

3. Recherchez ArcGIS Insights parmi les produits.

   La dernière version du logiciel est sélectionnée par défaut. Consultez la rubrique Compatibilité avec ArcGIS Enterprise pour connaître les versions compatibles avec votre déploiement.

4. Modifiez le numéro de version, si nécessaire, puis cliquez sur View Downloads (Afficher les téléchargements).
5. Dans la boîte de dialogue Download (Téléchargement), examinez les informations de version et de langue. Modifiez la langue de téléchargement, si nécessaire.
6. Dans l’onglet Download Components (Télécharger les composants), sous le menu Product Components (Composants produit), recherchez ArcGIS Insights (Linux).
7. Cliquez sur Télécharger.

   Le paquetage d’installation est téléchargé et enregistré dans le répertoire par défaut de votre navigateur (par exemple, Téléchargements).

8. Facultatif : sur l’onglet Download Components (Télécharger les composants), sous le menu Language Packs (Modules linguistiques), localisez ArcGIS Insights (Linux) Help Language Pack (ArcGIS Insights (Linux) - Module linguistique de l’aide) et cliquez sur Download (Télécharger).

Vous êtes maintenant prêt à exécuter le programme d’installation

Exécuter le programme d’installation

Remarque :

Les connexions SharePoint, OneDrive, et Jupyter Kernel Gateway sont activées par défaut. Vous avez la possibilité de désactiver ces connexions pour votre organisation au cours du processus d’installation.

Vous êtes inscrit par défaut au programme d’amélioration de l’expérience des utilisateurs Esri lorsque vous installez Insights. Vous pouvez choisir de ne pas participer au programme au cours de l’installation ou en modifiant le fichier de paramètres une fois l’installation terminée.

Pour plus d’informations, reportez-vous à la rubrique « Comment le programme d’amélioration de l’expérience des utilisateurs Esri fonctionne-t-il pour ArcGIS Insights ? ».

Pour exécuter le programme d’installation, procédez comme suit dans Linux :

1. Connectez-vous à votre ordinateur en tant qu’utilisateur disposant de privilèges d’administration.

   Remarque :

   L’installation de Insights en tant qu’utilisateur racine n’est pas prise en charge.

2. Utilisez la syntaxe ./Insights-Setup.sh pour exécuter l’installation par défaut. Vous pouvez également ajouter les options de syntaxe suivantes pour personnaliser votre installation :
   • ./Insights-Setup.sh -h : afficher les options disponibles dans l’installation. Cette commande n’exécute pas le programme d’installation.
   • ./Insights-Setup.sh -e no (format court) ou ./Insights-Setup.sh --esri-user-experience-improvement no (format long) : désactiver la participation au programme d’amélioration de l’expérience des utilisateurs Esri. La participation au programme est recommandée afin d’aider à améliorer l’expérience utilisateur.
   • ./Insights-Setup.sh --SharePoint no : désactiver les connexions Microsoft SharePoint, si cela est nécessaire pour votre organisation.
   • ./Insights-Setup.sh --OneDrive no : désactiver les connexions Microsoft OneDrive, si cela est nécessaire pour votre organisation.
   • ./Insights-Setup.sh --KernelGateway no : désactiver les connexions Jupyter Kernel Gateway, si cela est nécessaire pour votre organisation.

   Vous avez la possibilité d’ajouter plusieurs paramètres à l’installation par défaut. Par exemple, pour désactiver la participation au programme d’amélioration de l’expérience des utilisateurs Esri et désactiver les connexions SharePoint, utilisez la syntaxe suivante : ./Insights-Setup.sh -e no --SharePoint no

   Remarque :

   Portal for ArcGIS et ArcGIS Server redémarreront automatiquement dans le cadre du processus d’installation.

Si vous travaillez dans un environnement distribué, répétez les étapes d’installation jusqu’à ce que le client soit installé sur l’ordinateur de votre portail (ou deux ordinateurs dans un déploiement haute disponibilité) et que le composant serveur (contenant les services Insights) soit installé sur chaque ordinateur ArcGIS Server du site ArcGIS Server.

Remarque :

Il est important d’exécuter les étapes d’installation à la fois sur les ordinateurs du portail et serveur dans le cadre d’un environnement distribué. Si les installations ne sont pas exécutées sur tous les ordinateurs, Insights ne s’installe pas correctement.

Installer le paquetage d’aide (facultatif)

Insights in ArcGIS Enterprise inclut l’accès à l’aide de référence hors connexion (installée). L’aide en anglais est installée avec le programme d’installation de Insights in ArcGIS Enterprise. Il est possible d’installer un module linguistique séparément pour permettre l’accès à l’aide installée dans toutes les langues prises en charge.

Pour installer le module linguistique de l’aide de référence, procédez comme suit :

1. Connectez-vous à votre ordinateur en tant qu’utilisateur disposant de privilèges d’administration.

   Remarque :

   L’installation de Insights en tant qu’utilisateur racine n’est pas prise en charge.

2. Utilisez la syntaxe ./ Language-Pack-Setup.sh pour exécuter l’installation.

   Si le fichier d’installation ne se trouve pas sur votre ordinateur, suivez l’étape 8 de la procédure indiquée dans Télécharger le paquetage d’installation.

Désinstaller Insights in ArcGIS Enterprise

Pour désinstaller Insights, exécutez les scripts suivants en ligne de commande :

$ ./{HOME}/arcgis/portal/uninstall_Insights.sh
$ ./{HOME}/arcgis/server/uninstall_Insights.sh

Si vous travaillez dans un environnement distribué, exécutez les scripts de la procédure de désinstallation sur tous les ordinateurs Portal for ArcGIS et ArcGIS Server.

Une fois Insights désinstallé, vous êtes invité à redémarrer Portal for ArcGIS en exécutant le script suivant : $ ./{HOME}/arcgis/portal/startportal.sh

Mettre à niveau Insights in ArcGIS Enterprise

Si une version précédente de Insights in ArcGIS Enterprise est installée et que vous souhaitez la mettre à niveau vers la version actuelle, il est inutile de désinstaller la version précédente. L’exécution du programme d’installation ArcGIS Insights met à niveau le logiciel vers la version actuelle. Pour plus d’informations sur l’installation de Insights sous Windows et Linux, consultez la procédure détaillée.

Si vous mettez à niveau à la fois ArcGIS Enterprise et Insights, ou seulement ArcGIS Enterprise, vous devez désinstaller Insights avant de procéder à la mise à niveau. Pour plus d’informations, consultez la rubrique Mettre à niveau un déploiement de base avec ArcGIS Enterprise Builder ou Mettre à niveau votre portail ArcGIS Enterprise.

Remarque :

Vous devez effacer le cache du navigateur après avoir mis à niveau Insights in ArcGIS Enterprise.

Pour plus d’informations sur les versions Insights prises en charge par votre déploiement ArcGIS Enterprise, consultez la rubrique Compatibilité avec ArcGIS Enterprise. Vous pouvez également vérifier les versions de base de données prises en charge.

Si votre organisation utilise des connexions aux bases de données, vérifiez les versions de bases de données prises en charge et les fichiers de fournisseurs requis.

Si votre organisation utilise des bases de données qui ne sont pas prises en charge immédiatement, vous devrez peut-être également mettre à niveau les fichiers de configuration. Pour plus d’informations sur les mises à jour récentes, reportez-vous à la rubrique Nouveautés dans les fichiers de configuration.

Dépannage

Si Insights ne fonctionne pas normalement dans un déploiement sur plusieurs machines, il est possible que l’installation n’ait pas été effectuée sur toutes les machines. Pour résoudre le problème, exécutez le programme d’installation sur toutes les machines figurant sur le site du serveur d’hébergement.

Une fois ArcGIS Enterprise mis à jour, certaines fiches de classeurs existants créées à l’aide de connexions aux bases de données peuvent être endommagées avec le message Error. The original data source no longer exists (Erreur. La source de données d’origine n’existe plus). Pour corriger cette erreur, ouvrez le classeur et actualisez chaque page comportant des fiches endommagées.

Etapes suivantes

Une fois Insights in ArcGIS Enterprise installé, la prochaine étape consiste à attribuer les types d’utilisateurs, privilèges et licences nécessaires aux utilisateurs Insights de votre organisation. Pour plus d’informations, reportez-vous à la rubrique Administrer Insights in ArcGIS Enterprise et Insights in ArcGIS Online.