Mise à niveau vers BizTalk Server 2016

Mise à niveau vers BizTalk Server 2016 à partir de BizTalk Server 2013 R2 ou BizTalk Server 2013.

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

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.

Planification de la 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
• Coexistence des versions Microsoft Office 2016/2013

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 2016. « 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. La configuration matérielle et logicielle requise pour BizTalk Server 2016 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 2016. 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 2016 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 de BizTalk Server 2013 R2/2013 à BizTalk Server 2016. « Oui » signifie que l’édition BizTalk Server 2013 R2/2013 peut être mise à niveau vers l’édition. « Non » signifie que l’édition BizTalk Server 2013 R2/2013 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 principal Sign-On unique et le 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 :

  • Windows 7 et Windows Server 2008 R2 : Importer un certificat
  • Windows 7 et Windows Server 2008 R2 : Exporter un certificat

• DTC : activez Microsoft Distributed Transaction Coordinator (MSDTC) (étapes de post-configuration pour optimiser votre environnement), 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.

• SharePoint : le modèle objet côté client (CSOM) est utilisé pour se connecter à SharePoint Services. Le modèle objet côté serveur (SSOM) (le service web) est supprimé dans BizTalk Server 2016.

  Si vous utilisez une version de SharePoint qui ne prend pas en charge le modèle CSOM, vous pouvez éventuellement effectuer une mise à niveau vers une version prise en charge de SharePoint :

  • Mise à niveau vers SharePoint 2016
  • Mise à niveau vers SharePoint 2013

• .NET Framework : il n’existe aucun concept d’installation côte à côte entre .NET Framework 4.5 et .NET Framework 4.6. Les fichiers binaires de .NET Framework 4.6 remplacent les fichiers binaires de .NET Framework 4.5. .NET Framework 4.6 est une exigence BizTalk Server 2016 et n’est pas pris en charge (et ne doit pas être installé) dans les versions BizTalk Server précédentes.

• Office 2016 et Office 2013 : installer et utiliser différentes versions d’Office sur le même ordinateur. En outre, case activée problèmes liés aux installations MSI côte à côte d’Office 2013 et Office 2016.

• Hôte d’application BizTalkServer : la mise à niveau nécessite l’existence de l’hôte par défaut. Si l'instance de l'hôte par défaut associée aux ports d'envoi et aux emplacements de réception de l'adaptateur SQL est supprimée, associez l'hôte par défaut à l'adaptateur SQL avant la mise à niveau. Une fois la mise à niveau terminée, vous pouvez supprimer l’hôte par défaut de la liste.

• Liaisons personnalisées : les liaisons personnalisées définies par l’utilisateur qui sont généré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 2013 R2/2013. BizTalk Server prend en charge la migration des modifications uniquement dans les btsntsvc.exe.config fichiers et bm.exe.config .

Alertes BAM

La fonctionnalité Messagerie de base de données SQL Server est nécessaire pour utiliser les alertes BAM. Si SQL Server est mis à niveau à partir d’une version qui utilisait des définitions d’alerte BAM existantes avec Notification Services, vous pouvez sauvegarder vos définitions d’alerte BAM et les déployer après la mise à niveau. Utilisez l’outil en ligne de commande BM.exe (\Program Files (x86)\Microsoft BizTalk Server <your version>\Tracking). Les étapes spécifiques sont les suivantes :

1. Ouvrez une invite de commandes et accédez à \Program Files (x86)\Microsoft BizTalk Server <your version>\Tracking.
2. Créez un fichier de définition dans l’invite de commandes : bm.exe get-defxml -FileName:YourBAMDefinition.xml
3. Dans BizTalk Server configuration 2013 R2/2013, annulez la configuration des alertes BAM.
4. Effectuez une mise à niveau vers SQL Server 2016 ou SQL Server 2014 SP1.
5. Configurez la messagerie de base de données Microsoft SQL Server.
6. Mise à niveau vers BizTalk Server 2016.
7. Dans BizTalk Server configuration 2016, configurez les alertes BAM.
8. Déployez le fichier de définition enregistré à partir de l’invite de commandes : bm.exe update-all -DefinitionFile:YourBAMDefinition.xml

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é.

• Espace disque : l’espace disque disponible 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 bam en temps réel 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 avez une base de données BAM volumineuse, mettez à jour la maxTimeout valeur des transactions distribuées dans votre fichier de 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. Chaque nouveau message BAM intercepté peut conserver les références à BizTalk Server 2013 R2/2013. 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 2013 R2/2013, 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. 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 en tant que MyNewBook.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

     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.

Enterprise Single Sign-On (ESSO)

• Scénario : Mise à niveau à partir d’une version antérieure de l’authentification unique Entreprise

  BizTalk Server inclut une version mise à jour d’Enterprise Single Sign-On (ESSO). 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.

• Scénario : Mise à niveau à l’aide de l’installation autonome Sign-On d’entreprise

  Utilisez les étapes suivantes pour procéder à une mise à niveau sur des ordinateurs disposant d’une installation autonome d’Enterprise Single Sign-On, tels que des serveurs de secret principal dédiés.

  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 2016. 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. Pour BizTalk Server réglage des performances, consultez Utilisation du tableau de bord des paramètres.

Informations générales

• Noms des comptes : 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 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 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.

• BizTalk Assembly Viewer n’est pas pris en charge sur un système d’exploitation 64 bits.

• 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 quelques 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 exécutée 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 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

• Installer les Mises à jour Windows critiques : sélectionnez Windows Update dans le menu Programmes. Vous devez éventuellement redémarrer l’ordinateur.

• Enregistrer les définitions d’alerte BAM : s’applique uniquement si vous utilisez actuellement des définitions d’alerte BAM existantes avec SQL Server Notification Services. Créez un fichier de définition à l’aide de BM.exe et annulez la configuration des alertes BAM dans la configuration BizTalk Server 2013 R2/2013.

  Avant la mise à niveau (dans cet article) répertorie les étapes spécifiques. Dans le cas contraire, recréez les définitions d'alerte BAM après avoir effectué la mise à niveau.

• Mise à niveau SQL Server : mise à niveau vers une version SQL Server prise en charge. Pour plus d'informations, accédez à :

  • Configurations logicielle et matérielle requises pour BizTalk Server 2016
  • Mettre à niveau vers SQL Server 2016
  • Mettre à niveau vers SQL Server 2014

• Mettre à niveau Outils clients SQL Server : dans un environnement multiordinateur, 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.

• Installer Visual Studio : Pour les versions prises en charge, consultez Configuration matérielle et logicielle requise pour BizTalk Server 2016. Différentes versions de Visual Studio peuvent être installées côte à côte. Consultez Visual Studio 2015 et Visual Studio 2013.

• Installer Office : voir Installer et utiliser différentes versions d’Office sur le même ordinateur. Configuration matérielle et logicielle requise pour BizTalk Server 2016 répertorie les versions d’Office prises en charge.

• Arrêtez les services BizTalk et Windows :

  • BizTalk Service BizTalk Group : <Application_Name>
  • Service EDI de base BizTalk ;
  • 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.

• Sauvegardez les bases de données :

  • Master
  • MSDB
  • BAMArchive
  • BAMPrimaryImport
  • BAMStarSchema
  • BizTalkDTADb
  • BizTalkHwsDb
  • BizTalkMgmtDb
  • BizTalkMsgBoxDb
  • BizTalkRuleEngineDb
  • Module de plateforme sécurisée (TPM)
  • BizTalkAnalysisDb
  • BAMAnalysis

  Pour plus d’informations dans la documentation SQL Server, accédez à :

  • SQL Server 2014 : Vue d’ensemble de la sauvegarde
  • SQL Server 2012 : Vue d’ensemble de la sauvegarde

• Configurer SQL Server Database Mail : S’applique uniquement si vous utilisez des définitions d’alerte BAM avec SQL Server Notification Services.

  Avant la mise à niveau (dans cet article) répertorie les étapes spécifiques. Dans le cas contraire, recréez les définitions d'alerte BAM après avoir effectué la mise à niveau.

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 du produit, 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. S’il manque un composant requis sur votre ordinateur, le programme d’installation peut installer les composants redistribuables requis. Vous pouvez :

   • sélectionner Installer automatiquement la configuration requise redistribuable à partir du Web

     OR

   • Sélectionnez Installer automatiquement la configuration requise redistribuable à partir d’un fichier CAB, si vous avez téléchargé le fichier CAB. Accédez à l’emplacement du fichier CAB et sélectionnez-le.

9. Dans Résumé, passez en revue les composants pouvant être mis à jour.

10. Sélectionnez Mettre à niveau pour démarrer.

11. Facultatif : sélectionnez Utiliser Microsoft Update lorsque je case activée pour les mises à jour (recommandées).

12. Dans Mise à niveau terminée, désactivez la zone Launch 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 les actions à prendre en cas de problème.

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 du BizTalk Server Configuration Manager.

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

Validation de la mise à niveau

Vous ne pouvez pas revenir à BizTalk Server 2013 R2/2013.

• Si vous avez créé un fichier XML de définition d’alertes BAM : dans BizTalk Server configuration 2016, configurez les alertes BAM. Déployez ensuite les définitions enregistrées.

  Avant la mise à niveau (dans cet article) répertorie les étapes spécifiques. Dans le cas contraire, recréez les définitions d'alerte BAM après avoir effectué la mise à niveau.

• 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 2016 sur le serveur WebSphere MQ server distant.

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

• EXE et BRE personnalisés : si vous avez un fichier exécutable managé personnalisé qui fait référence à l’assembly Moteur de règles métiers dans BizTalk Server 2010, ajoutez ce qui suit au fichier de configuration de l’application pour exécuter le processus dans .NET Framework 2.0.

  <?xml version="1.0" encoding="Windows-1252"?>
  <configuration>
  <startup>
    <supportedRuntime version="v2.0.50727" />
  </startup>
  </configuration>
  

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

  • Purge et archivage DTA (BizTalkDTADb) : consultez Comment configurer le travail de purge et d’archivage DTA
  • BizTalk Server de sauvegarde (BizTalkMgmtDb) : consultez Comment configurer le travail de BizTalk Server de sauvegarde

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

• Erreur du portail BAM : lorsque vous ouvrez le portail BAM, le message d’erreur suivant peut s’afficher :

  The server encountered a critical failure while trying to access the list of Views. The Business Management Web Service requires Administrator's attention.

  Cette erreur peut se produire si le portail BAM est configuré sur un site web utilisé par des applications exécutant .NET Framework 2.0. Dans ce scénario, hébergez le portail BAM sur un nouveau site web. Pour ajouter un site web, consultez Créer un site web. Après avoir créé le site web, reconfigurez le portail BAM :

  1. Ouvrez BizTalk Server Configuration.
  2. Sélectionnez Annuler la configuration des fonctionnalités. Dans Annuler la configuration des fonctionnalités, sélectionnez la zone case activée portail BAM, puis ok.
  3. Reconfigurez le portail BAM en sélectionnant le nouveau site web dans la liste Site web du portail BAM .

• Accélérateur BizTalk 2016 pour SWIFT : le processus de mise à niveau BizTalk Server ne met pas à jour un fichier BREDeployment.exe.config modifié. Modifiez manuellement les chemins d’accès dans le fichier BREDeployment.exe.config situé dans le \Program Files\Microsoft BizTalk 2016 Accelerator for SWIFT\SDK\Tools dossier.

  Par ailleurs, la configuration d’A4SWIFT Web Services and Message Pack est perdue. Reconfigurez après la mise à niveau de BizTalk Server.

Annexe A : Programme d’amélioration du produit

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 multicalculateur 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.

• Redémarrer le service d’authentification unique : si vous avez installé une version précédente de Visual Studio ou .NET Framework 4.5 sur votre ordinateur, le service d’authentification unique dans les versions antérieures de BizTalk Server cesse de fonctionner. Pour résoudre ce problème, exécutez la regasm SSOSQL.dll commande à partir de l’invite de commandes Visual Studio. Cette commande redémarre le service SSO.

  Notes

  Sur un ordinateur 64 bits, exécutez les versions 32 bits et 64 bits de la commande regasm.

• Impossible d’utiliser SOAP : après une mise à niveau de la plateforme, il se peut que vous ne puissiez pas envoyer de message SOAP en raison d’autorisations. Pour résoudre ce problème, modifiez le fichier Web.config à l’emplacement C:\inetpub\wwwroot\<SOAPExternalAppName>\ avec le texte suivant :

  <securityPolicy>
  <trustLevel name="Full" policyFile="internal" />
  <trustLevel name="High" policyFile="web_hightrust.config" />
  <trustLevel name="Medium" policyFile="web_mediumtrust.config" />
  <trustLevel name="Low" policyFile="web_lowtrust.config" />
  <trustLevel name="Minimal" policyFile="web_minimaltrust.config"/>
  </securityPolicy>
  <trust level="Full" originUrl="" processRequestInApplicationTrust="true"/>
  

  Vous devrez peut-être également modifier le mode d’erreur personnalisé de Remote Only à Désactivé.

• 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 :

  1. 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.

  2. Mettre hors connexion le instance en cluster des services d’authentification unique d’entreprise. 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 d’exécution BizTalk Server en cluster du premier nœud vers le second.

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