Details a workaround for a small issues with BTDF v5.5 when deploying to multi server environments
We utilise the BizTalk Deployment Framework (BTDF) for deploying our Biztalk applications. It is a very useful utility and would strongly recommend checking it out if you are not currently utilising it for your Biztalk deployments.
However we did notice a small error with BTDF Version 5.5 in a given set of circumstances recently. This post will detail what this error is and how to work around it until a fix has been applied.
What is the error?
In multi-server environments, for non primary servers where the DeployBizTalkMgmtDB flag is set to false, the GACing of the application DLLs happens right at the very end. These are BizTalk artefact DLLs for schemas, maps, pipeline etc.
So? Whats wrong with that?
As part of your installation process if you need to create any web endpoints (receive locations) for your Biztalk application, they would be done in the CustomPostDeployTarget step in your Deployment.btdfproj file.
These websites will require the artefact DLLs to already be in the GAC. The CustomPostDeployTarget step is run before the GACing of the DLLs so it will fail.
This does not occur on Biztalk Servers where the DeployBizTalkMgmtDB flag is true which is the case for most test environments. This is because the all artefacts are added via BTSTask before the CustomPostDeployTarget step and this includes putting them into the GAC.
If you are not doing anything in your CustomPostDeployTarget step, then you will not have this issue. (I did say this was for given set of circumstances!)
Why does this happen?
We need to look at the BizTalkFramework.targets file (available via the source code) to see:
| <PropertyGroup> | |
| <DeployBizTalkMgmtDBfalseDependsOn> | |
| CustomPreInitialize; | |
| FrameworkInitialize; | |
| CustomPostInitialize; | |
| PreprocessBindings; | |
| PreprocessFiles; | |
| PreprocessAndConfigureLog4net; | |
| CustomDeployTarget; | |
| ConditionalHostStop; | |
| DeploySharedAssemblies; | |
| DeployExternalAssemblies; | |
| DeployComponents; | |
| DeployPipelineComponents; | |
| DeployCustomFunctoids; | |
| DeployVDirs; | |
| DeployBtsNtSvcExeConfig; | |
| CustomPostDeployTarget; | |
| CustomFinalDeploy | |
| </DeployBizTalkMgmtDBfalseDependsOn> | |
| </PropertyGroup> | |
| <!-- Used for a deployment that will NOT deploy assemblies to the BizTalk management database. | |
| Only one server in a BizTalk group should actually deploy assemblies to the management database. --> | |
| <Target Name="DeployBizTalkMgmtDB_false" DependsOnTargets="$(DeployBizTalkMgmtDBfalseDependsOn)"> | |
| <!-- Support server deployments that do not include BizTalk management database. --> | |
| <!-- Need to handle these differently than standard targets - just putting in gac... --> | |
| <Exec Command=""$(Gacutil)" /f /i "@(SchemasQualified)"" Condition="'$(IncludeSchemas)' == 'true' and '%(Identity)' == '%(Identity)'" /> | |
| <Exec Command=""$(Gacutil)" /f /i "@(PipelinesQualified)"" Condition="'$(IncludePipelines)' == 'true' and '%(Identity)' == '%(Identity)'" /> | |
| <Exec Command=""$(Gacutil)" /f /i "@(TransformsQualified)"" Condition="'$(IncludeTransforms)' == 'true' and '%(Identity)' == '%(Identity)'" /> | |
| <Exec Command=""$(Gacutil)" /f /i "@(OrchestrationsQualified)"" Condition="'$(IncludeOrchestrations)' == 'true' and '%(Identity)' == '%(Identity)'" /> | |
| </Target> |
As you can see the the DeployBizTalkMgmtDB_false target has a dependancy on the other group of targets. When we look at the targets in that group, we can see the CustomPostDeployTarget there.
Why is this an issue?
This is something is going to remain undetected until you get to your Prod like environment or Production itself if you have more than one BizTalk Server deployed. Suddenly applications that have not had any issues deploying previously in single server environments will be failing.
Okay... so how do we fix it?
There is a work item in place to fix this, but in the meantime, I would suggest we take the code in the DeployBizTalkMgmtDB_false target from BizTalkFramework.targets as shown above and add it to the start of the CustomPostDeploy step in your Deployment.btdproj file.
| <Target Name="CustomPostDeployTarget"> | |
| <!-- Workaround for BTDF not deploying Artefacts to GAC when DeployBizTalkMgmtDB is false --> | |
| <Message Text="Pre-deploying BizTalk Artefact DLLs into the GAC before rest of CustomPostDeployTarget executes..." Condition="'$(DeployBizTalkMgmtDB)' == 'false'"/> | |
| <Exec Command=""$(Gacutil)" /f /i "@(SchemasQualified)"" Condition="'$(IncludeSchemas)' == 'true' and '$(DeployBizTalkMgmtDB)' == 'false' and '%(Identity)' == '%(Identity)'" /> | |
| <Exec Command=""$(Gacutil)" /f /i "@(PipelinesQualified)"" Condition="'$(IncludePipelines)' == 'true' and '$(DeployBizTalkMgmtDB)' == 'false' and '%(Identity)' == '%(Identity)'" /> | |
| <Exec Command=""$(Gacutil)" /f /i "@(TransformsQualified)"" Condition="'$(IncludeTransforms)' == 'true' and '$(DeployBizTalkMgmtDB)' == 'false' and '%(Identity)' == '%(Identity)'" /> | |
| <Exec Command=""$(Gacutil)" /f /i "@(OrchestrationsQualified)"" Condition="'$(IncludeOrchestrations)' == 'true' and '$(DeployBizTalkMgmtDB)' == 'false' and '%(Identity)' == '%(Identity)'" /> | |
| <!-- ================================================================================================================================== --> | |
| <Message Text="Running SQL scripts for $(ProjectName)..." Condition="'$(DeployBizTalkMgmtDB)' == 'true'"/> | |
| <!-- Only run the SQL QUery if the BizTalk BAM Datasource variable is set--> | |
| <Exec Condition="'$(BizTalkBAM_DataSource)' != '#{BizTalkBAM_DataSource}' and '$(DeployBizTalkMgmtDB)' == 'true'" Command="sqlcmd.exe -S $(BizTalkBAM_DataSource) -d BAMPrimaryImport -E -i "..\SolutionItems\SQL\Create_ESB_BamViews.sql"" /> | |
| <!-- ================================================================================================================================== --> | |
The only change required is tweaking the condition paramter to only do this is the DeployBizTalkMgmtDB flag is false.
Yes this will result with GACing the DLLs twice when you do a deploy and DeployBizTalkMgmtDB is false, but this is harmless and the deployment will not fail.
Hopefully the fix will be applied soon and we won't need to worry about this workaround in the future!
If there is a better way to perform this workaround, or to deploy web sites required for Biztalk HTTP endpoints via BTDF, please let me know!