Enumerating the AddLocal parameters for a quiet BizTalk installation

More adventures in scripting – I’ve been using the Microsoft Deployment Toolkit (MDT) 2010 to work on scripting server installations in our fledgling Hyper-V environment.  The goal of this process is both to be able to quickly stand up new environments for disaster recovery as well as eliminating infrastructure discrepancies when deploying across environments (no more “It worked on my box” or “It worked in the QA environment”).  On my future TODO list is to post my learnings for this process (stay tuned).


On to the topic of THIS blog:  One of the challenges I faced was the BizTalk 2006 R2 quiet install.  Although the installation guide shows the command line switches (/CABPATH, /L(og), etc.), when it comes to the “ADDLOCAL” switch, which specifies which features of BizTalk to install, all that they give you is the “ALL” command, which installs all of the features (oddly enough).  Unfortunately, in my environment, I do not want to(and cannot even if I did due to security issues) install every feature.  For example, I can’t install portal components and dev/SDK tools into my production environment. 


Unlike the guides for SQL Server, which shows EVERY possible valid value for the ADDLOCAL parameter, I couldn’t find much additional information about the values for BizTalk.  I asked around and didn’t find anyone who had information as to which values were valid for this switch.  I did find various posts which had a listing of the switches, but they didn’t seem to map to the features you see in the GUI very well.  What I ended up doing in the end was installing, one by one, each feature and recording the ADDLOCAL commands which are written to the setup log (which was a real testament to Hyper-V and the snapshot process!).  I post them here in the hopes that others may learn from these.


A few notes:  You may see the commands, such as “BizTalk” and “WMI” repeated for each section heading.  This is by design.  Apparently some components are ubiquitous across all features, but they only need to be specified once.  For example, if you are installing the Server Runtime components and the Administration tools, only specify “BizTalk” and “WMI” once.  Also, I found that the switches are case-sensitive.  FBAMClient blows up while FBAMCLIENT is valid.


 BizTalk 2006 R2 features










































































Feature


ADDLOCAL Command


Documentation


Documentation


Server Runtime


BizTalk, WMI, Runtime, Engine, MOT, HwsBaseAssemblies, MessageQueuing, MSMQ, HwsRuntime


Base EDI Adapter


(Deprecated in 2006 R2)


BizTalk EDI/AS2 Runtime


MsEDIAS2, MsEDIAS2StatusReporting


Windows Communication Foundation


WCFAdapter


Portal Components


BizTalk, WMI, InfoWorkerApps


Business Activity Services


(Deprecated in 2006 R2)


Business Activity Monitoring


BAMPortal


Human Workflow Web Service


HwsWebService


Administration Tools


BizTalk, WMI, AdminAndMonitoring, AdminTools, MonitoringAndTracking, BizTalkAdminSnapIn, HealthActivityClient, BAMTools, HwsWMIProvider, PAM


Windows Communication Foundation Administration Tools


WcfAdapterAdminTools


Developer Tools and SDK


BizTalk, WMI, SDK, Development, VSTools, BizTalkExtensions, BizTalkExplorer, Designer, OrchestrationDesigner, PipelineDesigner, XMLTools, AdapterImportWizard, HwsDesigner, BasSchemaExtension, DeploymentWizard, TrackingProfileEditor


Additional Software


BizTalk, WMI, AdditionalApps


Enterprise Single Sign-On Administration


SSOAdmin


Enterprise Single Sign-On Master Secret Server


SSOServer


Business Rules Components


RulesEngine


MQSeries Agent


MQSeriesAgent


Windows SharePoint Services Adapter


WssAdapterWS


BAM Alert Provider For SQL Notification Services


OLAPNS


BAM Client


FBAMCLIENT


BAM-Eventing


BAMEVENTAPI


 


 


UPDATE***I went ahead and did the same for BizTalk 2009 features as they changed slightly from 2006 R2 to 2009 (mostly the removal of Human Workflow Services from 2006 R2 and the addition of Project Build Component). 


 BizTalk 2009 features

































































Feature


ADDLOCAL Command


Portal Components


BizTalk, WMI, InfoWorkerApps


Business Activity Monitoring


BAMPortal


Developer Tools and SDK


Development, MsEDISchemaExtension, MsEDISDK, MsEDIMigration, SDK, WMI, BizTalk, Migration, BizTalkExplorer, BizTalkExtensions, OrchestrationDesigner, Designer, PipelineDesigner, XMLTools, AdapterImportWizard, VSTools, WCFDevTools, DeploymentWizard, TrackingProfileEditor


Documentation


Documentation


Server Runtime


BizTalk, WMI, Runtime, Engine, MOT,  MSMQ


BizTalk EDI/AS2 Runtime


MsEDIAS2, MsEDIAS2StatusReporting


Windows Communication Foundation


WCFAdapter


Administration Tools


BizTalk, WMI, AdminAndMonitoring, AdminTools, MonitoringAndTracking, BizTalkAdminSnapIn, HealthActivityClient, BAMTools, PAM


Windows Communication Foundation Administration Tools


WcfAdapterAdminTools


Additional Software


BizTalk, WMI, AdditionalApps


Enterprise Single Sign-On Administration


SSOAdmin


Enterprise Single Sign-On Master Secret Server


SSOServer


Business Rules Components


RulesEngine


MQSeries Agent


MQSeriesAgent


Windows SharePoint Services Adapter


WssAdapterWS


BAM Alert Provider For SQL Notification Services


OLAPNS


BAM Client


FBAMCLIENT


BAM-Eventing


BAMEVENTAPI


Project Build Component


ProjectBuildComponent


And finally here is a working script for an install on a server with the “basic” components, but omitting such things as the HwsWebService, Developer Tools, and EDI Adapter/Runtime.  This would be included in a .cmd file (I parametarized the script for easier manipulation of the install options.


SET InstallDirectory=d:\Biztalk Server R2
SET CABLocation=d:\Biztalk Server R2\redist\BtsRedistW2k3EN64.cab
SET InstallOptions=BizTalk,WMI,Runtime,Engine,MOT,HwsBaseAssemblies,MessageQueuing,MSMQ,HwsRuntime,WCFAdapter,InfoWorkerApps,BAMPortal,AdminAndMonitoring,AdminTools,MonitoringAndTracking,BizTalkAdminSnapIn,HealthActivityClient,BAMTools,HwsWMIProvider,PAM,WcfAdapterAdminTools,AdditionalApps,SSOAdmin,SSOServer,RulesEngine,OLAPNS,FBAMCLIENT,BAMEVENTAPI
SET InstallDir=D:\Program Files\Microsoft BizTalk Server 2006
SET CompanyName=MyCompany
SET UserName=MyUser
SET OutputLog=BTSinstallLog.log


“%InstallDirectory%\setup.exe” /passive /CABPATH “%CABLocation%” /l “%OutputLog%” /InstallDir “%InstallDir%” /CompanyName “%CompanyName%” /UserName “%UserName%” /AddLocal “%InstallOptions%”


***Update***


I did not previously have the AddLocal commands for the MQSeriesAgent or Windows SharePoint Services Adapter Web Service features listed because my dev machine did not have the pre-requisites installed to support these.  However, I was reminded of the Orca tool which allows you to inspect MSI payload by a colleague, and this lists out all of the features, so I’ve completed the table with these values.  Thanks John!