Guide pratique pour exporter une application BizTalk

Article
05/04/2023

Cette rubrique décrit comment exporter une application à l'aide de la console Administration de BizTalk Server ou de la ligne de commande. L'exportation d'une application BizTalk génère un fichier Windows Installer (.msi) qui contient l'application, ainsi que les artefacts qu'elle contient et que vous sélectionnez pour l'exportation. L'option par défaut sélectionne tous les artefacts de l'application, mais vous pouvez en sélectionner certains seulement. Vous pouvez ensuite importer le fichier .msi file dans un autre groupe BizTalk afin d'ajouter les artefacts à une application existant dans le nouveau groupe, mettre à jour les artefacts dans une application existante ou créer une application dans le groupe contenant les artefacts importés. Pour plus d’informations, consultez Comment importer une application BizTalk. Vous utilisez également le fichier .msi pour installer l’application sur les ordinateurs qui l’exécuteront, comme décrit dans Installation d’une application BizTalk. Si l’application inclut des artefacts basés sur des fichiers, vous devez également l’installer avant de pouvoir commencer à fonctionner.

Lorsque vous exportez une application, gardez les points importants suivants à l'esprit :

Les liaisons existantes sont automatiquement remplacées par les liaisons importées. Pour éviter que les liaisons de l'application exportée ne remplacent les liaisons de l'application dans laquelle vous importez un fichier .msi, ne sélectionnez pas le fichier de liaison en tant que ressource à exporter. Lorsque vous importez un fichier .msi file contenant un fichier de liaison dans une application existante, les liaisons existantes sont remplacées par celles en cours d'importation, même si vous n'avez pas choisi de remplacer les artefacts existants.
Un utilisateur peut modifier un artefact au moment où vous exportez l'application. Si un utilisateur modifie un artefact basé sur une base de données, tel qu'un répertoire virtuel, un certificat ou une stratégie, pendant l'exportation, ces modifications n'apparaissent pas dans le fichier .msi exporté. Nous vous recommandons par conséquent de planifier les exportations à des heures où les utilisateurs ne sont pas susceptibles de modifier ces artefacts.
Une erreur incorrecte peut être affichée lors de l’installation d’un .msi sur Windows Vista. Lors de l’installation d’un package .msi exporté à l’aide de BizTalk Server, vous pouvez recevoir l’erreur incorrecte suivante : « Le programme d’installation a rencontré une erreur inattendue lors de l’installation de ce package. Il s'agit peut-être d'un problème lié au package. Le code d’erreur est 2869. » Pour corriger cette erreur, commencez par importer le package .msi à l’aide de BizTalk Server, puis réexportez et installez le package.
L'application peut dépendre d'une autre application. Ceci peut affecter le mode de déploiement de l'application. Pour plus d’informations, consultez Dépendances et déploiement d’applications.
Vous pouvez changer de répertoire de destination des ressources dans l'application avant l'exportation. Si vous souhaitez modifier l’emplacement de destination, développez le nœud ressources de votre application, cliquez avec le bouton droit sur la ressource à modifier, puis choisissez Modifier. Dans la boîte de dialogue Modifier les ressources, entrez un nouvel emplacement dans pour Emplacement de destination.
L'exportation échoue si l'application contient une stratégie ayant été supprimée de la base de données du moteur de règles. Lorsque vous supprimez une stratégie de la base de données du moteur de règles à l'aide de l'Assistant Déploiement du moteur de règles, il affiche la console d'administration en l'état « Non publié », et vous ne pouvez pas exporter l'application. Pour plus d’informations sur l’Assistant Déploiement du moteur de règles, consultez Guide pratique pour déployer et annuler le déploiement de stratégies et de vocabulaires.

Important

Le fichier .msi peut contenir des données sensibles. Vérifiez que le fichier est sécurisé. Pour plus d’informations, consultez Sécurité et Windows Installer.

Pendant l'exportation d'une application, les mots de passe sont supprimés des liaisons de l'application. Après avoir installé l’application à partir du fichier .msi, vous devez reconfigurer les mots de passe pour que l’application fonctionne. Les mots de passe ne sont cependant pas supprimés des fichiers de liaison ajoutés à l'application.

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. Si vous déployez une application dans l'environnement de production, avant de l'exporter, vérifiez que les paramètres répondent à vos exigences en matière de sécurité. Si le répertoire virtuel existe déjà sur l'ordinateur hôte, ses paramètres de sécurité ne sont pas remplacés, mais les fichiers de l'application sont ajoutés au répertoire. Une fois l'application importée, vous devez vérifier les paramètres de sécurité.

Toutes les listes de contrôle d'accès discrétionnaires (DACL) sont supprimées des fichiers et dossiers lors de l'exportation d'une application. Une fois l'application installée, vous devez reconfigurer tous les paramètres de sécurité dans les fichiers et les dossiers, y compris dans les répertoires virtuels.

Notes

Si l'exportation échoue, BizTalk Server supprime tous les fichiers temporaires avec le fichier .msi.

Prérequis

Pour effectuer les procédures de cette rubrique, vous devez être connecté avec un compte membre du groupe Administrateurs BizTalk Server. Pour plus d’informations sur les autorisations, consultez Autorisations requises pour le déploiement et la gestion d’une application BizTalk. De plus, le Moteur des règles d'entreprise doit être installé. Pour plus d’informations, consultez Installer BizTalk Server.

Exporter une application à l’aide de BizTalk Server Administration

Cliquez sur Démarrer, sur Tous les programmes, Microsoft BizTalk Server 20xx, puis sur Administration BizTalk Server.
Dans l’arborescence de la console, développez BizTalk Server Administration, développez le groupe BizTalk, puis Applications.
Cliquez avec le bouton droit sur l’application à exporter, pointez sur Exporter, puis cliquez sur Fichier MSI.
Dans la page Bienvenue dans l’Assistant Exporter un fichier MSI, cliquez sur Suivant.
Dans la page Sélectionner des ressources, sélectionnez les artefacts à exporter dans le fichier .msi, puis cliquez sur Suivant.
Si vous y êtes invité, dans la page Spécifier des hôtes IIS, tapez le nom du serveur de l’ordinateur hébergeant le répertoire virtuel que vous souhaitez inclure, puis cliquez sur Suivant. Vous êtes invité à indiquer le serveur uniquement si le répertoire virtuel n'a pas encore été ajouté à la base de données de gestion BizTalk, comme lorsqu'il a été ajouté à l'application ou importé dans une application.
Dans la page Dépendances, passez en revue les dépendances de l’application, puis cliquez sur Suivant.
Dans la page Destination, dans Nom de l’application de destination, tapez le nom de l’application.
Dans fichier MSI à générer, tapez le chemin d’accès complet du fichier .msi, puis cliquez sur Exporter. Exemple : C:\MSI\Errorhandling.msi

Notes

Nous vous recommandons d'enregistrer les fichiers .msi dans un dossier sécurisé.
Dans la page Résumé, notez l’emplacement du fichier journal pour cette opération, puis cliquez sur Terminer.

Exporter une application à l’aide de la ligne de commande

Ouvrez une invite de commandes comme suit : cliquez sur Démarrer, sur Exécuter, tapez cmd, puis cliquez sur OK.

Tapez la commande suivante en utilisant les valeurs appropriées, comme décrit dans le tableau suivant :

BTSTask ExportApp [/ApplicationName :value] /Package :value [ResourceSpec :value [/Server :value] [/Database :value]

Notes

Sur les systèmes qui prennent en charge le contrôle de compte d'utilisateur, vous devrez peut-être exécuter l'outil avec des privilèges d'administrateur.

Exemple :

BTSTask ExportApp /ApplicationName:MyApplication /Package:C:/MSI/MyApplication.msi /ResourceSpec:"C:\My Files\ResourceSpec.xml" /Server:MySQLServer /Database:BizTalkMgmtDb

Les artefacts mentionnés sont exportés dans le fichier .msi à l'emplacement spécifié.

Paramètre	Valeur
/Applicationname	Nom de l'application BizTalk à exporter. Si le nom de l'application n'est pas spécifié, l'application utilisée est l'application BizTalk définie par défaut. Si le nom comprend des espaces, il doit être placé entre guillemets doubles (« ).
/Paquet	Chemin du fichier .msi à créer, y compris son nom.
/ResourceSpec	Chemin d'accès du fichier XML de spécification de ressource, nom du fichier inclus. Vous pouvez spécifier les artefacts à exporter en modifiant le fichier XML de spécification de ressources, qui est créé lorsque vous exécutez la commande ListApp avec le paramètre ResourceSpec, comme décrit dans Commande ListApp. Vous devez ajouter manuellement à ce fichier le nom du serveur hôte des services IIS du répertoire virtuel à exporter si le serveur Web se trouve sur un ordinateur distant
/Serveur	Nom de l'instance SQL Server hébergeant la base de données de gestion BizTalk et indiqué sous la forme NomServeur\NomInstance,Port. Le nom de l'instance est uniquement requis lorsqu'il est différent du nom du serveur. Le port est uniquement requis lorsque le serveur SQL Server utilise un numéro de port autre que celui par défaut (1433). Exemples : Server=MyServer Server=MyServer\MySQLServer,1533 Si vous n'indiquez pas de nom pour l'instance SQL Server, le nom d'instance utilisé est celui de l'instance SQL Server exécutée sur l'ordinateur local.
/Base	Nom de la base de données de gestion BizTalk. Si vous ne l'indiquez pas, la base de données utilisée est la base de données de gestion BizTalk s'exécutant au sein de l'instance locale de SQL Server.

Voir aussi

Exportation d’applications, de liaisons et de stratégies BizTalk
Commande ExportApp