Skip to main content

Mettre à niveau un déploiement de base avec ArcGIS Enterprise Builder

ArcGIS Enterprise Builder peut mettre à niveau un déploiement de base préalablement installé par le générateur. Les déploiements configurés à l’aide d’une autre méthode ne peuvent pas être mis à niveau avec le générateur. Des limites s’appliquent, identiques à celles de l’installation.

Récapitulatif de la mise à niveau

Voici un récapitulatif de la procédure à suivre pour mettre à niveau un déploiement de base à l’aide d’ArcGIS Enterprise Builder :

  1. Passez en revue et effectuez les étapes préalables.

  2. Mettez à niveau les instances ArcGIS Web Adaptor.

  3. Exécutez le programme d’installation d’ArcGIS Enterprise Builder pour installer les composants ArcGIS Enterprise.

  4. Utilisez l’assistant de configuration ou l’utilitaire de ligne de commande upgradebasedeployment pour effectuer la mise à niveau.

  5. Effectuez les étapes requises après la mise à niveau.

Conditions requises

Étudiez soigneusement les informations suivantes et effectuez les opérations requises avant de procéder à la mise à niveau à l’aide d’ArcGIS Enterprise Builder :

  • Prenez connaissance de la configuration système requise pour ArcGIS Enterprise Builder afin de vous assurer que votre matériel répond aux conditions actuellement requises.

  • Vérifiez que votre version existante d’ArcGIS Enterprise est prise en charge pour une mise à jour directe vers cette version.

    Remarque :

    Les versions 10.7.1 et antérieures ne sont plus prises en charge. Deux mises à niveau intermédiaires sont nécessaires pour effectuer une mise à niveau à partir de ces versions. Consultez la documentation de la mise à niveau vers 11.5 pour plus d’informations.

  • Vous devez réautoriser votre logiciel pour la version 12.1. Vous pouvez accéder aux nouveaux fichiers d’autorisation sur My Esri, ainsi qu’au fichier ArcGIS Enterprise Builder.

  • Les comptes Run As (Exécuter en tant que) pour tous les composants logiciels ArcGIS Enterprise doivent être identiques.

Mettre à niveau vos instances ArcGIS Web Adaptor

ArcGIS Enterprise Builder ne peut pas mettre à niveau ArcGIS Web Adaptor (Java Platform), car une étape supplémentaire est nécessaire pour annuler le déploiement de l’adaptateur Web du serveur Web Java. Effectuez ces étapes avant d’exécuter ArcGIS Enterprise Builder.

  1. Accédez au dossier d’installation d’ArcGIS Web Adaptor en tant qu’administrateur.

  2. Désinstallez l’instance du fichier ArcGIS Web Adaptor de la machine.

    Cela supprime les instances ArcGIS Web Adaptor du serveur Web Java.

  3. Annulez le déploiement des deux instances d’ArcGIS Web Adaptor sur le serveur d’applications.

  4. Installer ArcGIS Web Adaptor 12.1

  5. Déployez deux instances d’ArcGIS Web Adaptor sur votre serveur d’applications à l’aide du fichier arcgis.war : une pour ArcGIS Server et une pour Portal for ArcGIS.

Vous pouvez maintenant poursuivre la mise à niveau d’ArcGIS Enterprise Builder.

Exécuter le programme d’installation d’ArcGIS Enterprise Builder

ArcGIS Enterprise Builder est conçu pour détecter et mettre à niveau une installation existante des composants ArcGIS Enterprise Builder. Pour lancer la mise à niveau, exécutez ./Setup à partir de l’emplacement d’extraction d’ArcGIS Enterprise Builder, puis suivez les invites pour terminer la mise à niveau des composants ArcGIS Enterprise Builder. L’installation doit être effectuée avec le compte d’utilisateur ayant installé les composants ArcGIS Enterprise Builder existants.

Lors de l’exécution de la configuration, les fichiers d’autorisation ArcGIS Server peuvent être transmis selon la méthode détaillée dans Installation d’ArcGIS Enterprise Builder en mode silencieux, ou une fois la configuration terminée à l’aide des outils d’autorisation logicielle, disponibles dans le dossier des outils ArcGIS Server. L’installation est effectuée dans <EnterpriseBuilderInstallPath>/arcgis/server/tools/authorizeSoftware.

Remarque :

Le chemin d’installation ne peut pas être modifié au cours du processus de mise à niveau.

Procédez comme suit pour installer les composants ArcGIS Enterprise de base à l’aide d’ArcGIS Enterprise Builder.

  1. Lancez le programme d’installation en cliquant sur le fichier Builder.exe.

  2. Lisez le contrat principal et acceptez-le ou quittez l’assistant si vous n’êtes pas d’accord avec les termes.

    Le dossier de destination de vos composants ArcGIS Enterprise Builder précédemment installés sera déjà fourni. Vous ne pouvez pas modifier ce dossier de destination pendant une mise à niveau.

  3. Cliquez sur Next (Suivant) pour poursuivre l’exécution du programme d’installation.

  4. Indiquez le mot de passe du compte spécifié.

    Il s’agit du compte avec lequel tous les composants ArcGIS Enterprise ont été exécutés. Vous devez utiliser le mot de passe correct pour cet utilisateur, sinon le programme d’installation renvoie un message d’erreur. Contactez l’administrateur de votre système si vous ne connaissez pas le mot de passe du compte utilisateur spécifié.

    Lorsque vous mettez à niveau un déploiement existant, vous ne pouvez pas modifier les noms des instances ArcGIS Web Adaptor (IIS) du serveur d’hébergement ou du portail. Le programme d’installation configure les noms des instances ArcGIS Web Adaptor (IIS) en fonction de votre configuration précédente.

  5. Dans la boîte de dialogue d’autorisation du logiciel, indiquez l’emplacement de vos fichiers d’autorisation pour Portal for ArcGIS et ArcGIS Server.

    Ces fichiers d’autorisation doivent correspondre à la version que vous installez.

Une fois l’installation mise à jour, l’assistant de configuration s’ouvre automatiquement dans votre navigateur Web par défaut.

Mettre à niveau votre déploiement ArcGIS Enterprise

Une fois l’installation terminée, vous pouvez utiliser l’assistant de configuration pour mettre à niveau ArcGIS Enterprise ou fermer le navigateur et utiliser l’utilitaire de ligne de commande upgradebasedeployment pour mettre à niveau le déploiement de base.

Mettre à niveau à l’aide de l’assistant de configuration

Pour effectuer la mise à niveau à l’aide de l’assistant de configuration, procédez comme suit :

  1. S’il n’est pas déjà ouvert, accédez à l’URL de l’assistant de configuration, qui est au format http://mymachine.myexample.com:6080/arcgis/enterprise.

    Si vous le souhaitez, vous pouvez rechercher l’assistant de configuration d’ArcGIS Enterprise sur votre machine et le lancer à l’aide du raccourci.

    Attention :

    Ne fermez pas et n’actualisez pas le navigateur pendant la mise à niveau.

  2. Lisez les informations sur la page de destination initiale expliquant que l’assistant doit utiliser une connexion sécurisée, puis cliquez sur Next (Suivant).

    L’assistant est redirigé sur le port sécurisé 6443. Le navigateur renvoie un avertissement de sécurité, ce qui est normal si vous accédez à l’assistant sécurisé pour la première fois. Ignorez l’avertissement. Les étapes suivantes dépendent du navigateur Web.

  3. Dans la page License and Upgrade ArcGIS Enterprise (Attribuer une licence et mettre à niveau ArcGIS Enterprise) de l’assistant, accédez au fichier .json du portail contenant les types d’utilisateur et les applications autorisés.

    Vous pouvez vous procurer ce fichier sur My Esri.

  4. Cliquez sur Mettre à niveau.

    Cette action déclenche le processus de mise à niveau et ouvre une page affichant la progression (Configuring a Deployment [Configuration d’un déploiement]). Le processus de mise à niveau prend quelques minutes.

Quand l’assistant de mise à niveau est terminé, une page finale de confirmation s’affiche. Fermez cette page pour suivre les étapes requises après la mise à niveau.

Mettre à niveau à l’aide de l’utilitaire de ligne de commande

Une fois que vous avez installé le logiciel à l’aide d’ArcGIS Enterprise Builder, vous pouvez mettre à niveau le déploiement de base à l’aide de l’utilitaire de ligne de commande upgradebasedeployment.

Exécutez l’utilitaire de ligne de commande depuis le compte ayant installé le logiciel.

L’utilitaire de ligne de commande upgradebasedeployment se trouve dans <ArcGIS Server installation directory>/tools/upgradebasedeployment.

Vous devez exécuter l’utilitaire de ligne de commande en tant qu’administrateur Windows.

L’utilitaire de ligne de commande upgradebasedeployment se trouve dans <ArcGIS Server installation directory>\tools\upgradebasedeployment.

Par défaut, cet emplacement est C:\Program Files\ArcGIS\Server\tools\upgradebasedeployment.

Voici la description des paramètres utilisés dans l’utilitaire de ligne de commande :

  • -lf : spécifie le chemin d’accès au fichier de licence .json du portail. Si vous effectuez une mise à niveau à partir d’une version appartenant à la même série, cette propriété est ignorée et vous pouvez importer un nouveau fichier de licence après avoir effectué la mise à niveau si nécessaire. Le fichier de licence .json du portail est disponible sur My Esri.

  • -s : met à niveau le déploiement d’ArcGIS Enterprise de base en mode silencieux ; vous ne devrez répondre à aucune invite.

  • -h : affiche une aide et quitte le programme.

Procédez comme suit pour mettre à niveau ArcGIS Enterprise à l’aide de l’utilitaire upgradebasedeployment :

  1. Ouvrez une invite de commande.

  2. Dans l’invite de commande, modifiez le répertoire de travail à l’emplacement de l’utilitaire upgradebasedeployment, par exemple, <ArcGIS Server installation directory>/tools/upgradebasedeployment.

  3. Dans l’invite de commande, modifiez le répertoire de travail à l’emplacement de l’utilitaire upgradebasedeployment, par exemple, <ArcGIS Server installation directory>\tools\upgradebasedeployment.

  4. Tapez la commande upgradebasedeployment et le paramètre directement dans l’invite de commande.

    ./upgradebasedeployment.sh -lf <path to portal json file> -s

    upgradebasedeployment.bat -lf <path to portal json file> -s

Une fois la mise à niveau terminée, des liens vers le site du portail et le site du serveur d’hébergement sont disponibles.

Effectuez les étapes requises après la mise à niveau.

Étapes requises après la mise à niveau

Après avoir mis à niveau le déploiement d’ArcGIS Enterprise à l’aide d’ArcGIS Enterprise Builder, vérifiez qu’il fonctionne. Vous pouvez également effectuer des étapes facultatives supplémentaires.

  1. Vérifiez que vous pouvez vous connecter à l’organisation via l’URL d’ArcGIS Web Adaptor en tant qu’administrateur. L’URL est au format https://webadaptorhost.example.com/webadaptorname/home.

    Remarque :

    Vérifiez l’index à l’aide du répertoire administrateur ArcGIS Portal. S’il n’est pas synchronisé, réindexez Portal for ArcGIS.

  2. Si vous le souhaitez, utilisez les scripts serverScan.py et portalScan.py pour la vérification des pratiques conseillées en matière de sécurité concernant votre instance d’ArcGIS Server et votre portail ArcGIS Enterprise mis à niveau.