PalmSync - Thunderbird: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
(added link to synch windows PDAs)
(clarifications)
Line 1: Line 1:
The PalmSync extension for Mozilla Thunderbird provides a '''conduit''' to synchronize your Thunderbird address book with the Address application on your Palm OS® device. PalmSync only works on Windows and only for address book (no mail sync). '''It replaces the Palm address book conduit,''' so it will no longer synchronize your Palm '''address book''' with the Palm Desktop or other software. Other conduits and sync options should not be affected.  PalmSync currently has one major limitation - it [https://bugzilla.mozilla.org/show_bug.cgi?id=237624 does not sync non-ascii characters, eg. international language, 8-bit, unicode]
The PalmSync extension for Mozilla Thunderbird (TB) provides a '''conduit''' to synchronize your TB address book with the Address application on your Palm OS® device. PalmSync only works on Windows and only for address book (no mail sync). '''It replaces the Palm address book conduit,''' so it will no longer synchronize your Palm '''address book''' with the Palm Desktop or other software. Other conduits and sync options should not be affected.  A current major limitation is it [https://bugzilla.mozilla.org/show_bug.cgi?id=237624 does not sync non-ascii characters, eg. international language, 8-bit, unicode].  There are also issues you might want to understand before installating and sync - see the list at [[#Bugs and Troubleshooting]].


PalmSync is a conduit, not a sync manager, so you need sync management software from Palm or another vendor.  If you already have a sync manager then check the vendor website to make sure you have the latest version ([http://www.palm.com/us/support/downloads/win_desktop.html Palm Desktop]).  After downloading, install and '''test''' it before proceeding further.   
PalmSync is a conduit, not a sync manager. This means you need sync management software from Palm or another vendor.  If you already have a sync manager then check the vendor website to make sure you have the latest version ([http://www.palm.com/us/support/downloads/win_desktop.html Palm Desktop]).  After downloading, install and '''test''' it before proceeding further.   


''Requirements''
''Requirements''
Thunderbird 1.0.2 or higher.
Thunderibird 1.5.  Or, thunderbird 1.0.2 or higher plus [https://addons.mozilla.org/extensions/moreinfo.php?application=thunderbird&category=Contacts&numpg=10&id=70 Contacts Sidebar extension] to work around TB 1.0.x [https://bugzilla.mozilla.org/show_bug.cgi?id=234391  bug 234391].
[https://addons.mozilla.org/extensions/moreinfo.php?application=thunderbird&category=Contacts&numpg=10&id=70 Contacts Sidebar extension] for PalmSync to function properly with Thunderbird 1.0.x (an issue being investigated in [https://bugzilla.mozilla.org/show_bug.cgi?id=234391  bug 234391]).
 


==Installation==
==Installation==
To install PalmSync, follow these steps:
To install PalmSync, follow these steps:


1. &nbsp;'''Right''' click [http://ftp.mozilla.org/pub/mozilla.org/thunderbird/extensions/palmsync/palmsync.xpi palmsync.xpi for TB 1.0.x] or [http://ftp.mozilla.org/pub/mozilla.org/thunderbird/extensions/palmsync/1.5/palmsync.xpi palmsync for TB 1.5] and select "save link as" to download the extension to your PC.  '''DO NOT LET IT INSTALL IN THE BROWSER!'''.<br />
1. &nbsp;'''Right''' (not left) click [http://ftp.mozilla.org/pub/mozilla.org/thunderbird/extensions/palmsync/palmsync.xpi palmsync.xpi for TB 1.0.x] or [http://ftp.mozilla.org/pub/mozilla.org/thunderbird/extensions/palmsync/1.5/palmsync.xpi palmsync for TB 1.5] and select "save link as" to download extension to your PC.  '''DO NOT INSTALL EXTENSION INTO BROWSER!''.<br />
2. &nbsp;TB 1.0 - Download the [https://addons.mozilla.org/extensions/moreinfo.php?application=thunderbird&category=Contacts&numpg=10&id=70 Contacts Sidebar] extension.<br />
2. &nbsp;TB 1.0 - Download the [https://addons.mozilla.org/extensions/moreinfo.php?application=thunderbird&category=Contacts&numpg=10&id=70 Contacts Sidebar] extension.<br />
3. &nbsp;In Thunderbird, go to "Tools -> Extensions -> Install" and install the PalmSync extension. (1)<br />
3. &nbsp;In Thunderbird, go to "Tools -> Extensions -> Install" and install the PalmSync extension. (1)<br />
4. &nbsp;TB 1.0 - Repeat step 3 for the Contacts Sidebar extension.<br />
4. &nbsp;TB 1.0 - Install Contacts Sidebar extension with "Tools -> Extensions -> Install".<br />
5. &nbsp;Restart Thunderbird to activate the extension. (1)<br />
5. &nbsp;Restart Thunderbird to activate the extension. (1)<br />
6. &nbsp;Verify conduit settings (2):<br />
6. &nbsp;Verify conduit settings (2):<br />
Line 22: Line 22:
Perform a HotSync&reg; operation to verify correct operation (3) - the palm and Thunderbird address books should sync.<br />
Perform a HotSync&reg; operation to verify correct operation (3) - the palm and Thunderbird address books should sync.<br />


==Troubleshooting==
==Bugs and Troubleshooting==


If you have a problem after the above steps and it does not appear in the bug list (below)
If you have a problem after the above steps and your problem does not appear in the [https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&product=Core&product=Firefox&product=Mozilla+Application+Suite&product=Thunderbird&product=Toolkit&resolution=---&op_sys=All&op_sys=Windows+95&op_sys=Windows+98&op_sys=Windows+ME&op_sys=Windows+2000&op_sys=Windows+NT&op_sys=Windows+XP&op_sys=Windows+Server+2003&op_sys=Windows+CE&op_sys=Mac+System+7&op_sys=Mac+System+7.5&op_sys=Mac+System+7.6.1&op_sys=Mac+System+8.0&op_sys=Mac+System+8.5&op_sys=Mac+System+8.6&op_sys=Mac+System+9.x&op_sys=MacOS+X&op_sys=Linux&op_sys=BSDI&op_sys=FreeBSD&op_sys=NetBSD&op_sys=OpenBSD&op_sys=AIX&op_sys=BeOS&op_sys=HP-UX&op_sys=IRIX&op_sys=Neutrino&op_sys=OpenVMS&op_sys=OS%2F2&op_sys=OSF%2F1&op_sys=Solaris&op_sys=SunOS&op_sys=Other&chfieldto=Now&field0-0-0=short_desc&type0-0-0=allwordssubstr&value0-0-0=palm+sync&field0-0-1=component&type0-0-1=equals&value0-0-1=mailnews%3A+palmsync '''Bug list''' and known issues]:
* if you never had a palmsync working, please uninstall and then reinstall thunderbird, and repeat the above steps
* if you never had a palmsync working, please uninstall and then reinstall thunderbird, and repeat the above steps
* if you need further assistance then ask for help in the [http://forums.mozillazine.org/viewforum.php?f=28 Thunderbird General mozillazine forum]  
* if you need further assistance then ask for help in the [http://forums.mozillazine.org/viewforum.php?f=28 Thunderbird General mozillazine forum]  
* for non-stable version of Thunderbird (nightlies, release candidates, etc) check the bug list below - the extension might not be working in development versions and perhaps a newer version of PalmSync is available for testing
* for non-stable version of Thunderbird (nightlies, release candidates, etc) check the bug list below - the extension might not be working in development versions and perhaps a newer version of PalmSync is available for testing
* if you are still stuck please comment in an existing bug (or make a new bug) with the following information: version of plamsync, build string and version of Thunderbird, hotsync log, and conduit log. For the conduit log:
* if you are still stuck please comment in an existing bug (or make a new bug) with the following information: version of plamsync, build string and version of Thunderbird, hotsync log, and conduit log. Hotsync log is found in hotsync > view log.  To create a conduit log:
** Go into the Windows Control Panel -> System -> Advanced -> Environment Variables
** Go into the Windows Control Panel -> System -> Advanced -> Environment Variables
** Set MOZ_CONDUIT_LOG=c:\temp\conduit.log<br>(if the conduit logfile is empty then the conduit is probably not getting called at all, i.e. you have an install problem)
** Set MOZ_CONDUIT_LOG=c:\temp\conduit.log<br>(if the conduit logfile is empty then the conduit is probably not getting called at all, i.e. you have an install problem)


[https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&product=Core&product=Firefox&product=Mozilla+Application+Suite&product=Thunderbird&product=Toolkit&resolution=---&op_sys=All&op_sys=Windows+95&op_sys=Windows+98&op_sys=Windows+ME&op_sys=Windows+2000&op_sys=Windows+NT&op_sys=Windows+XP&op_sys=Windows+Server+2003&op_sys=Windows+CE&op_sys=Mac+System+7&op_sys=Mac+System+7.5&op_sys=Mac+System+7.6.1&op_sys=Mac+System+8.0&op_sys=Mac+System+8.5&op_sys=Mac+System+8.6&op_sys=Mac+System+9.x&op_sys=MacOS+X&op_sys=Linux&op_sys=BSDI&op_sys=FreeBSD&op_sys=NetBSD&op_sys=OpenBSD&op_sys=AIX&op_sys=BeOS&op_sys=HP-UX&op_sys=IRIX&op_sys=Neutrino&op_sys=OpenVMS&op_sys=OS%2F2&op_sys=OSF%2F1&op_sys=Solaris&op_sys=SunOS&op_sys=Other&chfieldto=Now&field0-0-0=short_desc&type0-0-0=allwordssubstr&value0-0-0=palm+sync&field0-0-1=component&type0-0-1=equals&value0-0-1=mailnews%3A+palmsync '''Bug list''' and known issues] (with few exceptions).  New bugs should be filed in component "Mailnews: Palm Sync" of product "Core" (select "Other Products" to find core when creating a bug).
New bugs should be filed in component "Mailnews: Palm Sync" of product "Core" - select "Other Products" to find core when creating the bug.


==Enhancement requests==
==Enhancement requests==

Revision as of 23:19, 27 January 2006

The PalmSync extension for Mozilla Thunderbird (TB) provides a conduit to synchronize your TB address book with the Address application on your Palm OS® device. PalmSync only works on Windows and only for address book (no mail sync). It replaces the Palm address book conduit, so it will no longer synchronize your Palm address book with the Palm Desktop or other software. Other conduits and sync options should not be affected. A current major limitation is it does not sync non-ascii characters, eg. international language, 8-bit, unicode. There are also issues you might want to understand before installating and sync - see the list at #Bugs and Troubleshooting.

PalmSync is a conduit, not a sync manager. This means you need sync management software from Palm or another vendor. If you already have a sync manager then check the vendor website to make sure you have the latest version (Palm Desktop). After downloading, install and test it before proceeding further.

Requirements Thunderibird 1.5. Or, thunderbird 1.0.2 or higher plus Contacts Sidebar extension to work around TB 1.0.x bug 234391.


Installation

To install PalmSync, follow these steps:

1.  'Right (not left) click palmsync.xpi for TB 1.0.x or palmsync for TB 1.5 and select "save link as" to download extension to your PC. DO NOT INSTALL EXTENSION INTO BROWSER!.
2.  TB 1.0 - Download the Contacts Sidebar extension.
3.  In Thunderbird, go to "Tools -> Extensions -> Install" and install the PalmSync extension. (1)
4.  TB 1.0 - Install Contacts Sidebar extension with "Tools -> Extensions -> Install".
5.  Restart Thunderbird to activate the extension. (1)
6.  Verify conduit settings (2):
      a) Right click the Palm Hot Sync icon in the system tray and select "Custom".
      b) Set the Mozilla Address Book conduit default to "Synchronize The Files".
      c) If the Desktop's Contacts conduit was retained after Palm Sync was installed then set the Contacts conduit default to "Do Nothing".

Perform a HotSync® operation to verify correct operation (3) - the palm and Thunderbird address books should sync.

Bugs and Troubleshooting

If you have a problem after the above steps and your problem does not appear in the Bug list and known issues:

  • if you never had a palmsync working, please uninstall and then reinstall thunderbird, and repeat the above steps
  • if you need further assistance then ask for help in the Thunderbird General mozillazine forum
  • for non-stable version of Thunderbird (nightlies, release candidates, etc) check the bug list below - the extension might not be working in development versions and perhaps a newer version of PalmSync is available for testing
  • if you are still stuck please comment in an existing bug (or make a new bug) with the following information: version of plamsync, build string and version of Thunderbird, hotsync log, and conduit log. Hotsync log is found in hotsync > view log. To create a conduit log:
    • Go into the Windows Control Panel -> System -> Advanced -> Environment Variables
    • Set MOZ_CONDUIT_LOG=c:\temp\conduit.log
      (if the conduit logfile is empty then the conduit is probably not getting called at all, i.e. you have an install problem)

New bugs should be filed in component "Mailnews: Palm Sync" of product "Core" - select "Other Products" to find core when creating the bug.

Enhancement requests

The most notable requests for additional sync functionality (not just Palm OS® or Thunderbird) are:

Notes

(1) PalmSync is installed via extension manager, but it is not yet a true extension. Therefore the extension will not show up in the list of extensions nor can it be uninstalled via extension manager.
(2) Some newer versions of Palm software retain the Palm Desktop's Contacts as the default conduit after Palm Sync installs the Mozilla Address Book conduit. This has been documented with Palm Desktop version 4.1.4 with HotSync version 6.0.1. As a result, the final step of the Palm Sync install process is to verify the conduit settings.
(3) You might not see a log entry for the hotsync - bug 183722.

See also