BizTalk RFID Mobile Installation

Prerequisites for Installing BizTalk RFID Mobile

Installation Sequence for Prerequisites

Installing the .NET Compact Framework 2.0 Service Pack 2 on a Mobile Device

Installing SQL Server Compact Edition 3.5 on a Mobile Device

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

Compatibility between BizTalk RFID Mobile, and Providers or Mobile Applications Developed Using Different Versions of .NET Compact Frameworks 2.0 and 3.5

BizTalk RFID Mobile Setup Components

Installing BizTalk RFID Mobile in Interactive Mode on a Computer

Installing BizTalk RFID Mobile in Interactive Mode on a Mobile Device

Repairing BizTalk RFID Mobile in Interactive Mode

Removing BizTalk RFID Mobile from a Computer in Interactive Mode

Log Files

Known Issues

This document provides hardware and software requirements and detailed instructions for installing Microsoft® BizTalk® RFID Mobile 2009.

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

BizTalk RFID Mobile Installation

BizTalk RFID Mobile setup files include:

  • BizTalk RFID Mobile APIs

    BizTalk RFID Mobile includes a set of libraries that can be used to develop BizTalk RFID-based mobile RFID applications, samples, and providers for pocket PCs (P/PCs).

  • BizTalk RFID Management application and a sample application

    The BizTalk RFID Management and sample applications can be installed on a P/PC that has an RFID module attached. The RFID Management application enables a Windows®-powered P/PC to be used as a mobile RFID reader.

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

Prerequisites for Installing BizTalk RFID Mobile

This section lists the hardware and software requirements for installing BizTalk RFID Mobile.

Hardware Requirements

The minimum hardware requirements for BizTalk RFID Mobile installation are:

  • A P/PC using an ARMV4I processor

  • Disk space:

    • On a Windows Mobile® device, 2 megabytes (MB)

    • On a Windows CE device, 3 megabytes (MB)

  • Provision to connect (physically or remotely) to the P/PC

Software Requirements

Install the following software before you begin installing BizTalk RFID Mobile on a mobile device:

  • One of the following operating systems on your P/PC:

    • Microsoft Windows CE 5.0

    • Microsoft Windows Mobile 5.0 for Pocket PC

    • Microsoft Windows Mobile 6.0 (Classic or Professional)

    • Microsoft Windows Mobile 6.1 (Professional)

  • One of the following .NET Compact Frameworks

  • Microsoft SQL Server® Compact Edition 3.5 (SQL Server CE).

  • Software to enable transfer of files between a computer and your device (for example, Microsoft ActiveSync® or Windows Mobile Device Center).

    Note

    On Windows Server 2008 computers, by default, Windows Mobile Device Center is partially installed. For information on how to complete the installation, browse to: Windows Mobile Device Center troubleshooting guide.

Important

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

BizTalk RFID Mobile Application Development Requirements

To develop software applications based on the BizTalk RFID Mobile SDK, the following prerequisites must be installed on a computer:

  • One of the following operating systems on your computer: Microsoft Windows Server® 2008; Windows Server 2003 R2 (except the Web Edition); Windows Server 2003 SP2 (except the Web Edition); Microsoft Windows Small Business Server 2003 with SP1 or SP2; Microsoft Windows Vista® Ultimate; Windows Vista Enterprise; Windows Vista Business; Microsoft Windows XP Professional

    • Microsoft Visual Studio® 2005 or Visual Studio 2008

      Important

      Smart Device development is not supported on Express versions of Visual Studio.

    • One of the following SDKs on your computer: Windows CE 5.0, Windows Mobile 5.0 for Pocket PC, Windows Mobile 6.0 (Classic or Professional), Windows Mobile 6.1 (Professional)

      Note
      • Visual Studio 2008 includes the SDK and emulator images for Windows Mobile 5.0. No additional software may be required.

      • Visual Studio 2005 includes the SDK and emulator images for Pocket PC 2003, and requires the installation of the Windows Mobile 5.0, Windows Mobile 6.0, or Windows Mobile 6.1 SDK.

  • One of the following .NET Compact Frameworks

  • SQL Server Compact Edition 3.5 (SQL Server CE).

  • Software to enable transfer of files between a computer and your device (for example, Microsoft ActiveSync® or Windows Mobile Device Center).

Installation Sequence for Prerequisites

To ensure that BizTalk RFID Mobile installs on a mobile device without any errors, ensure that the prerequisites are installed in the suggested sequence: install the Microsoft .NET Compact Framework 2.0 first, and then install SQL Server CE.

Installing the .NET Compact Framework 2.0 Service Pack 2 on a Mobile Device

Follow these instructions to download and install the .NET Compact Framework on a mobile device.

To install .NET Compact Framework 2.0 Service Pack 2
  1. Download the Windows Installer package for the .NET Compact Framework 2.0 Service Pack 2 to a computer. The installation package is available at: http://go.microsoft.com/fwlink/?LinkID=108252.

    This downloads a file named NETCFSetupv2.msi to your computer.

  2. Establish a connection between the computer and a mobile device. You can use software like Microsoft ActiveSync 4.0 or later, or connect to the mobile device by using a wireless network.

    To install using ActiveSync

    1. Dock the mobile device with the computer.

    2. On the computer, double-click NETCFSetupv2.msi.

    3. The installer will install the .NET Compact Framework on the computer, and then on the mobile device.

    To install without ActiveSync

    1. Connect the computer and mobile device by any alternative method (for example, over a wireless network).

    2. On the computer, browse to the location:

      %programfiles%\Microsoft.NET\SDK\CompactFramework\v2.0\WindowsCE\wce500\armv4i

    3. Copy the appropriate .NET Compact Framework installer CAB file to the mobile device:

      • For a Windows Mobile P/PC device, copy the file: NETCFv2.wm.armv4i.cab.

      • For a Windows CE 5.0 device, copy the file: NETCFv2.wce5.armv4i.cab.

    4. On the mobile device, locate and tap the CAB file. The .NET Compact Framework will be installed on the mobile device.

Installing SQL Server Compact Edition 3.5 on a Mobile Device

Follow these instructions to download and install SQL Server Compact Edition 3.5 (SQL Server CE) on a mobile device.

Important

You can create BizTalk RFID Mobile applications by using Microsoft Visual Studio. If you are developing an application that accesses SQL Server CE, and plan to deploy and run it on the emulator through Visual Studio, ensure that SQL Server CE is also installed on the computer running Visual Studio (in addition to installing SQL Server CE on the emulator).

To install SQL Server Compact Edition 3.5 on a mobile device
  1. Download the Windows Installer package for SQL Server CE to a computer. The installation package is available at: http://go.microsoft.com/fwlink/?LinkID=121673.

    This downloads a file named SSCEDeviceRuntime-ENU to your computer.

  2. Establish a connection between the computer and a mobile device. You can use software like Microsoft ActiveSync 4.0 or later, or connect to the mobile device by using a wireless network.

    To install using ActiveSync

    1. Dock the mobile device with the computer.

    2. On the computer, double-click SSCEDeviceRuntime-ENU.

    3. The installer will install SQL Server Compact Edition 3.5 on the computer, and then on the mobile device.

    To install without ActiveSync

    1. Connect the computer and mobile device by any alternative method (for example, over a wireless network).

    2. On the computer, browse to the location:



      %programfiles%\Microsoft SQL Server Compact Edition\v3.5\Devices\wce500\armv4i

    3. Copy the appropriate SQL Server Compact Edition 3.5 CAB file to the mobile device:

      • For a Windows Mobile P/PC device, copy the file: sqlce.ppc.wce5.armv4i.CAB.

      • For a Windows CE 5.0 device, copy the file: sqlce.wce5.armv4i.CAB.

    4. On the mobile device, locate and tap the CAB file to install SQL Server Compact Edition 3.5.

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

If you are installing BizTalk RFID Mobile 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.

Compatibility between BizTalk RFID Mobile, and Providers or Mobile Applications Developed Using Different Versions of .NET Compact Frameworks 2.0 and 3.5

BizTalk RFID Mobile is based on .NET Compact Framework 2.0. However, a provider or a mobile application may have been written for .NET Compact Framework 3.5. To ensure that BizTalk RFID Mobile, and providers or mobile applications (built using the BizTalk RFID Mobile API) function correctly, consider the following:

  • Keeping the .NET Framework version of BizTalk RFID Mobile constant (.NET Framework 2.0):

    • If the mobile application has been built for .NET Compact Framework 2.0, and the provider is built for .NET Compact Framework 3.5: The BizTalk RFID Mobile environment and providers execute in the application context, and the application developer must include a configuration file that sets the execution environment to .NET Compact Framework 3.5. For more information on how to do this, refer to .NET Framework Developer's Guide (How to: Configure Runtime Version).

    • If the mobile application and provider have both been built for .NET Compact Framework 3.5, then no additional steps are required.

    • If the mobile application has been built for .NET Compact Framework 3.5, and the provider is built for .NET Compact Framework 2.0, then no additional steps are required.

BizTalk RFID Mobile Setup Components

BizTalk RFID Mobile Setup contains the following components or features:

  • BizTalk RFID Mobile API libraries (required to develop or run applications and providers for the BizTalk RFID Mobile platform)

  • BizTalk RFID Mobile CAB file for mobile devices. This CAB file can be copied and installed on a mobile device. When BizTalk RFID Mobile is installed on a mobile device, the following components are deployed:

    • BizTalk RFID Management application

    • Sample BizTalk RFID CE provider

    • Sample program (simulates tag reads and writes)

Installing BizTalk RFID Mobile in Interactive Mode on a Computer

This section explains how to install BizTalk RFID Mobile on your computer.

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

To install BizTalk RFID Mobile on a computer in interactive mode
  1. On your computer, in the folder containing BizTalk RFID Mobile installation files, locate and double-click setup.exe.

  2. On the Welcome to the Microsoft BizTalk RFID Mobile Setup Wizard page, click Next.

  3. On the End-User License Agreement page, review the End-User License Agreement (EULA), select the I accept the terms in the License Agreement option, and then click Next.

    Note

    To print the EULA, copy the text available on the EULA page to a document, and then print the document.

  4. On the Ready to Install page, review the installation details, and then click Install to begin the installation process.

  5. When the installation is complete, the following BizTalk RFID Mobile files are copied to your computer:

    • Feature: BizTalk RFID Mobile CAB file

      Description: The CAB setup file required to install BizTalk RFID Mobile on a mobile device. For more information, see Installing the BizTalk RFID Mobile on a Mobile Device in Interactive Mode.

      Location: %RFIDInstallDir%\SDK\Mobile\v1.1\bin\wce500\armv4i

      Files: biztalkrfidmobile.enu.wce5.armv4i.CAB, biztalkrfidmobile.enu.wm.armv4i.CAB

    • Feature: Application development using BizTalk RFID Mobile APIs

      Description: Libraries used by applications developed by using BizTalk RFID Mobile APIs.

      Location: %RFIDInstallDir%\SDK\Mobile\v1.1\bin

      Files: Microsoft.Rfid.Design.dll, Microsoft.Rfid.Llrp.dll, Microsoft.Rfid.ObjectModelExtensions.dll, Microsoft.Rfid.SpiSdk.dll, and Microsoft.Rfid.Util.dll

  6. To be able to connect with BizTalk RFID-based mobile applications from RFID Manager, ensure that port number 5084 is added to the list of port exceptions in Windows Firewall settings on the computer that has the RFID service running.

Note

If BizTalk Server RFID is already installed on the desktop computer, BizTalk RFID Mobile is installed in the %rfidinstalldir% folder. If BizTalk Server RFID is not installed on the desktop computer, the components are installed at %programfiles%\Microsoft BizTalk RFID\ folder.

Installing BizTalk RFID Mobile in Interactive Mode on a Mobile Device

This section explains how to install BizTalk RFID Mobile on your P/PC.

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

To install BizTalk RFID Mobile on a mobile device in interactive mode
  1. On your computer, in the folder containing the BizTalk RFID Mobile installation files, browse to the folder %RFIDInstallDir%\SDK\Mobile\v1.1\bin\wce500\armv4i.

  2. Copy the appropriate installation CAB file to your P/PC.

    • For a Windows Mobile P/PC device, copy the file: biztalkrfidmobile.enu.wm.armv4i.CAB.

    • For a Windows CE 5.0 device, copy the file: biztalkrfidmobile.enu.wce5.armv4i.CAB.

  3. Locate the CAB file on your P/PC, and then click it.

    • If no storage card is available in your P/PC, a progress bar appears and indicates the status of the installation process. Proceed to step 4.

    • If a storage device is detected on your P/PC, you will be prompted for the location to which the CAB file must be installed. Select an option and proceed. A progress bar appears and indicates the status of the installation process.

  4. When the installation is complete, the following BizTalk RFID Mobile features are installed on your P/PC:

    • Feature: Sample provider

      Description: A sample Windows CE DSPI provider implementation

      Folder: \My Documents\MyFirstCEProvider

      File: MyFirstCEProvider.dll

    • Feature: RFID Management Application

      Description: Application that demonstrates how to use BizTalk RFID Mobile Object Model (OM) calls for authoring applications for the BizTalk RFID Mobile platform.

      Location: %programfiles%\BizTalkRFIDMobile

      File: ManagementApp.exe

    • Feature: Sample program (ReadTagsApp.exe)

      Description: A sample application that demonstrates sending synchronous and asynchronous commands to an RFID module on a mobile device that uses the BizTalk RFID Mobile platform.

      Location: %programfiles%\BizTalkRFIDMobile

      File: ReadTagsApp.exe

    • Feature: Application development using BizTalk RFID Mobile APIs

      Description: Libraries used by applications developed by using BizTalk RFID Mobile APIs.

      Location: \Windows

      Files: Microsoft.Rfid.Design.dll, Microsoft.Rfid.Llrp.dll, Microsoft.Rfid.ObjectModelExtensions.dll, Microsoft.Rfid.SpiSdk.dll, and Microsoft.Rfid.Util.dll

Repairing BizTalk RFID Mobile in Interactive Mode

This section outlines the steps to repair a BizTalk RFID Mobile installation.

To repair a BizTalk RFID Mobile installation
  1. Click Start, point to Control Panel, and then click Add or Remove Programs.

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

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

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

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

  6. On the Completing the Microsoft BizTalk RFID Mobile Setup Wizard page, click Finish.

Removing BizTalk RFID Mobile from a Computer in Interactive Mode

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

To remove BizTalk RFID Mobile in interactive mode
  1. Click Windows, click Settings, and then click the System tab.

  2. Click Remove Programs.

  3. From the list of installed programs, select Microsoft BizTalk RFID Mobile, and then click Remove.

    BizTalk RFID Mobile is uninstalled.

Top of page

Log Files

On a computer, BizTalk RFID Mobile-related installation log files are stored in the default Windows Temp folder. To open this folder, run the following command in a Command Prompt window:

cd %temp%

The name of the installation log file is RfidMobileSetup(mmddyyyy hhmmss).log.

On a mobile device, if the installation procedure fails, you can use the BizTalkRFID.log file created in the root directory to find and troubleshoot the cause of the error.

Other log files are stored in the My Device%programfiles%\BizTalkRFIDMobile\Logs folder. Any logs generated by applications developed by using BizTalk RFID Mobile APIs are available in this folder.

Top of page

Known Issues

BizTalk RFID Mobile has the following known issues:

On a mobile device, BizTalk RFID Mobile setup fails, even though all prerequisites have been installed

Symptom

On a mobile device, the setup process fails, even though prerequisites have been installed. The installation log file indicates that the failure occurred because SQL Server CE 3.5 is not available.

Cause

If SQL Server CE 3.1 and SQL Server CE 3.5 are installed on the mobile device, when SQL Server 3.1 is uninstalled, certain registry keys related to SQL Server 3.5 are deleted. During the BizTalk RFID Mobile installation process, setup checks for SQL Server CE 3.5 registry keys, and fails when keys cannot be found (even though SQL Server CE 3.5 is available on the mobile device). The setup process is cancelled.

Solution

Reinstall SQL Server CE 3.5, and then try to install BizTalk RFID Mobile again.

Caution

Reinstalling SQL Server CE 3.5 may require the mobile device to be restarted, or cause other applications using SQL Server CE 3.5 to fail.

BizTalk RFID Mobile 2009 installation fails, and no message is displayed to indicate the cause of failure

Symptom

On a mobile device, the installation procedure for BizTalk RFID Mobile 2009 fails with no message.

Cause

An earlier version of BizTalk RFID Mobile may be installed on the mobile device. The installation procedure for BizTalk RFID Mobile 2009 fails, if you try to install the new BizTalk RFID Mobile 2009 CAB file on a mobile device that already has an earlier version of BizTalk RFID Mobile installed.

Solution

If the installation procedure fails on a mobile device, you can use the BizTalkRFID.Log file created in the root directory to find and troubleshoot the cause of the error. Examine the installation log file, and look for a message: “ERROR : A previous version of Microsoft BizTalk RFID Mobile is already installed. To install Microsoft BizTalk RFID Mobile 2009, uninstall the previous version, and then try again.”

Uninstall the previous version of BizTalk RFID Mobile and try to install BizTalk RFID Mobile 2009 again.

On a Windows Mobile P/PC, setup is interrupted due to an unsigned .cab file

Symptom

On a Windows Mobile P/PC, when you click the installation .cab file, a message is displayed asking if the file must be trusted because it is not signed.

Cause

During installation, Windows Mobile P/PCs check if the .cab setup files are signed. The current BizTalk RFID Mobile installation .cab file is not signed, and this causes the operating system to ask for confirmation to proceed.

Solution

Click the appropriate option to allow installation to continue.

On a Windows Mobile P/PC, when an error occurs, sometimes the error message is "An error message cannot be displayed because an optional resource assembly containing it cannot be found"

Symptom

When an error occurs on a mobile device, the error message is not displayed because a required resource file is not found.

Cause

The resource assembly required to display the error message is not installed by default.

Solution

The appropriate resource files must be installed on the mobile device. To install .NET Compact Framework resource files, do the following:

To install .NET Compact Framework resource files
  1. Verify if the .NET Compact Framework 2.0 Service Pack 2 or later is installed on your computer. If it is installed, proceed to step 3.

  2. Download and install the .NET Compact Framework 2.0 Service Pack 2 on your computer. To install the .NET Compact Framework 2.0 Service Pack 2, refer to the instructions in the Installing the .NET Compact Framework 2.0 Service Pack 2 on a Mobile Device section.

  3. On your computer, browse to the location %programfiles%\Microsoft.NET\SDK\CompactFramework\v2.0\WindowsCE\Diagnostics, and then copy the appropriate resource CAB file to the mobile device.

  4. On the mobile device, locate and tap the CAB file to install the resource pack.

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

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, ActiveSync, BizTalk, Visual Studio, Windows, Windows Mobile, 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