Share via


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!