| 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 BizTalk RFID Mobile Setup Components Installing the BizTalk RFID Mobile in Interactive Mode on a Computer Installing the 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 the 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/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)
-
.NET Compact Framework 2.0 Service Pack 2.
-
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®).
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 |
-
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.
-
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 using a wireless network.
To install using ActiveSync
-
Dock the mobile device with the computer.
-
On the computer, double-click NETCFSetupv2.msi.
-
The installer will install the .NET Compact Framework on the computer, and then on the mobile device.
To install without ActiveSync
-
Connect the computer and mobile device by any alternative method (for example, over a wireless network).
-
On the computer, browse to the location:
%programfiles%\Microsoft.NET\SDK\CompactFramework\v2.0\WindowsCE\wce500\armv4i
-
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.
-
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 |
-
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.
-
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 using a wireless network.
To install using ActiveSync
-
Dock the mobile device with the computer.
-
On the computer, double-click SSCEDeviceRuntime-ENU.
-
The installer will install SQL Server Compact Edition 3.5 on the computer, and then on the mobile device.
To install without ActiveSync
-
Connect the computer and mobile device by any alternative method (for example, over a wireless network).
-
On the computer, browse to the location:
%programfiles%\Microsoft SQL Server Compact Edition\v3.5\Devices\wce500\armv4i
-
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.
-
On the mobile device, locate and tap the CAB file to install SQL Server Compact Edition 3.5.
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 the 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 the 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 |
-
On your computer, in the folder containing BizTalk RFID Mobile installation files, locate and double-click setup.exe.
-
On the Welcome to the Microsoft BizTalk RFID Mobile Setup Wizard page, click Next.
-
On the End-User License Agreement page, review the End-User License Agreement (EULA), and then select the I accept the terms in the License Agreement option, and then click Next.
Note | To print the EULA, copy the text available in the EULA page to a document, and then print the document for further perusal. |
-
On the Ready to Install page, review the installation details, and then click Install to begin the installation process.
-
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, refer to 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
-
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 RFID service running.
| If BizTalk RFID is already installed on the desktop computer, BizTalk RFID Mobile is installed in the %rfidinstalldir% folder. If BizTalk RFID is not installed on the desktop computer, the components are installed at %programfiles%\Microsoft BizTalk RFID\ folder.
|
Installing the 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 |
-
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.
-
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.
-
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.
-
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 |
-
Click Start, point to Control Panel, and then click Add or Remove Programs.
-
Locate and click Microsoft BizTalk RFID Mobile in the list of programs, and then click Change.
-
On the BizTalk RFID Mobile Setup Wizard page, click Next.
-
On the Repair or Remove Installation page, click Repair.
-
On the Repair Microsoft BizTalk RFID Mobile page, click Repair.
-
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 |
-
Click Windows, click Settings, and then click the System tab.
-
Click Remove Programs.
-
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 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 other applications using SQL Server CE 3.5 to fail. |
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 |
-
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.
-
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.
-
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.
-
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.
© 2008 Microsoft Corporation. All rights reserved.
Microsoft, ActiveSync, BizTalk, Visual Studio, Windows, and Windows Mobile are trademarks of the Microsoft group of companies.
All other trademarks are property of their respective owners.
Top of page |