ArcGIS Data Store est inscrit auprès du site GIS Server qui est défini comme le serveur d’hébergement pour un déploiement ArcGIS Enterprise. Vous devez mettre à niveau vers la même version tous les composants de ce déploiement.
Préparation de la mise à niveau de ArcGIS Data Store
Étudiez soigneusement les informations suivantes et effectuez les opérations requises avant de mettre à niveau ArcGIS Data Store :
- Prenez connaissance de la configuration système requise pour ArcGIS Data Store 11.1 afin de vous assurer que votre matériel répond aux conditions actuellement requises.
- La mise à niveau directe vers ArcGIS Data Store11.1 à partir des versions 10.6.1 ou antérieures n’est pas prise en charge. Pour mettre à niveau ArcGIS Data Store 10.6.1 ou version antérieure, commencez par une mise à niveau vers une version intermédiaire (10.7.x à 10.9.1), puis mettez à niveau cette version vers 11.1. Consultez la documentation sur la mise à niveau de la version intermédiaire pour vérifier que les mises à niveau directes sont prises en charge pour la version ArcGIS Data Store de laquelle vous partez.
- Avant d’effectuer la mise à niveau d’un data store relationnel ou d’un data store de cache tuilé, vérifiez la taille du répertoire ArcGIS Data Store sur chaque machine. Assurez-vous que chaque machine dispose d’un espace disque suffisant pour contenir le double de la taille du répertoire ArcGIS Data Store.
- Si vous avez un répertoire de données du cache de tuiles qui fonctionne en mode principal-secours, assurez-vous que la machine en veille a accès à l’emplacement de sauvegarde par défaut avant de mettre à niveau. Si tel n’est pas le cas, vous ne disposez d’aucun emplacement de sauvegarde par défaut pour votre répertoire de données du cache de tuiles une fois la mise à niveau effectuée, et vous devrez en configurer un.
- Si vous avez un data store de cache tuilé qui contient plusieurs machines et que vous procédez à une mise à niveau depuis 10.7.x, 10.8.x ou 10.9, vous devez également ouvrir les ports 29079 à 29090 et 4369 dans le pare-feu.
- Si vous mettez à niveau un object store ArcGIS Data Store 10.9 vers 11.1, vous devez ouvrir les ports 29878 (HTTP) et 29879 (HTTPS) sur les machines de l’object store pour autoriser le serveur d’hébergement à communiquer avec lui. Dans la version 10.9, le port 9900 était utilisé. Ce port n’est plus requis. Vous devez également ouvrir les ports 9880 (HTTP) et les ports 9820, 9830 et 9840 (TCP) pour assurer la communication entre les machines de l’object store si ce dernier est déployé en mode de grappe.
- Les ports suivants doivent être disponibles sur les machines de data store relationnel avant la mise à niveau : 25672, 44369, 45671 et 45672. Les deux premiers doivent être disponibles, les deux suivants doivent être ouverts pour communiquer avec le serveur d’hébergement ou d’autres sites ArcGIS GIS Server fédérés. Si vous n’ouvrez pas ces ports, vous ne pouvez pas créer des webhooks de service dans le déploiement ArcGIS Enterprise.
- Si vous mettez à niveau un Spatiotemporal Big Data Store 10.8.1, regardez si le déploiement ArcGIS Enterprise contient des services de carte ArcGIS GeoEvent Server qui utilisent une agrégation carrée ou hexagonale. Dans l’affirmative, vous devez accomplir des étapes complémentaires après la mise à niveau du Spatiotemporal Big Data Store en vue de corriger un problème de rendu.
- Les object stores ArcGIS Data Store 11.1 déployés en mode de grappe doivent contenir un nombre impair de machines. Lorsque vous mettez à niveau un object store 10.9 en grappe vers 11.1, vous devrez peut-être ajouter une machine à l’object store après la mise à niveau.
- Créez une sauvegarde de tous les Data Stores du déploiement et stockez les fichiers de sauvegarde dans un emplacement à distance et sécurisé.
- Téléchargez les fichiers d’installation du logiciel ArcGIS Data Store, Portal for ArcGIS, ArcGIS Server et ArcGIS Web Adaptor les plus récents à partir de My Esri. Téléchargez également les fichiers d’autorisation 11.1 pour Portal for ArcGIS et ArcGIS Server depuis My Esri.
Tous les composants d’un déploiement ArcGIS Enterprise de base doivent être de la même version logicielle.
- ArcGIS Data Store est toujours utilisé dans le cadre d’un déploiement ArcGIS Enterprise et vous devez mettre à niveau certains composants du déploiement avant la mise à niveau de ArcGIS Data Store. Lisez la section suivante et mettez à niveau les composants ArcGIS Enterprise requis avant de procéder à la mise à niveau de ArcGIS Data Store.
Ordre de mise à niveau d’ArcGIS Enterprise
L’ordre recommandé pour mettre à niveau les composants de votre déploiement d’ArcGIS Enterprise est le suivant :
- Mettez à niveau Portal for ArcGIS.
- Mettez à niveau ArcGIS Web Adaptor (pour Portal for ArcGIS) pour IIS ou Java (Windows).
- Mettez à niveau le site ArcGIS Server qui fait office de serveur d’hébergement du portail.
- Mettez à niveau ArcGIS Web Adaptor (pour ArcGIS Server) pour IIS ou Java (Windows).
- Mettez à niveau ArcGIS Data Store.
- S’ils sont inclus dans votre déploiement ArcGIS Enterprise, mettez à niveau les serveurs fédérés.
La plupart des serveurs fédérés doivent correspondre à la version du déploiement ArcGIS Enterprise de base. Pour plus d’informations sur les versions prises en charge pour les serveurs fédérés, reportez-vous à la rubrique Fédérer une instance ArcGIS Server avec votre portail.
Reportez-vous aux informations de mise à niveau correspondant au type des serveurs fédérés à mettre à niveau.
Étapes de mise à niveau de ArcGIS Data Store
Une fois que vous disposez des fichiers d’installation et de sauvegarde et que vous avez mis à niveau le serveur d’hébergement, passez aux étapes de mise à niveau pour chaque type de répertoire de données. Tous les data stores inscrits auprès du même site ArcGIS Server doivent exécuter la même version de ArcGIS Data Store. Gardez les points suivants à l’esprit lorsque vous mettez à niveau ArcGIS Data Store :
- Installez toujours ArcGIS Data Store sur toutes les machines d’un data store avant de reconfigurer celui-ci.
- Ne désinstallez pas ArcGIS Data Store avant d’installer la nouvelle version.
L’exécution du programme d’installation de la version 11.1 de ArcGIS Data Store assure la mise à niveau automatique du déploiement ArcGIS Data Store 10.7 ou version ultérieure vers 11.1. Il n’est pas nécessaire d’obtenir et d’installer chaque version précédemment publiée en séquence.
- Si vous disposez de machines principales et de secours dans votre data store relationnel ou de cache tuilé, installez la nouvelle version de ArcGIS Data Store sur ces machines, puis reconfigurez le data store à partir de la machine principale.
- Si plusieurs machines de data store de cache tuilé, de Spatiotemporal Big Data Store ou d’object store sont configurées avec le site du serveur d’hébergement, installez la nouvelle version de ArcGIS Data Store sur chaque machine de Data Store dans le cluster. Lorsque la nouvelle version est installée sur toutes les machines dans le cluster, vous pouvez reconfigurer le Data Store.
Vous pouvez exécuter le programme Setup.exe pour procéder à une mise à niveau à l’aide d’un assistant interactif ou exécuter le programme Setup.exe pour n’installer que le logiciel et exécuter l’utilitaire configuredatastore à partir d’une invite de commande ou d’un script pour mettre ArcGIS Data Store à niveau en mode silencieux. Quelle que soit la méthode employée, le fichier d’installation Setup.exe détecte et met à jour l’installation ArcGIS Data Store existante.
Remarque :
La mise à niveau de ArcGIS Data Store redémarre le service ArcGIS Data Store.
Mettre à niveau à l’aide d’un assistant interactif
Après avoir effectué les étapes décrites dans la section Se préparer à mettre à niveau ArcGIS Data Store et mis à niveau les composants ArcGIS Enterprise dont la mise à niveau doit être réalisée avant celle de ArcGIS Data Store, procédez comme suit pour mettre à niveau vos répertoires de données à l’aide d’un assistant interactif : Si vous préférez utiliser les commandes pour procéder à la mise à niveau, passez à la section suivante.
- Si vous utilisez un répertoire de Big Data spatio-temporelles ArcGIS GeoEvent Server, connectez-vous à ArcGIS GeoEvent Server Manager et arrêtez les services d’entités utilisés pour archiver les données.
- Mettez à jour l’installation ArcGIS Data Store sur chaque machine de répertoire de données.
Pour mettre à jour l’installation, exécutez le programme ArcGIS Data Store Setup.exe sur chaque machine qui bénéficie d’un data store configuré avec le même serveur d’hébergement. Ne désinstallez pas l’installation ArcGIS Data Store existante.
Lorsque vous installez ArcGIS Data Storepour le mettre à niveau à partir de la version 10.9.1 ou une version antérieure, tous les types de data store (relationnel, cache tuilé, graph store, object store et Spatiotemporal Big Data Store) sont installés. Si ArcGIS Data Store est installé sous Microsoft Windows, après la mise à niveau, vous pouvez supprimer les types de data store qui n’ont jamais été configurés et dont vous n’avez pas besoin.
- 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.
Si vous acceptez le contrat de licence, le programme d’installation de ArcGIS Data Store affiche les fonctionnalités qui seront installées.
- Le compte utilisé par votre installation existante est prérenseigné dans la zone de saisie ArcGIS Data Store. Indiquez le mot de passe du compte.
Il s’agit généralement du mot de passe que vous avez défini lors de l’installation du logiciel. Si le mot de passe a changé depuis que vous avez installé le logiciel, vous devez saisir le mot de passe que vous avez indiqué lors de la modification du compte. Si la vérification du mot de passe échoue, un message d'erreur s'affiche pour indiquer que le mot de passe est incorrect. Si vous n'êtes pas certain du mot de passe du compte, contactez votre administrateur système.
- À l’issue de la mise à jour de l’installation ArcGIS Data Store sur toutes les machines de data store, ouvrez un navigateur Web pris en charge et effacez le cache du navigateur, y compris les cookies.
- Exécutez l’assistant Data Store Configuration (Configuration du data store) pour configurer chaque type de data store et terminer la mise à niveau.
La fréquence d’exécution de l’assistant de configuration du répertoire de données dépend de votre configuration.
- Pour les répertoires de données relationnelles et de cache de tuiles (mode principal-secours), connectez-vous à la machine principale ou de secours depuis l’assistant de configuration ArcGIS Data Store. Les étapes proposées par l’assistant permettent de mettre à niveau le répertoire de données sur les deux machines.
- Si vos répertoires de données relationnelles et du cache de tuiles principaux sont exécutés sur la même machine, il vous suffit d’exécuter l’assistant de configuration du répertoire de données une fois.
- Pour les répertoires de données de cache de tuiles (mode grappe) et de Big Data spatio-temporelles, connectez-vous à l’une des machines de répertoire de données de cache de tuiles agrégé ou de Big Data spatio-temporelles depuis l’assistant de configuration ArcGIS Data Store. Suivez les étapes proposées par l’assistant pour mettre à niveau toutes les machines de ce répertoire de données.
- Dans l’assistant de configuration ArcGIS Data Store, indiquez l’URL du serveur d’hébergement, ainsi que le nom d’utilisateur et le mot de passe d’un administrateur ArcGIS Server pour le serveur d’hébergement, et cliquez sur Next (Suivant).
- La même version de ArcGIS Data Store est installée sur toutes les machines des répertoires de données associés à ce serveur d’hébergement.
- Toutes les machines des stockages de données associés à ce serveur d’hébergement sont accessibles.
- Le serveur d’hébergement est accessible.
- Une fois toutes les conditions préalables remplies, la page Prerequisite Check (Contrôle préalable) affiche chaque stockage de données à mettre à niveau. Cliquez sur Next (Suivant) pour reconfigurer ces stockages de données avec le serveur d’hébergement et terminer la mise à niveau.
- Lorsque la configuration est terminée, la page Upgrade Status (Etat de mise à niveau) s’affiche.
- Pour chaque stockage de données mis à niveau, success (réussi) s’affiche dans le champ Status (Etat). Pour les répertoires de données relationnelles ou du cache de tuiles haute disponibilité (mode principal-secours), un statut s’affiche pour les deux machines. Si toutes les machines du stockage de données sont mises à niveau, cliquez sur Next (Suivant) pour passer à la page Configuration Status (Etat de configuration). Vous pouvez désormais fermer l’assistant Data Store Configuration.
- Si une mise à niveau a échoué, le stockage de données ou la machine affiche un état failed (échec), et des messages s’affichent pour aider à résoudre le problème. Corrigez les problèmes et exécutez de nouveau l’assistant Data Store Configuration pour mettre à niveau les machines qui ont échoué.
- Si vous détenez un répertoire de Big Data spatio-temporelles, vérifiez qu’il affiche le statut healthy (intègre).
Pour déterminer l’état du data store, connectez-vous au répertoire ArcGIS Server Administrator Directory pour le serveur d’hébergement et exécutez la commande REST validate.
- Si votre portail ArcGIS Enterprise comporte des sites ArcGIS GeoEvent Server, ArcGIS GeoAnalytics Server, ArcGIS Mission Server ou ArcGIS Knowledge Server fédérés, mettez-les à niveau.
Dès que les sites fédérés ont été mis à niveau, vérifiez que les services exécutés sur ces sites sont opérationnels.
Attention :
Après avoir exécuté le programme d’installation, ce dernier ouvre automatiquement l’assistant de configuration du stockage des données dans votre navigateur par défaut. Ne passez pas à la configuration sans avoir installé la même version de ArcGIS Data Store sur chaque machine de répertoire de données.
Si certaines conditions ne sont pas remplies, elles apparaissent sur la page Prerequisite Check (Contrôle préalable) au niveau de l’état correspondant à chaque type de stockage de données. Vous devez résoudre tous les problèmes avant d’effectuer la mise à niveau.
Mettre à niveau à l’aide de commandes
Au lieu d’exécuter le programme d’installation, vous pouvez exécuter le fichier Setup.exe à l’invite de commande ou dans un script par lot afin de mettre à jour ArcGIS Data Store. Pour ne pas recevoir une invite de mise à niveau, exécutez la commande en mode silencieux. Pour ce faire, incluez le paramètre /qb dans le script.
Après avoir effectué les étapes décrites à la section Préparer la mise à niveau de ArcGIS Data Store et mis à niveau les composants ArcGIS Enterprise dont la mise à niveau doit être réalisée avant celle de ArcGIS Data Store, exécutez le fichier d’installation ArcGIS Data Store sur chaque machine du data store pour installer la nouvelle version du logiciel. Ensuite, exécutez l’utilitaire configuredatastore sur chaque machine de data store à mettre à niveau.
- Si vous utilisez un répertoire de Big Data spatio-temporelles ArcGIS GeoEvent Server, connectez-vous à ArcGIS GeoEvent Server Manager et arrêtez les services d’entités utilisés pour archiver les données.
- Mettez à jour l’installation ArcGIS Data Store sur chaque machine de répertoire de données.
Exécutez le fichier Setup.exe à partir d’une invite de commande ou dans un script sur chaque machine de votre data store. Par exemple, si vous avez un data store relationnel haute disponibilité (deux machines) un spatiotemporal Big Data Store haute disponibilité avec trois machines, exécutez le fichier Setup.exe sur les cinq machines avant de passer à la configuration.
Remarque :
Ne désinstallez pas l’installation ArcGIS Data Store existante.
Lorsque vous installez ArcGIS Data Storepour le mettre à niveau à partir de la version 10.9.1 ou une version antérieure, tous les types de data store (relationnel, cache tuilé, graph store, object store et Spatiotemporal Big Data Store) sont installés. Si ArcGIS Data Store est installé sous Microsoft Windows, après la mise à niveau, vous pouvez supprimer les types de data store qui n’ont jamais été configurés et dont vous n’avez pas besoin.
Lors de la mise à niveau en mode silencieux à l’aide du programme Setup.exe, vous devez spécifier le compte ArcGIS Data Store. Il s'agit généralement du compte que vous avez défini lors de l'installation du logiciel. Si le compte a changé depuis l’installation, vous devez saisir le nom d’utilisateur et le mot de passe que vous avez indiqués lors de la modification du compte ArcGIS Data Store.
Si vous ne précisez pas le compte ArcGIS Data Store ou si celui-ci ne correspond pas au compte utilisé par votre installation actuelle, le programme d’installation affiche un message indiquant que les identifiants de connexion n’ont pas pu être validés. En conséquence, l'installation prendra fin.
Dans l'exemple suivant, le compte utilisé par le logiciel est myaccount :
<path to ArcGIS Data Store setup download folder>\Setup.exe /qb USER_NAME=myaccount PASSWORD=mypassword ACCEPTEULA=yes
Par exemple, pour exécuter la commande avec un compte de domaine, tel que mydomain\myaccount, avec le mot de passe 4myI.s0nly, saisissez ce qui suit :
\\machinename\mydownloadfolder\Setup.exe /qb USER_NAME=mydomain\myaccount PASSWORD=4myI.s0nly ACCEPTEULA=yes
Attention :
Les paramètres de ligne de commande respectent la casse. En cas de problème de mise à niveau, vérifiez que la casse correspond à celle des propriétés des exemples qui suivent.
- Utilisez l’utilitaire configuredatastore pour reconfigurer le data store avec le site GIS Server que vous utilisiez avant la mise à niveau. Vous devez exécuter l’invite de commande en tant qu’administrateur de la machine qui héberge ArcGIS Data Store.
La fréquence d’exécution de l’utilitaire configuredatastore dépend de votre configuration.
- Pour les data stores fonctionnant en mode principal-secours, identifiez-vous sur la machine principale ou de secours sous le nom de l’utilisateur qui a installé ArcGIS Data Store et exécutez l’utilitaire configuredatastore. Cela permet de mettre à niveau le data store sur les machines principale et de secours.
- Si vos data stores relationnels et data stores de cache tuilés se trouvent sur la même machine, l’exécution de l’utilitaire configuredatastore met les deux à niveau.
- Pour les data stores fonctionnant en mode de grappe, identifiez-vous sur l’une des machines sous le nom de l’utilisateur qui a installé ArcGIS Data Store et exécutez l’utilitaire configuredatastore. Cela permet de mettre à niveau toutes les machines du data store agrégé.
Dans cet exemple, l’utilitaire configuredatastore est exécuté sur une machine où le data store relationnel et le data store de cache tuilé sont tous les deux exécutés. Les deux répertoires de données sont configurés avec le site GIS Server https://myserver.network.com:6443/arcgis :
configuredatastore https://myserver.network.com:6443/arcgis serveradmin MyAdminPassword C:\arcgisdatastore --stores relational,tilecache
Dans cet exemple, l’utilitaire configuredatastore est exécuté sur l’une des machines dans un Spatiotemporal Big Data Store configuré avec le site GIS Server https://gisserver.mynetwork.com:6443/arcgis :
configuredatastore https://gisserver.mynetwork.com:6443/arcgis serveradmin MyAdminPassword C:\arcgisdatastore --stores spatiotemporal
L’exécution de l’utilitaire configuredatastore redémarre ArcGIS Data Store sur toutes les machines du data store.
Avant la mise à niveau, ArcGIS Data Store vérifie que la même version de ArcGIS Data Store est installée sur toutes les machines du répertoire de données et qu’elles sont toutes accessibles. Si des machines ne sont pas mises à jour ou accessibles, ArcGIS Data Store ne peut pas procéder à la mise à niveau. Corrigez les problèmes liés à l’installation ou au réseau, puis lancez de nouveau l’utilitaire configuredatastore.
- Si vous détenez un spatiotemporal Big Data Store, confirmez que le spatiotemporal Big Data Store affiche l’état healthy.
Pour déterminer l’état du data store, connectez-vous au répertoire ArcGIS Server Administrator Directory pour le serveur d’hébergement et exécutez la commande REST validate.
- Si votre portail ArcGIS Enterprise comporte des sites ArcGIS GeoEvent Server, ArcGIS GeoAnalytics Server, ArcGIS Mission Server ou ArcGIS Knowledge Server fédérés, mettez-les à niveau.
Dès que les sites fédérés ont été mis à niveau, vérifiez que les services exécutés sur ces sites sont opérationnels.
Points à prendre en compte après la mise à niveau de ArcGIS Data Store
Les sauvegardes ArcGIS Data Store que vous avez créées avant la mise à niveau ne peuvent pas être utilisées pour restaurer un déploiement ArcGIS Data Store. Il est par conséquent recommandé de créer des sauvegardes complètes de tous les Data Stores après la mise à niveau. Vous disposez ainsi d’une sauvegarde complète si un problème survient avant la prochaine sauvegarde planifiée.
Après la mise à niveau, vérifiez que vous pouvez accéder aux Data Stores. Pour ce faire, utilisez ArcGIS Server Manager ou le répertoire administrateur de ArcGIS Server. Confirmez également que vos couches de scènes et d’entités hébergées fonctionnent toujours.
Vous trouverez ci-dessous les instructions pour valider les Data Stores et vérifier que les couches s’exécutent depuis ArcGIS Server Manager.
La dernière section ci-dessous indique la procédure à suivre après la mise à niveau d’un Spatiotemporal Big Data Store depuis 10.8.1 si le déploiement ArcGIS Enterprise inclut des services de carte ArcGIS GeoEvent Server qui utilisent des agrégations carrées ou hexagonales.
Valider les stockages des données
Vous pouvez vous connecter à ArcGIS Server Manager pour vérifier que le site GIS Server est toujours en mesure de communiquer avec chaque data store.
Procédez comme suit pour valider un data store depuis ArcGIS Server Manager :
- Connectez-vous à ArcGIS Server Manager.
- Accédez à Site > Stockage des données.
- Cochez la case en regard du répertoire de données à vérifier. (ArcGIS_Data_Store).
- Cliquez sur Valider.
Si le Data Store est en cours d’exécution et que le site du GIS Server parvient toujours à communiquer avec lui, une coche verte apparaît dans la colonne Status (Statut).
Confirmer que les couches fonctionnent
Vous devez également vérifier que les services fonctionnent toujours après la mise à niveau.
- Connectez-vous à ArcGIS Server Manager.
- Accédez à Services > Hébergé.
- Vérifiez que tous les services fonctionnent.
Corriger les problèmes de rendu des services de carte ArcGIS GeoEvent Server
Pour corriger les problèmes de rendu provoqués par BUG-000139639, vous devez exécuter l’utilitaire upgradedatasource sur le Spatiotemporal Big Data Store après sa mise à niveau depuis 10.8.1 si vous possédez des services de carte ArcGIS GeoEvent Server configurés de façon à utiliser une agrégation carrée ou hexagonale.
- Dans une fenêtre de ligne de commande, ouvrez le répertoire d’outils ArcGIS Data Store sur une machine dans le Spatiotemporal Big Data Store.
Vous devez ouvrir la fenêtre en tant qu’administrateur Windows.
- Exécutez l’utilitaire listdatasources pour répertorier les services de carte GeoEvent Server.
listdatasources.bat
- Exécutez l’utilitaire upgradedatasource.
Personne ne peut accéder aux services de carte lorsque leurs sources sont en cours de mise à niveau. Vous pouvez spécifier le nom d’un service de carte lorsque vous exécutez l’utilitaire upgradedatasource afin d’affecter un seul service à la fois. Vous pouvez aussi exécuter l’utilitaire upgradedatasource sans préciser aucun nom pour que tous les services soient mis à niveau. Cela implique toutefois que personne ne peut accéder aux services tant qu’ils ne sont pas tous mis à niveau.
Dans cet exemple, tous les services de carte GeoEvent Server sont mis à niveau :
upgradedatasource.bat
Dans cet exemple, un seul service de carte (deliveryroutes) est mis à niveau.
upgradedatasource.bat deliveryroutes
Vous avez un commentaire à formuler concernant cette rubrique ?