Getting familiar with the included samples

Topics: Getting Started/Beginner
Dec 30, 2009 at 7:15 PM
Edited Feb 22, 2010 at 7:53 PM

Here's a quick little tour of the sample.  It will give you an very high overview of how the sample works in Visual Studio, and how it can be installed on a server using the MSI file. 

NOTE:  The install location is C:\Program Files\Deployment Framework for BizTalk\5.0... (it does not ask you where to install it).

Developer – Getting Familiar with the Provided Sample 

Summary of Three Samples

Summary of the three examples.  Before the Feb 2010 release, there was only one sample, which is now called "Advanced". Two simpler scenarios have been addd.

1) HelloWorld -  About the simplest possible.  A small orchestration with two schemas and one map, all in one project.  There are no substitutions in the binding file.   Has a PortBindings.xml file only (i.e. no PortBindingsMaster.xml).

2) BasicMasterBindings - Same as HelloWorld, except now includes substitutions in the bindings file (introduces PortBindingsMaster.xml vs PortBindings.xml).  Introduces the file: SettingsFileGenerator.xml, which you can open in Excel. 

3) Advanced - This one does a lot of stuff, including IIS Virtual Directories...  Again, this was the only example included in prior releases.

Visual Studio

  1. After installing the BTDF, open the 2006 or 2009 solution in Visual Studio.
         [Open C:\Program Files\Deployment Framework for BizTalk\5.0\Samples and then either open BizTalk2006 or BizTalk2009.
          As of the most Feb 2010 builds, you now have 3 projects to play with.  I suggest starting with the "HelloWorld".
          You have to run the PrepareSample.bat if using the BT2006 version.)
  2. In VS Solution Explorer, open the .btdfproj file and take a quick look at some of its parameters
  3. In Visual Studio, do a normal Build of the Solution.  As of Feb 2010, the BTDF will do a deploy, but not a build.
  4. In Visual Studio, do a “Tools”, “BizTalk Deployment Framework”,  then “Deploy BizTalk Solution”
  5. Watch the output window, and check for any “0 errors” when it has completed.
  6. From BizTalk Admin Console, refresh the “Applications”, and expand the “BizTalkSample_1.0” application.   It should be there, with three started orchestrations.
  7. In Visual Studio, do a “Tools”, “BizTalk Deployment Framework”,  then “Undeploy BizTalk Solution”, observe the output window and wait for it to finish.
  8. From BizTalk Admin Console, refresh the “Applications”, and the “BizTalkSample_1.0” application should no longer be there. 

 

MSI Install

  1. In Visual Studio, do a “Tools”, “BizTalk Deployment Framework”,  then “Build Server Deploy MSI”, observe the output window  
  2. Check that the date of the MSI in this directory is the current date/time:
    c:\BTDFInstallDirectory\BizTalkSample_BT2009\BizTalkSample.Deployment\bin\Debug\BizTalkSample-1.0.0.msi  
  3. Run the MSI.  This does not deploy the project, only installs a Windows Application.  
  4. Run the Windows Application, from “Start” click “All Programs” then “BizTalk Sample 1.0”.  Then click “Deploy Deployment Framework for BizTalk Sample”.  This will show 5 install screens (you'll have to have a user/pass).
  5. From BizTalk Admin Console, refresh the “Applications”, and expand the “BizTalkSample_1.0” application.   It should be there, with three started orchestrations.
  6. Run the Windows Application, from “Start” click “All Programs” then “BizTalk Sample 1.0”.  Then click “Verify Deployment”.   This will run the N-Unit tests.  
  7. To complete the cycle, you can now undeploy. Run the Windows Application, from “Start” click “All Programs” then “BizTalk Sample 1.0”.  Then click “Undeploy Deployment Framework for BizTalk Sample”.   
  8. From BizTalk Admin Console, refresh the “Applications”, and the “BizTalkSample_1.0” application should no longer be there. 
  9. From the Windows “Control Panel”,  “Programs and Features”, find “BizTalk Sample 1.0”.  Right-click and Uninstall (double clicking will also prompt you to begin the uninstall).  This will remove the items in the “Start”/”All Programs”. 

Neal Walters