BizTalk Server 2009 Tutorials Before You Begin

Microsoft Corporation Published: September 2009

Summary
Step-by-step instructions for learning how to use BizTalk Server and the BizTalk Server adapters to integrate enterprise applications within your company.

Copyright
Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in examples herein are fictitious. No association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation. Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. 2009 Microsoft Corporation. All rights reserved. Microsoft, BizTalk, Excel, InfoPath, Internet Explorer, SharePoint, Visual SourceSafe, Visual Studio, Windows, Windows Server, and Windows Vista are trademarks of the Microsoft group of companies. SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. All other trademarks are property of their respective owners.

Contents
BizTalk Server 2009 Tutorials Before You Begin..........................................................................1 Summary..................................................................................................................................1 Copyright.........................................................................................................................................2 Contents..........................................................................................................................................3 Before You Begin the Tutorials........................................................................................................4 In This Section.............................................................................................................................4 Step 1: Install BizTalk Server for the Tutorials.................................................................................4 Why must I install and configure BizTalk Server?........................................................................5 How do I install BizTalk Server?..................................................................................................5 Where do I find updated tutorial files?.........................................................................................6 What BizTalk Server components do I need to install?................................................................6 See Also......................................................................................................................................7 Step 2: Configure the BizTalk Hosts as Trusted..............................................................................7 Prerequisites................................................................................................................................8 Procedures..................................................................................................................................8 See Also....................................................................................................................................10 Step 3: Install the Tutorial Files.....................................................................................................10 Prerequisites..............................................................................................................................11 Procedures................................................................................................................................11 See Also....................................................................................................................................12 Step 4: Create a Strong Name Key File........................................................................................12 Prerequisites..............................................................................................................................12 Procedures................................................................................................................................13 See Also....................................................................................................................................13 Step 5: Learn About the BizTalk Server Tools...............................................................................13 Prerequisites..............................................................................................................................14 BizTalk Server Tools..................................................................................................................14 See Also....................................................................................................................................15 Step 6: Print the Tutorials..............................................................................................................16 Prerequisites..............................................................................................................................16 Procedures................................................................................................................................16 See Also....................................................................................................................................16

Before You Begin the Tutorials

Authors Note: An authors note is a means of sharing the experiences of the author. Because the steps in the tutorial focus on procedural information, the authors note provides conceptual information about what is being implemented in a particular step. So, wherever you see any information at the beginning of a step, in italics, preceded by the term Authors Note, thats the author trying to break out from the tutorial flow to share an experience related to the tutorial, or explaining a concept. (Nitin Mehrotra) The Microsoft BizTalk Server tutorials are designed to work on a full BizTalk Server installation on a single computer. A full BizTalk Server installation includes installing Business Activity Monitoring. Caution Do not use a production server to perform the BizTalk Server tutorials. Important The tutorials do not provide instructions for a multicomputer environment. If you are working in a distributed BizTalk Server environment, you must take that into consideration when you perform the steps in the tutorials. This section provides additional information and instructions for configuring your computer for the tutorials. You must complete this section before you begin the BizTalk Server tutorials.

In This Section
Step 1: Install BizTalk Server for the Tutorials Step 2: Configure the BizTalk Hosts as Trusted Step 3: Install the Tutorial Files Step 4: Create a Strong Name Key File Step 5: Learn About the BizTalk Server Tools Step 6: Print the Tutorials

Step 1: Install BizTalk Server for the Tutorials

Authors Note: We recommend that you do a clean installation of BizTalk Server 2009. This helps ensure that you have all required features for the tutorial, so that you dont run into issues later. If 4

your computer already has BizTalk Server installed, you should ideally uninstall it and then install BizTalk Server 2009 on the computer. See the BizTalk Server 2009 Installation and Upgrade Guides (http://go.microsoft.com/fwlink/?LinkId=128383) for instructions on uninstalling BizTalk Server. While uninstalling, make sure that you remove all features and associated footprints from the computer. Otherwise you might encounter errors while configuring BizTalk Server on the computer. For example, if the previous installation of BizTalk Server involved use of a BAM Portal, Internet Information Services (IIS) might continue to have the BAM application and application pool. This might result in an error while configuring BizTalk Server. In summary, use a clean computer so that when you start working with the tutorials, you do not run into prevent issues caused by a faulty BizTalk Server installation or configuration. (Nitin Mehrotra) Time to complete: See the installation instructions for time estimates. Objective: Install BizTalk Server. Purpose: You must install and configure BizTalk Server before you begin the BizTalk Server tutorials. This step provides guidance for installing BizTalk Server for the tutorials. The BizTalk Server tutorials are designed to work on a full BizTalk Server installation on a single computer. In a single computer installation, BizTalk Server and SQL Server are installed on the same computer.

Why must I install and configure BizTalk Server?

The BizTalk Server tutorials are designed to work on a full BizTalk Server installation on a single computer. You must install and configure BizTalk Server and all of its prerequisite software on your computer before you begin the tutorials.

How do I install BizTalk Server?

The following two topics contain information about installing and configuring BizTalk Server on a single computer: Installing BizTalk Server on a Single Server Note Use the installation instructions for the operating system you install. Basic Configuration

Caution Do not use a production server to perform the BizTalk Server tutorials. Important The tutorials do not provide instructions for a multicomputer environment. If you are working in a distributed BizTalk Server environment, you must take that into consideration when you perform the steps in the tutorials. 5

Where do I find updated tutorial files?

You can download the latest version of the files you need to complete the tutorials from http://go.microsoft.com/fwlink/?LinkId=132497. First, follow the instructions in Step 3: Install the Tutorial Files, and then replace the files in <installation drive>:\tutorials with the files from the download. The latest version of the tutorial instructions is available from the latest BizTalk Server 2009 documentation update on MSDN.

What BizTalk Server components do I need to install?

We recommend that you install all of the BizTalk Server features and components on the computer you use to complete the tutorials. The tutorials do not provide assistance for performing the tutorials in a multicomputer environment. If you are working in a distributed BizTalk Server environment, you must take that into consideration when you perform the steps in the tutorials. A full BizTalk Server installation includes installing Business Activity Monitoring. If you choose not to install all of the BizTalk Server features and components, the following table describes the BizTalk Server features required to complete the tutorials.
Tutorial Minimum required BizTalk Server components

Tutorial 1: Enterprise Application Integration

Server Runtime BizTalk EDI/AS2 Runtime Administrative Tools and Monitoring Project Build Component

Enterprise Single Sign-On Master Secret Server Tutorial 2: Purchase Order Process Server Runtime Administrative Tools and Monitoring Project Build Component

Enterprise Single Sign-On Master Secret Server Tutorial 3: Invoice and Payment Process Server Runtime Administrative Tools and Monitoring Project Build Component

Enterprise Single Sign-On Master Secret Server Tutorial 4: Business Activity Monitoring Business Rules Components Server Runtime 6

Tutorial

Minimum required BizTalk Server components

Administrative Tools and Monitoring Project Build Component

Enterprise Single Sign-On Master Secret Server Business Activity Monitoring BAM Alert Provider for SQL Notification Services BAM Client BAM Eventing

See Also
Before You Begin the Tutorials Step 2: Configure the BizTalk Hosts as Trusted Step 3: Install the Tutorial Files Step 4: Create a Strong Name Key File Step 5: Learn About the BizTalk Server Tools Step 6: Print the Tutorials

Step 2: Configure the BizTalk Hosts as Trusted

Time to complete: 10 minutes Objective: In this step, you change the authenticated trusted property for the following hosts: BizTalkServerApplication BizTalkServerIsolatedHost

Purpose: Before you begin the BizTalk Server tutorials, both of the default hosts must be trusted for authentication. In the tutorials, you use a single-computer installation of BizTalk Server to create and deploy BizTalk solutions that contain orchestrations and other BizTalk objects. Because you use the same computer to deploy and host BizTalk solutions, the environment must be trusted. When you install BizTalk Server, by default, the default hosts are not trusted. When you installed and configured BizTalk Server, a host instance for each default host was placed on the computer. A BizTalk Host is a logical set of BizTalk runtime processes. You deploy 7

BizTalk objects such as pipelines and orchestrations into a BizTalk Host. You install an instance of a host onto servers that you use to process, receive, and transmit messages. During a single-computer installation of BizTalk Server, it is typical to use the same user account to configure the default hosts. Because you cannot change the authenticated trusted property for both hosts simultaneously and a user account cannot have mixed privileges (trusted and not trusted), you must delete one of the default host instances or change the account for one of the default host instances before you can change the authenticated trusted property for either of the default hosts. Important The following process is provided for learning purposes only, and does not in any way represent best security practices (not even mediocre security practices). We designed the tutorials to run on a fresh, single-computer, developer installation. If you are using an existing installation, and have services running in the BizTalkServerIsolatedHost host instance, instead of deleting this host instance, change the account the host instance runs as. If the default host instances use different accounts, you can change the authenticated trusted property for them.

Prerequisites
You must install and configure BizTalk Server 2009 before you begin this step. For information about installing BizTalk Server, see Step 1: Install BizTalk Server for the Tutorials.

Procedures
To check whether the hosts are trusted 1. Click Start, point to All Programs, point to Microsoft BizTalk Server 2009, and then click BizTalk Server Administration. 2. In the BizTalk Server Administration console, in the console tree, expand BizTalk Server 2009 Administration, expand BizTalk Group, expand Platform Settings, and then click Hosts. 3. In the Hosts results pane, for the BizTalkServerApplication host and the BizTalkServerIsolatedHost host, if the value in the Trusted column is Yes, the hosts are trusted. If the hosts are not trusted, you must either use a different account for one of the host instances, or delete one of the host instances, before you can change the authentication trusted property. In the following procedure, you delete the BizTalkServerIsolatedHost host instance. To delete the BizTalkServerIsolatedHost host instance 1. In the BizTalk Server Administration console, in the console tree, expand BizTalk 8

Server 2009 Administration, expand BizTalk Group, expand Platform Settings, and then click Host Instances. 2. In the Host Instances results pane, right-click the BizTalkServerIsolatedHost host instance, and then click Delete. 3. Click Yes to confirm the deletion. After you delete one of the host instances, you can change the authenticated trusted property for both hosts. To change the authenticated trusted property for the host 1. In the BizTalk Server Administration console, in the console tree, expand BizTalk Server 2009 Administration, expand BizTalk Group, expand Platform Settings, and then click Hosts. 2. In the Hosts results pane, right-click the host that is not trusted, and then click Properties. 3. In the <host name> - Host Properties dialog box, on the General tab, select the Authentication Trusted check box, and then click OK. 4. Verify that the Trusted column of the host shows the value Yes. 5. Repeat steps 2 through 4 for the second default host. Now that both hosts are trusted, you can create a new host instance for the BizTalkServerIsolatedHost host. To create a new host instance for the BizTalkServerIsolatedHost host 1. In the BizTalk Server Administration console, in the console tree, expand BizTalk Server 2009 Administration, expand BizTalk Group, expand Platform Settings, rightclick Host Instances, point to New, and then click Host Instance. 2. In the BizTalkServerIsolatedHost - Host Instance Properties dialog box, from the Host name drop-down list, select the host for which you deleted the host instance, and then click Configure. 3. In the Logon Credentials dialog box, do the following:

Use this

To do this

Logon

Type the user account name you want to use for the host instance. Note If you use a domain account for the host instance, type the name in the format domain\user name.

Password Note

Type the password for the account.

If the account you use has administrative privileges, in the warning box, click OK to indicate that you want to use the account. 4. Click OK to close the Logon Credentials dialog box. 5. Click OK to close the BizTalkServerIsolatedHost - Host Instance Properties dialog box.

See Also
Before You Begin the Tutorials Step 1: Install BizTalk Server for the Tutorials Step 3: Install the Tutorial Files Step 4: Create a Strong Name Key File Step 5: Learn About the BizTalk Server Tools Step 6: Print the Tutorials

Step 3: Install the Tutorial Files

Time to complete: 8 minutes Objective: In this step, you install the tutorial files in C:\tutorial. Purpose: The BizTalk Server tutorials provide instructions that assume that you can access the tutorial files in C:\tutorial. This preserves the original tutorial files in drive:\Program Files\Microsoft BizTalk Server 2009\SDK\Tutorial, so that you can repeat the tutorials if you want.

10

Prerequisites
You must install and configure BizTalk Server before you install the tutorial files. For information about installing BizTalk Server 2009, see Step 1: Install BizTalk Server for the Tutorials.

Procedures
To install the necessary tutorial files 1. Click Start, and then click Run. 2. In the Run dialog box, in the Open box, type cmd, and then click OK. 3. At the command prompt, type cd drive:\Program Files\Microsoft BizTalk Server 2009\SDK\Tutorial, and then press ENTER. 4. At the command prompt, type unpack, and then press ENTER. 5. At the command prompt, type exit, and then press ENTER. The tutorial files are now located in the C:\tutorial folder. Note The tutorial files shipped with BizTalk Server are read-only. To complete the tutorials successfully, you must clear the Read-only value of the Attribute property for each file you will use to complete the tutorials. You must perform the following procedure for each of the following files: C:\tutorial\Solutions\B2BSolution\B2BOrchestrations_webservice\App_Code\B2BOrchestratio ns_B2BProcess_Receive_ASN_Port.asmx.cs C:\tutorial\Solutions\B2BSolution\B2BOrchestrations_webservice\App_Code\B2BOrchestratio ns_B2BProcess_ReceiveInvoice_Port.asmx.cs C:\tutorial\Solutions\Schemas\PO.xsd C:\tutorial\Solutions\Schemas\AdvancedShipNotice.xsd C:\tutorial\Solutions\Schemas\CommonBaseTypes.xsd C:\tutorial\Solutions\Schemas\CommonInvoice.xsd C:\tutorial\Solutions\Schemas\InvoiceToPayment.btm 11 C:\tutorial\POInstance.xml C:\tutorial\RepRequestAccepted.xml C:\tutorial\RepRequestDenied.xml C:\tutorial\Solutions\SetInstallPathEnv.vbs C:\tutorial\Solutions\B2BSolution\SetupWebService.bat

C:\tutorial\Solutions\Schemas\MapToCommonPO.btm C:\tutorial\Solutions\SupplierWebServices\Setup.bat

To update the file attribute property 1. For each file listed above, in Windows Explorer, navigate to the folder that contains the file. 2. Right-click the file name, and then click Properties. 3. In the Properties dialog box, in the Attribute section clear the Read-only check box, and then click OK.

See Also
Before You Begin the Tutorials Step 1: Install BizTalk Server for the Tutorials Step 2: Configure the BizTalk Hosts as Trusted Step 4: Create a Strong Name Key File Step 5: Learn About the BizTalk Server Tools Step 6: Print the Tutorials

Step 4: Create a Strong Name Key File

Time to complete: 2 minutes Objective: In this step, you create a strong name key file for the tutorials. Purpose: You must create a strong name key file to build projects in Microsoft Visual Studio. A strong name consists of the project's identity its simple text name, version number, and culture information (if provided) plus a public key and a digital signature. The strong name key file contains the public key and the private key. Important You must create one strong name key file, one time before starting any of the tutorials.

Prerequisites
You must install the tutorial files before you begin this step. For instructions, see Step 3: Install the Tutorial Files.

12

Procedures
To create a strong name key file 1. Click Start, point to All Programs, point to Microsoft Visual Studio 2008, point to Visual Studio Tools, and then click Visual Studio 2008 Command Prompt. 2. At the command prompt, type cd C:\tutorial and press ENTER. 3. At the command prompt, type sn -k Tutorial.snk, and then press ENTER. Note You should receive a message at the command prompt stating that the key pair was written to Tutorial.snk. 4. At the command prompt, type exit, and then press ENTER.

See Also
Before You Begin the Tutorials Step 1: Install BizTalk Server for the Tutorials Step 2: Configure the BizTalk Hosts as Trusted Step 3: Install the Tutorial Files Step 5: Learn About the BizTalk Server Tools Step 6: Print the Tutorials

Step 5: Learn About the BizTalk Server Tools

Objective: This step provides information about the BizTalk Server tools used in the tutorials. Purpose: The BizTalk Server tutorials provide a guided introduction to a number of BizTalk Server tools. You may want to learn more about these tools. The following table shows the BizTalk Server tools you use to complete each of the tutorials: Tutorial 1: Enterprise Application Integration Tutorial 2: Purchase Order Process Tutorial 3: Invoice and Payment Process Tutorial 4: Business Activity Monitoring
Tutorial 1 Tutorial 2 Tutorial 3 Tutorial 4

Tools/Tutorial

Visual Studio

X 13

Tools/Tutorial

Tutorial 1

Tutorial 2

Tutorial 3

Tutorial 4

BizTalk Editor (schema editor) Orchestration Designer BizTalk Mapper Pipeline Designer BizTalk Server Administration console Business Rule Composer Tracking Profile Editor Web Services Business Activity Monitoring (BAM) Add-In for Excel BAM portal BAM Management and Deployment utilities

X X X X X X X X

X X

X X X X

X X

Prerequisites
You must install BizTalk Server before you can access the BizTalk Server tools.

BizTalk Server Tools

The following table provides you with a list of top-level topics that explain how to use each of the listed tools.
Tool Links

Visual Studio

Using Visual Studio Working with BizTalk Projects

Deploying BizTalk Assemblies from Visual Studio into a BizTalk Application 14

Tool

Links

Learn more about Visual Studio: Introduction to Solutions, Projects, and Items (http://go.microsoft.com/fwlink/? LinkId=58503) Solution Explorer Concepts (http://go.microsoft.com/fwlink/? LinkId=58504) BizTalk Editor (schema editor) Orchestration Designer BizTalk Mapper Pipeline Designer BizTalk Server Administration console Business Rule Composer Tracking Profile Editor Web Services Business Activity Monitoring (BAM) Add-In for Excel BAM portal BAM Management and Deployment utilities Creating Schemas Using BizTalk Editor

Creating Orchestrations Using Orchestration Designer Creating Maps Using BizTalk Mapper

Creating Pipelines Using Pipeline Designer Using the BizTalk Server Administration Console Creating Business Rules Using Business Rules Editor Tracking Profile Editor Using Web Services Monitoring Business Activities with BAM BAM Portal Managing BAM

See Also
Before You Begin the Tutorials Step 1: Install BizTalk Server for the Tutorials Step 2: Configure the BizTalk Hosts as Trusted Step 3: Install the Tutorial Files Step 4: Create a Strong Name Key File Step 6: Print the Tutorials

15

Step 6: Print the Tutorials

Time to complete: 4 minutes Objective: In this step, you download a copy of the tutorials that you can print. Purpose: For your convenience, we have provided copies of the BizTalk Server tutorials in Microsoft Office Word format that you can download and print.

Prerequisites
You must have access to the Internet, and have software installed that can open Microsoft Office Word files.

Procedures
To download printable copies of the tutorials 1. In Internet Explorer, navigate to http://go.microsoft.com/fwlink/?LinkId=132497. 2. Follow the instructions to download the BizTalk Server tutorial files page.

See Also
Before You Begin the Tutorials Step 1: Install BizTalk Server for the Tutorials Step 2: Configure the BizTalk Hosts as Trusted Step 3: Install the Tutorial Files Step 4: Create a Strong Name Key File Step 5: Learn About the BizTalk Server Tools

16