Microsoft BizTalk Server 2002 Service Pack 1 Documentation

This document contains installation instructions and information about Microsoft® BizTalk® Server 2002 Service Pack 1 (SP1). The latest version of this document is available on the BizTalk Server 2002 Service Pack 1 documentation site.

Important   It is strongly recommended that you read this entire document before you install Service Pack 1.

This document provides information about the following:

Before You Install Service Pack 1

Note the following requirements:

Important   Service Pack 1 setup requires the original BizTalk Server 2002 installation source (Microsoft BizTalk Server.msi) to be available.

Platform Recommendations

You must have BizTalk Server 2002 installed before installing Service Pack 1. This section contains information about the operating systems supported by BizTalk Server 2002 SP1.

Optional Software

Supported Platforms

The following platforms are supported for BizTalk Server 2002 SP1:

Microsoft Windows 2000

This section contains information about using BizTalk Server 2002 SP1 on Windows 2000.

Software Requirements

The following software must be installed before installing BizTalk Server 2002 SP1 on Windows 2000:

Windows 2000 Configuration

To enable the use of the certificate revocation list (CRL) with BizTalk Server 2002 SP1 on Windows 2000 or Windows XP, you need to apply a Windows hotfix referred to in Microsoft Knowledge Base article 329433. To obtain this hotfix, contact Microsoft Product Support, as listed in the About Product Support section in this document. After the hotfix is applied, BizTalk Server SP1 can verify that a certificate is valid and has not been revoked by the certificate issuer.

The registry key used to enable or disable CRL checking is:

Key name Type Location
PerformCRLChecking REG_DWORD HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTSSvc

A value of 1 indicates that CRL checking is enabled, and a value of 0 indicates that CRL checking is disabled. If this registry key does not exist on a computer with SP1 installed, CRL checking is enabled by default.

Microsoft Windows XP

This section contains information about using BizTalk Server 2002 SP1 on Windows XP.

Note   BizTalk Server 2002 SP1 should only be installed on Windows XP as a tools installation for development purposes.

Software Requirements

The following software must be installed before installing BizTalk Server 2002 SP1 on Windows XP:

Microsoft Windows Server 2003

This section contains information about using BizTalk Server 2002 SP1 on Windows Server 2003.

Software Requirements

The following software must be installed before installing BizTalk Server 2002 SP1 on Windows Server 2003:

Windows Server 2003 Configuration

Before installing BizTalk Server 2002 SP1 on Windows Server 2003, ensure that the following tasks are completed:

SQL Server Tasks

On Windows Server 2003, additional configuration is necessary to enable BizTalk Server 2002 to work in configurations where SQL Server is installed on a different computer. This scenario requires you to enable network Distributed Transaction Coordinator (DTC) access on both servers. For information about enabling network DTC, see Microsoft Knowledge Base article 817064.

Internet Information Services (IIS) 6.0 Tasks

This section includes information about configuring IIS for BizTalk Server 2002 HTTP receive functions on Windows Server 2003.

Note   The HTTP receive functions support running either in native IIS 6.0 mode or in IIS 5.0 isolation mode.

To configure IIS 6.0

  1. Install Internet Information Services (IIS) 6.0 on the computer. If you will use the SMTP transport, verify that the SMTP Service is installed and running.
  2. Open the IIS Manager and either create a new application pool for BizTalk Server or modify the default application pool settings if appropriate for your system, as shown in the following procedure:
    1. Click the application pool to be modified.
    2. On the Action menu, click Properties.
    3. Click the Identity tab.
    4. In the Application pool identity area, select Configurable.
    5. Click the Browse button to select a user or user group that is a domain account, and then click OK.

      Note   The selected user must belong to the IIS Worker Process Group (IIS_WPG).

    6. Restart the application pool.

    For more information about configuring application pools, see IIS Help.

  3. In the IIS Manager, click Web Service Extensions. Update these settings as follows:
    1. Select WebDAV and then click Allow.
    2. Select Active Server Pages and then click Allow.
    3. Select All Unknown ISAPI Extensions and then click Allow.
    4. Allow other Web Service Extensions as required for your system.

Windows Components Tasks

Perform the following tasks to run BizTalk Server 2002 SP1 on Windows Server 2003:

To install Message Queuing

  1. On the Start menu, point to Control Panel, and then click Add or Remove Programs.
  2. On the Add or Remove Programs screen, click Add/Remove Windows Components.
  3. On the Windows Components Wizard page, select Application Server and then click Details.
  4. In the Application Server dialog box, select Message Queuing and then click OK.
  5. On the Windows Components Wizard page, click Next.
  6. When the wizard completes, click Finish.

To configure Internet Explorer

  1. On the Start menu, point to Control Panel, and then click Add or Remove Programs.
  2. On the Add or Remove Programs screen, click Add/Remove Windows Components.
  3. On the Windows Components Wizard page, clear Internet Explorer Enhanced Security Configuration and then click Next.
  4. When the wizard completes, click Finish.

XLANG Tasks

This section includes information about XLANG tasks that should be performed on Windows 2003.

XLANG group managers

If you need to create additional XLANG group managers for your deployment of BizTalk Server 2002 on Windows Server 2003, note that the COM+ application settings may need to be changed. COM+ applications enforce role-based security access by default in Windows Server 2003. Therefore, any new COM+ applications need to either disable role-based security (not recommended), or roles need to be assigned to the application. To update the COM+ settings for new COM+ group manager applications, use the following procedure:

To update the XLANG group manager settings

  1. On the Start menu, point to Administrative Tools, and then click Component Services.
  2. In the console tree, expand Component Services, expand Computers, expand My Computer, and then expand COM+ Applications.
  3. Click the newly created XLANG group manager application.
  4. On the Action menu, click Properties.
  5. Click the Advanced tab, clear the Disable changes check box, and then click OK.
  6. Expand the newly created XLANG group manager application.

    Note   The default group manager name is XLANG Scheduler.

  7. Click the Roles folder under the group manager application.
  8. On the Action menu, point to New, and then click Role.
  9. In the Role dialog box, enter XLANG Schedule Creator, and then click OK.
  10. Repeat steps 8 and 9 to create the following roles:

    For additional information about these role definitions, see the section titled "Security for Applications That Host XLANG Schedule Instances" in BizTalk Server 2002 Help.

  11. Expand the XLANG Schedule Creator role, and then click the Users folder.
  12. On the Action menu, point to New, and then click User.
  13. In the Select Users or Groups dialog box, add the list of authorized users and/or groups of users for this role, and then click OK.
  14. Repeat steps 11 through 13 for each role created for the new XLANG group manager application.
  15. Restart the new group manager application.

XLANG pooling

The maximum number of threads that can be created by a process on Windows Server 2003 is 500. Therefore, the number of running XLANG schedule instances at any given time should be significantly less than 500 to ensure that this limit is not exceeded. If the limit is reached, then no more threads will be spawned. This condition may cause the XLANG Scheduler process to stop responding, which affects the running XLANG schedules.

To prevent this, you should associate your XLANG schedules with XLANG schedule pools to limit the number of executing schedule instances. The maximum pool size you should set for your XLANG schedules varies based on a number of factors, including the complexity and components of your XLANG schedules. XLANG schedule pool sizes should be tested on your installation of BizTalk Server 2002 to determine the proper configuration for your environment prior to deploying it into a production environment. For more information, see "Pooling XLANG Schedules" in BizTalk Server 2002 Help.

Running Samples on Windows Server 2003

Some of the samples shipped with the BizTalk Server 2002 Software Development Kit (SDK) use the Microsoft Visual Basic® MsgBox function to display dialog boxes to the user. Under some conditions, executing this function in a multithreaded environment, such as COM+, may cause the program to stop responding. The samples in the SDK identified with this potential problem include:

Sample name Path
Self-Routing \Program Files\Microsoft BizTalk Server\SDK\Messaging Samples\Self-Routing
While Shape \Program Files\Microsoft BizTalk Server\SDK\XLANG Samples\Loop
XLANG Schedule Pooling \Program Files\Microsoft BizTalk Server\SDK\XLANG Samples\Schedule Throttling

To fix this problem, download the latest Visual Basic 6.0 Service Pack update from the Product Updates for Microsoft Visual Basic site.

Installing Service Pack 1

The files for Service Pack 1 are packaged into a single executable file, BTS2002-SP1-<language>.exe, for example, BTS2002-SP1-ENU.exe. When you open this file, the Service Pack 1 setup files are extracted to a temporary folder, and the Setup.exe file is run automatically.

Note   During installation, Service Pack 1 requires that you have access to the original installation source of BizTalk Server 2002 (CD or network share).

If you need to run a silent installation, you must save the executable file when downloading it, and then extract the files to a folder. The Service Pack 1 executable contains the following files:

If your installation is canceled or stopped for any reason, you can begin the installation again by double-clicking the Setup.exe file. If you encounter a problem during installation and no error message appears, review the log file, Setup.log. A link is provided to this file on the last page of the Microsoft BizTalk Server 2002 SP1 installation wizard.

Note   After the SP1 installation completes successfully, an error may be written to the Application section of the Event Viewer as follows:

Installing the performance counter strings for BTSSvc failed. The Error code is DWORD 0 of the Record Data.

No action is required for this error during installation.

See Also

Command-Line Operations Instructions
Service Pack Security Updates
Known Issues in Service Pack 1

Command-Line Operations Instructions

You can also install Service Pack 1 by using command-line switches. After you have saved the Service Pack 1 executable to your hard disk and extracted the files to a folder, you can run any of the Service Pack 1 command-line switches from a command prompt. Command-line switches are provided for users who want to use scripting to install Service Pack 1 on multiple servers.

To use command-line switches to install Service Pack 1

See Also

Installing Service Pack 1

Service Pack 1 Fixes

Service Pack Security Updates

Service Pack 1 Fixes

This section contains information about the following fix issued in Service Pack 1:

Reliable Messaging Receipt Format Changes

<prop:identity xmlns:prop="http://schemas.biztalk.org/btf-2-0/properties">

The identity element generated in SP1 is declared by using the receipt namespace:

<rcpt:identity xmlns:prop="http://schemas.biztalk.org/btf-2-0/properties">
Important   This change may result in compatibility issues when exchanging receipts between two BizTalk Server systems if SP1 is not present on both systems. Individual hotfixes addressing this problem are available for BizTalk Server 2000 and BizTalk Server 2002. These hotfixes can be applied to systems experiencing this problem that have not yet upgraded to Service Pack 1. For more information about this issue, see Microsoft Knowledge Base article 811092.

If necessary, you can disable this feature on your server by modifying the following registry key:

Key name Type Location
UseFixedReceiptFormat REG_DWORD HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTSSvc

A value of 1 indicates that the new receipt format (<rcpt:identity…>) is generated, and a value of 0 indicates that the original receipt format (<prop:identity…>) is generated. If this registry key does not exist on a computer with SP1 installed, the new receipt format is generated by default.

Service Pack Security Issues

A default installation of BizTalk Server 2002 creates several IIS virtual directories to facilitate functionality for the BizTalk Server tools used at design time. Two of the IIS virtual directories created by a complete installation of Microsoft BizTalk Server are vulnerable to attack if these virtual directories are published in a nonsecure environment, and should be secured as described below. These folders and settings are listed in the following sections.

Documentation folder

The http://<servername>/BizTalkServerDocs/ Web site contains the BizTalk Server documentation files and is configured as follows:

XML schema repository

The http://<servername>/BizTalkServerRepository/ Web site houses the BizTalk Server Web Distributed Authoring and Versioning (WebDAV) repository and is configured as follows:

Recommendation

Configure NTFS permissions for the underlying file structures for these virtual directories to permit only those accounts that need access to the BizTalk Server documentation and/or the BizTalk Server WebDAV repository.

Note   BizTalk Server running in a production environment does not need write access to the BizTalkServerRepository virtual directory or any access to the BizTalkServerDocs virtual directory. Write access to the BizTalkServerRepository virtual directory and read access to the BizTalkServerDocs virtual directory is only necessary for development purposes. The SQL Server computer that contains the BizTalk Server InterchangeBTM database does need read access to the BizTalkServerRepository virtual directory for production purposes.

Security Updates

For information about the security updates included with Service Pack 1, see Microsoft Knowledge Base article 824862.

Uninstalling Service Pack 1

Use the Add or Remove Programs utility in Control Panel to uninstall BizTalk Server 2002 SP1.

Important   Before you uninstall Service Pack 1, back up all BizTalk Server 2002 databases. As with any update of your system, this step is a recommended operations procedure.

Restoring the Databases

After removing Service Pack 1, you need to restore the SQL Server databases to their pre-SP1 state. This will remove any SQL Server changes done by previous QFEs before installing BizTalk Server 2002 SP1. Therefore, you will need to reapply any necessary QFE SQL scripts after removing BizTalk Server 2002 SP1.

To restore the BizTalk Server databases

Restoring the btstrace.dll File

After uninstalling Service Pack 1, you should use the following procedure to restore btstrace.dll to its original state:

To restore btstrace.dll

  1. Browse to \Program Files\Microsoft BizTalk Server\ on the installation drive.
  2. Copy the file btstrace.dll.
  3. Browse to \Program Files\Microsoft BizTalk Server\XLANG Scheduler\ on the installation drive.
  4. Paste the file.
  5. In the Confirm File Replace dialog box, click Yes.

Known Issues in Service Pack 1

This section contains information about the following known issue:

For additional information about known issues and specific fixes, see Microsoft Knowledge Base article 824863.

S/MIME Encrypted and Signed BTF Messages

Important   When submitting S/MIME encrypted or signed BizTalk Framework (BTF) messages to BizTalk Server 2002 SP1, data loss may occur due to an incorrectly registered Collaboration Data Objects (CDO) library file. Follow the steps outlined below to ensure that the DLL is correctly registered.

To register the CDO System Library (cdosys.dll)

  1. On the Start menu, open a Command Prompt window.
  2. In the Command Prompt window, type the following:

    For Windows 2000:

    regsvr32 "\WINNT\System32\CDOSYS.dll"

    For Windows XP or Windows Server 2003:

    regsvr32 "\WINDOWS\System32\CDOSYS.dll"

Additional Information

For more information about BizTalk Server 2002, see:

About Product Support

If you have technical questions about Service Pack 1 that are not answered in this document or in the Microsoft Knowledge Base articles, Microsoft offers technical support and services ranging from free, to pay-per-incident, to annual support plans. Some of these plans may be available 24 hours a day, seven days a week. Microsoft offers the following support:

______________________________________________

Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious, and 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.

© 1996-2003 Microsoft Corporation. All rights reserved.

Microsoft, MS-DOS, Windows, Windows NT, Windows Server, BizTalk, MSDN, Visio, and Visual Basic are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

The names of actual companies and products mentioned herein may be the trademarks of their respective owners.