Partager via

Installation d'une application BizTalk

  • Article

Cette rubrique décrit la procédure d'installation d'une application sur l'ordinateur local par double-clic sur le fichier Windows Installer (.msi) de l'application dans l'interface Windows ou par l'exécution du programme msiexec à partir de la ligne de commande. Vous pouvez également démarrer l’Assistant Installation en tant que dernière étape de l’Assistant Importation, comme décrit dans Comment importer une application BizTalk.

Attention

Si l'application a déjà été installée sur l'ordinateur, vous aurez la possibilité de la réparer. La réparation est possible uniquement lorsqu'un seul fichier .msi a été installé pour l'application. Si vous avez installé plusieurs fichiers .msi sur l'ordinateur pour l'application, vous ne pourrez pas sélectionner cette option, car la réparation annule toutes les modifications apportées par les fichiers .msi installés après le fichier .msi, ce qui peut entraîner un mauvais fonctionnement de l'application.

Avant de pouvoir exécuter une application, vous devez l'installer sur les ordinateurs BizTalk Server qui l'exécuteront. L'installation d'une application place ses ressources sur le système de fichiers local. Selon l'application, son contenu et sa configuration, l'installation peut aussi effectuer les opérations suivantes :

Prérequis

Pour exécuter les procédures décrites dans cette rubrique, vous devez être connecté avec un compte disposant d'autorisations en écriture sur le système de fichiers local. Selon les éléments contenus dans l'application, vous pouvez avoir également besoin d'autorisations en écriture sur le Registre Windows, le GAC, le magasin de certificats et les services IIS. Le compte des administrateurs de l'ordinateur local dispose de ces autorisations. Pour plus d’informations sur les autorisations, consultez Autorisations requises pour le déploiement et la gestion d’une application BizTalk.

Considérations relatives à l'installation d'une application

Lors de l'installation d'une application, tenez compte des éléments suivants :

  • Vous devez également installer toute application dont l'application dépend. Lorsque vous installez une application dépendant d'un artefact, comme un assembly BizTalk, contenu dans une autre application, vous devez également installer l'application qui contient cet artefact. Vous devez effectuer cette opération avant d'exécuter l'application. Par exemple, si l’application A dépend d’un assembly dans l’application B, vous devez également installer l’application B. Vous pouvez ensuite installer l’application A. Pour plus d’informations, consultez Dépendances et déploiement d’applications.

  • Vous devez arrêter l'application que vous mettez à jour. Si vous effectuez l'installation afin de mettre à jour un artefact de l'application, il n'est pas utile d'arrêter cette dernière sauf si la mise à jour inclut des assemblys dont la version est identique aux assemblys existants. Dans ce cas, vous devez arrêter l'application avant de procéder à la mise à jour. Nous vous recommandons d'arrêter l'application dans tous les cas, sauf si vous êtes sûr que la mise à jour n'interfèrera pas avec l'exécution de l'application. Pour plus d’informations, consultez Mise à jour d’applications BizTalk.

  • Lorsque vous installez plusieurs fichiers .msi pour la même application, une seule entrée est créée dans Ajout/Suppression de programmes. Vous pouvez procéder ainsi pour mettre à jour une application existante par exemple. Vous pouvez ensuite utiliser Ajouter ou supprimer des programmes (dans Panneau de configuration) pour désinstaller complètement l’application, y compris les éléments mis à jour. La désinstallation d'une application par double-clic sur le fichier .msi ou par l'exécution du programme msiexec n'est pas prise en charge. Pour plus d’informations, consultez Comment désinstaller une application BizTalk.

  • Vous devez installer les certificats sur tous les ordinateurs hébergeant les ports d'envoi pour pouvoir exécuter l'application. Le magasin de certificats d'autres personnes contient le certificat utilisé par les ports d'envoi.

  • Vous pouvez factoriser les artefacts de l'application dans différents fichiers .msi de l'installation. Vous n'avez pas besoin d'installer tous les artefacts de l'application sur chaque ordinateur qui devra exécuter l'application. Il est plutôt préférable d'exporter des sous-ensembles d'artefacts de l'application dans différents fichiers .msi à installer sur les différents ordinateurs. Pour obtenir des instructions, consultez Guide pratique pour exporter une application BizTalk.

  • Si le fichier .msi de l'application contient un répertoire virtuel, les services IIS (Internet Information Services) doivent être exécutés sur l'ordinateur local. Dans le cas contraire, l'installation échouera.

  • Si l'application contient un répertoire virtuel portant le même nom qu'un répertoire virtuel existant sur l'ordinateur local, les ressources de l'application seront ajoutées au répertoire de l'ordinateur. Dans le cas contraire, le répertoire virtuel est créé. Tout fichier existant portant le même nom que les fichiers ajoutés sera remplacé. En outre, les paramètres de sécurité d'un répertoire virtuel ne sont pas modifiés, vous devez donc vérifier qu'ils sont suffisamment sécurisés.

  • Créez des pools d'applications pour les répertoires virtuels avant d'installer l'application. Si l'application contient un répertoire virtuel et que le pool d'applications n'existe pas encore dans IIS, vous devez le créer manuellement avant de procéder à l'installation. Ainsi, le répertoire virtuel sera associé au pool d'applications au cours de l'installation. Si vous ne créez pas l'application, le répertoire virtuel sera associé au pool d'applications par défaut au cours de l'installation.

  • Vérifiez que BTSHttpReceive.dll est enregistré comme mappage de gestionnaire avec Internet Information Services (IIS) 7.0. Vous devez effectuer cette vérification si l'application contient un répertoire virtuel, de sorte que l'emplacement de réception HTTP fonctionne.

  • Vous pouvez rencontrer des problèmes lors de l'installation d'une application contenant des artefacts 64 bits sur un ordinateur 32 bits. Pour plus d’informations, consultez Ajout d’un artefact 64 bits à une application.

  • Vous pouvez rencontrer des problèmes si le répertoire cible dépasse les 260 caractères. Si le nombre de caractères du répertoire cible spécifié au cours de l'installation d'un package MSI dépasse les 260 caractères, l'installation échoue. Pour résoudre ce problème, assurez-vous que le nombre de caractères indiqué pour le répertoire cible ne dépasse pas 260.

  • Vous ne devez pas déplacer le dossier d'installation. Une fois l'application installée, vous ne devez en aucun cas déplacer le dossier d'installation ni les fichiers qu'il contient. Dans le cas contraire, toute tentative ultérieure de désinstallation de l'application échouera, notamment si le dossier d'installation de l'application contient des fichiers générés par BizTalk Server et nécessaires à la suppression. Par conséquent, vous ne devez pas renommer ces fichiers, ni les déplacer, ni les supprimer. Ces fichiers sont les suivants :

    • ApplicationDefinition.adf

    • Microsoft.BizTalk.CustomInstaller.dll

    • Microsoft.BizTalk.CustomInstaller.InstallState

Notes

Si vous annulez l’opération d’installation avant qu’elle ne se termine, BizTalk Server annule l’installation, à l’exception des actions effectuées par des scripts de pré-traitement ou de post-traitement avant l’annulation de l’opération.

Important

Avant d’installer une application, assurez-vous que vous avez reçu le fichier .msi d’une source approuvée. Un utilisateur malveillant peut inclure du code dans un fichier .msi qui peut avoir un impact indésirable sur votre système ou votre réseau. Pour plus d’informations, consultez Sécurité et Windows Installer.

Si l'application inclut un site Web ou une orchestration qui utilise un site Web, sachez que les paramètres de sécurité du répertoire virtuel utilisés sont ceux qui sont activés lorsque le fichier .msi est généré au cours de l'exportation de l'application, sauf s'il existe déjà un répertoire virtuel, auquel cas, les paramètres existants sont employés. Une fois l'application installée, vous devez vérifier que ces paramètres répondent à vos exigences en matière de sécurité.

Les listes de contrôle d’accès alldiscrétionary (DACL) sont supprimées des fichiers et dossiers lorsqu’une application est exportée. Une fois l'application installée sur une instance de l'hôte, vous devez reconfigurer tous les paramètres de sécurité dans les fichiers et les dossiers, y compris dans les répertoires virtuels.

  • Vous pouvez être amené à modifier la désignation du chemin d'accès local d'un répertoire virtuel référencé par un emplacement de réception HTTP après sa création sur l'ordinateur cible.

    Une fois le répertoire virtuel créé sur l'ordinateur cible, il pointe vers un des répertoires physiques suivants :

    <lecteur d’installation>\Program Files\Microsoft BizTalk Server\HttpReceive

    - ou –

    <lecteur d’installation>\Program Files (x86)\Microsoft BizTalk Server\HttpReceive

    Si le fichier BTSHTTPReceive.dll d'extension ISAPI de l'emplacement de réception HTTP BizTalk ne se trouve pas dans le répertoire spécifié ou si l'ordinateur cible exécute un système d'exploitation 64 bits, vous devez modifier la désignation du chemin d'accès local : du répertoire virtuel de sorte qu'il pointe vers le répertoire physique contenant le fichier d'extension ISAPI de l'emplacement de réception HTTP BizTalk. Par exemple, si l’ordinateur cible exécute la version 64 bits de Windows Vista, la désignation Chemin d’accès local : du répertoire virtuel doit être remplacée par <lecteur d’installation>\Program Files (x86)\Microsoft BizTalk Server\HttpReceive64.

Pour installer une application BizTalk

Utilisation de l’interface Windows

  1. Copiez le fichier .msi file de l'application sur l'ordinateur local.

  2. Si vous réinstallez ou mettez à niveau une application BizTalk existante et que la nouvelle installation inclut un assembly qui a la même version que celle qui existe déjà dans l’application, ou interagit avec un artefact que vous mettez à jour, assurez-vous que l’application est arrêtée en cliquant avec le bouton droit sur le dossier de l’application, puis en cliquant sur Arrêter.

  3. Dans l'Explorateur Windows, double-cliquez sur le fichier .msi pour démarrer l'Assistant Installation.

  4. Dans la page Sélectionner un dossier d’installation , dans Dossier, tapez le chemin d’installation complet de l’application BizTalk. Exemple : C:\Program Files\Generated by BizTalk\MyApplication.

  5. Cliquez sur Suivant quatre fois, puis sur la page Installation terminée , cliquez sur Fermer.

  6. Si plusieurs ordinateurs doivent exécuter l'application, répétez ces étapes pour chacun d'eux.

    Une fois que l’application est installée sur tous les ordinateurs qui l’exécutent et que l’application a été importée dans le groupe BizTalk, vous pouvez démarrer l’application à partir de la console d’administration BizTalk Server en cliquant avec le bouton droit sur le dossier de l’application et en cliquant sur Démarrer. Pour obtenir des instructions complètes, consultez Guide pratique pour démarrer et arrêter une application BizTalk.

Utilisation de la ligne de commande

  1. Copiez le fichier .msi file de l'application sur l'ordinateur local.

  2. Cliquez sur Démarrer, sur Exécuter, tapez cmd, puis appuyez sur Entrée.

  3. Accédez à l'emplacement où se trouve le fichier .msi.

  4. Entrez la commande suivante pour installer l'application, en saisissant les paramètres et valeurs adéquats, comme indiqué dans le tableau suivant :

    Important

    Seuls les paramètres de msiexec affichés dans le tableau suivant sont pris en charge.

    msiexec [/i] Package [/qn] TARGETDIR="value"]

    Exemple : msiexec /i MyApplication.msi

    Paramètre Valeur
    /Je Installe l'application.
    Package Nom du fichier Windows Installer (.msi).
    /qn Effectue l'installation sans afficher d'interface utilisateur.
    TARGETDIR="value » Spécifie l'emplacement du dossier d'installation de l'application. Cette valeur est également définie dans la variable d'environnement %BTAD_InstallDir%.

    Exemple : TARGETDIR="C:\Programs\BizTalk Applications\My Application"

  5. Si plusieurs ordinateurs doivent exécuter l'application, répétez ces étapes pour chacun d'eux.

    Une fois l’application installée sur tous les ordinateurs qui l’exécutent, vous pouvez démarrer l’application à partir de la console d’administration BizTalk Server en cliquant avec le bouton droit sur le dossier de l’application, puis en cliquant sur Démarrer. Pour obtenir des instructions complètes, consultez Guide pratique pour démarrer et arrêter une application BizTalk.

Voir aussi

Déploiement des applications BizTalk
Désinstallation d'une application BizTalk