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

Copyright

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

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 (http://go.microsoft.com/fwlink/?LinkID=140809).

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: Windows Server 2012, Windows Server 2008 R2 SP1, Windows 7 SP1, Windows 8.

    • Microsoft ® Visual Studio ® 2012

      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)

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

Important

You must first install the .NET Compact Framework and only then install SQL Server CE to avoid errors during BizTalk RFID Mobile installation.

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 Windows Mobile Device Center or Microsoft ActiveSync 4.0 or later, or connect to the mobile device by using a wireless network.

    To install using Windows Mobile Device Center or 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

      • On a 64-bit computer, browse to the location:
      • %programfiles(x86)%\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 Windows Mobile Device Center or Microsoft ActiveSync 4.0 or later, or connect to the mobile device by using a wireless network.

    To install using Windows Mobile Device Center or 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.

    4. On the computer, browse to the location:

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

      Warning
      • On a 64-bit computer, browse to the location:
      • %programfiles(x86)%\Microsoft SQL Server Compact Edition\v3.5\Devices\wce500\armv4i
    5. 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.

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

    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

      • On a 64-bit computer, browse to the location:
      • %programfiles(x86)%\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 Server 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.

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 BizTalk RFID Mobile .

To install BizTalk RFID Mobile on a computer in interactive mode
  1. Insert the BizTalk Server 2013 installation disk into the DVD-ROM drive.

  2. On the Start screen, click Install Microsoft BizTalk RFID Mobile.

    The Microsoft BizTalk RFID Mobile Setup Wizard is displayed.

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

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

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

  6. 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 BizTalk RFID Mobile in Interactive Mode on a Mobile Device.

      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

  7. 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 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 Programs and Features.

  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 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 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 fails, if you try to install the new BizTalk RFID Mobile 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, uninstall the previous version, and then try again.”

Uninstall the previous version of BizTalk RFID Mobile and try to install BizTalk RFID Mobile 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.

Top of page

Copyright

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.

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