Supported Deployment Configurations

Prerequisites

Hardware

Software

Security

Installing BizTalk Server RFID

Side-by-Side Installation of BizTalk Server and BizTalk Server RFID

Side-by-Side Installation of Different Versions of BizTalk Server RFID

Compatibility with Previous Versions of BizTalk RFID Standards Pack and BizTalk RFID Mobile

BizTalk Server RFID Setup Components

Types of Installation

Preparing to Install BizTalk Server RFID

Installing BizTalk Server RFID in Interactive Mode

Upgrading from BizTalk Server RFID 2006 R2

Removing BizTalk Server RFID in Interactive Mode

Silent Mode Operations

Modifying or Repairing a BizTalk Server RFID Installation

Preparing to Set Up a Remote RFIDsink Database

Installation Log Files

Troubleshooting the Installation and Deployment of BizTalk Server RFID

Known Issues

Last updated: June 23, 2009

This document provides hardware and software requirements and detailed instructions for installing and configuring Microsoft® BizTalk® Server RFID 2009 (BizTalk Server RFID). It also outlines supported deployment configurations and provides installation-related troubleshooting information.

To ensure that you are reading the most up-to-date installation information, download the latest version of this document (Installing and Configuring BizTalk Server RFID) at http://go.microsoft.com/fwlink/?LinkID=149997&clcid=0x409

Supported Deployment Configurations

BizTalk Server RFID can be deployed in various configurations. You can deploy all BizTalk Server RFID components on the same computer, or each component on a different (remote) computer. The BizTalk Server RFID components that can be installed are:

  • RFID Server

  • RFID Manager

  • RFIDsink database

  • RFIDstore database

You can choose how to deploy these components based on your requirements and scenario. For example, you might install BizTalk Server RFID and SQL Server (for the RFID store) on the same computer, and the RFIDsink database (the database that the out-of-box sink event handler uses) on a remote SQL server.

Note

If you plan to install the RFIDsink database on a remote SQL server, use the initial configuration steps listed in Preparing to Set Up a Remote RFIDsink Database to support such a deployment scenario.

Top of page

Prerequisites

This section lists the hardware, software, and security requirements needed to install BizTalk Server RFID.

Hardware

Minimum and recommended hardware requirements are as follows:

Minimum Hardware Requirements

The minimum hardware requirements for BizTalk Server RFID installation are:

  • 133 megahertz (MHz) or higher Intel Pentium-compatible CPU

  • 512 megabytes (MB) of RAM

  • 6 gigabytes (GB) disk space

  • CD-ROM or DVD-ROM drive

  • A super VGA (800 x 600) or higher-resolution monitor compatible with:

    • Windows Vista® Service Pack 1 (SP1)

    • Windows® XP Service Pack 3 (SP3)

Recommended Hardware Requirements

The recommended hardware requirements for BizTalk Server RFID installation are:

  • 733 megahertz (MHz) or higher Intel Pentium-compatible CPU

  • 1 gigabyte (GB) of RAM

  • 40 gigabytes (GB) of disk space

  • A super VGA (1024 x 768) or higher-resolution monitor compatible with:

    • Windows Vista SP1

    • Windows XP SP3

  • Microsoft mouse or compatible pointing device

Software

Install the following software before you begin installing BizTalk Server RFID:

  • One of the following operating systems:

    • Windows Vista SP1

    • Windows XP

  • Microsoft .NET Framework 3.5 Service Pack 1.

  • Message Queuing service (MSMQ), if you choose to install RFID Server. MSMQ is a Windows component and can be installed by using Add/Remove Windows Components in Add or Remove Programs from Control Panel.

  • Any one of the following database software, if you choose to install RFID Server, and want to install the database component of BizTalk Server RFID on the same computer:

    • Microsoft SQL Server® 2008

    • Microsoft SQL Server 2005 with Service Pack 2

  • Microsoft Management Console (MMC) 3.0 RTM version

For details about how to install any of the software prerequisites listed above, refer to their respective installation guides.

Important

After you install all the required software, install any relevant Microsoft updates on your computer.

Security

You need the following permissions to successfully install BizTalk Server RFID:

  • You must belong to the Administrators group on the computer on which you want to install BizTalk Server RFID.

  • You must have Administrator rights for the SQL Server instance.

Top of page

Installing BizTalk Server RFID

This section outlines the steps you should follow to install BizTalk Server RFID on your computer. It describes how you should plan for the installation, the prerequisites for installation, and the actual installation steps.

Side-by-Side Installation of BizTalk Server and BizTalk Server RFID

  • BizTalk Server Compatibility. BizTalk Server RFID 2009 is compatible only with BizTalk Server 2009, and cannot be installed with any previous version of BizTalk Server.

  • Message Queuing (MSMQ) and the BizTalk Message Queuing (MSMQT) adapter. BizTalk Server RFID uses MSMQ to store and forward messages. When BizTalk Server is installed, an MSMQ-related adapter (the BizTalk Message Queuing adapter) is also installed. We recommend that you do not run both standard Message Queuing (MSMQ) and BizTalk Message Queuing (MSMQT) on the same computer. For more information about the compatibility of MSMQ and the MSMQT adapter on the same computer, refer to the BizTalk Server documentation.

Side-by-Side Installation of Different Versions of BizTalk Server RFID

Side-by-side installations of BizTalk Server RFID 2006 R2 and BizTalk Server RFID 2009 is not supported.

Important

To install BizTalk Server RFID 2009, you must first uninstall BizTalk RFID 2006 R2.

Compatibility with Previous Versions of BizTalk RFID Standards Pack and BizTalk RFID Mobile

If you are installing BizTalk Server RFID in an environment where both BizTalk Server RFID and BizTalk RFID Mobile will be used, ensure that both components are from the same release. If you install BizTalk Server RFID 2009, and require BizTalk RFID support for mobile devices, ensure that you also install BizTalk RFID Mobile 2009.

BizTalk Server RFID Setup Components

BizTalk Server RFID Setup contains the following three components or features:

  • RFID Services. This feature contains components for RFID Service Engine, Business Rule Engine, RFID Store, Rule Engine Database, performance counters, and client tools. Install this component if you want the server to run on the computer, and want to be able to administer the server through command-line tools.

  • RFID Tools and Client Connector. This feature contains components for the Client Console administration tool, RFID Connector library, and MMC-based graphical user interface (GUI) management tools. Install this component if you want to manage an RFID server through the GUI or through your own RFID clients.

  • RFID SDK. The RFID Software Development Kit is a development kit for those who provide devices and write providers for their devices to interact with BizTalk Server RFID. The development kit contains components for the Device Service Provider Interface (DSPI), configuration file manager binaries, and DSPI Software Development Kit (SDK) documents.

Types of Installation

This section lists the types of BizTalk Server RFID installations and the components that install according to the particular type of installation you choose when running Setup.

Setup allows you to choose from the following types of installation:

  • Typical. Installs the following features on your computer:

    • RFID Services

    • RFID Tools and Client Connector

  • Custom. Allows you to choose the features that you want to install:

    • RFID Services

    • RFID Tools and Client Connector

    • RFID SDK

  • Complete. Installs all three of the following features:

    • RFID Services

    • RFID Tools and Client Connector

    • RFID SDK

Preparing to Install BizTalk Server RFID

This section outlines the points you need to consider before you start installing BizTalk Server RFID on your computer.

Installing BizTalk Server RFID for the First Time

Before installing BizTalk Server RFID on your computer, do the following:

  • Ensure that the computer meets the system requirements for BizTalk Server RFID. For more information, see Prerequisites for Installing BizTalk Server RFID.

  • Ensure that you follow the supported configurations while setting up BizTalk Server RFID. For more information, see Supported Configurations.

  • Review all BizTalk Server RFID installation options and prepare to make the appropriate selections when running Setup. For more information, see BizTalk Server RFID Setup Components and Types of Installation.

RFID Services Port Number

The BizTalk Server RFID service uses the port number 7891. You must add 7891 to the list of exceptions in Windows Firewall.

You can change the port number by making the appropriate configuration modifications in the rfidServices.exe.config file located in the ..\Microsoft BizTalk RFID\bin\ folder. After installing BizTalk Server RFID, you can see the RFID Manager documentation located in the ..\Microsoft BizTalk RFID\Documentation\ folder for more information about providing a port to connect.

Installing BizTalk Server RFID in Interactive Mode

This section explains how to use the interactive setup GUI to install and set up different installer options and properties of BizTalk Server RFID on your computer.

Before you begin installation, ensure that your computer complies with the hardware, software, and security requirements listed in Prerequisites for Installing BizTalk Server RFID.

Caution

Close all applications before you begin installation.

Important

Before you install BizTalk Server RFID, uninstall any previous version, and delete the BizTalk Server RFID installation folder. If you have a current deployment of BizTalk Server RFID 2006 R2, and would like to upgrade to BizTalk Server RFID 2009, read the installation instruction outlined in the section Upgrading from BizTalk Server RFID 2006 R2.

Note

The comma character (,) is not supported for configuration information such as install directories, user names, and RFID configuration database names.

To install BizTalk Server RFID in interactive mode
  1. Extract the contents of the BizTalk Server RFID installation package to a folder, and then double-click setup.exe.

    The BizTalk Server RFID Setup Wizard is displayed.

  2. On the BizTalk RFID Setup Wizard page, click Next.

  3. The End User License Agreement page appears. For future reference, print the License Agreement by clicking Print. Read the license agreement carefully. Select the I accept the terms in the License Agreement option, and then click Next.

  4. On the Customer Information page, type the name of the user and the organization, and then click Next.

    Note

    The Product Key fields will be pre-populated, and cannot be edited.

  5. If your computer is not configured to receive Microsoft updates, the Use Microsoft Update to help keep your computer secure and up-to-date dialog box appears. Choose an option, and then click OK.

    Note

    By default, no option is selected on the Use Microsoft Update to help keep your computer secure and up-to-date dialog. You must select an option to continue.

  6. On the Choose Setup Type page, do one of the following:

    • To perform a typical installation, select Typical. Proceed to step 12 to continue.

    • To perform a custom installation, select Custom. Proceed to step 8 to continue.

    • To perform a complete installation, select Complete. Proceed to step 12 to continue.

    Type a location in the Data path box, or click Browse to select a folder for process, provider, log, and configuration-related folders and files. Type a location in the Installation path box, or click Browse to select a folder where the BizTalk Server RFID application-related binary files and folders will be installed.

    Click Next to continue.

    Note

    For more information, see Types of Installation.

  7. When you select the Custom installation option, the Custom Setup page appears with a list of features. Click the first feature in the feature selection tree, for example RFID Product. A drop-down list will appear for this feature.

  8. Select and click the setting that you require from the following options:

    • Will be installed on local hard drive

    • Entire feature will be installed on local hard drive

    • Will be installed to run from network

    • Entire feature will be installed to run from network

    • Feature will be installed when required

    • Entire feature will be unavailable

    Note

    The six options above are available only for sub-features. For the main feature (RFID Product), the drop-down list does not contain the Will be installed to run from network and the Entire feature will be installed to run from network options.

  9. Repeat steps 8 and 9 for each feature in the feature selection tree. At the end of this procedure, each feature should have a setting associated with it.

    Note

    The features are listed in a tree view. Selecting a setting for a particular feature will apply the same setting for all subfeatures listed under that feature.

  10. On the Custom Setup page, click Disk Usage to view details about the disk usage for your selected features. On the Disk Space Requirements page, click OK. You return to the Custom Setup page. Click Next.

  11. On the Database System and RFID Store Information page, type the name of the SQL server in the SQL Server Name field. If SQL Server is installed on the computer, the name of the server is displayed.

    • If you are using a remote SQL Server for the RFID configuration store, you must use a domain account to install BizTalk Server RFID. The domain account should have the necessary privileges on the remote SQL Server.

    • To overwrite the contents of a previous store, select the Overwrite contents of RFID Store check box.

      Note

      If you are migrating from a previous version of BizTalk Server RFID, ensure that you select the Overwrite contents of RFID Store check box.

      Note

      If you have previously uninstalled BizTalk Server RFID and you want to retain the data in the RFIDstore database, use the same installation directory and data directory as the previous installation.

    • If the computer has a default instance of SQL Server, the installation procedure will, by default, use this instance. If you want to proceed with this default setting, leave this field as is, and then click Next.

    • If you want to point the installer to a named instance of the database, type the instance information in the following format: ComputerName\InstanceName

    • By default, this option is set to Windows Authentication. This allows you to specify an existing Windows user who has access to the SQL Server databases.

    • To specify SQL Server authentication, select the SQL Server Authentication option, specify the user name and password of the SQL Server user who will have access to the RFID Store, and then click Next.

    Note

    This page will not appear if you choose to perform a Custom setup, and then choose not to install RFID Services on the Custom Setup page.

  12. If any prerequisite components to run BizTalk Server RFID are not installed, the System Configuration page displays the missing components. Install any missing prerequisites, and then click Recheck. Click Next. Proceed to the next step.

  13. To provide correct authentication, specify the accounts that will be used with BizTalk Server RFID. By default, in Windows XP or Windows Vista, BizTalk Server RFID will run under the RFID Service account created during installation. To change the service account used to access the RFID Store database, on the Set up the RFID Service Account page, click Specify user name and password, and then type the user credentials of the service account.

    Click Next.

    Note

    The RFID Service Account is the default for the MSBizTalkRFID Service.

    Important

    The Service Account specified must not be the same account as that of the user installing BizTalk Server RFID.

  14. On the Ready to Install page, if you need to review the installation settings, click Back. To begin the installation, click Install.

  15. The installer proceeds with BizTalk Server RFID installation, and the progress is displayed on the Installing BizTalk RFID status page.

  16. When the installation is successful, the BizTalk Server RFID Setup Wizard exit page appears. Click Finish.

    Important

    When you click Finish, Setup starts the Automatic Update Scheduler to download updates to the computer. If the computer is not configured to receive Microsoft updates, the Automatic Update Scheduler will not download updates.

  17. If you have chosen to install RFID Services, the Business Rules Configuration dialog box is displayed. Use the information in the dialog box to complete the wizard, and then close the Business Rules Configuration wizard.

    Important

    If the Business Rule Engine (BRE) is already installed and configured on the computer through BizTalk Server, specify the same configuration information in the Business Rules Configuration wizard that was used while installing BizTalk Server. This ensures that existing BRE data can be reused by BizTalk Server RFID.

    For more information, refer to the "Configuring BizTalk Server 2009" section in BizTalk Server 2009 documentation.

Note

Errors while installing BizTalk Server RFID may cause Setup to fail, roll back, or continue to the end of the installation procedure. Installation-related information is stored in log files in the %TEMP% folder. The log file is named RfidServicesSetup(mmddyy hhmm).log.

Upgrading from BizTalk Server RFID 2006 R2

You can upgrade your existing BizTalk Server RFID 2006 R2 deployment to BizTalk Server RFID 2009. All components, event handlers, processes, and devices will continue to work after you upgrade to BizTalk Server RFID 2009.

Important

If a process has a Business Rule Engine (BRE) component, after upgrading to BizTalk Server RFID 2009, the process will fail to start until the BRE is configured. Configure the BRE, and then try to restart the process.

To ensure that the upgrade is error-free, do the following:

To upgrade from BizTalk Server RFID 2006 R2
  1. Uninstall any previous version of BizTalk Server RFID.

  2. Use the procedure outlined in the section on Installing BizTalk Server RFID Install BizTalk Server RFID 2009. In the installation wizard, in step 11 (Database System and RFID Store Information page), clear the Overwrite contents of RFID Store check box.

    Warning

    If you select the Overwrite contents of RFID Store check box all the information related to processes, providers, and devices will be lost.

Known Issues (Upgrading from a Previous Version of BizTalk Server RFID)

The following issues may occur while upgrading from a previous version of BizTalk Server RFID:
  • Log locations and levels are not retained.

    To upgrade, any previous version of BizTalk Server RFID must be uninstalled. Log-related settings are deleted. Before you upgrade to BizTalk Server RFID 2009, ensure that you have noted current log levels and the log locations. After an upgrade to BizTalk Server RFID 2009, you can manually set log file locations and levels to your previous settings.

  • LLRP provider settings are not retained.

    To upgrade, any previous version of BizTalk Server RFID must be uninstalled. Provider-related settings are lost. Before you upgrade to BizTalk Server RFID 2009, ensure that you have noted current LLRP configuration settings. After an upgrade to BizTalk Server RFID 2009, you can manually set the LLRP provider settings to previous values.

  • Devices that have a password in BizTalk Server RFID 2006 R2 do not retain the password after an upgrade to BizTalk Server RFID 2009.

    To upgrade, any previous version of BizTalk Server RFID must be uninstalled. After an upgrade to BizTalk Server RFID 2009, devices that had a password in BizTalk Server RFID 2006 R2 no longer retain the password. You must set the password for such devices.

Removing BizTalk Server RFID in Interactive Mode

This section describes steps to remove BizTalk Server RFID from your computer in interactive mode by using the GUI.

Note

Rollback is not supported. If you choose to cancel Setup while uninstalling BizTalk Server RFID, actions performed during the procedure will not be rolled back.

To remove BizTalk Server RFID in interactive mode
  1. Click Start, point to Control Panel, and then click Add or Remove Programs. A list of programs appears.

  2. Locate and click Microsoft RFID Services or Microsoft BizTalk RFID in this list.

  3. Click Remove.

  4. On the Add or Remove Programs confirmation page, click Yes to remove BizTalk Server RFID from your computer.

    Note

    You can also remove BizTalk Server RFID by double-clicking the BizTalk Server RFID Setup.exe file, and then selecting Remove in the options.

Silent Mode Operations

This section discusses how to install and remove BizTalk RFID in silent mode. You cannot run Repair in silent mode. To run Repair, use Add or Remove Programs.

BizTalk Server RFID enables automated distribution of electronic software with minimum manual intervention, also known as silent mode installation. You can use silent installation to install BizTalk Server RFID in an automated way on computers that have the same configurations. With silent installations, system administrators can install BizTalk Server RFID on remote computers without user intervention.

To perform a silent installation, use command-line options that are provided to suppress all interaction and provide parameters for all options.

When you perform a silent installation, the installation program does not display messages. Instead, a log file captures the installation information that includes information about the success or failure of the installation. You can review the log file and determine the results of the installation.

Important

BRE components are installed as part of the installation, but are not configured. To configure BRE components, see the BRE Configuration topic under Microsoft BizTalk RFID Documentation\Operations\Administering RFID Servers in BizTalk Server RFID help.

Important

Before you install BizTalk Server RFID, uninstall any previous version, and delete the BizTalk Server RFID installation folder.

To install BizTalk Server RFID in silent mode
  1. Click Start, click Administrative Tools, and then click Services.

  2. In Services, stop Rule Engine Update Service.

  3. Open a command prompt by doing one of the following:

    • Click Start, click Run, type cmd in the Open field, and then click OK.

    • Click Start, point to All Programs, point to Accessories, and then click Command Prompt.

  4. At the command prompt, navigate to the root directory of Setup.exe. Type msiexec.exe /i RfidServices.msi Property Name=”Property value /lvxp logfilename.log /qn and then press ENTER. This installs BizTalk Server RFID with the specified properties in silent mode, and also creates a log file (in the root directory of Setup.exe) that contains installation information. The following table shows the properties that you can specify at the command prompt to install BizTalk Server RFID.

    Note

    To get help about msiexec.exe parameters and their use, type msiexec.exe -h at the command prompt, and then press ENTER.

    Property nameDefault valueRemarks

    INSTALLLEVEL

    If no value is specified, a typical installation is performed (RFID Services, Client, and Tools)

    The INSTALLLEVEL parameter is mapped as shown below:

    1: RFID Client and Tools

    2, 3, or 4: Typical Installation (RFID Services, Client, and Tools)

    5: Complete Installation

    INSTALLDIR

    C:\Program Files\Microsoft BizTalk RFID

    Root directory where BizTalk Server RFID application-related binary files are located.

    DATADIR

    C:\Program Files\Microsoft BizTalk RFID

    Root directory where process, provider, log, and configuration-related folders and files are located.

    SQLSERVERMACHINENAME

    ( local )

    Name of computer that is running the SQL Server 2008 or SQL Server 2005 database instance.

    SQLSERVERINSTANCE

    Blank

    Database instance name if a named instance of the database is running. You can pass SQLSERVERMACHINENAME as computername \ instance name to point to a named database instance.

    If the INSTALLLEVEL is greater than 2, the following properties can be set for the silent installation.

    Property nameDefault valueRemarks

    ISDBAUTHENTICATION

    No

    If ISDBAUTHENTICATION equals "Yes", you can specify a custom SQL authentication.

    SQLUSERNAME

    sa

    A user who has access to the SQL Server database.

    SQLPASSWORD

    N/A

    The password of the SQL Server user.

    OVERWRITERFIDSTORE

    0

    If a previous RFID Store exists, specify OVERWRITERFIDSTORE as "1" to overwrite the previous RFID Store.

    To keep the previous RFID Store, specify OVERWRITERFIDSTORE as "0".

  5. To set more than one property from the command prompt, type all the properties and their values one after the other on the command line, separated by spaces. For example:

    msiexec.exe /i RfidServices.msi INSTALLDIR=”D:\MyFolders\MyRfid” INSTALLLEVEL=”1” SQLSERVERMACHINENAME=”computer name” SQLSERVERINSTANCE =”instance name” /lvxp msi-install.log /qn

  6. After installation is complete, to configure BRE in silent mode, run the command:

    configuration.exe /s <inputconfiguration.xml> /l <mylogfile.txt>

To remove BizTalk Server RFID in silent mode
  1. Open a command prompt by doing one of the following:

    • Click Start, click Run, type cmd in the Open field, and then click OK.

    • Click Start, point to All Programs, point to Accessories, and then click Command Prompt.

  2. At the command prompt, navigate to the root directory of RfidServices.msi. Type msiexec.exe /x RfidServices.msi /lvxp logfilename.log /qn

Modifying or Repairing a BizTalk Server RFID Installation

This section outlines the steps to modify and repair a BizTalk Server RFID installation.

After installing BizTalk Server RFID, if you need to change the components or features that you selected during installation, you can do so by modifying the installation. For example, if you chose to install only the RFID Services component during installation, and later you also need to install RFID Tools and Client Connector, modifying the installation enables you to do this.

To modify a BizTalk Server RFID installation
  1. Click Start, point to Control Panel, and then click Add or Remove Programs. A list of programs appears.

  2. Locate and click Microsoft BizTalk RFID in the list of programs, and then click Change.

  3. On the BizTalk RFID Setup Wizard page, click Next.

  4. On the Modify, Repair or Remove Installation page, click Modify.

  5. On the Custom Setup page, select a feature and modify the setting for the feature. For more information about changing feature settings, see step 8 under Installing BizTalk Server RFID in Interactive mode.

  6. After modifying all desired features, click Next.

  7. On the Ready to Install page, click Install.

  8. When the installation is successful, the BizTalk RFID Setup Wizard exit page appears. Click Finish to exit.

  9. In the setup completion confirmation screen, click OK.

Note

You can also modify the installation by double-clicking Setup.exe and then choosing Modify in the options that appear.

Repairing the installation allows you to repair errors in the most recent installation state.

To repair a BizTalk Server RFID installation
  1. Click Start, point to Control Panel, and then click Add or Remove Programs. A list of programs appears.

  2. Locate and click Microsoft BizTalk RFID in the list of programs, and then click Change.

  3. On the Microsoft BizTalk RFID Setup Wizard page, click Next.

  4. On the Modify, Repair, or Remove Installation page, click Repair.

  5. On the Repair Microsoft BizTalk RFID page, click Repair.

  6. The Repairing Microsoft BizTalk RFID page appears while Setup performs the necessary actions to repair the installation. When Setup repairs the installation successfully, the Microsoft BizTalk RFID Setup Wizard exit page appears. Click Finish to exit.

  7. If asked to restart the computer, click Yes to restart your computer immediately. Click No if you plan to manually restart your computer later.

Note

You can also repair the installation by double-clicking Setup.exe and then choosing Repair in the options that appear.

Preparing to Set Up a Remote RFIDsink Database

RFIDsink is the database that is used by the out-of-box SQL Server Sink event handler to store read tags. This section describes the initial configuration steps to use if you plan to set up RFIDsink on a remote SQL server. This method of deploying RFIDsink is important when you want to install the database on a computer other than the one that has BizTalk Server RFID.

Complete the following tasks before you configure the RFIDsink database on a remote SQL server:

  1. Enable Microsoft Data Transaction Coordinator (DTC) on the BizTalk Server RFID computer and on the remote SQL Server computer.

    Note

    Windows Vista users may skip this step.

  2. Allow DTC through the Windows firewall on the BizTalk Server RFID computer and on the remote SQL Server computer.

  3. Allow SQL Server and SQL Server Browser through the Windows firewall on the remote computer.

  4. Enable SQL Server to use the TCP/IP port for communication. The TCP/IP port is normally enabled for SQL Server. You need not do this step if the port is already enabled.

  5. Restart all associated components on the BizTalk Server RFID computer and on the remote SQL Server computer.

To enable DTC access on Windows XP
  1. Click Start, click Run, type dcomcnfg.exe, and then click OK to start the DCOM Configuration tool.

  2. In the console tree of the Component Services administrative tool, expand Component Services, expand Computers, right-click My Computer, and then click Properties.

  3. Click the MSDTC tab, and then click Security Configuration.

  4. Select the Network DTC Access check box, and then do the following:

    1. On the BizTalk Server RFID computer, select the Allow Outbound check box, and then click OK.

    2. On the remote SQL Server computer, select the Allow Inbound check box, and then click OK.

  5. Click OK on the MSDTC tab, and close the Component Services window. You can also refer to the detailed steps for enabling DTC at http://support.microsoft.com/Default.aspx?kbid=899191.

To allow DTC through the Windows firewall
  1. Click Start, point to Control Panel, and then double-click Windows Firewall.

  2. Click the Exceptions tab, and then click Add Program.

  3. Click Browse, locate and click msdtc.exe in the System directory (C:\Windows\System32), and then click Open.

  4. In the Add a Program dialog box, select msdtc, and then click OK.

  5. On the Exceptions tab, click OK.

To allow SQL Server and SQL Server Browser through the Windows firewall
  1. Click Start, point to Control Panel, and then double-click Windows Firewall.

  2. Click the Exceptions tab, and then click Add Program.

  3. Click Browse, locate and click sqlservr.exe in the C:\Program Files\Microsoft SQL Server\MSSQL\Binn folder, and then click Open.

    Note

    If you cannot find a folder named C:\Program Files\Microsoft SQL Server\MSSQL\Binn, then search for a folder named C:\Program Files\Microsoft SQL Server. The default installation path for SQL Server is C:\Program Files\Microsoft SQL Server.

    Note

    If you are running a named instance of SQL Server, you need to add the named instance to the Windows Firewall Exception list.

  4. In the Add a Program dialog box, select sqlservr and then click OK.

  5. On the Exceptions tab, click OK.

    Note

    The TCP/IP port is normally enabled for SQL Server. You need not perform the following procedure if the port is already enabled.

  6. Repeat steps 1 through 5 for SqlBrowser.exe (found at C:\Program Files\Microsoft SQL Server\90\Shared\).

To enable SQL Server to communicate by using the TCP/IP port
  1. Click Start, point to All Programs, point to Microsoft SQL Server 2005 or 2008, point to Configuration Tools, and then click Microsoft SQL Server Configuration Manager.

  2. In the console tree of Microsoft SQL Server Configuration Manager, expand SQL Server 2005 Network Configuration, and then click Protocols for <Instance Name>.

    The <Instance Name> refers to the instance of Microsoft SQL Express being used by the product.

  3. Right-click TCP/IP and then click Enable.

    The icon for the protocol will change to show that the protocol is enabled.

To restart BizTalk Server RFID
  1. Click Start, point to Control Panel, point to Administrative Tools, and then click Services.

  2. Locate and double-click BizTalkRFID.

  3. On the General tab, click Stop, click Start, and then click OK.

To restart SQL Server and SQL Server Browser
  1. Click Start, point to Control Panel, click Administrative Tools, and then click Services.

  2. Locate and double-click MSSQLSERVER.

  3. On the General tab, click Stop, click Start, and then click OK.

  4. Repeat Steps 1 through 3 for the service SQLBrowser.

To restart Message Queuing
  1. Click Start, point to Control Panel, click Administrative Tools, and then click Services.

  2. Locate and double-click Message Queuing.

  3. On the General tab, click Stop, click Start, and then click OK.

Installation Log Files

This section contains an explanation of the Setup log files. All dynamic information used by Setup, such as upgrade information, error logs, and others, will be located in the %Temp% directory.

Note

The setup wizard carries out a large number of custom actions before BizTalk Server RFID is installed on your computer. However, these actions are logged to the installation logs only after the user clicks Finish to complete the setup wizard and start BizTalk Server RFID installation.

Log files created during the installation procedure are:

  • RfidCreateRfidStoreDb_mmddyyyy hhmmss.log

  • RfidCreateRfidStoreDbRollback_mmddyyyy hhmmss.log

  • RfidRegisterOobEventhandlers_mmddyyyy hhmmss.log

  • RfidUnregisterOobEventhandlers_mmddyyyy hhmmss.log

  • RfidCreateADMarker_mmddyyyy hhmmss.log

  • RfidRemoveADMarker_mmddyyyy hhmmss.log

  • RfidADMarkerRollback_mmddyyyy hhmmss.log

  • RfidRegisterStartProvider_mmddyyyy hhmmss.log

  • RfidStopUnregisterProvider_mmddyyyy hhmmss.log

  • RfidStopProvider_mmddyyyy hhmmss.log

  • RfidWriteMachineConfigEPCIS_mmddyyyy hhmmss.log

  • RfidWriteMachineConfigEPCISRollback_mmddyyyy hhmmss.log

  • RfidRemoveMachineConfigEPCIS_mmddyyyy hhmmss.log

  • RfidIsBREConfigured_mmddyyyy hhmmss.log

  • RfidCheckSKUBasedClustering_mmddyyyy hhmmss.log

  • Rfidwmi_mmddyyyy hhmmss.log

  • RFIDCustomAction.log

  • RfidServicesSetup(mmddyyyy hhmmss).log

Note

The number of log files may vary based on the type of installation chosen.

Top of page

Troubleshooting the Installation and Deployment of BizTalk Server RFID

This section discusses some common problems related to installing and deploying BizTalk Server RFID, including the possible cause, and how you can resolve the problem.

Uninstallation of BizTalk Server RFID fails. Thereafter, RFID Server fails to run.

Possible Cause

Any error while removing BizTalk Server RFID can cause service account credentials to be deleted.

Solution

Find the service named MSBizTalkRFID, set the service account to Local System, and then try to remove the installation.

Unable to uninstall BizTalk Server RFID by using Add or Remove Programs or msiexec /x option

Symptom

Uninstalling fails with error message: "The installation source for this product is not available. Verify that the source exists and that you can access it."

Possible Cause

Setup.exe cannot run if the version of the RfidServices.msi package is different from that of the original installation.

Solution

Run Setup.exe from the directory where the product was originally installed and select the Remove option.

If this doesn't solve the problem, you can attempt to repair the installation by using the Repair option when setup is run from Add or Remove Programs. If the Repair option isn't available when setup is run from Add or Remove Programs, you may be able to access it by clicking Click here for support information in the Add or Remove Programs entry for Microsoft BizTalk Server RFID. After repairing the installation, attempt to uninstall BizTalk Server RFID.

Installation fails with an error message

Symptom

Installation fails with error message: "An error occurred during the installation of assembly component {A0B265D0-E711-4106-91E1-67843687C8A1}. HRESULT: 0x80070005".

Possible Cause

This can be due to a recent credentials change for the logged-in user.

Solution

Cancel the installation, restart the computer, and try the installation again.

Installation fails with an error message

Symptom

Installation fails with an error message: "((Error)) GacAssembly:Failed to GAC the Dll.:-1".

- OR -

Installation fails and the log file has an entry: "Access denied. You might not have administrative credentials to perform this task."

Possible Cause

The global assembly cache (GAC) might be in an unstable state.

Solution

Restart the computer, and try to install BizTalk Server RFID again.

MSBizTalkRFID service fails to start

Symptom

Installation of BizTalk Server RFID succeeds, but the MSBizTalkRFID service fails to start.

Possible Cause

Various conditions can cause this problem to occur. Check the following list of solutions to ensure that BizTalk Server RFID is installed correctly.

Solution

Check the following on your computer:

  • Ensure that the user name specified for the RFID Service account has administrator privileges on the computer.

  • Ensure that the user name specified for the RFID Service account has access to the SQL server that you specified during installation.

  • Ensure that the user name specified for the RFID Service account has the "Logon as a service" right enabled.

  • The RFID service is dependent on the following services. Check if any of these services failed to start:

    • The SQL server (or a particular instance of SQL Server) that you mentioned during installation

    • Message Queuing

  • In Administrative Tools, click Event Viewer, and then click Application. Locate messages with Source as BizTalkRFID and Event equal to 1500. View these messages for further information about why the RFID service failed to start.

  • In Administrative Tools, click Event Viewer, and then click System. Locate messages with Source as Service Control Manager and Event equal to 7000 or 7038. View these messages for further information about why the RFID service failed to start.

  • Check to determine if the SQL server was added correctly as a dependency of the RFID service.

  • The Rfid.Config file and the RfidServices.exe.Config file might have been corrupted. Duplicates of these files are located in the \bin folder of BizTalk RFID, and are named as Rfid.Config.Initial and Rfidservices.exe.config.initial. Delete the corrupted files and rename the duplicate files to Rfid.Config and RfidServices.exe.Config respectively.

During installation, user names like .\RfidSvcAcc or .\RfidUsrAcc are displayed in the Setup RFID Service Account page

Symptom

In the Setup RFID Service Account page of BizTalk Server RFID Setup, the user name appears as .\RfidSvcAcc or .\RfidUsrAcc, and then the installation process fails.

Possible Cause

The computer may be in an unstable state.

Solution

Restart the computer and then try installing BizTalk Server RFID again.

MSBizTalkRFID service fails to start with an error message "The dependency service or group failed to start"

Symptom

After you install BizTalk Server RFID, you receive the error "The dependency service or group failed to start", and the MSBizTalkRFID service fails to start.

Possible Cause

The MSBizTalkRFID service depends on Message Queuing, which in turn depends on the Distributed Transaction Coordinator (DTC) service. If the DTC service is using LocalSystem as the Service Account, then the DTC service will not start.

Solution

At the command prompt, run the following command:

sc qc msdtc

  • If the displayed value of SERVICE_START_NAME is LocalSystem, then perform the following steps.

    1. At the command prompt, run the following command:

      net stop msdtc

    2. At the command prompt, run the following command:

      msdtc -uninstall

    3. Open Registry Editor and delete the HKLM\Software\Microsoft\MSDTC key.

    4. At the command prompt, run the following command:

      msdtc -install

    5. At the command prompt, run the following command:

      net start msdtc

    6. At the command prompt, run the following command:

      net start MSMQ

    7. At the command prompt, run the following command:

      net start BizTalkRFID

  • If the displayed value of SERVICE_START_NAME is NetworkService, contact Microsoft Support for further assistance.

MSBizTalkRFID service fails to start with an error message "Socket Address in use"

Symptom

After you install BizTalk Server RFID, you receive the error "Socket Address in use," and the MSBizTalkRFID service fails to start.

Possible Cause

The MSBizTalkRFID service uses the default Web Services Enhancements port 7891. If any other Web service application has been loaded before the RFID service, then port 7891 is already in use and the MSBizTalkRFID service will not start.

Solution

Do one of the following:

  • If possible, change the port that the Web service application uses.

  • Alternatively, change the port that the RFID service uses.

To change the port that the RFID service uses, use the following steps.

Note

These steps assume that you are changing the default port to port 8092. This port number is only an example; select the new port number according to your requirements.

  1. Edit the Rfid.config file located in the \bin folder of BizTalk RFID to include the following code fragment:

    <rfidStore>
       <connectionString>Persist Security Info=False;Integrated Security=SSPI;database=RFIDSTORE;server=YOURSERVERNAME</connectionString>
    </rfidStore>
    <wsConfiguration><wSPort>8092</wSPort></wsConfiguration>   <!-- insert this line of code -->
  2. RFID administration tools use the default WSE port 7891, and changing this port in the rfid.config file will cause RfidClientConsole.exe and RFID Manager to fail. To resolve this, create and place the RfidClientConsole.exe.config and mmc.exe.config files in the \bin folder of BizTalk RFID. Both these files need to have the following content:

    <?xml version="1.0" encoding="utf-8" ?> 
    <configuration>
      <configSections>
        <section name="microsoft.web.services2" type="Microsoft.Web.Services2.Configuration.WebServicesConfiguration, Microsoft.Web.Services2, Version=2.0.3.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
      </configSections>
      <microsoft.web.services2>
            <messaging>
              <executionTimeout value="300" />
                <transports><add scheme="soap.tcp"><defaultPort value = "8092"/></add></transports>
            </messaging>
      </microsoft.web.services2>
    </configuration>
    Note

    The mmc.exe.config file will redirect the snap-in to communicate to the server using the new port only if RFID Admin UI.msc is opened from the \bin folder of BizTalk RFID. This will not work if the snap-in is added explicitly to mmc.exe.

    Note

    If you write your own program using the RFID client proxies—for example, DeviceManagerProxy—you need to explicitly set the proxy port to the same port that the server is using.

RFID Manager does not appear in the Start menu

Symptom

After you install BizTalk Server RFID, RFID Manager does not appear in the Start menu.

Possible Cause

The correct option to install RFID Manager may not have been selected during installation.

Solution

RFID Manager is packaged with the RFID Tools and Client Connector component of BizTalk Server RFID Setup. If you have chosen Custom setup during installation, use the steps listed under Modifying or Repairing BizTalk Server RFID Installation to view the Custom page. On the Custom page, ensure that the RFID Tools and Client Connector component is not cleared.

An administrator is unable to install BizTalk Server RFID on a computer

Symptom

When trying to install BizTalk Server RFID, you get the error message, "Verify that you have sufficient privileges to install system services," even though you have administrator privileges on your computer.

Possible Cause

This is probably because the previous version of BizTalk RFID is not completely removed from your computer.

Solution

Uninstall any previous version of BizTalk RFID, restart your computer, and then try installing BizTalk Server RFID on your computer again.

An error message is displayed indicating that the RFID Store database could not be created.

Symptom

When installing BizTalk Server RFID, you get an error message saying Setup was unable to create the RFID Store database.

Possible Cause

The user specified may not have sufficient privileges, or previous installations of SQL Server may not have been removed completely.

Solution

Perform the following steps:

  1. Ensure that the user who installed BizTalk Server RFID had the required permissions to create the database in SQL Server.

  2. Ensure that any previous installation removals of SQL Server have completed successfully, by removing the MDF files associated with the SQL Server instance. The MDF files can be found in a folder that has the instance name in the SQL Server installation directory.

Error messages are displayed while trying to assign a remote SQL server as the RFIDsink database.

Symptom

You receive errors related to DTC, MSDTC, or remote transaction manager if you configure the RFIDsink database on a remote SQL server.

Possible Cause

Configuration steps to assign a remote SQL server as the RFIDsink database may not have been completed.

Solution

You need to complete some initial configuration steps to enable the remote RFIDsink database to work with BizTalk Server RFID. For more information about these steps, see Preparing to Set up a Remote RFIDsink Database.

You are unable to connect to the RFID service from a client computer

Symptom

You are unable to connect to a BizTalk Server RFID service on a remote computer from a client computer.

Possible Cause

Windows Firewall may be restricting access from and to BizTalk Server RFID.

Solution

You need to allow Rfidservices.exe through the Windows firewall on the RFID server. To do this, click Start, click Control Panel, and then double-click Windows Firewall. On the Exceptions tab, click Add Program, browse to the location of RfidServices.exe, and then click Open. In the Add a Program dialog box, click OK. On the Exceptions tab, click OK.

Setup fails with an error message

Symptom

Setup fails with the error "((ERROR)) Failed to execute immediate command line: "C:\Program Files\BizTalk RFID\bin\ManagedCustomActions.exe "RegisterOOBEventhandlers" %temp%\RegisterOOBEventhandler 0XFFFFFFFF -"

Possible Cause

The BizTalk Server RFID service may have been successfully installed, but failed to start after installation. This can occur if old data exists in the RFIDstore database.

Solution

Review the file %TEMP%\ RfidRegisterOobEventhandlers*.log for additional information about why this failure occurred. In addition, inspect the event logs for more information.

BizTalk Server RFID installation fails on the CreateWMINamespace method

Symptoms

The BizTalk Server RFID installation fails with the error message: Failed to execute deferred command line: "C:\Program Files\BizTalk RFID\bin\ManagedCustomActions.exe" "CreateWMINamespace" "%Temp%\rfidwmi":0xFFFFFFFF".

Cause

The Windows Management Instrumentation (WMI) service may be disabled, or may not be running.

Resolution

Enable the WMI service if it is disabled, and then start the WMI service.

Rollback during uninstallation fails

Symptoms

If you choose to cancel Setup while uninstalling BizTalk Server RFID, actions performed during the procedure will not be rolled back.

Cause

This is by design.

Resolution

If you ran the uninstallation by mistake, and want to keep the product on the computer, reinstall it.

Installation succeeds, but the BizTalk Server RFID service fails to start

Symptoms

During installation with SQL Server authentication type for the RFID configuration database (RFIDstore), the following error message is displayed: "Setup has succeeded, but the service could not be started. Please look at the event viewer for more information". The event viewer has the error: "Cannot open database "RFIDSTORE" requested by the login. The login failed."

Cause

The specified SQL Server user for the SQL Server type authentication is associated with a low-privileged role. For example, the role associated with the SQL Server user may be "Public".

Resolution

To start BizTalk Server RFID after the installation is complete, the SQL Server user (specified in the Database System and RFID Configuration Database Information page of the setup wizard) must have permissions to:

  1. Connect to the RFID configuration database

  2. Execute stored procedures on the RFID configuration database.

To grant the required permissions, execute the following queries in SQL Server:

USE [RFIDSTORE]
SP_GRANTDBACCESS [SQLUser]
GRANT EXECUTE TO [SQLUser]   

On a Windows Vista computer, an error occurs during installation, and Setup rolls back

Symptoms

On a Windows Vista computer, Setup fails with the error: "Could not access VBScript runtime for custom action", and then the failed installation process rolls back.

Cause

During installation, BizTalk Server RFID requires the VBScript engine. When Windows Vista is installed on a computer, by default, the VBScript engine is available on the computer, but is not registered.

Resolution

Manually register the VBScript engine on the computer. To register the VBScript engine, run the following command in a Command Prompt window with Administrator privileges:

regsvr32 vbscript.dll

Installation of BizTalk Server RFID is interrupted with a message related to the Active Directory Marker

Symptom

Setup is interrupted with a message "Creation of the Active Directory Marker failed with error: The server is not operational. Setup will ignore the error and continue".

Cause

During setup, BizTalk Server RFID attempts to connect with the Active Directory server present in the domain. If the computer that you are installing BizTalk Server RFID on is not joined to any domain, this message is displayed.

Solution

You may ignore this message. Click OK to close the message dialog, and continue BizTalk Server RFID installation.

Top of page

Known Issues

BizTalk Server RFID has the following known issues:

Log files for the BizTalk Server RFID service, providers, or processes are empty

Symptom

BizTalk Server RFID functions normally, but log files do not have any log entries.

Cause

A custom tool can have a file handle to a log file. When the log file reaches the file size limit, BizTalk Server RFID attempts to rotate the log file. If the custom tool file handle is active when BizTalk Server RFID attempts to rotate the log file, the logger stops writing information to the log file.

Solution

Restart the BizTalk Server RFID service, or the affected provider or process. For more information, refer to the KB article: http://support.microsoft.com/kb/941995/en-us.

-----------------------------------------------------------------------------------------------

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, SharePoint, Windows, Windows Server, and Windows Vista are trademarks of the Microsoft group of companies.

All other trademarks are property of their respective owners.

Top of page