The following procedures describe how to run the supplied CustDB and Simple sample applications.
Before you start, ensure that you have M-Business Anywhere 6.0 or later installed and running, and that you have administrative privileges on the server. You must also have a supported handheld device.
To install and run M-Business Anywhere samples
Copy the UltraLite for M-Business Anywhere sample files to your installation directory for deployment.
where deploy-dir is the directory where the CustDB and UltraLite files are to be deployed. For example, you may choose C:\tutorial\mba
The batch file copies the required files to the location you specify. To see what files are being copied, examine the file samples-dir\UltraLiteForMBusinessAnywhere\CustDB\build.bat using a text editor.
Create a virtual directory in your web server that points to the directory deploy-dir specified in step 1. The following instructions are for Microsoft IIS:
Add users to M-Business Anywhere.
There are three ways to add new users to M-Business Anywhere: by creating new user profiles, by allowing users to self-register, and by importing a CSV file. These instructions describe how to create a new user profile. For more information, see the M-Business Anywhere documentation.
The default administrator account settings are a user ID of Admin and an empty password.
Deploy the M-Business Anywhere Client to a handheld device or PC.
Enter the user ID and password of the new M-Business user account you created.
If you have connection problems at this stage, specify the host using an IP number rather than a host name (to avoid name resolution issues with some versions of ActiveSync).
For more information, see your M-Business Anywhere documentation.
Add a group to M-Business Anywhere.
The group will be used to test UltraLite for M-Business Anywhere.
The default URL is http://localhost or http://localhost:8091.
Configure the M-Business Anywhere channel settings.
|Location||http://localhost/CustDB/main.htm or the URL from step 2.|
|Allow binary distribution||Yes (checked)|
After setting the Location value, click View to confirm that you have entered the value correctly.
Synchronize your client.
The initial synchronization downloads the UltraLite for M-Business Anywhere files onto your handheld device.
To verify your setup
Check that the required files are present.
If any of these files is missing, you may have to manually copy them over to the device.
If any of these are missing, you may have to use the Palm install utility to install the UltraLite for M-Business Anywhere runtime .prc and sample schemas .pdb files to the device.
If any of these files are missing, you may have to manually copy them over to the device.
Launch M-Business Client.
On your handheld device or PC, check that the About screen displays the UltraLite for M-Business Anywhere version number. This confirms that UltraLite for M-Business Anywhere is successfully installed.
Run the CustDB sample application.
From the Start menu, choose Programs » SQL Anywhere 11 » MobiLink » Synchronization Server Sample.
The CustDB application is a link on your M-Business home page.
The default value is 50.
At the prompt "Do you have a network connection now?" answer Yes, or in the CustDB application, click Synchronize. This synchronizes data with MobiLink, and is a separate operation from synchronizing with M-Business Anywhere.
You should now see data in the CustDB fields. You can now explore the CustDB application.
Each UltraLite database on a Palm OS device must have a distinct creator ID to work properly with HotSync. In addition, an application with that creator ID must exist on the Palm OS device.
The HotSync Manager uses each application's creator ID as an identifier to handle synchronization. It hands each properly configured UltraLite application to the MobiLink conduit for synchronization. The conduit searches for and synchronizes a database with the same creator ID as the application.
For more information about configuring the conduit, see HotSync synchronization overview.
All UltraLite for M-Business Anywhere applications inherit the creator ID of the M-Business client, which is AvGo. This inheritance means that only one UltraLite database with creator ID AvGo can be synchronized, and that if you assign a distinct creator ID to your database, HotSync will not find it because there is no application with a corresponding creator ID.
This limitation is not an issue for the two sample applications (CustDB and Simple), as they share a common database schema. The only side effect is that when you synchronize the CustDB database, the Simple sample is also synchronized.
For more information about resolving this problem, see Registering the Palm creator ID.
|Send feedback about this page via email or DocCommentXchange||Copyright © 2008, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.0|