Skip to the content of the web site.

Enhancing Support for UW Users of RIM BlackBerry

Installing and Configuring the Nexthaus SyncJe client

PLEASE NOTE THAT UW stopped using Oracle Calendar ("Bookit") in December 2010. This page is here for reference purposes only! Blackberry Calendar synchronization is now accomplished with the Exchange server ("Connect") via a BES account. Please refer to the IST Exchange Calendar web page for details.

This page describes the steps required to install the NextHaus SyncJe client on a BlackBerry and configure it to import data from UW's Oracle Calender ("Bookit") into the BlackBerry Calendar program.

The steps to follow are:

  1. Confirm that you have a compatible device
  2. Download and install the software
  3. Configure the client
  4. Troubleshooting
Confirm your device

Network: The SyncJe client depends upon stable network connections. Our experience is more favourable results with the newer model BlackBerrys that operate on Rogers' EDGE network such as the 8100 ("Pearl") and the 8700 series models.

OS version: You need to be running a BlackBerry OS version later than 4.0.0.x. Any version prior to (and including) 4.0.0.x doesn't support calendar and tasks "ChangeListener" so Nexthaus SyncJe cannot detect changes and will only work if you do a slow sync (reset). If you are running 4.0.0.x or earlier, you will need to update your device operating system before installing SyncJe. Most service providers have an upgrade available. Rogers customers can obtain the update from Rogers.Com - BlackBerry Software Upgrades

DST 2007 patch: Verify that you have the 2007 Daylight Savings Time patch installed on your device. Refer to BlackBerry 2007 Daylight Savings Time Patch for details.

 

Downloading the software

You have 2 options for downloading and installing the software:

  1. Over-the-Air installation (recommended)
  2. Installation via BlackBerry Desktop Manager

Over-the-Air installation
This method installs the software directly onto the device via the Internet Browser on the BlackBerry but will result in data charges for the download (approximately 1.1 MB). Follow the instructions on this page to perform and Over-the-Air installation.

Installation via BlackBerry Desktop Manager
This method uses your (Windows) desktop/workstation to download and install the software using the BlackBerry Desktop Manager software. Follow the instructions on this page to install via BlackBerry Desktop Manager.

Choose your installation method (above), follow the instructions and then return here to configure the software using the instructions below.

 

   
Configuring the client

On the main screen of the BlackBerry, you will see a new icon for the NextHaus SyncJe application (below). Using the trackwheel or trackball, navigate to the icon and push the trackwheel/trackball to launch the software.

 

 

While under the trial mode, you have 15 days to test the client software. You will need to acknowledge the trial nature every time you launch the SyncJe client (below) by clicking the trackwheel/trackball. Contact Trevor to obtain license codes beyond the 15 day trial.

 

 

You will then see the SyncJe startup screen. Click the trackwheel/trackball and select the Settings option from the resulting menu.

 

 

Enter your Bookit account information as follows (see example below):

Server URL:
https://bookit.uwaterloo.ca/ocas-bin/ocas.fcgi?sub=syncml
User Name :
Enter your UWDir username (8 characters max).
Password:
The password is your bookit account password.

Select the Calendar checkbox (using the spacebar) and enter the foldername:

./Calendar/Events

The screenshot below provides a sample configuration (including the folder required for synchronizing your Address Book with Bookit if you wish). For Address Book and Tasks, use the following folder settings:

./Contacts
./Calendar/Tasks

You have the option of setting the Auto Sync interval. We recommend that you not set this for the initial sync as the first data transfer may take some time to complete. For the same reason, consider enabling the synchronization for one component at a time (e.g. set Calendar, then add ToDo, then add Contacts). Once you have successfully completed the synchronization (see below), you can come back to this menu and enable the Auto Sync at an appropriate interval.


 

With the configuration entered, click the trackwheel/trackball and select Save from the resulting popup menu (below).

 

 

You will be taken back the main SyncJe menu. Click the trackwheel/trackball and select Start Sync from the popup menu (below).

You may be prompted to approve the https data transfer. Accept the https data transfer to bookit.uwaterloo.ca and click on allow this connection.

 

 

While the device is synchronizing the data, you will told how much data is being transferred (below).

 

 

When the sychronization is complete, the message "Session Complete." will appear below the log of data transferred (below).

 

 

Your Bookit (Oracle Calendar) schedule has now been loaded into the native BlackBerry Calendar application. To view your appointments, launch the Calendar.

Subsequent synchronization can be set to occur on a pre-determined schedule by configuring the Auto Sync option (discussed above) or conducted manually by launching the NextHaus SyncJe client and selecting "Start Sync" from the popup menu on the main screen (below).

 

Troubleshooting

It is a good practice to check the main screen of the SyncJe client to confirm that synchronization with Oracle Calendar is still working. We have found that SyncJe will work for long periods of time but may fail. When it fails, you may not notice it. To resume synchronization:

  1. turn the wireless off;
  2. wait 30 seconds;
  3. turn the wireless back on;
  4. wait for wireless service to resume;
  5. perform a manual sync in the SyncJe client (i.e. Start Sync option).

If turning the wireless off and on doesn't work (e.g. if you get less than 1000 bytes transferred), then:

  1. power off the device;
  2. wait 30 seconds;
  3. power on the device;
  4. wait for wireless service to resume;
  5. perform a manual sync in the SyncJe client (i.e. Start Sync option).

It that still fails to sync more than 1000 bytes, then:

  1. power off the device;
  2. remove the battery for 30 seconds;
  3. replace the battery;
  4. power on the device;
  5. wait for wireless service to resume;
  6. perform a manual sync in the SyncJe client (i.e. Start Sync option)

 

 

 

 

 

project website
last updated by Trevor Bain on Tuesday, 22-Feb-2011 09:46:27 EST