Partager via

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 de 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 l’intégralité de ce document avant de procéder à la mise à niveau. BizTalk Server connecte de nombreux composants disparates, internes et externes, à votre entreprise. La plupart des scénarios de déploiement réels s’étendent beaucoup plus loin pour inclure plusieurs serveurs et éventuellement des clusters d’ordinateurs physiques et virtuels.

  • Il n’y a pas deux déploiements BizTalk Server identiques. Avant de mettre à niveau, rassemblez des informations sur vos besoins d’entreprise et discutez de l’étendue de votre déploiement avec les professionnels de l’informatique, les administrateurs système et les 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 feuille de route de déploiement.

  • Utilisez BizTalk Server Best Practices Analyzer (BPA) pour examiner un déploiement BizTalk Server et générer une liste de bonnes pratiques. BPA effectue la vérification au niveau de la configuration, en lisant et en signalant uniquement et en utilisant les données collectées pour déterminer si les meilleures pratiques sont suivies.

Planifier votre mise à niveau

Voici une vue générale du processus de mise à niveau. Chacune des étapes répertoriées doit être exécutée dans l’ordre indiqué.

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

Chemins de mise à niveau pris 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 exécutée sur ce système d’exploitation peut être mise à niveau. « Non » signifie que la version de BizTalk Server exécutée sur ce système d’exploitation ne peut pas être mise à niveau. Quand « 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.

Systèmes d’exploitation BizTalk Server 2016
Windows Server 2016 Oui
Windows Server 2012 R2 Non
Windows 10 Oui
Windows 8.1 Non

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

Conseil / Astuce

Si votre version de SQL Server n’est pas prise en charge ou n’est pas dans la liste suivante, consultez la documentation de mise à niveau de SQL Server. La mise à niveau SQL couvre plus de versions que ce que BizTalk prend en charge. Par exemple, si vous utilisez SQL Server 2014, vous pouvez effectuer une mise à niveau vers SQL Server 2016/2017/2019. Ensuite, vous pouvez effectuer une mise à niveau vers BizTalk Server 2020. La mise à niveau de SQL Server répertorie les versions de SQL Server qui peuvent être mises à niveau.

Serveur SQL BizTalk Server 2016
SQL Server 2016 Oui
SQL Server 2014 Non

Le tableau suivant répertorie le chemin de mise à niveau des éditions prises 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. Quand « Non », l’environnement BizTalk doit être recréé.

BizTalk Server 2016 BizTalk Server 2020 Édition d'Évaluation BizTalk Server 2020 Branch Edition BizTalk Server 2020 Édition Développeur BizTalk Server 2020 Standard Edition BizTalk Server 2020 Enterprise Edition
Évaluation Non Non Non Non Oui
Branche Non Oui Non Non Oui
Développeur Non Non Non Non Oui
Norme Non Non Non Oui Oui
Entreprise Non Non Non Non Oui

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 SQL Server
    • Groupe Administrateurs BizTalk Server
    • Groupe Administrateurs unique Sign-On (SSO)

  • SSO : Le Serveur de Secret Maître Unique Sign-On et le serveur SQL Server qui héberge la base de données SSO 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 le Gestionnaire de serveur, sélectionnez Outils et ouvrez pare-feu Windows avec Advanced Security.
    2. Sélectionnez Règles de trafic entrant.
    3. Dans les 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 le Pare-feu Windows avec Advanced Security, 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 les versions antérieures du .NET Framework ne sont pas disponibles après la mise à niveau. Pour utiliser les liaisons personnalisées, ajoutez manuellement les liaisons personnalisées dans le fichier machine.config .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 fichiers btsntsvc.exe.config et bm.exe.config.

  • Adaptateur SQL : l’adaptateur SQL est supprimé dans BizTalk Server 2020. Il est à l’état déconseillé dans BizTalk Server 2016 et les 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 2020, l'adaptateur TIBCO Enterprise Message Service est pris en charge uniquement sur les systèmes hôtes 64 bits.

BAM

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

  • Packages DTS BAM et catalogue SSIS : BizTalk Server 2016 a déployé des packages DTS BAM dans le magasin de packages SSIS (MSDB). À compter de BizTalk Server 2020, le package DTS BAM 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éplace pas les packages DTS BAM 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 la version actuelle de votre serveur BizTalk et que vous mettez à niveau SQL Server, installez ou mettez à niveau vers SQL Server Enterprise Edition. Sinon, la mise à niveau échoue.

  • valeur maxTimeout : si vous avez 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. Les nouveaux messages BAM interceptés peuvent toujours avoir les références BizTalk Server 2016. Pour mettre à niveau les configurations d’intercepteur correspondantes, utilisez l’Éditeur de profil de suivi pour récupérer le profil de l’activité, puis réappliquez 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 cahier LiveData :

    1. Récupérez 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 sous le nom deMyNewBook.xls.

    3. Renommez les rapports de tableau croisé dynamique en recherchant les noms des tableaux croisés dynamiques 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 LiveData en exécutant la commande suivante :

      BM regenerate-livedataworkbook MyNewBook.xls

      Remarque

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

  • Prérequis des outils BAM : l’installation de SSIS est requise sur l’ordinateur outils BAM. La version de SSIS doit être compatible avec votre serveur SQL Server sur l’ordinateur où 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 Enterprise : BizTalk Server inclut une version mise à jour d’Enterprise Single Sign-On (ESSO). Si vous installez cette version sur un ordinateur avec une version antérieure de BizTalk, ESSO est automatiquement mis à jour lors de l’installation. Nous vous recommandons d’effectuer les étapes suivantes avant la mise à niveau :

    1. Vérifiez qu’une version actuelle de la base de données single Sign-On (SSODB) est sauvegardée vers un emplacement sécurisé.
    2. Vérifiez que la clé secrète principale actuelle est sauvegardée à 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 exigence s’applique également à un serveur secret maître autonome.

  • Effectuez une mise à niveau à l’aide de l’installation autonome d’Enterprise Single Sign-On : procédez comme suit pour effectuer une mise à niveau sur des ordinateurs disposant d’une installation d’authentification unique Enterprise autonome, telle qu’un serveur secret principal dédié.

    1. Vérifiez que la clé secrète principale actuelle est sauvegardée à un emplacement sécurisé.
    2. Vérifiez qu’une version actuelle de la SSODB est sauvegardée à un emplacement sécurisé.
    3. Exécutez ESSO Setup.exe à partir du support d'installation de 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 Microsoft Enterprise Single Sign-On.
    5. Dans la boîte de dialogue Résumé, sélectionnez Mettre à niveau.

Environnement multicomputer

Dans un environnement multiordinateur, mettez à niveau le serveur maître de secret SSO. Ensuite, mettez à niveau les autres ordinateurs BizTalk Server. La mise à niveau simultanée des ordinateurs BizTalk dans un groupe n’est pas prise en charge. Mettez à niveau un ordinateur à la fois dans l’ordre suivant :

  1. Serveur secret principal Sign-On unique
  2. Ordinateurs d’exécution exécutant BizTalk Server
  3. Outils d’administration et ordinateur de surveillance
  4. Développement et tous les autres ordinateurs restants exécutant BizTalk Server

Supplémentaire

À l’aide du tableau de bord des paramètres, vous pouvez ajuster largement les paramètres BizTalk Server pour optimiser les performances. Vous pouvez également modifier les paramètres du groupe BizTalk, de l’hôte BizTalk et de l’instance d’hôte BizTalk. Voir Utilisation du tableau de bord des paramètres pour l'optimisation des performances de BizTalk Server.

Informations générales

  • Noms de compte : utilisez les noms de compte par défaut dans la mesure du possible. Le programme d’installation de BizTalk Server configure automatiquement les composants installés pour utiliser les comptes par défaut. S’il existe plusieurs groupes BizTalk Server dans une forêt Active Directory, modifiez les noms de compte pour éviter les conflits. BizTalk Server prend uniquement en charge les <NetBIOS domain name>\<user> formats de noms 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 ni les comptes sans mot de passe pour l’utilisateur du service web de gestion BAM.

    La configuration de BizTalk Server avec ces comptes peut sembler réussir, mais le service web de gestion BAM échoue.

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

  • Installez et désinstallez : 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 d’installer sur une machine virtuelle. De cette façon, si vous devez réinstaller, vous pouvez facilement revenir à un point de contrôle prédéfini sans avoir à passer par le processus de désinstallation.

  • Ordinateurs 32 bits et 64 bits : il existe quelques différences lors de l’installation de BizTalk Server sur Windows 32 bits ou Windows 64 bits. Ce document couvre les installations 32 bits et 64 bits. Les différences entre elles sont noté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 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 silencieuse 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 mettre à niveau votre environnement de production.

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

Préparer votre ordinateur pour la mise à niveau

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

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

  3. Installez les versions x86 et x64 de Visual C++ 2015-2019 redistribuables 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 de SQL Server, consultez Mettre à niveau SQL Server.

  5. Mettez à niveau sql Server Client Tools. Dans un environnement multicomputer, les outils d’administration peuvent être installés sur un ordinateur distinct. Mettez à niveau les outils client d’administration SQL Server, y compris les outils de gestion.

  6. Installez SQL Server Integration Services. Dans un environnement multicomputer, 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 serveur SQL Server cible.

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

  8. Installez Visual Studio. 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. Installation d’Office. Configuration matérielle et logicielle requise pour BizTalk Server 2020 répertorie les versions d’Office prises en charge. Consultez Installer et utiliser différentes versions d’Office sur le même ordinateur.

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

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

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

  11. Sauvegardez les bases de données :

    • Maître
    • MSDB
    • BAMArchive
    • BAMPrimaryImport
    • BAMStarSchema
    • BizTalkDTADb
    • BizTalkMgmtDb
    • BizTalkMsgBoxDb
    • BizTalkRuleEngineDb
    • BAMAnalysis

    SQL Server : Vue d’ensemble de la sauvegarde

Effectuer la mise à niveau

Important

Lorsque vous avez installé SQL Server, le programme d'installation a accordé à votre compte connecté les droits d'administrateur système. Les droits d’administrateur système sont également requis pour installer BizTalk Server. Effectuez l’une des opérations suivantes :

  • Utilisez le même compte que celui que vous avez utilisé lors de l’installation de SQL Server. OU
  • Vérifiez que le compte connecté actuel dispose des droits d’administrateur système.

É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 organisation et votre clé de produit. Cliquez sur Suivant.
  5. Acceptez le contrat de licence, puis sélectionnez Suivant.
  6. Dans le programme d’amélioration de l’expérience utilisateur, entrez votre préférence. 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. En 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 recherche des mises à jour (recommandées).
  11. Dans La mise à niveau terminée, désactivez la case à cocher Launch BizTalk Server Configuration , puis sélectionnez Terminer.

ADDITIONNEL

Beaucoup de choses se produisent lors d'une mise à niveau de BizTalk Server, et il n'est pas rare de rencontrer une erreur pendant le processus de mise à niveau. Toutefois, la plupart des erreurs sont facilement corrigées si vous êtes prêt. 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 ce qu’il faut faire en cas de problème.

Le processus de mise à niveau met uniquement à niveau les fonctionnalités qui faisaient partie de votre version précédente de BizTalk Server. Les nouvelles fonctionnalités ne sont pas installées lors d’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 du Gestionnaire de configuration BizTalk Server.

Pour vérifier si la mise à niveau réussit, ouvrez Programmes et fonctionnalités et recherchez BizTalk Server 2020. S’il est listé, l’installation a réussi.

Après la mise à niveau

Vous ne pouvez pas restaurer BizTalk Server 2016.

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

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

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

  • Installez 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 distant.

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

  • Tâche SQL Agent : reconfigurez les tâches SQL Server Agent suivantes :

  • Packages DTS BAM programmés : si vous avez des tâches SQL Agent planifiant des packages DTS BAM, reconfigurez les tâches 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.

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

  • Pack de fonctionnalités BizTalk Server 2016 : si vous avez effectué une mise à niveau à partir de BizTalk Server 2016 Feature Pack, les actions de 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 configurez à nouveau la fonctionnalité d’API REST BizTalk dans la configuration de BizTalk Server 2020.

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

  • Mettez à 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 l’adaptateur 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 de l’expérience client dans BizTalk Server, vous pouvez fournir des commentaires utiles à Microsoft concernant l’utilisation des fonctionnalités de BizTalk Server. Les données collectées sont anonymes et ne peuvent pas être utilisées pour vous identifier. Microsoft collecte les statistiques d’utilisation des fonctionnalités dans le cadre de ce programme.

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

Annexe B : Problèmes connus

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

    PROBLÈME : Lorsque vous configurez bam Tools 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 runtime. Pour résoudre ce problème, configurez les alertes BAM sur le même ordinateur que la console Administration BizTalk. Ne configurez pas les alertes BAM sur l’ordinateur runtime.

  • Récupération à partir d’une mise à niveau ayant échoué : une mise à niveau ayant échoué peut se produire à tout moment pendant la mise à niveau. La façon dont vous récupérez à partir d’une mise à niveau ayant échoué est déterminée à partir du point pendant chaque phase où l’échec s’est produit.

    • Si la mise à niveau échoue lors de l’installation des prérequis, le programme d’installation arrête l’installation ultérieure des prérequis et retourne un message avec l’erreur. Vous pouvez ensuite corriger le problème et réexécuter la configuration.

    • Si la mise à niveau échoue lors de la mise à niveau des bases de données, la suppression des fonctionnalités de la version existante de BizTalk Server ou l’installation de la nouvelle version, le programme d’installation arrête l’installation et retourne un message avec l’erreur. Toutes les modifications sont annulées. Les modifications apportées aux bases de données BizTalk Server ne peuvent pas être restaurées.

      Si les composants de l’installation de BizTalk Server précédente sont supprimés lors de la mise à niveau, votre ordinateur peut être laissé dans un état sans composants BizTalk Server. Les informations de configuration des fonctionnalités de l’installation précédente peuvent être conservées. En fonction de l’échec du processus de mise à niveau, les bases de données BizTalk Server peuvent avoir été mises à niveau. Il peut être nécessaire de restaurer les bases de données que vous avez sauvegardées précédemment avant d’exécuter à nouveau 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 avec le niveau d’achèvement. Si la mise à niveau de configuration échoue ou réussit partiellement, exécutez la configuration de BizTalk Server pour terminer la mise à niveau.

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

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

  • Magasin de certificats : après la mise à niveau, vous ouvrez un port d’envoi ou recevez un emplacement à partir de la console Administration de BizTalk Server et obtenez une 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. Résolution possible :

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

    2. À l’aide de bm.exe dans le dossier BizTalk Server Tracking, exécutez ce qui suit à l’invite de commandes : bm.exe get-config –FileName:<filepath> -Server:MyServer -Database:MyDB

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

    3. Ouvrez la configuration bizTalk Server sur l’ordinateur répertorié 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 à partir de l’emplacement mentionné à 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"

      Remarque

      Sur un ordinateur 64 bits, après avoir mis à niveau le système d’exploitation, nous vous recommandons de reconfigurer le portail BAM.

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

    "<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 : sur 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, redémarrez les services d’authentification unique (SSO) ainsi que le cluster d’exécution BizTalk Server.

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

    1. Dans l’administrateur de cluster, apportez 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 du groupe de clusters.

    2. Mettre hors connexion l’instance en cluster du service d’authentification unique Entreprise. Puis, remettez-le en ligne.

    3. Déplacez le groupe de clusters. Cette étape doit déplacer le groupe de clusters qui contient la ressource des services d’authentification unique d’entreprise en cluster du premier nœud vers le deuxième nœud.

    4. Mettre hors connexion l’instance en cluster du service d’authentification unique Entreprise. Et puis, ramenez-le en ligne.

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

    5. Dans l’administrateur de cluster, apportez en ligne le groupe de clusters qui contient la ressource d’exécution BizTalk Server en cluster. Ceci devrait démarrer toutes les ressources du groupe de cluster.

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

    7. Déplacez le groupe de clusters. Cette étape doit déplacer le groupe de clusters qui contient la ressource d’exécution BizTalk Server en cluster du premier nœud vers le deuxième nœud.

    8. Mettre hors connexion l’instance en cluster des services d’authentification unique d’entreprise. Ramenez-le en ligne après cela.

Étapes suivantes

Étapes de post-configuration pour optimiser votre environnement