description | title | ms.custom | ms.date | ms.service | ms.reviewer | ms.suite | ms.topic |
---|---|---|---|---|---|---|---|
Learn about symptoms, possible causes, and solutions for issues related to running BizTalk Accelerator for RosettaNet (BTARN). |
Troubleshooting: Issues and Resolutions3 |
06/08/2017 |
biztalk-server |
article |
This topic addresses issues related to running Microsoft® [!INCLUDEBTARN_CurrentVersion_FirstRef]. The individual issues detail a specific symptom, a possible cause, and a solution.
You receive the following or similar error in the event log:
The Messaging Engine encountered an error publishing a batch of "n" messages to the Message Box database for the transport adapter "BizTalk HTTP Receiver". Please refer to Health and Activity Tracking tool for more detailed information on this failure and check the endpoint bindings are correctly configured.
This error could be caused by one of the following reasons:
-
Missing decryption certificate
-
Incorrectly encrypted message
-
Unauthorized message (source not recognized as a valid partner)
-
Message failing validation of any header part: preamble, delivery header, or service header.
This message may be preceded by another error message that details the cause.
Review the details provided with the error message for additional help. Restarting Microsoft [!INCLUDEbtsSQLServerNoVersion]™ may resolve this issue.
Running the [!INCLUDEbtaBTARN3.3abbrevnonumber]Clean utility does not unenlist all artifacts.
If you run the [!INCLUDEbtaBTARN3.3abbrevnonumber]Clean utility before deleting agreements and partners from the Microsoft® Management Console (MMC), the BtarnClean utility will not be able to unenlist all artifacts because they are still used.
-
At the command prompt, type:
lookback.exe /disable <home org or partner>
-
Run the BtarnClean.exe file.
-
In BizTalk Explorer, delete the parties.
Running the ConfigFramework.exe file yields no results on a computer that does not have MicrosoftBizTalk Server or Microsoft [!INCLUDEbtsVStudioNoVersion] installed. You can only use this [!INCLUDEbtaBTARN3.3abbrevnonumber] configuration as an HTTP client.
Two DLL files are missing from the installation.
Install SQLXML on the computer, and then manually copy the Msxml4.dll and Atl71.dll files to the System folder.
You receive the following error message when you import a configuration file using the [!INCLUDEbtaBTARN3.3abbrevnonumber] Management Console:
Could not store transport type data for Primary Transport of Send Port 'RNSTT.Async' to config store. Access is denied.
You can also receive this error when you try to change the configuration, such as by creating a new partner.
The current user is not a member of the BizTalk Administrators group.
Make sure that the current user is a member of the BizTalk Administrators group.
You receive the following error messages in the Event Viewer:
Error happened in tracking Message activity. Error message is Stored Procedure Does Not Exist.
-or-
Error in terminating BAM message activity with id <ID number>.
The Business Activity Monitoring (BAM) tracking tool is not installed.
Install the BAM tracking tool using the Custom Installation option. If you do not need BAM functionality, you can ignore these messages or disable tracking using the [!INCLUDEbtaBTARN3.3abbrevnonumber] Management Console. After you disable tracking, you must restart [!INCLUDEbtsBizTalkServerNoVersion] and Internet and Information Services (IIS).
You cannot view the content of a schema properly in BizTalk Editor.
The schema is missing the displayroot_reference
attribute for the schemaInfo
element.
Open the schema in Notepad or another text editor and add the displayroot_reference
attribute to the schemaInfo
element. The value of the displayroot_reference
attribute should be the same as the root_reference
attribute.
For example:
<schemaInfo document_type="4A1" version="V02_00" xmlns="<http://schemas.microsoft.com/BizTalk/2003>" displayroot_reference="Pip4A1StrategicForecastNotification" root_reference="Pip4A1StrategicForecastNotification" \>
You receive the following or similar errors when sending a HTTP request:
The remote server returned an error: (404) Not Found.
Message cannot be sent to ../BTSHttpReceive.dll.
The [!INCLUDEbtsBizTalkServerNoVersion] Internet Server API (ISAPI) extension DLL (BTSHttpReceive.dll) has not been configured in Internet Information Services (IIS). This occurs if the HwsMessages HttpReceive web service extension is not configured and if this web service extension is configured, but not allowed.
To determine whether the HwsMessages HttpReceive web service extension is configured, and if it is not configured, to allow it, perform the following procedure.
-
Click Start, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.
-
Expand <computer name> (local computer), and then click Web Service Extensions.
-
In the Web Service Extension pane, verify that the status for HwsMessages HttpReceive is Allowed. If not, right-click HwsMessages HttpReceive, and then click Allow.
If the HwsMessages HttpReceive web service extension is not configured (it is not included in the Web Service Extensions list in IIS Manager), perform the following procedure.
-
Click Start, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.
-
Expand <computer name> (local computer), right-click Web Service Extensions, and then click Add a new Web service extension.
-
In the New Web Service Extension dialog box, in the Extension Name box, type BizTalk ISAPI Extension, and then click Add.
-
In the Add File dialog box, in the Path to file box, type <drive>:\Program Files\Microsoft BizTalk Server <version>\HttpReceive\BTSHttpReceive.dll, and then click OK.
-
In the New Web Service Extension dialog box, select Set extension status to Allowed, and then click OK.
You receive the following or similar error in the event log:
A BizTalk isolated host instance configured with the user account '\HostSvc' was either not running or does not exist on this computer. Use the BizTalk Administration Console to create a new isolated host or reconfigure an existing to run as '\hostsvc'.
To run the Configuration Wizard, the user should be configured as '<machine name>\hostsvc', not '\hostsvc'.
Open the BizTalk Administration Console, and change hosts that are running under the account '\hostsvc', so that they run under the account '<machine name>\hostsvc'.
You receive the following or similar error in the event log:
error CS0234: The type or namespace name 'SerializableAttribute' does not exist in the class or namespace 'RosettaNet.Schemas.System' (are you missing an assembly reference?).
One of your schemas, for example, StandardDocumentHeader.xsd, has a [!INCLUDEbtsDotNet] namespace of RosettaNet.Schemas.System.
Remove the "System" from the [!INCLUDEbtsDotNet] namespace for the schema, so that the namespace is RosettaNet.Schemas.
When you manually try to deploy the BAM package for [!INCLUDEbtaBTARN3.3abbrevnonumber], you receive an error indicating that you cannot deploy the package.
The DTS packages BAM_DM_Process and BAM_DM_Message are installed on your system, preventing deployment of the BAM package.
-
Click Start, point to All Programs, point to Microsoft SQL Server, and then click Enterprise Manager.
-
In Enterprise Manager, expand Microsoft SQL Servers, SQL Server Group, (local) (Windows NT), and Data Transformation Services.
-
Click Local Packages, right-click BAM_DM_Message, and then click Delete.
-
Right-click BAM_DM_Process, and then click Delete.
-
Click Start, click Run, type cmd, and then click OK.
-
At the command prompt, type the following code to deploy the tracking file, and then click OK.
cd %ProgramFiles%\Microsoft BizTalk Server <version>\Tracking bm deploy all "%ProgramFiles%\Microsoft BizTalk <version> Accelerator for RosettaNet\BAMTracking\tracking.xml"
You receive the following or similar error in the event log:
UNP.SCON.VALERR: A failure occurred while validating the service content.
Details: Finding document specification by message type failed. Verify that the schema is deployed properly.
Either the document namespace or the root node property the deployed schema for the instance Pip4A5NotifyofForecastReply is incorrect.
Verify that the document namespace and the root node property for the deployed schema for instance Pip4A5NotifyofForecastReply is correct.
Error during the configuration of BTARN at installation time, caused by presumed network connectivity issues
During the configuration process, you receive an error in the error dialog box indicating that the computer is not properly connected to the network, when in fact it is.
This error may be caused by the [!INCLUDEbtaBTARN3.3abbrevnonumber] configuration program misinterpreting IP addresses. The hosts file in C:\Windows\system32\drivers\etc contains an entry mapping the localhost host name to the IP address 127.0.0.1. The configuration program may confuse this value with the loopback address, and assume that the computer is not connected properly to the network.
-
In [!INCLUDEbtsWinNoVersion] Explorer, move to C:\Windows\system32\drivers\etc, and open the hosts file using Notepad.
-
Comment out the line "127.0.0.1 localhost" by placing "# " at the start of the line. Save the changed hosts file.
-
Click Retry in the error dialog box.
-
After configuration has completed successfully, re-open the hosts file in Notepad, remove the comment mark at the start of the line mapping localhost, and then save the hosts file.
You receive the following or similar error in the event log:
There was a failure executing the receive pipeline: "Microsoft.Solutions.BTARN.Pipelines.Receive" Source: "MIME/SMIME decoder" Receive Location: "/BTARNHttpReceive/BTSHTTPReceive.dll?xRNResponseType=async" Reason: Incorrect signature length, value = 1935897193.
This error message indicates that the signature length is incorrect. In addition to the above cause, this error could also due to the incorrect or incomplete header content length which leads to the wrong bytes read on the signature length.
Verify that both of the signature length and header content length is correct.
After [!INCLUDEBTARN_CurrentVersion_abbrev] configuration is completed, when you try to access http://localhost
or http://localhost/BtarnApp/RnifSend.aspx
, you may receive the following or similar error:
503: Service Unavailable
This error may be caused by the ISAPI filter found under C:\windows\system32\rpcproxy\rpcproxy.dll being set on IIS Web Sites.
-
Click Start, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.
-
Expand <computer name> (local computer), right-click Web Sites, and then click Properties.
-
Select ISAPI Filters tab.
-
Select RpcProxy filter, and click Remove.
-
Click OK.
-
Click Start, click Run, type cmd, and then click OK.
-
At the command prompt, type the following code to reset IIS.
iisreset
Note
If you try to access http://localhost or http://localhost/BtarnApp/RnifSend.aspx again after performing the above steps, you will receive HTTP 400 message back from the Internet Explorer which means that IIS is now functioning properly.
The HubScenario sample will not be installed correctly if the assembly key files are not entered for the projects
When you run setup.bat in <drive>:\Program Files\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\HubScenario to set up the HubScenario sample, the operation fails.
The HubScenario and HubHelper assemblies were not deployed correctly because the assembly key files were not set in the projects.
Set the assembly key files for the HubScenario and HubHelper projects. For more information, see HubScenario Sample.
Run setupx64.bat to set up the Double Action PIPAutomation Orchestration sample on SQL Server 2008 R2/2008 SP1
When you run setup.bat to build and initialize the Double Action PIPAutomation Orchestration sample, the PipAutomationGetAction stored procedure in the BTARNData database is not created.
You ran setup.bat on a 64-bit computer or on a BizTalk Server installation that is running on SQL Server 2008 R2/2008 SP1. Both of these instances require you to run setupx64.bat.
Run setupx64.bat to create the stored procedure. For more information, see Double Action PIPAutomation Orchestration.
Enable the BTARN Application Pools for 32 bit on Windows Server 2008, 64-bit Windows Operating System (OS)
To run the BTARN End to End scenario on Windows Server 2008,64-bit Windows Operating System (OS), Internet Information Services Manager 7.5/7.0.
-
Enable the BTARN Application Pools for 32 bit.
-
Add a HTTP Handler for *.dll referring the IsapiModule Filters.