
  Hi!

  First of all I have to tell you that there is no automatic
  installation for Palm-FE yet. In this file I will explain
  step by step how to install Palm-FE. It is not hard but
  requires some httpd configuration unless you already alowed
  features Palm-FE requires.

  NOTE: for now Palm-FE distribution archives are named in this
  way: palm-fe-YYYYMMDD.tar.gz where YYYYMMDD is release date.

  ____________________________________________________________________
  STEP 1:

  go to install directory and unpack palm-fe-*.tar.gz archive:
  NOTE: `install' directory is any directory you like, I'll use
        `/usr/local' here.
  NOTE: you have to be logged in as root!
 

  cd /usr/local/
  tar xzvf ~/palm-fe-YYYYMMDD.tar.gz

  this will create /usr/local/palm-fe3/ directory that contains
  Palm-FE files and directories.

  ____________________________________________________________________
  STEP 2:

  now you have to copy or symlink file /usr/local/palm-fe3/pro/palm3.pl
  in your httpd's cgi-bin directory (or any visible directory you like
  with enabled CGI support)
 
  usually web-visible documents and cgi-bin directories are located as:
 
  /var/lib/apache/htdocs/      (Slackware 7.0)
  /var/lib/apache/cgi-bin/

  /home/httpd/html/            (RedHat 6.0, 6.2)
  /home/httpd/cgi-bin/

  /usr/local/apache/htdocs/    (when install from apache sources)
  /usr/local/apache/cgi-bin/

  /home/apache/htdocs/         (custom one)
  /home/apache/cgi-bin/

  /usr/local/etc/httpd/htdocs/ (this is old one but still is used)
  /usr/local/etc/httpd/cgi-bin/


  otherwise you have to find it. I will assume it is
  /var/lib/apache/htdocs/  so you have to do:

  cp /usr/local/palm-fe3/pro/palm3.pl /var/lib/apache/cgi-bin/palm3.cgi
  chown 0755 /var/lib/apache/cgi-bin/palm3.cgi
 
  or
 
  ln -s /usr/local/palm-fe3/pro/palm3.pl /var/lib/apache/cgi-bin/palm3.cgi
  chown 0755 /var/lib/apache/cgi-bin/palm3.cgi


  ____________________________________________________________________
  STEP 3:
 
  edit files:
 
  /usr/local/palm-fe3/pro/palm3.pl
  /var/lib/apache/cgi-bin/palm3.cgi
 
  and on the first line, after `-I' put yor install directory followed
  by `/pro' string:
 
  #!/usr/bin/perl -I/usr/local/palm-fe3/pro
 
  ____________________________________________________________________
  STEP 4:

  you have to check httpd.conf which is in:
  /var/lib/apache/conf/        (Slackware 7.0)
  /etc/httpd/conf/httpd.conf   (RedHat 6.0, 6.2)
  /usr/local/apache/htdocs/    (when install from apache sources)

  first of all you have to be sure httpd runs as nobody
  (this is the common case):

  --------------
  User  nobody
  Group nogroup
  --------------

  and for RedHat:
  --------------
  User  nobody
  Group nobody
  --------------

  then do this:
 
  chmod 1700 /usr/local/palm-fe3/data/users
  chmod 1700 /usr/local/palm-fe3/data/sessions
  chmod 0600 /usr/local/palm-fe3/data/passwd
  chown nobody /usr/local/palm-fe3/data/users
  chown nobody /usr/local/palm-fe3/data/sessions
  chown nobody /usr/local/palm-fe3/data/passwd

  or change `nobody' with the user that runs the httpd server

  ____________________________________________________________________
  STEP 5:

  edit file:
 
  /usr/local/palm-fe3/data/passwd
 
  and add users:
 
  username1=password1
  username2=password2
  ...

  ____________________________________________________________________
  STEP 6:

  run your browser and point it at:

  http://localhost/cgi-bin/palm3.cgi

  and login with one of the users from step 5



  That's all!
  In case you have problems you can contact

  cade@biscom.net  or  cade@datamax.bg
  mgoebenich@needful.de or mgoebenich@entire-systems.com
