CWebLog for Palm OS



Installing Palm CWebLog


Bulk Installs

  1. If you have a lot of bulk installs to do, let's say you are installing CWebLog on all of the student PDAs, then I recommend one of these two approaches:
  2. Check that the version of your Palm Desktop software is greater than or equal to 3.0.1 (click on the top menu bar "Help->About Palm Desktop".) Version 3.0.0 (and earlier) is broken in a way that makes installing the large number of cweblog databases very difficult. You can use version 3.0.0, but you must move only about 20 files at a time into your Palm install directory, uuuggg. If you have one of these older versions, get a new one from the palm download site (wherever that might be by the time you read this.)

Linux Install

  1. Create a new directory, say ... ~/cweblog_palm.
  2. Download cweblog_pda.tgz to this directory.
  3. Unzip it with "tar -zxvf cweblog_pda.tgz".
  4. Put your palm device in your cradle and start up (tap) "HotSync".
  5. On your Linux command line, type "pilot-xfer --install *.pdb *.prc", assuming that you have the "pilot-link" package installed.
  6. Tap the hotsync icon on your PDA and go have a cup of coffee. The install process over a 9600 Baud line takes 35 minutes, unless you are installing only a subset of files. The minumum subset is: cweblog.prc and a full subset of the pdf files for a particular clerkship, *_psy.pdb for example.
  7. Linux has several utilities for sending mail from your Palm OS mail. Pilot-mailsync is a powerful command line utility you can obtain from master.penguinppc.org/~hollis/palm. The very nice graphical pilot desktops for Linux, kpilot and jpilot also sync and send palm email.

    If you use a MS Windows system to send your PalmOS email, you will need to have a properly configured Palm Desktop and Email Client (Eudora or MS Outlook) - at each station that you wish to synch from - before you can synchronize your Palm mail.


Configure your Palm Desktop and email application.

  1. We assume here that you have already installed your Palm Desktop software on your PC. If you haven't, do so, and in this case you may wish to install the latest version (see next step).
  2. (Optional) Palm Email configuration is easier if you have the latest version of Palm Desktop installed. Go to http://www.palmone.com/us/support/downloads/index.html#windowsdesktop to download and install the latest. If they have changed the link (again), google it (Palm Desktop).
  3. Start your Palm Sync Manager program if it is not already running. The Palm Sync Manager normally starts when you start up Windows, but - it can crash so check for the little sync icon in the lower right hand corner of your PC display.
  4. Start your Palm Desktop program. Click on Tools->Users->New User, and set up your account with the same username that appears at the top-right of your PDA display when you tap on your HotSync icon.
  5. Click on Hotsync->Custom->Select your user ID. (if there is more than one on your PC). Then select Mail->Change->Synchronize the files.
  6. You will have a choice of email client programs: Eudora or Microsoft Outlook (Express), (at least some of the other listed options don't really work, such as Netscape Communicator) or - if you opt to purchace the conduit for Groupwise available for $40. at http://www.quartzdevelopment.com/smartSYNC.html - Groupwise. When you choose to use either of the Eudora or Outlook options, you must set that email client to be the default email application on your PC. This means that Groupwise will not be the default email application. This is OK. You will have no problems using either of these email programs with the Groupwise mail server at USUHS. Simply configure for POP3 email. Alternatively, the commercial smartSYNC conduit, used on the LRC sync stations, requires less attention to these configuration details.

    Eudora Option: If Eudora is installed on your system, I recommend it. Eudora can be easily installed by browsing to http://www.eudora.com/ and clicking on the icon to download the software. Start Eudora and configure MAPI to "always" be on. You must also set Eudora to be your default email client. You will need to have your own account on Eudora with your own email return address, and the SMTP server (outgoing email) should be properly configured. At USUHS the outgoing (SMTP) server is mx.usuhs.mil and your incoming address should look something like s1rwilliams@usuhs.mil. You should ensure that Eudora is running whenever you synchronize your email.

    Outlook Express Option: You may be forced to choose Outlook Express, in which case you should also ensure that MAPI, your own return address, and SMTP are configured, and that Outlook is running when you sync your pda mail. To configure Outlook Express, click on Tools->Options and set Outlook to be your default email client. You may not see a button to set MAPI on, depending on the version of Outlook that you have, in which case you can ignore the MAPI setting.

    Configure your Outlook Express account thus:
    If you don't already have your Outlook Express set up:
    Click on Tools->Accounts->Add->Mail and set "Outgoing mail (SMTP) server" to "mx.usuhs.mil". Don't use mxa,mxb,mxc...etc.usuhs.mil here, just "mx.usuhs.mil". You don't need to configure incoming mail unless you want to use Outlook Express for this purpose, and remember that Microsoft incoming mail is insecure and may subject you to a virus infection.

    If you do have your Outlook Express configured, Click on Tools->Accounts->Mail, select your account, click on "Properties->Servers", and ensure that "Outgoing mail (SMTP)" is set to "mx.usuhs.mil". You don't need to have incoming main configured (as above).

    Groupwise SmartSYNC Option: Just install the smartSYNC conduit (assuming you already have Groupwise installed), and configure your Palm Desktop (HotSync -> Custom) to ensure that SmartSYNC Mail is set to "Synchronize the files."

  7. Linux Option: A Linux workstation is a good platform of choice for a synchronization station. Separate Palm Desktop and Email client accounts are not required, the Linux platform is far less likely to be subjected to virus attacks, is more stable, and can be easily configured as a firewall to restrict the kinds of access both in and out. Simply install the pilot-mailsync package (included with the source distribution of CWebLog) and make a KDE or Gnome desktop icon pointed to the execution of /usr/bin/pilot-mailsync.

How It Works

We think the Palm OS CWebLog is intuitive enough that instructions for making entries are not required. When entries are submitted, they are put into the Palm Mail application Outbox where they remain until you synchronize your Palm to a Palm Desktop (yours or one in the Library). When you synchronize your Palm to a Palm Desktop, your Palm Outbox is emptied into the outbox of your Desktop Email application, if it is configured properly. This email can be sent automatically from there to the CWebLog server.

Do you already have Palm Mail installed?

To determine whether or not you already have Palm Mail installed, inspect your Palm device top menu looking for an application labelled simply "Mail" (not VersaMail or any thing else). Tap on "Mail" and then on the top dropdown menu->Options->About Mail. You should see the name "Mail" and a version v.3.5 or higher. The version we supply here is v.4.5PT. Once you are sure about your need for Mail.prc, click Here to return to your install instructions.

Palm Mail.prc

If you have a Palm OS 5 device, such as a Tungsten T, you do not have Palm Mail.prc installed and you must install it separately. Installing Mail.prc will not interfere with any other email application. Mail.prc is included in cweblogp.exe.
  • If you have Palm OS 5 or a Tungsten, you can install Palm Mail now. In Palm Desktop-Install click on Add and then on Mail.prc, Click on the Open button.
  • Click on Done on the right of the Palm Desktop - Install window and then return to the install instructions above by clicking here. You can read about this version of Palm Mail at http://www.pumatech.com/intellisync_products/palmos5.html and you can download it from http://www.pumatech.com/intellisync_products/Mail.prc if you don't want to use the one in cweblogp.exe. This version of Palm Mail is required to store and send cweblog data entries.

    You will also probably need to install the Palm E-Mail conduit for the Palm Desktop. We cannot provide this program and you must download it from http://www.palmone.com/us/support/downloads/emailupd.html and install it yourself. This is an easy install. Just agree to the licence question, download, and run. Configure the E-Mail conduit as described here.