Il y a maintenant presque un an, j'ai créé un petit utilitaire en ligne de commande permettant de "faire le ménage" et supprimer complètement une application BizTalk sur un groupe de serveurs.

Je viens de le mettre sur CodePlex et voici donc quelques informations sur son utilisation.

Utilisation de BTSZap

BTSZap est un utilitaire permettant de complètement supprimer toutes traces d'une application sur un groupe de serveur BizTalk.

BTSZap fonctionne avec BizTalk 2006 R2 et BizTalk 2009.

Il s'agit d'un utilitaire en ligne de commande disposant de nombreuses options.

BTSZap est prévu pour effectuer les opérations suivantes :

Ø Effectuer une sauvegarde MSI de l'application

Ø Désinstaller le MSI sur l'ensemble des serveurs (si l'application a été installée par MSI)

Ø Terminer les instances actives

Ø Arrêter et supprimer l'application

Ø Enlever du GAC, le cas échéant, les assemblies

Ø Redémarrer les host instances

Option de la ligne de commande et exemples d'utilisation :

La syntaxe pour utiliser BTSZap est la suivante :

BTSZap NomDuParametre1:Valeur1 ... NomDuParametreN:ValeurN

Pour obtenir la liste des options il suffit de lancer BTSZap sans paramètres :

Utilisation des paramètres :

Language:String

Langue (FR,EN...). Si absent le programme utilise le paramétrage courant

ApplicationName:String

Nom de l'application BizTalk à supprimer

[AutoDetectConfig:Boolean] Default=True

Si actif, une auto détection des paramètres de connection SQL Server sera effectuée

[DatabaseServer:String] Default=.

Nom de l'instance SQL Server hébergeant la base de configuration BizTalk

[ManagementDatabase:String] Default=BiztalkMgmtDb

Nom de la base de donnée de configuration

[UnGAC:Boolean] Default=False

Si actif, les assemblies seront enlevées du GAC

[RestartHostInstances:Boolean] Default=True

Si actif les instances de host seront redémarrée après désinstallation

[FullStop:Boolean] Default=True

Effectue un "Full Stop" (supprime les orchestrations en cours)

[NoConfirmation:Boolean] Default=False

Désactivation de la confirmation de lancement

[InfoLevel:Int32] Default=2

Niveau d'information (0 à 3)

BackupMSIFile:String

Nom et chemin d'accès du MSI à créer. Si non précisé, aucun backup ne sera effectué

MSI:String

Nom du package MSI à désinstaller

[HaltOnError:Boolean] Default=True

à true, arrête le traitement en cas d'erreur critique. Sinon essaie de continuer

Exemple d'utilisation :

BTSZap ApplicationName:Rental FullStop:true BackupMSIFile:c:\Rental.msi AutoDetectConfig:false UnGac:true DatabaseServer:localhost InfoLevel:3 Language:EN MSI=Rental HaltOnError:false

Cette commande demande a BTSZap d'effectuer les actions suivantes :

Ø ApplicationName:Rental --> désinstallation de l'application Rental

Ø FullStop:true --> supprimer les instances actives

Ø BackupMSIFile:c:\Rental.msi --> effectuer un backup et sauvegarder dans c:\rental.msi

Ø AutoDetectConfig:false --> ne pas détecter automatiquement les paramètres de connexion à la base de données de configuration BizTalk

Ø UnGac:true --> retirez du GAC les assemblies

Ø DatabaseServer:localhost --> se connecter au serveur de base de donnée : localhost

Ø InfoLevel:3 --> niveau d'information 3

Ø Language:EN --> forcer les messages en anglais

Ø MSI:Rental --> nom de l'application telle qu'elle apparait dans la liste des programmes

Ø HaltOnError:false --> ne pas s'arrêter sur erreur

Téléchargement et remarques

BTSZap peut être téléchargé sur codeplex. l'adresse est http://btszap.codeplex.com

Attention, en cas de recompilation des sources le comportement est différent en mode Debug et en mode Release (le mode Debug fait une pause après chaque action)

Bonne utilisation

Roch BADUEL