This post describes the installation process for the BizTalk Benchmark Wizard application. For more information read part 1.
The complete installation will include the following components:
- BizTalk Benchmark wizard – The client tool from which you will run the tests
- Three Hosts – BBW_RxHost, BBW_PxHost, BBW_TxHost
- Three Host Instances
- Two Adapter handlers for NetTcp
- One BizTalk Application
- Two Receive Ports
- Two Send Hosts
- One Orchestration
The installation process
Download the bits from Codeplex, and proceed with the normal installation. As the setup completes, your first step would be to install the BizTalk artifacts. These artifacts are the BizTalk components and bindings which makes up the testing scenarios. This is a two step process as you need to set up the hosts before you import the bindings.
You can run the scenarios on either a single-server installation or a two server installation. Regardless of the number of BizTalk servers in you group, you should not run it with more than two “active” servers, as it will otherwise not be covered by the benchmark values.
1. Setup Hosts, Instances and Adapter handlers
The hosts, instances and handlers are created through running a script. You need to run the script file using “cscript” as shown below, and I apologize in advance to the poor error messages you might run into.
1. Open an command prompt window and navigate to [Installation folder]\Artefacts\BizTalk. By default, the installation folder is “C:\Program Files\Blogical\BizTalk Benchmark Wizard”.
2. In the BizTalk folder you’ll find a InstallHosts.vbs file. Execute it using the following parameters:
- Three hosts (BBW_RxHost, BBW_TxHost and BBW_PxHost)
- Three host instances
- One send and one receive adapter handler for the WCF NetTcp adapter.
NTGroupName – The name of the Windows NT group.
UserName – The name of the user account running the service instances.
Password – The password of the user account running the service instances.
Receive Host – The name of the server where you want to run the receive host instance.
Send Host – The name of the server where you want to run the sen host instance.
Processing Host – The name of the server where you want to run the process host instance.
If you have a single box installation, your script command might look like this:
cscript InstallHosts.vbs "BizTalk Application Users" “\MyUser” “MyPassword” “BtsServer1” “BtsServer1” “BtsServer1”
If you have a multi server installation, your script command might look like this:
cscript InstallHosts.vbs "MyDomain\BizTalk Application Users" “MyDomain\MyUser” “MyPassword” “BtsServer1” “BtsServer2” “BtsServer2”
Running this script will create:
2. Import BizTalk MSI
1. Open the BizTalk Administration Console, point to the “Applications” node and import the BizTalk Benchmark Wizard.msi found in the same folder as the scripts above.
This will create a “BizTalk Benchmark Wizard” application along with all ports and orchestrations.
2. Finally, run the BizTalk Benchmark Wizard.msi on all BizTalk servers to add the assemblies to the Global Assembly Cache (GAC).
Done, click [Start]-> [All Programs]->[BizTalk Application Wizard] – [BizTalk Application Wizard] to start the application.