Supported Deployment Configurations

Prerequisites

Hardware

Software

Security

Configuring the Software Environment for BizTalk Server RFID

Installing and Configuring IIS 7.0 on Windows Server 2008

Registering .NET Framework Script Mappings with IIS 7.0

Installing and Configuring IIS 6.0 on Windows Server 2003

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 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

Configuring the MSBizTalkRFID Service to Work with a Non-Default Web Site in IIS

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 Server 2008

    • Windows Server 2003 Service Pack 2 (SP2)

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 Server 2008

    • Windows Server 2003 SP2

  • 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 Server 2008

    • Windows Server 2003 SP2

  • Microsoft Internet Information Services (IIS)

    • IIS 7.0 on Windows Server 2008 computers

    • IIS 6.0 on Windows Server 2003 computers

  • 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

  • World Wide Web Publishing Service on Windows Server 2003 or Windows Server 2008 computers

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

Configuring the Software Environment for BizTalk Server RFID

Installing and Configuring IIS 7.0 on Windows Server 2008

Computers running Windows Server 2008 must have Internet Information Services (IIS) 7.0 installed to enable provider code to run as distinct worker processes.

To install IIS 7.0 on a computer running Windows Server 2008
  1. Click Start, point to Administrative Tools, and then click Server Manager.

  2. In the left pane, select Roles, and then in the right pane, click Add Roles.

    The Add Roles Wizard is displayed.

  3. On the Before You Begin page, click Next.

  4. On the Select Server Roles page, from the list of roles displayed, select Web Server (IIS), and then click Next.

    Note

    If the role has dependencies on other features, a dialog box is displayed to confirm the installation of additional features. In the dialog box, click Add Required Role Services, and then click Next.

  5. On the Web Server (IIS) page, click Next.

  6. On the Select Role Services page, a list of IIS 7.0 features is displayed. Ensure that the IIS 6 Metabase Compatibility feature is selected. Select any other features, if required, and then click Next.

    Note

    If the role has dependencies on other features, a dialog box is displayed to confirm the installation of additional features. In the dialog box, click Add Required Role Services, and then click Next.

  7. On the Confirm Installation Selections page, click Install.

    The Installation Progress page displays the status of actions performed by the Add Roles Wizard.

  8. Review the information displayed on the Installation Results page, and then click Close.

Configuring IIS 7.0 and ASP.NET 2.0

You must configure IIS to work with ASP.NET.

Note

Setup performs a check, and will not proceed if ASP.NET 2.0 is not installed and configured correctly.

To configure IIS 7.0 and ASP.NET 2.0
  1. Click Start, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.

  2. In the Internet Information Services (IIS) Manager console, from the left pane, select the local computer.

    IIS-related features installed on the computer are displayed in the right pane.

  3. In the list of IIS features, double-click ISAPI and CGI Restrictions, and verify if ASP.NET 2.0 is installed and in an allowed state. If ASP.NET 2.0 is installed and is in an allowed state, IIS and ASP.NET have already been configured, and you may skip the remaining steps in this procedure.

  4. In a Command Prompt window, browse to the ASP.NET 2.0 Framework folder. This directory is generally %WinDir%\Microsoft.NET\Framework\v2.0.50727.

    Note

    If your operating system is a 64-bit architecture, the directory is generally %WinDir%\Microsoft.NET\Framework64\v2.0.50727.

  5. To register ASP.NET 2.0 Framework with IIS, run the command:

    aspnet_regiis -i -enable

  6. In Administrative Tools, click Services, select IIS Admin Service, and then restart the service.

Registering .NET Framework Script Mappings with IIS 7.0

You must register .NET Framework 3.0 script mappings with IIS.

To register .NET Framework Script Mappings with IIS 7.0
  1. Click Start, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.

  2. In the Internet Information Services (IIS) Manager console, from the left pane, select the local computer.

    IIS-related features installed on the computer are displayed in the right pane.

  3. In the list of IIS features, double-click Handler Mappings, and verify if mappings for *.svc are installed and enabled. If the mappings are installed and enabled, IIS and ASP.NET have already been configured, and you may skip the remaining steps in this procedure.

  4. In a Command Prompt window, browse to the directory: %WinDir%\Microsoft.NET\Framework\v3.0\Windows Communication Foundation.

    Note

    If your operating system is a 64-bit architecture, the directory is generally %WinDir%\Microsoft.NET\Framework64\v3.0\Windows Communication Foundation.

  5. To register ASP.NET 3.0 mappings with IIS 7.0, run the command:

    ServiceModelReg.exe -r

  6. In the Handler Mappings pane, verify if the mappings have been added, and then close the Internet Information Services (IIS) Manager console.

Installing and Configuring IIS 6.0 on Windows Server 2003

Computers running Windows Server® 2003 must have Internet Information Services (IIS) 6.0 installed to enable provider code to run as distinct worker processes.

Important

For BizTalk Server RFID, IIS must be configured to run in native mode. BizTalk Server RFID is not supported in IIS 5.0 Isolation mode.

To install IIS 6.0 on a computer running Windows Server 2003
  1. In Control Panel, click Add or Remove Programs, and then click Add/Remove Windows Components.

  2. In the Windows Components Wizard, select Application Server, and then click Details.

  3. In the Application Server dialog box, select all subcomponents except Enable network DTC access, and then click OK.

  4. Click Next, provide the installation CD or location of Windows Server 2003 installation files if necessary, and then click Finish.

Configuring IIS 6.0 and ASP.NET 2.0

You must configure IIS to work with ASP.NET.

Note

Setup performs a check, and will not proceed if ASP.NET 2.0 is not installed and configured correctly.

To configure IIS 6.0 and ASP.NET 2.0
  1. Click Start, point to Control Panel, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.

  2. In the IIS console tree, browse to Web Service Extensions in the local computer.

  3. Check if ASP.NET 2.0 is installed and in the Allowed state. If yes, proceed to step 6.

  4. In a Command Prompt window, browse to the ASP.NET 2.0 Framework folder. This directory is generally %windir%\Microsoft.NET\Framework\v2.0.50727. To register ASP.NET 2.0 Framework with IIS, run the command:

    aspnet_regiis -i -enable

  5. In Administrative Tools, click Services, select IIS Admin Service so that its status shows as "Started," and then restart the service.

  6. In the IIS console tree, double-click Web Sites, right-click Default Web Site, and then click Properties.

  7. In the Default Web Site Properties dialog box, click the ASP.NET tab, and in the ASP.NET version list, click 2.0.50727.

  8. In Administrative Tools, click Services, select IIS Admin Service so that its status shows as "Started," and then restart the service.

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 RFID Server 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 Microsoft BizTalk Server RFID 2009 is not supported.

Important

To install BizTalk Server RFID 2009, you must first uninstall BizTalk RFID Server 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 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 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 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 RFID v1,0, and would like to upgrade to BizTalk Server RFID 2009, read the installation instruction outlined in the section Upgrading from BizTalk Server RFID 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 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. In Windows Server 2003 or Windows Server 2008, by default, BizTalk Server RFID uses the RFID Service account and Microsoft BizTalk RFID Worker Process account created during installation. On the Set up the RFID Service and RFID Process Accounts page:

    • To change the service account used to access the RFID Store database, in the RFID Service Account area, click Specify user name and password, and then type the user credentials of the RFID Service account.

    • To change the account used for worker processes, in the Microsoft BizTalk RFID Worker Process Account area, click Specify user name and password, and then type the user credentials of the Worker Process account.

    Click Next.

    Note

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

    Important

    The user specified for the Service account must be a member of the Administrator group on the local computer. Also, 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 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 R2

You can upgrade your existing BizTalk Server RFID 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 R2
  1. Uninstall any previous version of BizTalk Server RFID.

  2. Use the procedure outlined in the section on Installing BizTalk 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 sRFID 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 RFID Setup.exe file, and then selecting Remove in the options.

Silent Mode Operations

This section discusses how to install and remove BizTalk Server 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.

    ACCOUNTNAME

    RFIDWorkerProcessAcc

    Worker Process account under which the IIS application pools run.

    PASSWORD

    Blank

    If an account name has been specified, then the corresponding password must be specified.

    This is hidden and will be masked in the log file.

    SERVICE_ACCOUNTNAME

    RFIDSvcAcc

    Service logon account for BizTalk Server RFID. Make sure that the account has permission to access the SQL server that you specify by using the SQLSERVERINSTANCE property.

    SERVICE_PASSWORD

    Blank

    If an account name has been specified, then the corresponding password must be specified.

    This is hidden and will be masked in the log file.

    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” ACCOUNTNAME=”domain\account” PASSWORD=”mypwd” /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 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 Server 2008 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
  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.

  6. If the BizTalk Server RFID computer or the remote computer is running Windows Server 2003 or Windows Server 2008, you must follow the additional steps described below.

    1. Click Start, point to Control Panel, and then click Add or Remove Programs.

    2. Click Add/Remove Windows Components.

    3. Select Application Server, and then click Details.

    4. Select Enable network DTC access, and then click OK.

    5. Click Next, and then click Finish.

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 (%windir%\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.

Configuring the MSBizTalkRFID Service to Work with a Non-Default Web Site in IIS

In Windows Server 2003 and Windows Server 2008, processes and providers are hosted in IIS. During installation, BizTalk Server RFID configures the default Web site for all process- and provider-related actions. However, another application—for example, Windows SharePoint® Services—may have already been configured to use the default Web site in IIS. In such a scenario, an administrator can create and configure a new Web site for BizTalk Server RFID. This is a two-step process:

  1. Create a new Web site.

  2. Configure the MSBizTalkRFID service to use the new Web site.

Important

You must be a member of the Administrators group on the local computer to perform the following procedure.

To create a new Web site
  1. In IIS Manager, expand the local computer, right-click the Web Sites folder, point to New, and then click Web Site. The Web Site Creation Wizard appears.

  2. Click Next.

  3. In the Description box, type the name of your site (for example, BizTalkRFIDWebsite), and then click Next.

  4. Type or click the IP address (the default is All Unassigned), TCP port, and host header (for example, www.mysite.com) for your site, and then click Next.

    Note

    Specify an unused TCP port, and add the port to the list of exceptions in Windows Firewall.

  5. In the Path box, type or browse to the directory %systemdrive%\inetpub, create a new directory (for example, RFID), and set the path to the new directory (for example, %systemdrive%\inetpub\RFID). Select Allow anonymous access to this website, and then click Next.

  6. Select the check boxes for the Web site access permissions. Select Read, Run scripts, Execute, and Browse, and then click Next.

  7. Click Finish.

    A new Web site has been created.

  8. Click the Web Sites node, and then note the Identifier of the new Web site. The Identifier is a unique number assigned to each Web site, and is displayed in the right pane of IIS Manager.

After a new Web site is created, use RFID Manager to configure the MSBizTalkRFID service to use the new Web site.

To connect to a non-default BizTalk Server RFID Web site
  1. In RFID Manager, expand RFID Services Administration, right-click the server node (server for which the new Web site has been created), and then click Properties.

  2. On the advanced page, type the port number and identifier of the non-default Web site created for BizTalk Server RFID, and then click OK.

Modifying a Web Site Identifier

RFID Manager may not accept an identifier assigned to a new Web site, if it is a very large number. Use these commands to modify the identifier of the Web site if necessary:

CSCRIPT %SYSTEMDRIVE%\Inetpub\AdminScripts\adsutil.vbs STOP_SERVER W3SVC/<Large_WebsiteID>
CSCRIPT %SYSTEMDRIVE%\Inetpub\AdminScripts\adsutil.vbs MOVE W3SVC/<Large_WebsiteID> W3SVC/<New_WebsiteID>
CSCRIPT %SYSTEMDRIVE%\Inetpub\AdminScripts\adsutil.vbs START_SERVER W3SVC/<New_WebsiteID>
Important

The identifier you choose must be a unique, positive, non-zero integer.

For example, if the Web site identifier that RFID Manager does not accept is 51829689933, and you would like to assign a new identifier 1987, you need to run the following commands:

CSCRIPT %SYSTEMDRIVE%\Inetpub\AdminScripts\adsutil.vbs STOP_SERVER W3SVC/51829689933
CSCRIPT %SYSTEMDRIVE%\Inetpub\AdminScripts\adsutil.vbs MOVE W3SVC/51829689933 W3SVC/1987
CSCRIPT %SYSTEMDRIVE%\Inetpub\AdminScripts\adsutil.vbs START_SERVER W3SVC/1987

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.

The ASP.NET tab is not available in the Web Sites Properties dialog box of IIS

Possible Cause

This error can occur if the removal of a Beta 2 version of the ASP.NET Framework did not delete old entries from the registry.

Solution

  1. Locate the following subkeys in the registry:

    • HKEY_CLASSES_ROOT\CLSID\{7D23CCC6-A390-406E-AB67-2F8B7558F6F6}\InprocServer32

    • HKEY_CLASSES_ROOT\CLSID\{FD5CD8B1-6FE0-44F3-BBFB-65E3655B096E} \InprocServer32

    • HKEY_CLASSES_ROOT\CLSID\{FEDB2179-2335-48F0-AA28-5CDA35A2B36D}\InprocServer32

  2. Expand the InProcServer32 subkey, and delete any entries not named 2.0.0.0 (for example, delete 2.0.36.0).

  3. Restart IIS.

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 Server 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 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.

Processes and providers fail to start

Symptom

After a fresh install of BizTalk Server RFID, providers or processes fail to start and you see system event log entries like:

A process serving application pool 'Contoso03b708f3-b811-45b4-869f-4587aee86241' reported a failure. The process id was '6312'. The data field contains the error number.

The data field contains the number 80070005.

Possible Cause

IIS does not recognize the identity of the application pool.

Solution

Restart the World Wide Web Publishing service (w3svc).

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 Server 2003 or Windows Server 2008 computer, an error occurs during installation, and Setup is interrupted

Symptoms

During the installation process, on a Windows Server 2003 or Windows Server 2008 computer, setup is interrupted with an error: "Setup could not successfully register and start the LLRP provider due to an error. Setup will ignore this error and continue. To resolve this issue, ensure that the BizTalk RFID service is running, and then register/start the LLRP provider by using RFID Manager".

Cause

During installation, BizTalk Server RFID checks if various prerequisites are installed, registered, or configured correctly. This error occurs when ASP.NET is not registered and configured correctly.

Resolution

Manually configure/register ASP.NET. Refer to the section on Configuring the Software Environment for BizTalk RFID for additional guidance on how to resolve this issue. In addition to this, you must manually register and start the LLRP provider in RFID Manager.

On a Windows Server 2003 or Windows Server 2008 computer, providers and processes do not start

Symptoms

BizTalk RFID has installed correctly, and the BizTalk RFID service is running. However, providers and processes fail to start.

Cause

On a Windows Server 2003 or Windows Server 2008 computer, BizTalk RFID uses the default website in IIS to host providers and processes. If the default website is stopped, providers and processes will fail to start. Certain software force the default website to stay in a stopped state. For example, if Microsoft® Office Sharepoint® Server 2007 is installed on the same computer, it may have forced the default website to stop.

Resolution

Ensure that the default website is in a started state. When the default website is in the started state, you must register and start the providers and processes.

Important

In IIS, ensure that the port number of the default website is the same as the port number that BizTalk RFID server is using. Use RFID Manager to view or modify the port number of a BizTalk RFID server. In RFID Manager, right-click a server, click Properties, and then view or modify port settings in the Advanced tab.

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