Mise à niveau vers BizTalk Server 2020

Mise à niveau vers BizTalk Server 2020 à partir de BizTalk Server 2016. Cette rubrique fournit une vue d’ensemble du processus de mise à niveau BizTalk Server 2020, des informations clés et des instructions pas à pas pour la mise à niveau à partir de BizTalk Server 2016.

Présentation de la mise à niveau

• Lisez ce document dans son intégralité avant d'effectuer la mise à niveau. BizTalk Server connecte plusieurs composants hétérogènes, aussi bien internes qu'externes, à votre entreprise. Dans la réalité, la plupart des scénarios de déploiement sont bien plus vastes et comprennent plusieurs serveurs ainsi que des clusters d’ordinateurs physiques et virtuels.

• Les déploiements de BizTalk Server sont tous différents. Avant de commencer la mise à niveau, rassemblez les informations relatives aux besoins de votre entreprise, et discutez de l'étendue de votre déploiement avec les informaticiens, administrateurs système et développeurs qui utilisent BizTalk Server. En étudiant ce guide de mise à niveau et en déterminant les besoins spécifiques de votre entreprise, vous créez votre propre calendrier de déploiement.

• Utilisez l’Analyseur de recommandations (BPA) de BizTalk Server pour examiner un déploiement BizTalk Server et générer une liste de bonnes pratiques. Il procède à une vérification au niveau de la configuration, par lecture et génération de rapport uniquement, et utilise les données collectées pour déterminer si les méthodes conseillées sont suivies ou non.

Planifier votre mise à niveau

L’aperçu ci-dessous détaille le processus de mise à niveau. Les étapes listées doivent être exécutées dans l'ordre indiqué.

• Chemins de mise à niveau des systèmes d’exploitation
• Mises à niveau pour Microsoft SQL Server®
• Mise à niveau de Windows® SharePoint® Services
• Coexistence de versions de Visual Studio
• Installer Microsoft Office 2019/2016 côte à côte

Options de mise à niveau prises en charge

Le tableau suivant répertorie les systèmes d’exploitation pris en charge qui peuvent être mis à niveau vers BizTalk Server 2020. « Oui » signifie que la version de BizTalk Server s’exécutant sur ce système d’exploitation peut être mise à niveau. « Non » signifie que la version de BizTalk Server s’exécutant sur ce système d’exploitation ne peut pas être mise à niveau. En cas de « Non », l’environnement BizTalk doit être recréé sur un système d’exploitation pris en charge. Configuration matérielle et logicielle requise pour BizTalk Server 2020 répertorie les systèmes d’exploitation pris en charge.

Le tableau suivant répertorie les versions SQL Server prises en charge qui peuvent être mises à niveau vers BizTalk Server 2020. Le serveur SQL Server héberge les bases de données utilisées par BizTalk Server. « Oui » signifie que BizTalk Server utilisant cette version de SQL Server peut être mis à niveau. « Non » signifie que BizTalk Server utilisant cette version de SQL Server ne peut pas être mis à niveau. En cas de « Non », l’environnement BizTalk doit être recréé sur une version de SQL Server prise en charge. La configuration matérielle et logicielle requise pour BizTalk Server 2020 répertorie les versions SQL Server prises en charge.

Le tableau suivant répertorie le chemin de mise à niveau de l’édition prise en charge à partir de BizTalk Server 2016. « Oui » signifie que l’édition BizTalk Server 2016 peut être mise à niveau vers l’édition. « Non » signifie que l’édition BizTalk Server 2016 ne peut pas être mise à niveau vers l’édition. En cas de « Non », l'environnement BizTalk doit être recréé.

Avant la mise à niveau – ce que vous devez savoir

• Autorisations : l’utilisateur effectuant la mise à niveau doit être membre des groupes d’utilisateurs suivants ou disposer des autorisations équivalentes :

  • Groupe Administrateurs sur l’ordinateur local
  • Groupe Administrateurs système SQL Server sur le serveur SQL Server
  • Groupe Administrateurs de BizTalk Server
  • Groupe Administrateurs de l'authentification unique (SSO)

• Authentification unique : le serveur secret maître Sign-On unique et le SQL Server qui héberge la base de données DSO doivent être en cours d’exécution pendant la mise à niveau.

• Compte de service réseau : doit avoir un accès en écriture à %windir%\temp.

• Certificats : sauvegardez le magasin de certificats Windows :

• DTC : activez Microsoft Distributed Transaction Coordinator (MSDTC), puis activez les règles DTC entrantes/sortantes :

  1. Dans Gestionnaire de serveur, sélectionnez Outils, puis ouvrez Pare-feu Windows avec sécurité avancée.
  2. Sélectionnez Règles de trafic entrant.
  3. Dans Règles de trafic entrant, cliquez avec le bouton droit sur Distributed Transaction Coordinator * (le cas échéant), puis Activez la règle.
  4. Dans Pare-feu Windows avec sécurité avancée, sélectionnez Règles de trafic sortant.
  5. Dans Règles de trafic sortant, cliquez avec le bouton droit sur Distributed Transaction Coordinator * (le cas échéant), puis Activez la règle.

  Les étapes de post-configuration pour optimiser votre environnement répertorient les étapes permettant d’activer MSDTC.

• Liaisons personnalisées : les liaisons personnalisées définies par l’utilisateur qui sont créées avec des versions antérieures du .NET Framework ne sont pas disponibles après la mise à niveau. Pour utiliser les liaisons personnalisées, ajoutez-les manuellement dans le fichier machine.config de .NET Framework 4.6.

• Fichiers de configuration : sauvegardez tous les fichiers de configuration personnalisés dans BizTalk Server 2016. BizTalk Server prend en charge la migration des modifications uniquement dans les btsntsvc.exe.config fichiers etbm.exe.config.

• Adaptateur SQL : l’adaptateur SQL est supprimé dans BizTalk Server 2020. Il est à l’état déprécié dans BizTalk Server 2016 et versions antérieures. La mise à niveau BizTalk Server 2020 modifie les ports associés au traitement par lots EDI ou aux exceptions ESBT pour utiliser l’adaptateur WCF-SQL.

  Avertissement

  Si vous utilisez l’ancien adaptateur SQL dans votre solution BizTalk, veillez à mettre à jour votre solution pour utiliser l’adaptateur SQL dans le pack d’adaptateurs BizTalk avant de procéder à la mise à niveau. Pour plus d’informations sur l’adaptateur SQL dans le pack d’adaptateurs BizTalk, consultez Prise en main de l’adaptateur BizTalk pour SQL.

• ADAPTATEUR TIBCO Enterprise Message Service : Applicable à partir de , BizTalk Server 2020TIBCO Enterprise Message Service Adapter est pris en charge uniquement dans l’hôte 64 bits.

BAM

• Packages BAM DTS : arrêtez tous les packages BAM Data Transformation Services (DTS). Sinon, des données peuvent être perdues ou un cube OLAP (Online Analytical Processing) peut être altéré.

• Packages BAM DTS et catalogue SSIS : BizTalk Server 2016 a déployé des packages BAM DTS dans le magasin de packages SSIS (MSDB). À compter de BizTalk Server 2020, le package BAM DTS sera déployé dans le catalogue SSIS (SSISDB). Créez un catalogue SSIS (SSISDB) sur SQL Server avant de commencer la mise à niveau. Sinon, le processus de mise à niveau ne déplacera pas les packages BAM DTS déployés vers le catalogue SSIS.

• Espace disque : l’espace disque libre doit être au moins de la taille des bases de données BAM existantes.

• Agrégations en temps réel : si vous utilisez des agrégations en temps réel BAM dans votre version actuelle de BizTalk Server et que vous mettez à niveau SQL Server, installez ou mettez à niveau vers l’édition SQL Server Entreprise. Faute de quoi, la mise à niveau échoue.

• valeur maxTimeout : si vous disposez d’une base de données BAM volumineuse, mettez à jour la maxTimeout valeur des transactions distribuées dans votre fichier machine.config pour :

  <system.transactions>
     <machineSettings maxTimeout="23:59:59" />
  </system.transactions>
  

• Suivi BAM activé avec l’Éditeur de profil de suivi (TPE) : après la mise à niveau, les profils de suivi précédemment déployés sont mis à niveau ; toutefois, leurs configurations d’intercepteur correspondantes ne sont pas mises à niveau. Tous les nouveaux messages BAM interceptés peuvent toujours avoir les références BizTalk Server 2016. Pour mettre à niveau les configurations d'intercepteurs associées, utilisez l'Éditeur de modèle de suivi pour extraire le profil de l'activité, puis réappliquer le profil.

• Classeur LiveData : si vous utilisez BAM dans BizTalk Server 2016, après la mise à niveau, vous devez régénérer manuellement le classeur LiveData. Pour régénérer le classeur des données actives :

  1. Extrayez la définition BAM en exécutant la commande suivante :

     BM get-defxml MyDef.xml

  2. Recréez les rapports de tableau croisé dynamique en ouvrant Microsoft Office Excel, puis en sélectionnant les compléments BAM. Importez le fichier MyDef.xml créé à l’étape (1) et recréez les rapports de tableau croisé dynamique. Enregistrez le nouveau classeur BAM en tant que MyNewBook.xls.

  3. Renommez les rapports de tableau croisé dynamique en recherchant les noms du tableau croisé dynamique dans MyDef.xml sous <Caption> dans le chemin d’accès <BAMDefinition>\<Extension>\<OWC>\<PivotTableView>\<PivotTable>\<PivotView>\<Label> . Utilisez ces noms pour renommer vos rapports de tableau croisé dynamique dans MyNewBook.xls.

  4. Régénérez le classeur des données actives en exécutant la commande suivante :

     BM regenerate-livedataworkbook MyNewBook.xls

     Notes

     Les classeurs ainsi régénérés ne recréent pas les artefacts Excel (par exemple, les graphiques) du classeur d’origine. Recréez manuellement les artefacts.

• Prérequis des outils BAM : L’installation de SSIS est requise sur l’ordinateur BAM Tools. La version de SSIS doit être compatible avec votre SQL Server sur l’ordinateur sur lequel les outils BAM sont configurés. Vous pouvez arrêter et désactiver le service Windows SSIS après l’installation de SSIS sur cet ordinateur.

Enterprise Single Sign-On (ESSO)

• Mise à niveau à partir d’une version antérieure de l’authentification unique Entreprise : BizTalk Server inclut une version mise à jour d’ESSO (Enterprise Single Sign-On). Si vous installez cette version sur un ordinateur possédant une version antérieure de BizTalk, l'authentification unique de l'entreprise est automatiquement mise à jour au cours de l'installation. Il est recommandé d'effectuer les opérations suivantes préalablement à la mise à niveau.

  1. Vérifiez que la version actuelle de la base de données SSO (SSODB) est sauvegardée dans un emplacement sécurisé.
  2. Vérifiez que la clé secrète principale actuelle est sauvegardée dans un emplacement sécurisé.
  3. Connaissez le mot de passe du secret principal.

  Mettez à niveau tous les serveurs d'un groupe BizTalk vers la même version. Cette règle s’applique également au serveur de secret principal autonome.

• Mettez à niveau à l’aide de l’installation autonome d’Enterprise Single Sign-On : procédez comme suit pour effectuer une mise à niveau sur les ordinateurs qui ont une installation d’authentification unique d’entreprise autonome, par exemple un serveur secret master dédié.

  1. Vérifiez que la clé secrète principale actuelle est sauvegardée dans un emplacement sécurisé.
  2. Vérifiez que la version actuelle de la base de données d'authentification unique de l'entreprise est sauvegardée dans un emplacement sécurisé.
  3. Exécutez le Setup.exe ESSO à partir du support d’installation BizTalk Server 2020. Le dossier d’installation par défaut est \Platform\SSO.
  4. Dans la boîte de dialogue Exécution automatique, sélectionnez Authentification unique Microsoft Enterprise.
  5. Dans la boîte de dialogue Résumé, sélectionnez Mettre à niveau.

Environnement à plusieurs ordinateurs

Dans un environnement à plusieurs ordinateurs, mettez à niveau l’ordinateur serveur de secret principal du système SSO. Ensuite, mettez à niveau les autres ordinateurs BizTalk Server. La mise à niveau simultanée des ordinateurs BizTalk d'un groupe n'est pas prise en charge. Mettez à niveau un ordinateur à la fois dans l'ordre suivant :

1. serveur de secret principal du système d'authentification unique ;
2. ordinateurs d'exécution qui exécutent BizTalk Server ;
3. outils d'administration et ordinateur de surveillance ;
4. ordinateur de développement et tous les autres ordinateurs qui exécutent BizTalk Server.

Supplémentaire

Le panneau de configuration vous permet de modifier complètement les paramètres de BizTalk Server dans le but d'optimiser les performances. Vous pouvez également y modifier les paramètres du groupe BizTalk, de l'hôte BizTalk et de l'instance de l'hôte BizTalk. Consultez Utilisation du tableau de bord paramètres pour BizTalk Server réglage des performances.

Informations générales

• Noms de compte : utilisez les noms de compte par défaut chaque fois que possible. Le programme d'installation de BizTalk Server configure automatiquement les composants installés pour qu'ils les utilisent. S'il existe plusieurs groupes BizTalk Server dans une forêt Active Directory, modifiez les noms de comptes pour éviter les conflits. BizTalk Server prend uniquement <NetBIOS domain name>\<user> en charge les formats de nom pour les comptes de service et les groupes Windows.

• Noms de comptes avec le service web de gestion BAM : BizTalk Server ne prend pas en charge les comptes intégrés ou les comptes sans mot de passe pour l’utilisateur du service web de gestion BAM.

  Même si la configuration de BizTalk Server avec de tels comptes réussit, le service Web de gestion BAM échoue.

  L’utilisation de tels comptes pour le pool d’applications BAM est prise en charge.

• Installer et désinstaller : lorsque vous désinstallez BizTalk Server, supprimez manuellement les bases de données BizTalk Server. Si vous installez BizTalk Server en tant que développeur ou évaluateur, envisagez l'installation d'une machine virtuelle. Ainsi, si vous devez procéder à une réinstallation, vous pouvez facilement revenir à un point de contrôle prédéfini sans avoir à suivre le processus de désinstallation.

• Ordinateurs 32 bits et 64 bits : il existe peu de différences lors de l’installation de BizTalk Server sur Windows 32 bits ou Windows 64 bits. Ce document couvre les deux types d'installations. Les différences entre elles sont indiquées.

• Groupes de travail : l’installation et la configuration de BizTalk Server dans un environnement de groupe de travail sur un seul ordinateur sont prises en charge. Dans ce scénario, les fonctionnalités et composants de SQL Server et BizTalk Server sont installés et configurés sur le même ordinateur.

• Terminal Server : l’installation de BizTalk Server à l’aide de Terminal Server s’exécutant en mode application n’est pas prise en charge.

• La mise à niveau en mode silencieux n’est pas prise en charge.

• Applications non prises en charge : BizTalk Server ne prend pas en charge les applications personnalisées basées sur des API non prises en charge, telles que les API PAM, les procédures stockées ou l’accès direct à la base de données. Exécutez au moins une mise à niveau de test avant de procéder à la mise à niveau de l’environnement de production.

• SQL Server instances : il est recommandé de mettre à niveau toutes les instances SQL Server avant de mettre à niveau la plateforme.

Préparation de l’ordinateur pour la mise à niveau

1. Installez des Mises à jour Windows critiques. Une fois l’installation terminée, il est recommandé de redémarrer votre ordinateur.

2. Installez Microsoft OLEDB Driver for SQL Server sur tous les ordinateurs BizTalk Server.

3. Installez les versions x86 et x64 des packages redistribuables Visual C++ 2015-2019 sur tous les ordinateurs BizTalk Server.

4. Mettez à niveau SQL Server vers une version prise en charge. Pour connaître les versions prises en charge, consultez Configuration matérielle et logicielle requise pour BizTalk Server 2020. Pour plus d’informations sur la mise à niveau SQL Server, consultez Mettre à niveau SQL Server.

5. Mettre à niveau Outils clients SQL Server. Dans un environnement à plusieurs ordinateurs, les outils d'administration peuvent être installés sur un ordinateur distinct. Mettez à niveau les outils clients d'administration SQL Server, y compris les outils de gestion.

6. Installez SQL Server Integration Services. Dans un environnement multiordinateur, les outils BAM peuvent être installés et configurés sur un ordinateur distinct. Installez la version de SQL Server Integration Services compatible avec votre SQL Server cible.

7. Créez le catalogue SSIS (SSISDB) sur SQL Server.

8. Installez Visual Studio. La configuration matérielle et logicielle requise pour BizTalk Server 2020 répertorie les versions prises en charge. Différentes versions de Visual Studio peuvent être installées côte à côte. Pour plus d’informations, consultez Visual Studio.

9. Installez Office. Configuration matérielle et logicielle requise pour BizTalk Server 2020 répertorie les versions d’Office prises en charge. Voir Installer et utiliser différentes versions d’Office sur le même ordinateur.

10. Arrêtez les services BizTalk Server et les services Windows :

    • BizTalk Service BizTalk Group : <Application_Name>
    • Service de mise à jour du moteur des règles
    • Service de publication World Wide Web

    Si vous installez des accélérateurs BizTalk Server, arrêtez le service de journalisation HL7.

11. Sauvegardez les bases de données :

    • Master
    • MSDB
    • BAMArchive
    • BAMPrimaryImport
    • BAMStarSchema
    • BizTalkDTADb
    • BizTalkMgmtDb
    • BizTalkMsgBoxDb
    • BizTalkRuleEngineDb
    • BAMAnalysis

    SQL Server : Vue d’ensemble de la sauvegarde

Réalisation de la mise à niveau

Étapes de la mise à niveau

1. Fermez tous les programmes ouverts.
2. Exécutez Setup.exe à partir du support d’installation.
3. Dans Démarrer, sélectionnez Installer Microsoft BizTalk Server.
4. Dans Informations client, entrez votre nom d’utilisateur, votre organization et votre clé de produit. Sélectionnez Suivant.
5. Acceptez le contrat de licence, puis sélectionnez Suivant.
6. Dans Programme d’amélioration de l’expérience client, entrez vos préférences. Pour plus d’informations, consultez l’Annexe A (dans cet article).
7. Dans Installation du composant, passez en revue les composants disponibles, puis sélectionnez Suivant.
8. Dans Résumé, passez en revue les composants pouvant être mis à niveau.
9. Sélectionnez Mettre à niveau pour démarrer.
10. Facultatif : sélectionnez Utiliser Microsoft Update lorsque je case activée pour les mises à jour (recommandé).
11. Dans Mise à niveau terminée, désactivez la zoneL’authentification BizTalk Server Configuration case activée, puis sélectionnez Terminer.

SUPPLÉMENTAIRE

En raison de la complexité du processus de mise à niveau de BizTalk Server, des erreurs peuvent se produire. Toutefois, si vous êtes correctement préparé, vous pouvez en résoudre facilement la plupart. Nous vous recommandons de lire l’Annexe B (dans cet article) pour obtenir des conseils sur la façon d’éviter les erreurs de mise à niveau et sur la procédure à suivre le cas échéant.

Le processus de mise à niveau ne s'applique qu'aux fonctionnalités présentes sur la version antérieure de BizTalk Server. Les nouvelles fonctionnalités ne sont pas installées pendant une mise à niveau. Pour installer ces fonctionnalités, réexécutez le programme d’installation après la mise à niveau, choisissez Modifier, puis sélectionnez les fonctionnalités que vous souhaitez installer. Une fois installés, configurez-les à l’aide de la BizTalk Server Configuration Manager.

Pour vérifier si la mise à niveau a réussi, ouvrez Programmes et fonctionnalités et recherchez BizTalk Server 2020. Si elle est répertoriée, l'installation a réussi.

Validation de la mise à niveau

Vous ne pouvez pas revenir à BizTalk Server 2016.

• Installer BizTalk Server extension dans Visual Studio : pour terminer l’installation des outils de développement BizTalk, installez BizTalk Server extension dans Visual Studio.

• Télécharger et copier WinSCP : si vous utilisez l’adaptateur SFTP, téléchargez la version recommandée du fichier zip WinSCP et extrayez-la dans BizTalk Server dossier d’installation 2020.

• Désinstaller OWC : OWC est déconseillé et non pris en charge par Microsoft. Il est recommandé de le désinstaller de BizTalk Server ordinateurs. L’impact est limité à la fonctionnalité De visionneuse d’agrégation dans le portail BAM.

• Installer MQSAgent : si le fichier MQSAgent.dll est installé sur un serveur WebSphere MQ distant, installez une nouvelle version de l’agent MQ à partir de BizTalk Server 2020 sur le serveur WebSphere MQ server distant.

• Démarrer MSMQ : si vous utilisez l’adaptateur MSMQ, démarrez le service Message Queuing.

• Travail SQL Agent : reconfigurez les travaux SQL Server Agent suivants :

  • Vidage et archivage DTA (BizTalkDTADb) : consultez Guide pratique pour configurer le travail de vidage et d’archivage DTA
  • BizTalk Server de sauvegarde (BizTalkMgmtDb) : consultez Guide pratique pour configurer le travail de BizTalk Server de sauvegarde

• Packages DTS BAM planifiés : si vous avez des travaux SQL Agent pour planifier des packages BAM DTS, reconfigurez les travaux pour utiliser des packages SSIS à partir du catalogue SSIS (SSISDB) au lieu du magasin de packages SSIS (MSDB).

• Activer l’audit : si vous souhaitez activer l’audit pour les opérations de gestion BizTalk, activez l’audit via les paramètres de groupe BizTalk.

• BizTalk Server groupe Utilisateurs en lecture seule : si vous souhaitez configurer le rôle Utilisateurs en lecture seule, exécutez le script PowerShell Configure-WindowsGroupForReadOnlyUserDBRole.ps1 avec le groupe Windows en tant que paramètre. Vérifiez que SQL Server module PowerShell est installé.

• BizTalk Server Feature Pack 2016 : si vous avez effectué une mise à niveau à partir de BizTalk Server Feature Pack 2016, des actions post-mise à niveau ci-dessous sont requises.

  • Adaptateurs O365 : installez et configurez BizTalk TMS si vous utilisez des adaptateurs O365. Vous devez activer chaque port à l’aide de ces adaptateurs en vous connectant à votre compte Outlook une fois pour chaque port.

  • Service de gestion et service de données opérationnelles : si vous utilisez le service de gestion ou le service de données opérationnelles, supprimez le service de gestion et le service de données opérationnelles dans le Gestionnaire IIS, supprimez les pools d’applications correspondants, puis reconfigurez la fonctionnalité d’API REST BizTalk dans BizTalk Server configuration 2020.

• Redémarrer les applications : redémarrez toutes les applications déployées qui sont mises à niveau.

• Mettre à jour l’hôte vers 64 bits pour TIBCO Enterprise Message Service Adapter : mettez à jour l’hôte du gestionnaire d’envoi et de réception pour TIBCO Enterprise Message Service Adapter vers un hôte 64 bits.

Annexe A : Programme d’amélioration de l’expérience client

Dans le cadre du Programme d’amélioration du produit de BizTalk Server, vous avez la possibilité de fournir un retour d’expérience utile à Microsoft concernant l’utilisation des fonctions de BizTalk Server. Les données ainsi collectées sont anonymes et ne peuvent pas être utilisées pour vous identifier. Dans le cadre de ce programme, Microsoft collecte des statistiques d'utilisation des fonctions.

En participant à ce programme, vous pouvez contribuer à améliorer la fiabilité et les performances de diverses fonctionnalités de BizTalk Server.

Annexe B : Problèmes connus

• Configurer les alertes BAM sur l’ordinateur d’administration : il existe un environnement multiordinateur avec les composants Administration, Runtime et SQL Server installés sur des ordinateurs distincts. Lorsque vous travaillez avec les outils BAM ou les alertes BAM, les problèmes suivants peuvent se produire :

  PROBLÈME : lorsque vous configurez les outils BAM sur un ordinateur d’administration BizTalk, l’erreur suivante se produit :

  Service BAMAlerts was not found on computer ‘.’.The specified service does not exist as an installed service.

  PROBLÈME : Lorsque vous déployez une définition d’activité BAM à partir de l’ordinateur runtime, l’erreur suivante se produit :

  A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: Named Pipes Provider, error: 40 - Could not open a connection to SQL Server) (.Net SqlClient Data Provider)

  Cela se produit si les alertes BAM sont configurées sur l'ordinateur d'exécution. Pour résoudre ce problème, configurez les alertes BAM sur le même ordinateur que la console Administration de BizTalk. Ne configurez pas les alertes BAM sur l'ordinateur d'exécution.

• Récupération d’une mise à niveau ayant échoué : une mise à niveau ayant échoué peut se produire à tout moment pendant la mise à niveau. La méthode de récupération après un échec de mise à niveau est déterminée selon la phase au cours de laquelle s'est produit l'échec.

  • Si la mise à niveau échoue lors de l’installation des prérequis, le programme d’installation arrête l’installation des autres prérequis et renvoie un message avec l’erreur. Vous pouvez alors corriger cette erreur et relancer le programme d’installation.

  • Si la mise à niveau échoue lors de la mise à niveau des bases de données, de la suppression des fonctionnalités de la version de BizTalk Server existante ou de l’installation de la nouvelle version, l’installation est interrompue et un message d’erreur s’affiche. Les éventuels changements sont annulés. Les modifications apportées aux bases de données BizTalk Server ne peuvent pas être annulées.

    Si les composants de l’installation précédente de BizTalk Server sont supprimés au cours de la mise à niveau, l’ordinateur peut rester dans un état sans aucun composant BizTalk Server. Les informations de configuration des composants de l'installation précédente peuvent être conservées. Donc, en fonction du moment où s’est produit l’échec de la mise à niveau, les bases de données BizTalk Server ont peut-être été mises à niveau. Il peut s’avérer nécessaire de restaurer les bases de données sauvegardées précédemment avant de relancer le programme d’installation.

  • Si la mise à niveau échoue lors de la reconfiguration des fonctionnalités BizTalk Server, le programme d'installation retourne un message indiquant le niveau d'achèvement de la mise à niveau. En cas d’échec ou de réussite partielle de la configuration, exécutez la configuration de BizTalk Server afin de terminer la mise à niveau.

    Si le processus de mise à niveau continue d’échouer et que vous devez revenir à la version précédente de BizTalk Server, vous devez restaurer les bases de données que vous aviez sauvegardées, puis réinstaller la version précédente de BizTalk Server.

• Utiliser les mêmes versions : dans un groupe d’applications BizTalk, vous ne pouvez pas exécuter des machines avec des versions différentes de BizTalk Server. Par exemple, dans la console Administration de BizTalk, vous ne pouvez pas lier un port d'envoi exécutant une version de BizTalk Server à un emplacement de réception exécutant une autre version de BizTalk Server.

• Magasin de certificats : après la mise à niveau, vous ouvrez un port d’envoi ou un emplacement de réception à partir de la console d’administration BizTalk Server et obtenez l’erreur :Could not open certificate store, the system cannot find the file specified (System).

  Cette erreur se produit si le magasin de certificats est manquant.

• Portail BAM : sur un ordinateur 64 bits, vous ne pouvez pas accéder au portail BAM après la mise à niveau. Solution possible :

  1. Créez une copie de sauvegarde du fichier web.config situé à l’adresse %BizTalkInstallDir%\BAMPortal\web.config.

  2. À l’invite de commandes, exécutez la commande suivante en vous aidant du programme bm.exe situé dans le dossier de suivi de BizTalk Server : bm.exe get-config –FileName:<filepath> -Server:MyServer -Database:MyDB

     À partir du fichier XML de configuration, obtenez la valeur de BAMVRoot (xpath : BAMConfiguration\ GlobalProperty\Name="BAMVRoot »).

  3. Ouvrez la configuration de BizTalk Server sur l’ordinateur indiqué comme valeur BAMVRoot et annulez la configuration du portail BAM.

  4. Ouvrez la configuration de BizTalk Server et configurez le portail BAM.

  5. Ouvrez le nouveau fichier web.config dans l’emplacement indiqué à l’étape (1).

  6. À l’aide de la copie de sauvegarde du fichier web.config, définissez les valeurs suivantes (sous configuration\appSettings) :

     • key="MainPageContentUrl"
     • key="AlertNotificationOptions"

     Notes

     Sur une machine 64 bits, une fois la mise à niveau du système d’exploitation effectuée, il est recommandé de reconfigurer le portail BAM.

• Déployer des activités EDI BAM : lorsque vous effectuez une mise à niveau, la mise à niveau peut partiellement réussir. Cela peut se produire lorsque vous mettez à niveau SQL Server (avec EDI configuré). Les activités BAM d'EDI ne peuvent pas être mises à niveau correctement. Pour résoudre ce problème, à l'invite de commande avec informations d'identification d'administration, exécutez les commandes suivantes pour déployer les activités BAM :

  "<BizTalk Installation Folder>\Tracking\bm.exe" deploy-all -DefinitionFile:"<BizTalk Installation Folder>\AS2ResendActivityDefs.xml" -Server:"<BAM Database Server Name>" -Database:"<BAM Database Name>"

  "<BizTalk Installation Folder>\Tracking\bm.exe" update-all -DefinitionFile:"<BizTalk Installation Folder>\Microsoft.BizTalk.Configuration.EdiAS2.UpgradeR2toR3.xml" -Server:"<BAM Database Server Name>" -Database:"<BAM Database Name>"

  "<BizTalk Installation Folder>\Tracking\bm.exe" update-all -DefinitionFile:"<BizTalk Installation Folder>\Microsoft.BizTalk.Configuration.Batching.UpgradeR2toR3.xml" -Server:"<BAM Database Server Name>" -Database:"<BAM Database Name>"

• Erreur d’authentification unique sur le cluster : dans un environnement de cluster d’exécution BizTalk Server, lorsque vous essayez de mettre à niveau, vous pouvez recevoir un message d’erreur :

  SSO Master Secret Server service is not running on <Cluster name>.Please start the service to continue the upgrade.

  Pour résoudre ce problème, actualisez les services SSO dans le cluster SSO et le cluster d’exécution BizTalk Server.

  Pour actualiser les services d’authentification unique dans le cluster SSO :

  1. Dans Administrateur de cluster, Mettez en ligne le groupe de clusters qui contient la ressource de service d’authentification unique d’entreprise en cluster. Cela doit démarrer toutes les ressources dans le groupe du cluster.

  2. Mettre hors connexion le instance en cluster du service Enterprise SSO. Et puis, ramenez-le en ligne.

  3. Déplacez le groupe de clusters. Cette opération doit déplacer le groupe du cluster contenant la ressource des services Enterprise SSO en cluster du premier nœud vers le second.

  4. Mettre hors connexion le instance en cluster du service Enterprise SSO. Et puis, ramenez-le en ligne.

     Pour actualiser les services d’authentification unique dans un cluster BizTalk Server Runtime :

  5. Dans Administrateur de cluster, Mettez en ligne le groupe de clusters qui contient la ressource runtime BizTalk Server cluster. Cela doit démarrer toutes les ressources dans le groupe du cluster.

  6. Mettre hors connexion le instance en cluster des services d’authentification unique d’entreprise. Et puis, ramenez-le en ligne.

  7. Déplacez le groupe de clusters. Cette opération doit déplacer le groupe du cluster contenant la ressource d’exécution BizTalk Server en cluster du premier nœud vers le second.

  8. Mettre hors connexion le instance en cluster des services d’authentification unique d’entreprise. Et puis, ramenez-le en ligne.

Étapes suivantes

Étapes d’optimisation de l’environnement après configuration