mettre à niveau vers ArcGIS Enterprise 11.x

Résumé

Cet article décrit le processus de mise à niveau vers ArcGIS Enterprise 11.x, avec des étapes détaillées sur ce qui doit être vérifié avant la mise à niveau, ce qui doit être réalisé au cours de la mise à niveau et ce qui doit être vérifié après la mise à niveau.

Note:
The upgrade process can be time-consuming, and if not done correctly, many things can go wrong. The steps outlined here can save a significant amount of time and make the process more efficient.

Procédure

Lorsque vous planifiez une mise à niveau, gardez à l’esprit qu’il n’est pas recommandé d’effectuer la mise à niveau directement à partir de versions qui sont séparées de plus de deux versions. Par exemple, vous ne pouvez pas effectuer directement la mise à niveau d’ArcGIS Enterprise 10.6.1 ou version antérieure vers la version 11.0. Vous devez d’abord effectuer une mise à niveau vers une version intermédiaire (10.7.x vers 10.9.x), puis effectuer la mise à niveau vers 11.0. Avant la mise à niveau, 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 de départ d’ArcGIS Enterprise.
 

Préparer la mise à niveau

Avant de commencer le processus de mise à niveau :

1. Vérifiez les éléments à prendre en compte avant de procéder à la mise à niveau vers la version souhaitée en consultant la rubrique suivante : Éléments à prendre en compte pour la mise à niveau depuis ArcGIS Enterprise 10.9.1 et versions antérieures
2. Vérifiez les éventuels avis de retrait : Avis de retrait, par exemple :
   • Fin de la prise en charge des processus basés sur ArcMap Dans cette version, les processus basés sur ArcMap ne sont plus pris en charge dans ArcGIS Enterprise. Le logiciel 11.0 et les versions ultérieures incluent l’environnement d’exécution ArcGIS Pro, mais pas l’environnement d’exécution ArcMap. Reportez-vous à la rubrique suivante : En savoir plus sur les possibilités de migration des services vers l’environnement d’exécution ArcGIS Pro.
   • Si vous avez publié des applications basées sur des modèles ArcGIS Configurable Apps, vérifiez si le modèle d’application a été déclassé.Les modèles d’application configurables retirés ne fonctionneront pas après la mise à niveau de votre portail vers la version 11.x. Vous devrez recréer ces applications à l’aide d’ArcGIS Instant Apps, d’ArcGIS StoryMaps, d’ArcGIS Experience Builder, d’ArcGIS Web AppBuilder ou d’ArcGIS Dashboards. Notez que si votre portail remonte à plusieurs versions, vous devez vérifier les modèles retirés de chaque version dans leurs rubriques Nouveautés du portail respectives. Par exemple, si vous effectuez la mise à niveau à partir de Portal for ArcGIS 10.7, consultez la liste des modèles retirés pour toutes les versions comprises entre la version 10.7 et la version actuelle.
3. Vérifiez la configuration système requise des machines qui hébergent les produits ArcGIS Enterprise et assurez-vous qu’elles présentent la configuration minimale requise.À partir de là, une liste de recommandations peut être élaborée, comme l’augmentation du processeur, de l’espace disque, etc., avant de commencer le processus de mise à niveau. Consultez : Configuration système requise d’ArcGIS Enterprise 11.3 
   • Gardez à l’esprit que la quantité d’espace libre disponible sur le disque doit être au moins 2,5 fois supérieure à la quantité d’espace dans les répertoires. Dans le cas contraire, allouez au moins 2,5 fois plus d’espace supplémentaire sur le disque. La procédure de mise à niveau nécessite cet espace libre pour sauvegarder et mettre à niveau le contenu de votre portail, les informations relatives au site et les paramètres de sécurité.
   • ArcGIS Web Adaptor (IIS) requiert un minimum de 8 Go de mémoire. Une mémoire plus importante peut être nécessaire en fonction du nombre d’instances d’ArcGIS Web Adaptor installées et du nombre et de la taille des requêtes reçues.
4. Vérifiez la compatibilité du type et de la version des bases de données utilisées et inscrites (telles que SQL Server, Oracle, etc.). En absence de compatibilité, procédez à une mise à niveau avant de mettre à niveau ArcGIS Enterprise. Consultez : Bases de données prises en charge
5. Vérifiez les autorisations dans le déploiement d’entreprise. Le compte de service Windows qui exécute les services sur toutes les machines doit correspondre au compte d’administration Active Directory au niveau du domaine. Le compte doit avoir un mot de passe statique. Ajoutez explicitement des autorisations aux dossiers suivants pour un contrôle total. Cela doit inclure les privilèges en lecture et en écriture. Le lecteur répertorié ici doit être modifié en fonction du lecteur utilisé. Il s’agit généralement du lecteur C, mais ce n’est pas toujours le cas.
   1. Vérifiez les autorisations sur la machine ArcGIS Server :
      • Vérifier C:\arcgisserver
      • Vérifier C:\Program Files\ArcGIS
      • Vérifier C:\Python 27
   2. Vérifiez les autorisations sur la machine Portal for ArcGIS :
      • Vérifier C:\arcgisportal
      • Vérifier C:\Program Files\ArcGIS
   3. Vérifiez les autorisations sur la machine ArcGIS Data Store :
      • Vérifier C:\arcgisdatastore
      • Vérifier C:\Program Files\ArcGIS
6. Téléchargez la version souhaitée de Portal for ArcGIS, d’ArcGIS Server, d’ArcGIS Data Store et d’ArcGIS Web Adaptor, ainsi que les licences associées, à partir du site Web My Esri.
7. Accédez à l’interface portaladmin : https://domain.com/webadaptor name/portaladmin

• Si votre portail est actuellement en mode de lecture seule, désactivez-le avant d’exécuter la mise à niveau.
  • Dans le répertoire administrateur du portail, dans Accueil > Mode > Mise à jour, définissez Lecture seule sur false.

Note:
Unlike the portal, if your ArcGIS Server site is in read-only mode, the site mode will be set to editable when you upgrade. After all machines in your site have been successfully upgraded, the site will remain in editable mode. You can switch back to read-only mode once your upgrade is complete.

Vérifier le statut de l’outil d’indexation

• Dans le répertoire administrateur du portail, dans Accueil > Système > Outil d’indexation > Statut :
• Vérifiez le statut d’index et assurez-vous que les valeurs d’index sont alignées.Si elles ne sont pas synchronisées, réindexez-les.

1. Par mesure de précaution, prenez un instantané de toutes les machines impliquées.
2. Validez la fédération et les data stores. Consultez : Valider les serveurs et Procédure : valider ArcGIS Data Store
3. Notez les noms d’instance Web Adaptor, puisque vous devrez utiliser exactement les mêmes noms lors de la réinstallation.
4. Notez le contexte Web attribué (le cas échéant) au portail et au serveur.
5. Sauvegardez le déploiement à l’aide des éléments suivants :
   • L’utilitaire webgisdr pour le portail. Consultez : Utiliser l’utilitaire webgisdr -Exporter ArcGIS Enterprise
   • L’utilitaire de sauvegarde pour ArcGIS Server : Utilitaire de sauvegarde 
   • Exécutez l’utilitaire backupdatastore pour sauvegarder chaque data store-backupdatastore
   • Sauvegardez le dossier du répertoire de contenu d’arcgisportal et toutes les extensions que vous avez ajoutées pour Dashboards et Web AppBuilder. De plus,
   • sauvegardez l’option de portail avancée du déploiement en cours en copiant le script JSON dans le répertoire du portail ArcGIS. Reportez-vous aux étapes 1 à 3 de la rubrique Portal for ArcGIS : Définir les options avancées du portail pour savoir comment accéder au script JSON. Le script JSON copié peut être collé dans le nouveau déploiement à l’aide de la fonction de mise à jour dans le répertoire du portail ArcGIS.
6. Si possible, arrêtez l’antivirus pendant le processus de mise à niveau.

Voici d’autres éléments à prendre en compte (le cas échéant) :

• Avant de mettre à niveau ArcGIS Enterprise, vous devez désinstaller ArcGIS Insights si vous mettez à niveau Enterprise à partir de la version 10.7 ou antérieure. Une fois la mise à niveau terminée, il est nécessaire d’installer une version compatible d’ArcGIS Insights. Consultez : Installer Insights dans ArcGIS Enterprise
• Si vous avez configuré des paquetages de cartes mobiles ArcGIS Navigator avec votre portail, vous devez les reconfigurer après avoir mis le portail à niveau vers la version 11.0.
• Si vous utilisez le contenu d’ArcGIS Living Atlas of the World dans des cartes ou des applications, vérifiez que les éléments que vous utilisez n’ont pas le statut de prise en charge éprouvée ou obsolète avant de procéder à la mise à niveau. Consultez la rubrique Mises à jour et cycles de vie du contenu d’ArcGIS Living Atlas.

Démarrer le processus de mise à niveau

Note:
Please keep in mind that your deployment (Portal, any ArcGIS Server site you federated with your portal, ArcGIS Data Store, and ArcGIS Pro (if licensed through the portal) will be offline (down) during the upgrade.

N’oubliez pas de réaliser les opérations suivantes :

• Vérifiez les autorisations sur tous les répertoires.
• Prenez un instantané de toutes les machines impliquées, par mesure de précaution.
• Notez les noms d’instance Web Adaptor (car leur installation doit présenter les mêmes noms).
• Notez le contexte Web attribué (le cas échéant) au portail et au serveur. Comme ils peuvent parfois se perdre après la mise à niveau, il est recommandé de les sauvegarder pour les reconfigurer.

S’il s’agit d’un déploiement à plusieurs machines, répertoriez les noms des machines afin de les vérifier au cours de la mise à niveau : Mettre à niveau votre portail ArcGIS Enterprise

1. Mettre à niveau Portal for ArcGISMettre à niveau Portal for ArcGIS
   1. N’oubliez pas que si vous effectuez une mise à niveau à partir d’un déploiement de Portal for ArcGIS 10.8.1 ou 10.9 sur lequel Map Viewer Bêta est installé, Map Viewer Bêta est automatiquement supprimé.
      En plus de Map Viewer Classic, la version 11.x dispose également du nouveau Map Viewer (auparavant nommé Map Viewer Bêta).
   2. La quantité de matériel dont dispose votre portail, le nombre de comptes inscrits, le nombre de composants et de personnalisations que vous déployez et les performances de la machine qui héberge le portail ont tous une incidence sur le temps nécessaire à la mise à niveau. Parfois, le processus prend jusqu’à trois heures.
   3. Effacez le cache du navigateur, y compris les cookies. D’après la documentation, des informations issues de la version antérieure du site Web qui seraient conservées dans le cache pourraient entraîner un affichage incorrect du site Web mis à niveau et vous empêcher de vous connecter. Il est recommandé d’effacer le cache (cookies compris) dans tous les navigateurs qui afficheront le site Web du portail mis à niveau.
   4. Exécutez le fichier d’installation du portail (Setup.exe) en tant qu’administrateur et n’interrompez pas le processus d’installation.
   5. S’il s’agit d’un portail haute disponibilité, mettez à niveau les machines principales et de secours avant de passer à l’étape suivante.
   6. Une fois l’installation terminée, une page Importer un fichier de licence est lancée dans le navigateur. Ayez le fichier de licence (.json) à portée de main, car il est nécessaire.
   7. Cliquez sur Poursuivre la mise à niveau du portail. Vous déclenchez ainsi la mise à niveau et générez une sauvegarde du contenu de votre portail, des informations sur le site et des paramètres de sécurité.
   8. Désinstallez l’instance Web Adaptor du portail existant.
   9. Installez la nouvelle instance Web Adaptor du portail portant le même nom qu’auparavant (version de mise à niveau).
   10. Configurez l’instance Web Adaptor du portail. Pour obtenir des instructions complètes, reportez-vous à la rubrique de configuration pour IIS ou Java (Windows). Gardez à l’esprit que si vous avez un DNS et qu’il n’est pas répertorié dans les propriétés système, vous devez l’utiliser pour accéder à la page de configuration du Web Adaptor.
   11. Une fois l’opération terminée, vérifiez que vous pouvez vous connecter au portail via l’URL du Web Adaptor, par exemple, https://webadaptorhost.domain.com/webadaptorname/home
   12. Si un message vous signale que des étapes sont requises après la mise à niveau, vous devez cliquer sur OK dans la boîte de dialogue du message pour effectuer les étapes en question. Il peut être nécessaire, par exemple, de mettre à niveau le contenu d’ArcGIS Living Atlas of the World, de réindexer le contenu et de mettre à jour l’association entre les machines dans un portail haute disponibilité.
2. Mettez à niveau le site ArcGIS Server faisant office de serveur d’hébergement du portail. Mettre à niveau ArcGIS Server
   1. Effacez le cache du navigateur (y compris les cookies).
   2. N’annulez pas la fédération d’un serveur fédéré avec un portail lorsque vous mettez votre déploiement à niveau. Cela est néfaste au déploiement du portail car les utilisateurs ne pourront pas accéder aux services ArcGIS Server sur le portail, ni les partager ou les utiliser.
   3. Exécutez le fichier d’installation du serveur (.exe) en tant qu’administrateur. Un fichier de licence est requis après cette étape.
   4. Une fois l’installation terminée, l’assistant d’autorisation du logiciel s’ouvre et vous demande d’autoriser à nouveau ArcGIS Server avec un nouveau fichier de licence.
   5. Une fois l’autorisation accordée, lancez une page « Poursuivre la mise à niveau » dans le navigateur.
   6. Désinstallez l’instance Web Adaptor du serveur existant. S’il s’agit d’un site de serveur à plusieurs machines, la désinstallation doit s’effectuer une fois toutes les machines jointes au site mises à niveau.
   7. Installez la nouvelle instance Web Adaptor du serveur portant le même nom qu’auparavant.
   8. Configurez l’instance Web Adaptor du serveur.Pour obtenir des instructions complètes, reportez-vous à la rubrique d’installation pour IIS ou Java (Windows).
   9. Vérifiez que l’interface ArcGIS Server Manager est accessible via Web Adaptor et que vous pouvez vous connecter à l’aide des informations d’identification du portail. Lorsque vous vous connectez à ArcGIS Server Manager via l’instance Web Adaptor, les informations de redirection OAuth du portail doivent indiquer que la fédération a été maintenue tout au long de la mise à niveau.
3. Pour mettre à niveau ArcGIS Data Store, consultez : Mettre à niveau ArcGIS Data Store
   1. Effacez le cache du navigateur (y compris les cookies).
   2. Exécutez le fichier d’installation du Data Store (.exe) en tant qu’administrateur.
   3. Poursuivez la mise à niveau dans le navigateur.
   4. Une fois l’opération terminée, vérifiez que le Data Store est validé dans ArcGIS Server Manager.
4. Mettez à niveau tous les sites ArcGIS Server supplémentaires, s’il existe d’autres serveurs fédérés, tels qu’un serveur d’imagerie. Répétez le processus de mise à niveau pour chaque site supplémentaire.
   • Sites ArcGIS GIS Server ou ArcGIS Image Server
   • ArcGIS GeoEvent Server
   • ArcGIS GeoAnalytics Server
   • ArcGIS Notebook Server
   • ArcGIS Mission Server
   • ArcGIS Workflow Manager
   • ArcGIS Knowledge Server
   1. Effacez le cache du navigateur (y compris les cookies).
   2. Exécutez le fichier d’installation du serveur (.exe) en tant qu’administrateur. Un fichier de licence sera requis après cette étape.
   3. Poursuivez la mise à niveau dans le navigateur.
   4. Désinstallez l’instance Web Adaptor du serveur existant (pour la version précédente). S’il s’agit d’un site de serveur à plusieurs machines, la désinstallation doit s’effectuer une fois toutes les machines jointes au site mises à niveau.
   5. Installez la nouvelle instance Web Adaptor du serveur portant le même nom qu’auparavant.
   6. Configurez l’instance Web Adaptor du serveur.
   7. Vérifiez qu’ArcGIS Server Manager est accessible via Web Adaptor et que vous pouvez vous connecter à l’aide des informations d’identification du portail. Lorsque vous vous connectez à ArcGIS Server Manager via l’instance Web Adaptor, les informations de redirection OAuth du portail doivent indiquer que la fédération a été maintenue tout au long de la mise à niveau.
5. Une fois que toutes les applications ont été mises à niveau avec succès,
   1. accédez à l’accueil du portail.
   2. Pour ArcGIS Server dans Portal for ArcGIS, vérifiez que tout a été validé.
   3. Accédez à l’interface d’administration du portail :
      • Vérifiez le statut d’index. S’il n’est pas synchronisé, réindexez-le.
   4. Accédez à ArcGIS Server Manager :
      • Valider tous les data stores
   5. Restaurez toutes les personnalisations de portail créées précédemment. Lorsque vous restaurez les personnalisations de votre portail, ne remplacez pas les fichiers que vous avez modifiés dans la version précédente. Cela a un effet néfaste sur votre déploiement. Vous devez rajouter manuellement votre comportement personnalisé de la version précédente dans chaque fichier.
   6. Il est recommandé d’utiliser les scripts serverScan.py et portalScan.py pour vérifier les pratiques conseillées en matière de sécurité avec votre portail ArcGIS Server et ArcGIS Enterprise après la mise à niveau.
   7. Une fois la mise à niveau effectuée, étudiez soigneusement les informations suivantes : Points à prendre en compte après la mise à niveau de Portal for ArcGIS
6. Si vous avez utilisé ArcGIS Enterprise Builder pour configurer un déploiement ArcGIS Enterprise de base sur une seule machine :
   1. Passez en revue et effectuez les étapes des conditions préalables.
   2. En tant qu’administrateur, exécutez le fichier d’installation d’ArcGIS Enterprise Builder (.exe) de la version souhaitée pour installer les composants.
   3. Utilisez l’assistant de configuration ou l’utilitaire de ligne de commande upgradebasedeployment pour effectuer la mise à niveau.
   4. Effectuez les étapes requises après la mise à niveau.