Sharp Zaurus/PointBase Demo

Getting Started with the Zaurus Contact Manager Demo

The 'ContactManagerSync' demonstration is a personal contact organizer that can store images together with contact details. This demonstration combines the PointBase ContactManager demo with synchronization between databases. There are two ContactManager client applications that store data in separate PointBase Micro databases, one running on your Sharp Zaurus, the other on your desktop. You can add, delete, store and search both text and/or BLOB images, then synchronize your information between databases with PointBase UniSync.

YOU WILL NEED:

1. An 802.11 card on your Zaurus and the ability to ping the central server
2. The ability to install .ipk files
3. The Sharp Zaurus file manager installed
4. Unix Emulator (author uses MKS Toolkit) or ability to create tar and gzip files. The tar/gzip utilities can be downloaded from http://unxutils.sourceforge.net/
5. An installed evaluation copy of PointBase.
6. Java SDK 1.3 or higher installed from Sun Microsystems. It is available free at http://java.sun.com/j2se/

INSTALLING & RUNNING THE CONTACTMANAGERSYNC DEMO:

1. Download and unzip the Demo.
2. On your desktop machine, edit the file setEnv.bat (located at the root of your installed directory) to reflect your settings and the PointBase version you have installed.
3. Run the make.bat file to generate the contacts.jar file. Also, copy this jar file to the folder <install directory>\SHARP\home\QtPalmtop\java. This is needed to build the .ipk file.
4. Open a command window and navigate to the root of your installed directory and execute runBasic_1_Config.bat.
   
   This configures the Hub database (PointBase Embedded) using the Config application (ResetServer.java). This batch file will set up subscriptions and publications.
   
   
5. Press any key to continue after you see the prompt.
6. After this program completes successfully, run runBasic_2_Hub.bat.
   
   This starts the UniSync server listening for spoke connections.
   
   
7. Wait for the prompt that says, "UniSync Server is running."
8. Click on runBasic_3_Spokes.bat to test and ensure that your UniSync Server is properly setup. You should see two basic forms with a list of names. Click on one of the Forms and ‘Add’ new record information, you can use the ‘Set Image’ icon to also add an image to the record.
9. Then click ‘Sync’ to send the changes back to the Hub database. Now go to the form you did not change and click on ‘Sync’. You should see the new record.
10. Navigate to <install directory>\SHARP\home\QtPalmtop\bin, and open the file 'runcontacts' in a text editor. Change the -syncurl setting to reflect your machine name (or ip address) that is hosting the sync server. (Note that if you need to change the port from 8675, you will need to edit the files unisync.ini and runBasic_3_Spokes.bat in addition to the file runcontacts).
    
    Example: -syncurl http://192.168.0.201:8675
    
    Note: If you are using a wireless connection with Ad-hoc mode, you should use the IP address associated with the Wireless LAN adapter on the UniSync server machine. If you are using USB connection, you should use the IP address associated with the SL Series connection of the UniSync server machine.
    
    
    Place a valid PointBase Micro license file pbmic.lic on the Zaurus device and update the -D option in the runcontacts file. For example, if you have pbmic.lic in /home/pointbase, then use -Dpbmic.lic=/home/pointbase/pbmic.lic
11. Click on makepack.bat at the root of the SHARP directory, to automatically create the .ipk file. (This batch file requires the Unix Emulator referred to above if you are on a Windows platform).
12. Move the generated file contacts-cvm_1.0_arm.ipk to your Zaurus device, using either a flash card or the Zaurus cradle.
13. On the Zaurus, go to Settings, Add/Remove Software, Install Packages.
14. Click on 'ContactManager', press Install, select 'RAM' and click OK.
15. Close the Package Installer, close 'Add/Remove Software' and wait for the main window to appear.
16. Select the Jeode tab and click on 'Contact Manager'. This will display a form on the Zaurus similar to that in step 6. Using the form, edit records on the Zaurus as well as on the desktop and press the Sync button on each to see changes moved back and forth.
17. For more information on the ContactManagerSync demo beyond these steps for running it on the Sharp Zaurus, please refer to the file pbudeveloper.pdf located in the PointBase installation directory under \docs\unisync\pdf, beginning on page 36.