Résolution des problèmes de configuration

Le programme de configuration Microsoft BizTalk Server crée des bases de données sur un ou plusieurs ordinateurs exécutant SQL Server, remplit les bases de données avec des tables, des rôles et des procédures stockées utilisées par BizTalk Server et déploie des assemblys .NET utilisés pendant l’exécution dans la base de données de gestion BizTalk.

Cette section présente les techniques permettant de résoudre les erreurs de configuration. Elle présente également des problèmes de configuration courants et les méthodes utilisées pour les résoudre.

Consignation des informations de configuration

Le programme de configuration écrit des informations détaillées dans un fichier journal de configuration qui se trouve par défaut dans le répertoire temporaire de l’ordinateur exécutantBizTalk Server. Pour déterminer le dossier spécifié par la variable d'environnement TEMP, ouvrez une invite de commande sur cet ordinateur, tapez la commande suivante, puis appuyez sur ENTRÉE :

echo %TEMP%

Le fichier journal contient un récapitulatif des étapes de configuration effectuées, ainsi que des informations de diagnostic sur les échecs susceptibles de survenir au cours du processus de configuration. En cas d'erreur de configuration, ouvrez le journal dans un éditeur de texte tel que le Bloc-notes, puis recherchez les causes possibles.

Outils de dépannage

SQL Server Profiler, Filemon ou Regmon vous permettent de collecter des informations supplémentaires sur les échecs de configuration. Pour plus d’informations sur ces outils, consultez Outils et utilitaires à utiliser pour la résolution des problèmes.

Problèmes connus

Échec de la configuration lorsque BizTalk Server et SQL Server sont installés sur des ordinateurs distincts

Problème

Échec de la configuration avec erreurs similaires à celle indiquée ci-après lors de la tentative de configuration du composant d'authentification unique de l'entreprise :

Une erreur s'est produite lors de la tentative d'accès à la base de données SSO.

Fonction : FieldInfoCreate

-ou-

Impossible d'activer le service d'authentification unique (code d'erreur 0X800706BA)

Cause

Si BizTalk Server et SQL Server sont installés sur différents ordinateurs, les opérations de configuration sont effectuées dans le contexte d’une transaction MSDTC (Distributed Transaction Coordinator) et la fonctionnalité MSDTC doit être disponible sur le réseau entre ces ordinateurs. Si la fonctionnalité MSDTC n’est pas disponible sur le réseau entre les ordinateurs exécutant BizTalk Server et SQL Server cette erreur peut se produire.

Résolution

Suivez les étapes décrites dans Résolution des problèmes avec MSDTC pour garantir la fonctionnalité MSDTC sur le réseau entre les ordinateurs exécutant BizTalk Server et SQL Server.

Le logiciel antivirus interfère avec la configuration et provoque des échecs de configuration

Problème

BizTalk Server configuration échoue lorsque le logiciel antivirus détermine incorrectement que le programme de configuration est un virus.

Cause

Le logiciel antivirus n’a pas été mis à jour pour inclure le programme de configuration BizTalk Server en tant que programme légitime (non-virus).

Résolution

Configurez le programme antivirus pour qu’il reconnaisse le programme de configuration BizTalk Server comme un programme légitime (non-virus) ou désactivez temporairement le logiciel antivirus pendant l’exécution du programme de configuration.

Échec de la configuration avec erreur « Le fichier ou l'assembly nommé FileName.dll ou l'une de ses dépendances est introuvable »

Problème

Une erreur similaire à celle indiquée ci-après s'affiche lors du processus de configuration :

Impossible de déployer l'assembly C:\Program Files\Microsoft\ du système BizTalk

BizTalk Server 2009\Microsoft.BizTalk.DefaultPipelines.dll. Non spécifié

exception : nom de fichier ou d’assembly FileName .dll, ou l’un de ses noms

dépendances est introuvable. Le fichier ou l'assembly nommé FileName.dll ou

l'une de ses dépendances est introuvable.

Cause

Cette erreur peut se produire si le compte de service réseau ne dispose pas d’autorisations d’écriture sur le dossier temporaire sur l’ordinateur exécutant BizTalk Server. Pendant la configuration, BizTalk Server configuration utilise Windows Management Instrumentation (WMI) pour déployer des assemblys .NET sur la base de données de gestion BizTalk. WMI emprunte l’identité du compte de service réseau lors du déploiement de ces assemblys dans la base de données de gestion BizTalk. Le compte de service réseau doit donc disposer d’un accès en écriture au dossier temporaire sur l’ordinateur exécutant BizTalk Server.

Résolution

Accordez au compte de service réseau l’accès en écriture au dossier temporaire sur l’ordinateur exécutant BizTalk Server et réexécutez le programme de configuration. Pour déterminer le dossier spécifié par la variable d'environnement TEMP, ouvrez une invite de commande sur l'ordinateur, tapez la commande suivante, puis appuyez sur ENTRÉE :

echo %TEMP%  

Échec de la configuration du groupe si le nom NetBIOS de l'ordinateur exécutant SQL Server dépasse 15 caractères

Problème

BizTalk Server configuration du groupe échoue et une erreur semblable à ce qui suit s’affiche dans le journal de configuration BizTalk Server :

2006-08-29 23 :54 :00 :0902 [WARN] AdminLib GetBTSMessage : hrErr=80070547 ;

Msg=Les informations de configuration n'ont pas pu être lues sur le contrôleur

de domaine car l'ordinateur n'est pas disponible ou l'accès

a été refusé.;

Cause

Ce problème se produit si la longueur du nom NetBIOS de l’ordinateur exécutant SQL Server dépasse 15 caractères. Si le nom NetBIOS dépasse 15 caractères, Windows le tronque à 15 caractères et celui-ci ne correspond donc pas à la première partie du nom FQDN (Fully Qualified Domain Name) ou DNS de cet ordinateur. Si le nom NetBIOS ne correspond pas à la première partie du nom FQDN de l'ordinateur, la configuration du groupe échoue.

Résolution

Remplacez le nom NetBIOS de l’ordinateur exécutant SQL Server par un nom ne contenant pas plus de 15 caractères et réexécutez la configuration.

Notes

Si vous modifiez le nom, vous devez redémarrer l'ordinateur.

Échec de la configuration si le fichier d'une base de données SQL Server a le même nom que la base de données spécifiée qui existe déjà dans le dossier de données SQL Server.

Problème

Échec de la configuration avec une erreur similaire à celle indiquée ci-après :

Impossible de configurer une ou plusieurs bases de données BAM

Impossible d'ouvrir la base de données demandée dans la connexion « BAMPrimaryImport »

Échec de l'ouverture de session. Échec de l’ouverture de session pour l’utilisateur « BizTalk\BizTalkUser »

Cause

Cette erreur peut se produire si un fichier .mdf ou un fichier .ldf existe déjà dans le dossier \MSSQL\data de l’ordinateur exécutant SQL Server qui porte le même nom que le fichier .mdf ou le fichier .ldf que le programme de configuration BizTalk Server tente de créer. Les noms du fichier .mdf et du fichier .ldf créés pour les bases de données sont dérivés du nom de la base de données spécifiée dans le programme de configuration BizTalk Server avec une extension .mdf et .ldf ajoutées.

Résolution

Pour résoudre ce comportement, utilisez l’une des méthodes suivantes :

• Supprimez les fichiers .mdf ou .ldf dont les noms correspondent à ceux des bases de données que vous créez.

• Choisissez des noms différents de ceux des fichiers .mdf ou .ldf qui existent déjà dans le dossier \Program Files\Microsoft SQL Server\MSSQL\data de votre serveur SQL.

Échec de la configuration sur un contrôleur de domaine lors de la spécification de comptes locaux

Problème

Lors de l’exécution du programme de configuration BizTalk Server sur un contrôleur de domaine, la configuration échoue si vous avez spécifié un groupe local (par exemple, groupe d’utilisateurs hôtes BizTalk) pour l’hôte BizTalkServerApplication ou l’hôte BizTalkIsolatedHost.

Cause

Un contrôleur de domaine traite automatiquement un groupe Windows local en tant que groupe Windows de domaine (il n'existe pas de groupe Windows local sur un contrôleur de domaine). Si vous avez spécifié un groupe Windows local pour l’hôte lors de l’exécution du programme de configuration, la configuration échoue lors de la tentative de création d’une SQL Server d’ouverture de session pour le groupe. Le programme de configuration ne désactive pas l'option de groupe Windows local lorsque le serveur est un contrôleur de domaine.

Résolution

Spécifiez les groupes de domaine des hôtes créés lors de la configuration.

Échec de la configuration lors de la création de la base de données SQL Server Analysis si le serveur SQL a été renommé

Problème

Si vous avez renommé l'ordinateur sur lequel vous avez installé le serveur d'analyse du serveur SQL Server, le programme de configuration échoue lorsqu'il essaie de créer une nouvelle base de données SQL Server Analysis, et une erreur similaire à celle indiquée ci-après est générée :

Impossible de se connecter au référentiel.

Serveur d’analyse : <nom de la machine>

Erreur :

'\\<nom> de machine\MsOLAPRepository$\msmdrep.mdb' n’est pas un chemin d’accès valide.

Assurez-vous que le nom du chemin d’accès est correct et qu’une

connexion est établie avec le serveur sur lequel réside le fichier.

Cause

Le programme de configuration ne parvient pas à déterminer le nouveau nom de l'ordinateur sur lequel vous avez installé le serveur d'analyse du serveur SQL Server.

Résolution

Exécutez manuellement les étapes suivantes afin de mettre à jour le serveur d'analyse avec le nouveau nom de l'ordinateur :

1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft SQL Server, sur Analysis Services, puis cliquez sur Gestionnaire d’analyse.

2. Dans le panneau de navigation Analysis Manager , double-cliquez sur le nœud Serveurs d’analyse pour le développer.

3. Cliquez avec le bouton droit sur le serveur avec le dépôt chaîne de connexion que vous souhaitez modifier, puis sélectionnez Modifier la chaîne de connexion au référentiel.

4. Dans la boîte de dialogue Modifier la chaîne de connexion du référentiel , vérifiez le nom du serveur dans cette chaîne et mettez-le à jour avec le nouveau nom d’ordinateur s’il est incorrect.

5. Accédez à l’emplacement suivant : < répertoire >d’installation\Program Files\Microsoft Analysis Services\Bin.

6. Cliquez avec le bouton droit sur le dossier Bin , puis cliquez sur Partage et sécurité. La boîte de dialogue Propriétés du bac s’affiche.

7. Dans la boîte de dialogue Propriétés du bac, cliquez sur l’onglet Partage pour vérifier que tous les administrateurs OLAP (Online Analytical Processing) disposent des autorisations complètes sur ce dossier.

Les artefacts disparaissent de la base de données de configuration lors du redéploiement d'assemblys à partir de Visual Studio

Problème

Lorsqu’un projet BizTalk Server est redéployé au niveau du projet dans Visual Studio, tous les artefacts contenus dans le projet qui font référence au projet redéployé semblent disparaître lorsque le BizTalk Server MMC est actualisé.

Cause

Pour illustrer la cause de ce problème, prenons l'exemple suivant basé sur une solution BizTalk Server dans lequel l'utilisateur souhaite redéployer le projet de mappage. Notez que les projets de compilation génèrent des assemblys individuels. La figure suivante indique l'état de la solution avant redéploiement. Les relations entre les artefacts sont les suivantes :

• Orch1, Orch2, Maps, Pipelines et Schemas sont des projets.

• Orch1 fait référence à Maps, qui a son tour fait référence à Schemas.

• Orch2 fait référence à Schemas.

• Pipelines fait référence à Schemas.

  

  Si l'utilisateur redéploie le projet Maps à l'aide des paramètres de projet Visual Studio par défaut, les artefacts Orch1, Orch2 et Pipelines disparaissent, comme le montre la figure suivante.

  

  Le redéploiement du projet Maps est un processus en deux étapes qui consiste à annuler le déploiement de l'assembly Maps.dll actuellement déployé, puis à déployer le nouveau fichier Maps.dll. Visual Studio effectue ces étapes automatiquement dans le cadre du processus de redéploiement.

Notes

La phrase précédente n'est pas strictement correcte car Visual Studio exécute systématiquement certaines étapes, donc rien n'indique que ce soit la méthode appropriée.

Le point clé est que pour annuler le déploiement d’un assembly BizTalk Server, Visual Studio doit annuler le déploiement de tous les assemblys dépendant de cet assembly qui ont l’indicateur de déploiement défini. Dans notre exemple, pour effectuer la première étape d'annulation de déploiement du processus de redéploiement, BizTalk Server doit annuler le déploiement de Orch1.dll (qui dépend de Maps.dll). Pendant l’annulation du déploiement de Maps.dll, Visual Studio déséploie également Schemas.dll (en supposant qu’il a l’indicateur de déploiement défini). Pour annuler le déploiement de Schemas.dll, Visual Studio doit annuler celui de Orch2.dll et Pipelines.dll (qui dépendent tous deux de Schemas.dll).

Un problème existe dans le fait que Visual Studio redéploie uniquement Maps.dll et les assemblys dont il dépend : dans ce cas, Schemas.dll. Ainsi, lorsque l’utilisateur actualise le BizTalk Server MMC, les assemblys Orch1, Orch2 et Pipeline semblent avoir disparu, mais Maps.dll et Schemas.dll sont toujours visibles.

Résolution

Pour le projet principal (qui fait référence à d'autres projets), procédez comme suit :

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud de la solution.

2. Cliquez sur Propriétés pour ouvrir la boîte de dialogue Pages de propriétés de la solution.

3. Cliquez sur Propriétés de configuration, puis sur Configuration.

4. Désactivez la zone Déployer case activée pour le projet référencé.

5. Dans l'Explorateur de solutions, exécutez une nouveau déploiement au niveau solution. Pour ce faire, cliquez avec le bouton droit sur le nœud de solution, puis cliquez sur Déployer la solution.

Types de répertoire virtuel pris en charge

Lors du référencement de services web à partir d’une orchestration et d’une tentative d’exportation MSI, l’opération d’exportation réussit uniquement si les répertoires virtuels associés sont de type IIsWebVirtualDir ou IIsWebDirectory. IIsWebVirtualDir et IIsWebDirectory sont les types de nœuds qui apparaissent dans la métabase IIS. IIsWebVirtualDir est un répertoire virtuel avec une propriété Path qui pointe vers un dossier de fichier absolu. IIsWebDirectory est un répertoire virtuel sans propriété Path et fait donc référence à un dossier de fichiers relatif, généralement un sous-dossier d’un autre nœud IIsWebVirtualDir ou IIsWebDirectory . Ces deux types sont ceux qui apparaissent généralement dans la hiérarchie de la métabase pour décrire les dossiers.

Les répertoires virtuels de type IIsConfigObject ne sont pas pris en charge et l’exportation MSI échoue dans ce cas. IIsConfigObject est un type de nœud de métabase inattendu qui est soit un type de nœud valide que BizTalk Server ne gère pas correctement, soit une indication d’une entrée de métabase créée de manière incorrecte (et donc non valide). Dans ce cas, BizTalk Server affiche un message d’erreur semblable à ce qui suit : Entrée de répertoire inattendue « IIS://LM/W3SVC/1/ROOT/BadVdir/ » de type IIsConfigObject.

Impossible d'afficher les informations sur les groupes après suppression des connexions dépassées

Problème

Si, lors de la configuration, vous rencontrez et supprimez des connexions dépassées, vous ne pouvez pas afficher les informations sur les groupes.

Cause

Il s'agit d'un problème de configuration connu.

Résolution

Supprimez les connexions du groupe Windows de l'hôte, puis exécutez à nouveau le programme de configuration. Si les informations sur les groupes ne sont toujours pas disponibles, contactez le support technique Microsoft.

Impossible de modifier le nom de l'ordinateur après l'installation de BizTalk Server

Problème

Lorsque vous modifiez le nom de l’ordinateur sur un ordinateur exécutant BizTalk Server et que vous redémarrez l’ordinateur, des messages d’erreur peuvent se produire.

Cause

SQL Server ne prend pas en charge la modification du nom de l’ordinateur, BizTalk Server ne prend pas en charge la modification du nom de l’ordinateur une fois BizTalk Server installé et configuré.

Résolution

Il est recommandé de ne pas modifier les noms d'ordinateur après l'installation de BizTalk Server.