See the following sections for known issues in this Beta release of Microsoft BizTalk Server 2006:
Upgrade Issues
Upgrading the BizTalk Server 2004 BAS Portal to BizTalk Server 2006 Beta 2
You must first install the BizTalk Server 2004 Administration tools on your Business Activity Services (BAS) computer before you upgrade the BAS portal to BizTalk Server 2006. If you don't do this, the upgrade may fail.
Backup and restore functions do not restore the adm_otherdatabases table correctly
Problem: When you restore a database, the restore operation does not correctly update the list of databases and servers referred to by the upgrade process.
The adm_otherdatabases table in the BizTalk Management database contains the names of the servers and databases in the BizTalk group. It is used specifically to locate other databases when you upgrade or patch your system. So an upgrade from BizTalk Server 2004 or beta versions of BizTalk Server 2006 may fail if in the past you restored the BizTalk group from a backup version.
This problem occurs in the following upgrade paths:
-
BizTalk Server 2004 Service Pack 1 (SP1) to BizTalk Server 2006 Beta 1
-
BizTalk Server 2004 SP1 to BizTalk Server 2006 Beta 2
-
BizTalk Server 2004 SP1 to BizTalk Server 2006
-
BizTalk Server 2006 Beta 2 to BizTalk Server 2006 (general released version)
Solution: After you restore a database, ensure that the server and database names are correct in the adm_otherdatabases table in the BizTalk Management database. You can manually correct the names of the servers and databases in the adm_otherdatabases table if necessary.
Preparing your MSI files and resources for upgrade
For additional information about upgrading from the Microsoft BizTalk Server 2006 Beta 1 version to the Beta 2 version, see the
The following constraints exist for using MSI files built in the Beta 1 version in BizTalk Server 2006 Beta 2:
-
In the Beta 2 version, you cannot install any MSI files that were created in Beta 1. However, you can import these MSI files.
-
In the Beta 2 version, you cannot uninstall any MSI file that you installed in Beta 1.
To ensure that you can work with your MSI files after you upgrade, we recommend that you perform the following steps before upgrading:
-
Ensure you have back-up copies of your resources.
-
Open the BizTalk Administration console, and identify any applications that have resources of type preprocessingscript or postprocessingscript or file.
-
Delete those resources, and then add them back to the application. The resources should have been installed to the hard disk when you set up the application, so you can add them from there.
-
Uninstall all the BizTalk Server applications that were installed. Although you are uninstalling the applications from the hard drive, they will not be deleted from the BizTalk Management database.
-
Now upgrade to the Beta 2 version. This will upgrade the BizTalk Management database.
-
Export all your applications to MSI files.
-
Install all of the MSI files that you exported in step 6. Your BizTalk Server application is now usable.
After upgrading from Beta 1 to Beta 2
After you upgrade from the Beta 1 version to Beta 2, perform the following steps to ensure that all of your Beta 1 functionality has been preserved.
Step 1: Upgrade Your Analysis Services Database
If your Analysis Services database is configured, you must run AnalysisDB_Upgrade.vbs on the runtime computer to upgrade the Analysis Services database. To do this, perform the following steps:
-
Insert the Microsoft BizTalk Server 2006 installation disk into the CD-ROM drive.
-
Browse to the \MSI\Upgrade folder on the CD.
-
Copy the file AnalysisDB_Upgrade.vbs to the local BizTalk server.
-
Open a command prompt and type the following:
AnalysisDB_Upgrade.vbs <anaysis_server_name> <analysis_database_name>
Note: |
---|
In a multi-server environment, it is recommend that you run this script after you upgrade the first runtime computer and prior to any other upgrades. |
Step 2: Undeploy your tracking profiles
After upgrading from the Beta 1 version to Beta 2, you must undeploy your tracking profiles and then redeploy them. Otherwise, you will get the following error message:
Guid should contain 32 digits with 4 dashes |
Step 3: Fix your BAM Alerts
After you upgrade from the Beta1 version to Beta 2, Business Activity Monitoring (BAM) alerts will fail with the following error:
An extended stored procedure did not connect with the data source object (DSO) using the supplied connection string. |
To avoid this, do the following:
-
After upgrading from the Beta 1 version to Beta 2, run the Notification Services Command prompt from Configuration Tools under the Microsoft SQL Server program group.
-
Change your folder to Program Files\Microsoft BizTalk Server 2006\Tracking.
-
Get the configuration file, using the following script:
cscript ProcessBamNSFiles.vbs -Get config.xml adf.xml machineName BAMPrimaryImport
-
Modify the ADF file (adf.xml):
-
Search for <ActionTimeout>.
-
Modify the value from P1DT00H00M00S to P0DT00H30M00S.
-
Search for <ActionTimeout>.
-
Update the configuration file using the following command:
cscript ProcessBamNSFiles.vbs -Update config.xml adf.xml machineName BAMPrimaryImport
Step 4: Create bindings
If, in BizTalk Server 2006 Beta 1, you created bindings files that use one-way send ports with message body tracking enabled, and you exported these bindings. You cannot, however, import them into the Beta 2 version.
To solve this problem, after you upgrade your Beta 1 computer to Beta 2, create any necessary bindings. Or, before you export the bindings, turn off tracking and then enable it again after you have imported them.
Step 5: Change your BTSTask script names
The names of the BTSTask commands and parameters changed between the Beta 1 version and Beta 2. The following table shows the Beta 1 name and the corresponding Beta 2 name.
Beta 1 Name |
Beta 2 Name |
Description |
GacNow |
GacOnAdd |
Add assembly to the global assembly cache (GAC) during AddResource |
UpdateGacOnImport |
GacOnImport |
Add assembly to GAC during Import MSI file |
GacUtil |
GacOnInstall |
Add assembly to GAC during MSI file installation |
Regasm |
RegasmOnInstall |
regasm during MSI file installation |
RegSvcs |
RegSvcsOnInstall |
regsvcs during MSI file installation |
RegSvr32 |
RegSvr32OnInstall |
regsvr32 during MSI file installation |
You must change all of your BTSTask scripts to use the new names.
For example, if you had the following script:
BTSTask.exe AddResource -ApplicationName:MyApp -Type:System.BizTalk:BizTalkAssembly -Source:C:\MyApp\Orchestrations.dll -Destination:C:\install\Orchestrations.dll -Options:”GacNow,GacUtil” |
You would change it to this:
BTSTask.exe AddResource -ApplicationName:MyApp -Type:System.BizTalk:BizTalkAssembly -Source:C:\MyApp\Orchestrations.dll -Destination:C:\install\Orchestrations.dll -Options:”GacOnAdd,GacOnInstall” |
Installation and Configuration Issues
Install SQL Server Client Tools before installing BizTalk Server 2006 Beta 2
You must install Microsoft SQL Server Client Tools before installing BizTalk Server. If BizTalk Server Beta 2 is already installed, you must remove Microsoft Office Web Components (OWC) before installing SQL Server Client Tools.
Do not use Unicode characters in the installation path for BizTalk Server 2006
Base EDI Adapter multiserver deployments require that SQL Server components reside on the same computer
For multicomputer deployments of the Base EDI adapter, where SQL Server 2005 is on a different computer than the BizTalk Server 2006 runtime, you must install one of the following in the runtime environment:
-
SQL Server 2005 Database Services.
-
SQL Server Management Studio or SQL Server 2005 Database Services: Install one of these on the runtime server, but only if you have a multicomputer deployment using SQL Server 2005.
-
Client connectivity component of SQL client tools: This is required for all deployments, whether SQL Server 2000 or SQL Server 2005.
Base EDI Adapter configuration fails if you use a local non-administrative account for the EDI subsystem service
Problem: You cannot configure the Base EDI Adapter if you are using a local non-administrative account for the EDI subsystem. The EDI subsystem service fails to start.
Solution: Add the local service account that you want to use for the Base EDI Adapter subsystem to the BizTalk Server Administrators group that is created during group configuration. After you do this, the EDI subsystem service starts normally.
Grant permissions to Notification Services for BAM Alerts
After configuring alerts on SQL Server 2005, you must execute the following command on the BAM Alerts Application database to grant appropriate privileges to the Notification Services user:
GRANT SELECT ON [dbo].[bam_Metadata_AlertInstance] TO NSRunService |
Otherwise, the BAM instance alert will not work.
Other Known Issues
Creating a Web site using the Web Services Publishing Wizard requires ASP.NET 2.0
Problem: If you have both Microsoft .NET Framework version 1.1 and version 2.0 installed on your computer, you will get the following error message when you use the Web Services Publishing Wizard to create a virtual root (vroot folder):
Configuration Error Description: An error occurred during the processing of a configuration file required to service this request. Please review the specific error details below and modify your configuration file appropriately. |
This error occurs because the Web Services Publishing Wizard creates a virtual root and configures the web.config file to use ASP.NET version 2.0. To browse an .asmx file, ASP.NET must use version 2.0, rather than version 1.1.
If your Web site is configured to use ASP.NET version 2.0, you can create and browse the individual virtual root. However, if it is configured to use ASP.NET version 1.1, an error results.
Solution: When you publish an orchestration as a Web service to the Web site, ensure that the Web site you are publishing to is using ASP.NET version 2.0 and not version 1.1. You can do this even after you have published an orchestration.
To change your configuration to use ASP.NET version 2.0:
-
In the Run box, type inetmgr.
-
Navigate to the Web site, and right-click Properties.
-
Click the ASP.NET tab.
-
In the ASP.NET version box, select the 2.0 version, and then click OK.
A COM hotfix causes problems on 64-bit computers
Problem: If you have installed the COM+ hotfix,
The ServicedComponent being invoked is not correctly configured Use regsvcs to re-register). |
After getting this error, if you try to restart the COM+ system application service from the Service Control manager, it fails.
Solution: Perform the following steps to reinstall COM+ components:
-
From the Start menu, click Control Panel, double-click Add or Remove Programs, and then click Add/Remove Windows Components.
-
In the Windows Component Wizard, highlight Application Server, and then click Details.
-
Verify that Enable network COM+ access is selected, click OK, and then click Next.
-
Click Finish to close the Windows Components Wizard.
-
Restart the COM+ System Application service, and restart the BizTalk services using the Service Control Manager.
Note: |
---|
Contact Microsoft Customer Support to get an updated COM+ rollup package to fix this problem. |
Base EDI Adapter has a memory leak
Problem: The Base EDI Adapter service process esp_srv.exe continues to grow in memory size even if the adapter is not processing any documents. For example, when you monitor the process in Performance Monitor, you may see an increase of approximately 12288 bytes every 8 to 12 seconds. This memory leak is bigger when a non-existent path is specified for the EDI pickup location in the EDI receive handler.
Solution: Periodically restart the Base EDI Adapter service. If the Base EDI Adapter service is not actively being used, stop the service, and set it to Manual so that the service does not start up automatically upon a reboot.
Debugging doesn't work in Workgroup mode with SQL Server 2000
Problem: You cannot debug an orchestration. After setting a breakpoint in an orchestration, when you try to "Attach" to the orchestration in the orchestration debugger, you get the following error: No such Host is found.
This problem only occurs in the following scenario: You are using Microsoft SQL Server 2000 to host your BizTalk Tracking database, and your BizTalk Server is in a Workgroup mode.
Solution: Either add your server to a Microsoft Active Directory domain, or use SQL Server 2005 instead of SQL Server 2000.
MOM 2005 SP1 does not support SQL Server 2005
Problem: Microsoft Operations Manager (MOM) 2005 Service Pack 1 (SP1) currently does not support SQL Server 2005.
Solution: If you plan to deploy the BizTalk Management Pack for BizTalk Server 2006, use SQL Server 2000 for your MOM databases. For more information, see the
MSI file installation fails on Microsoft Windows Server 2000 when the MSI file contains a virtual directory
Importing an MSI file locks the database and blocks runtime
When you import an application, if the MSI file contains BAS resources, a dialog box appears. While the dialog box is present, the database is locked and runtime is blocked.
Do not start an import process and then leave your console unattended.
Using BizTalk Server 2006 SDK samples
This Beta 2 release includes the following new SDK samples:
-
Error Handling
-
Composed Message Processor
-
Aggregator
-
OperationsOM
To use these samples, follow the instructions in the "Samples" documentation found in the "Developing" node of BizTalk Server 2006 Help. The instructions are accurate.
The documentation for all other SDK samples, however, is incorrect. If you try to run the samples using the documentation, the samples will not work.
The following SDK sample does not work with the Beta 2 release:
-
HTTP.NET Adapter SDK Sample
Cannot start HWS Server Administration
Problem:If you start the Human Workflow Services (HWS) Server Administration after you have configured the Human Workflow Services (HWS) Runtime and HWS Web services, you may get the following error:
The selected server does not exist or does not have a valid Human Workflow Services installation. |
Solution: Restart the WMI service in services.msc.
DTC access must be enabled
Problem: By default, network Distributed Transaction Coordinator (DTC) access is disabled on Microsoft Windows Server 2003 and Windows XP with SP2.
Solution: Before configuring Beta 2, you must enable DTC access on the computer.
When you make the following changes, ensure that all servers in your environment have compatible settings. For example, if you configure your BizTalk server to No Authentication Required because it is running on a Windows Server 2003 server without SP1, you must make sure that your SQL Server computer is also set to No Authentication Required, even if it is running under Windows Server 2003 with SP1.
To enable DTC access for Windows Server 2003 with SP1 or Windows XP with SP2, do the following:
-
From the Start menu, click Control Panel, double-click Administrative Tools, and then double-click Component Services.
-
Expand Component Services, and then expand Computers.
-
Right-click the computer you need to set, and then select Properties.
-
In the Properties window, select the MSDTC tab.
-
In the Transaction Configuration area, click Security Configuration.
-
In the Security Settings area, select the Network DTC Access check box.
-
In the Transaction Manager Communication area, select the Allow Inbound and the Allow Outbound check boxes.
-
Click OK to close each open dialog box.
-
Restart your computer to enable the remote DTC option.
To enable DTC access for Windows Server 2003 without SP1, do the following:
-
From the Start menu, double-click Control Panel, double-click Administrative Tools, and then double-click Component Services.
-
Expand Component Services, and then expand Computers.
-
Right-click the computer you need to set, and then select Properties.
-
In the Properties window, select the MSDTC tab.
-
In the Transaction Configuration area, click Security Configuration.
-
In the Security Settings area, select the Network DTC Access check box.
-
In the Security Settings area, select the Network Transactions and Network Clients check box.
-
Ensure Allow Remote Clients is selected, and ensure No Authentication Required is selected.
-
Click OK to close each open dialog box.
-
Restart your computer to enable the remote DTC option.
In some time zones, a DateTime exception occurs in the Group Hub page
Problem: When you access the Group Hub page on the BizTalk Administration console and you refresh the page or run certain queries, a SQL Server DateTime overflow exception may appear. This problem occurs only if you are in a time zone that is ahead of Coordinated Universal Time (UTC, also known as Greenwich Mean Time). That is, this error occurs if your local time is UTC + n hours.
Solution: Set the time on your computer to either UTC or to a time zone that is behind UTC; that is, UTC - n hours. Change the clock time before opening the Administration console, or open a new Administration console window, so that the changes are in effect. After you do this, users can reset the clock on their computer back to their original GMT+ time.
Copyright
This document supports a preliminary release of a software product that may be changed substantially prior to final commercial release. This document is provided for informational purposes only and Microsoft makes no warranties, either express or implied, in this document. Information in this document, including URL and other Internet Web site references, is subject to change without notice. The entire risk of the use or the results from the use of this document remains with the user. 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.
(c) 2005 Microsoft Corporation. All rights reserved.
Microsoft, MS-DOS, Windows, Windows Server, Windows Vista, Active Directory, BizTalk, and SQL Server are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
All other trademarks are property of their respective owners.