PIM Fusion FAQ

The following installation notes were generated based on a  Fedora 7 Linux installation. 
Your mileage might vary with other distros and versions..

1) Need to have Linux installed and verify that the Apache web server is
   operational.  See the Apache documentation for more details.

2) PIM Fusion uses the wv package for parsing and indexing M$ Word documents. 
   Install this package as root from the support directory using the standard:
   'configure'
   'make'
   'make install'

   The contents should be installed to /usr/local/bin.
  
3) Verify that the software pdftotext is installed if you would like the ability
   to index Adobe PDF documents.  This program is a part of the Xpdf suite at
   http://ftp.foolabs.com/xpdf/.
  
4) Verify that the xls2csv software is installed if you would like the ability
   to index M$ excel documents.  This software and installation instructions
   can be found at http://www.cpan.org/.
  
5) a) Install a Java runtime such as the Sun Java SE Development kit.  If you
      are not planning on making modifications to document indexing used by PIM
      Fusion document searching, then use the Java Runtime (JRE) edition.  See
      the Sun Java installation documentation for more details.
     
   b) If you do not see a home directory in /home for apache, create one
      setting directory permission to the apache user and modify the
      /etc/passwd file accordingly.
     
      'mkdir /home/apache'
      'chown apache: /home/apache'
     
      Example showing the mods for the apache user in /etc/passwd (apache UID
      is 48 in this configuration):
     
      apache:x:48:48:Apache:/home/apache:/sbin/nologin
     
   c) Several env variables need to be defined in apache's environment.  This
      can be accomplished by adding the following lines to the script that
      starts apache (/etc/init.d/httpd).  Setting these variables in the apache
      shell profile doesn't always seem to work, so it is recommended to modify
      this file to provide consistent installation instructions.
     
      find the start() function within /etc/init.d/httpd and add the lines:
     
        HOME=/home/apache
        JAVAHOME=/usr/local/jdk1.6.0_01
        PATH=$JAVAHOME/bin:$HOME/bin:/usr/local/bin:$PATH
        export PATH JAVAHOME HOME

      using your Java path, before the line that starts the httpd daemon:
     
      example before:
     
      start() {
              echo -n $"Starting $prog: "
              check13 || exit 1
     
              LANG=$HTTPD_LANG daemon $httpd $OPTIONS
              RETVAL=$?
              echo
              [ $RETVAL = 0 ] && touch ${lockfile}
              return $RETVAL
      }
     
      example after:
           
      start() {
              echo -n $"Starting $prog: "
              check13 || exit 1
     
              HOME=/home/apache
              JAVAHOME=/usr/local/jdk1.6.0_01
              PATH=$JAVAHOME/bin:$HOME/bin:/usr/local/bin:$PATH
              export PATH JAVAHOME HOME
     
              LANG=$HTTPD_LANG daemon $httpd $OPTIONS
              RETVAL=$?
              echo
              [ $RETVAL = 0 ] && touch ${lockfile}
              return $RETVAL
      }

6) The following instructions assumes the use of /var/www/html as the document
   root of the web server.
  
   a) Remove or move the existing directory at /var/www/html.
  
   b) Recursively copy the subdirectory html within the PIM Fusion directory to
      the location: /var/www/
      'cp -r html/ /var/www/'
  
7) Recursively copy the contents of usr_local to the directory /usr/local/
   respectively.
   'cp -r usr_local/* /usr/local/'
  
8) Install the anyterm/rote tools from the PIM Fusion support directory using
   the installation instructions from the anyterm website.  The web components
   of anyterm should already be installed in /var/www/html/anyterm at this
   point.  If you install a newer version of anyterm, replace the equivalent
   files at this location respectively.  To obtain the latest version of these
   tools, visit:
  
   http://anyterm.org
   http://sourceforge.net/projects/rote.
  
   Note your linux platform equivalents of the following software packages are
   required before installing rote and anyterm:
  
   apr-devel-1.2.2-7.2.x86_64.rpm
   apr-util-devel-1.2.2-4.2.x86_64.rpm
   httpd-devel-2.2.0-5.1.2.x86_64.rpm
 
   Also note that you need to have the line:

   /usr/local/lib

   in the file /etc/ld.so.conf so that the shared libraries will be found.

   After installing anyterm type ldconfig as root to ensure shared libraries
   are properly resolved.
  
   The default user can be set in the file /var/www/html/anyterm/.htaccess.
   Modify the line:
  
      anyterm_command '/usr/bin/ssh username@localhost'


9) Modify the Apache config file /etc/httpd/conf/httpd.conf:

   a) Add the following line to /etc/httpd/conf in the Dynamic Shared Object (DSO)
      Support section

      LoadModule anyterm /usr/lib/httpd/modules/anyterm.so

   b) Add the following code block to the apache directory access section which
      is located at the bottom of file.
  
      <Directory "/var/www/html">
         Options Indexes Includes FollowSymLinks
         AllowOverride All
      </Directory>
     
      <Directory "/var/www/html/phpAutoGallery">
         Options Indexes Includes FollowSymLinks
         AllowOverride FileInfo
      </Directory>
     
10) Install both the Xapian and the modified Omega packages from the support
   directory as the root user.  These packages install using the standard:
   'configure'
   'make'
   'make install'
  
   Issue the following commands from the extracted Omega directory after building:
   'cp omega /usr/local/omega/'
   'cp omindex /usr/local/omega/'
   'cp -r omega_icons /var/www/icons/omega'

11)  Set the proper permissions on directories:
     'chown -R apache: /var/www/icons'
     'chown -R apache: /var/www/html'
     'chown -R apache: /var/www/cgi-bin'
  
12)  Setup the web calendar database.

     a) As the root user, type:
     'mysql'
    
     b) At the mysql monitor prompt create the web calendar database.
     mysql> create DATABASE web_calendar;
     mysql> GRANT ALL PRIVILEGES ON web_calendar.* TO pimfusion@localhost IDENTIFIED BY 'pimfusion';

     c) From a web browser, type in the url:
     http://localhost/calendar/caladmin/create.php