Edit file: /faq.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>PIM Fusion FAQ</title> <meta http-equiv="content-type" content="text/html; charset=US-ASCII"> </head> <body> <h1 align="center">PIM Fusion FAQ</h1> <ul> <li>Pim Fusion FAQ <ul> <li><a href="#faq-intro">Introduction</a><br> <ul> <li><a href="#faq-what">What is PIM Fusion?</a></li> <li><a href="#faq-lang">What language is it developed in?<br> </a></li> <li><a href="#faq-who">Disclaimer<br> </a></li> </ul> </li> <li><a href="#faq-install">Installation</a> <ul> <li><a href="#faq-require">System Requirements</a><br> </li> <li><a href="#faq-install_notes">Installation Notes</a></li> </ul> </li> <li><span style="text-decoration: underline;"><a href="#faq-features">Web Enabled Features</a></span> <ul> <li><a href="#faq-file_manager">File Manager<br> </a></li> <li><a href="#faq-doc_search">Document indexing and search<br> </a></li> <li><a href="#faq-remote">Remote terminal sessions<br> </a></li> <li><a href="#faq-image_video">Image and Video Gallery<br> </a></li> <li><a href="#faq-calendar">Calendar</a></li> <li><a href="#faq-contact_manager">Contact Manager</a></li> </ul> </li> <li><a href="#faq-use_case">Use Case Scenarios</a> <ul> <li><span style="text-decoration: underline;"></span><a href="#faq-knowledge_base">Web based knowledge base</a><br> </li> <li><a href="#faq-sync_contact">Syncing contact information with cell phone</a></li> </ul> </li> <li><a href="#faq-misc_questions">Miscellaneous Questions</a> <ul> <li><a href="#faq-non_functional">Why isn't the remote terminal or document search functional in the web demo?</a></li> </ul> </li> </ul> </li> </ul> <h2><a name="faq-intro"></a>Introduction</h2> <h3><a name="faq-what"></a>What is PIM Fusion?<br> </h3> PIM Fusion provides web based distributed information management. The idea is to accumulate knowledge and information in electronic format, upload through the file manager via the web interface, and provide indexing and search capabilities to retrieve the information on demand. The software provides search capabilities within native document types such as PDF, Word docs, PowerPoint, and HTML. When used over time, a powerful knowledge base can evolve.<br> <br> PIM Fusion includes web enabled support for a File Manager, Contact Manager (with support to sync to cell phone), Calendar, Image / Video gallery, and finally support for terminal sessions through the web browser.<br> <br> PIM Fusion relies heavily upon open source projects and is a collective mashup of other existing software applications and technologies.<br> <h3><a name="faq-lang"></a>What language is it developed in?</h3> Primarily PHP, but also includes some JavaScript, Ajax, Java and C++.<br> <h3><a name="faq-who"></a>Disclaimer</h3> <p>PIM Fusion requires a fair amount of Linux know-how to set up, so the setup is recommended only for advanced users. After the initial setup process, the web interface provides an intuitive and easy to use interface for all users. I have been enjoying the use of this tool for a couple of years now, however, no guarantees or warranties, including (but not limited to) any express or implied warranties of merchantability or fitness for a particular use or purpose, are made by Aquarius Software.<br> </p> <h2><a name="faq-install"></a>Installation</h2> <h3><a name="faq-require"></a> System Requirements</h3> <ul> <li>Intel Pentium 4 equivalent or faster processor<br> </li> <li>Linux, BSD, or Unix like OS</li> <li>MySQL database server installed<br> </li> <li>Apache web server installed</li> <li>Sun Java SE Development Kit<br> </li> </ul> <h3><a name="faq-install_notes"></a> Installation Notes<br> </h3> <div style="margin-left: 40px;">The following installation notes were generated based on a Fedora 7 Linux installation. <br> Your mileage might vary with other distros and versions..<br> <br> </div> <div style="margin-left: 40px;">1) Need to have Linux installed and verify that the Apache web server is<br> operational. See the Apache documentation for more details.<br> <br> </div> <div style="margin-left: 40px;">2) PIM Fusion uses the wv package for parsing and indexing M$ Word documents. <br> Install this package as root from the support directory using the standard:<br> 'configure'<br> 'make'<br> 'make install'<br> <br> The contents should be installed to /usr/local/bin.<br> <br> 3) Verify that the software pdftotext is installed if you would like the ability<br> to index Adobe PDF documents. This program is a part of the Xpdf suite at <br> http://ftp.foolabs.com/xpdf/.<br> <br> 4) Verify that the xls2csv software is installed if you would like the ability<br> to index M$ excel documents. This software and installation instructions<br> can be found at http://www.cpan.org/.<br> <br> 5) a) Install a Java runtime such as the Sun Java SE Development kit. If you <br> are not planning on making modifications to document indexing used by PIM<br> Fusion document searching, then use the Java Runtime (JRE) edition. See<br> the Sun Java installation documentation for more details.<br> <br> b) If you do not see a home directory in /home for apache, create one <br> setting directory permission to the apache user and modify the <br> /etc/passwd file accordingly.<br> <br> 'mkdir /home/apache'<br> 'chown apache: /home/apache'<br> <br> Example showing the mods for the apache user in /etc/passwd (apache UID <br> is 48 in this configuration):<br> <br> apache:x:48:48:Apache:/home/apache:/sbin/nologin<br> <br> c) Several env variables need to be defined in apache's environment. This <br> can be accomplished by adding the following lines to the script that <br> starts apache (/etc/init.d/httpd). Setting these variables in the apache<br> shell profile doesn't always seem to work, so it is recommended to modify<br> this file to provide consistent installation instructions.<br> <br> find the start() function within /etc/init.d/httpd and add the lines:<br> <br> HOME=/home/apache<br> JAVAHOME=/usr/local/jdk1.6.0_01<br> PATH=$JAVAHOME/bin:$HOME/bin:/usr/local/bin:$PATH<br> export PATH JAVAHOME HOME<br> <br> using your Java path, before the line that starts the httpd daemon:<br> <br> example before:<br> <br> start() {<br> echo -n $"Starting $prog: "<br> check13 || exit 1<br> <br> LANG=$HTTPD_LANG daemon $httpd $OPTIONS<br> RETVAL=$?<br> echo<br> [ $RETVAL = 0 ] && touch ${lockfile}<br> return $RETVAL<br> }<br> <br> example after:<br> <br> start() {<br> echo -n $"Starting $prog: "<br> check13 || exit 1<br> <br> HOME=/home/apache<br> JAVAHOME=/usr/local/jdk1.6.0_01<br> PATH=$JAVAHOME/bin:$HOME/bin:/usr/local/bin:$PATH<br> export PATH JAVAHOME HOME<br> <br> LANG=$HTTPD_LANG daemon $httpd $OPTIONS<br> RETVAL=$?<br> echo<br> [ $RETVAL = 0 ] && touch ${lockfile}<br> return $RETVAL<br> }<br> <br> 6) The following instructions assumes the use of /var/www/html as the document<br> root of the web server.<br> <br> a) Remove or move the existing directory at /var/www/html.<br> <br> b) Recursively copy the subdirectory html within the PIM Fusion directory to <br> the location: /var/www/<br> 'cp -r html/ /var/www/'<br> <br> 7) Recursively copy the contents of usr_local to the directory /usr/local/<br> respectively.<br> 'cp -r usr_local/* /usr/local/'<br> <br> 8) Install the anyterm/rote tools from the PIM Fusion support directory using<br> the installation instructions from the anyterm website. The web components<br> of anyterm should already be installed in /var/www/html/anyterm at this<br> point. If you install a newer version of anyterm, replace the equivalent<br> files at this location respectively. To obtain the latest version of these <br> tools, visit:<br> <br> http://anyterm.org<br> http://sourceforge.net/projects/rote.<br> <br> Note your linux platform equivalents of the following software packages are<br> required before installing rote and anyterm:<br> <br> apr-devel-1.2.2-7.2.x86_64.rpm<br> apr-util-devel-1.2.2-4.2.x86_64.rpm<br> httpd-devel-2.2.0-5.1.2.x86_64.rpm<br> <br> Also note that you need to have the line:<br> <br> /usr/local/lib <br> <br> in the file /etc/ld.so.conf so that the shared libraries will be found.<br> <br> After installing anyterm type ldconfig as root to ensure shared libraries<br> are properly resolved.<br> <br> The default user can be set in the file /var/www/html/anyterm/.htaccess.<br> Modify the line:<br> <br> anyterm_command '/usr/bin/ssh username@localhost'<br> <br> <br> 9) Modify the Apache config file /etc/httpd/conf/httpd.conf:<br> <br> a) Add the following line to /etc/httpd/conf in the Dynamic Shared Object (DSO) <br> Support section<br> <br> LoadModule anyterm /usr/lib/httpd/modules/anyterm.so<br> <br> b) Add the following code block to the apache directory access section which<br> is located at the bottom of file.<br> <br> <Directory "/var/www/html"><br> Options Indexes Includes FollowSymLinks<br> AllowOverride All<br> </Directory><br> <br> <Directory "/var/www/html/phpAutoGallery"><br> Options Indexes Includes FollowSymLinks<br> AllowOverride FileInfo<br> </Directory><br> <br> 10) Install both the Xapian and the modified Omega packages from the support <br> directory as the root user. These packages install using the standard:<br> 'configure'<br> 'make'<br> 'make install'<br> <br> Issue the following commands from the extracted Omega directory after building:<br> 'cp omega /usr/local/omega/'<br> 'cp omindex /usr/local/omega/'<br> 'cp -r omega_icons /var/www/icons/omega'<br> <br> 11) Set the proper permissions on directories:<br> 'chown -R apache: /var/www/icons'<br> 'chown -R apache: /var/www/html'<br> 'chown -R apache: /var/www/cgi-bin'<br> <br> 12) Setup the web calendar database. <br> <br> a) As the root user, type:<br> 'mysql'<br> <br> b) At the mysql monitor prompt create the web calendar database.<br> mysql> create DATABASE web_calendar;<br> mysql> GRANT ALL PRIVILEGES ON web_calendar.* TO pimfusion@localhost IDENTIFIED BY 'pimfusion';<br> <br> c) From a web browser, type in the url:<br> http://localhost/calendar/caladmin/create.php<br> </div> <h2><a name="faq-features"></a>Web Enabled Features. </h2> <h3><a name="faq-file_manager"></a> File Manager</h3> The File Manager is the default control interface for PIM Fusion providing web based file management as well as access to the other components. Hover over each icon with the mouse pointer to determine the icon's function.<br> <br> The following functionality is provided by the File Manager:<br> <ul> <li>Copy or Move a file or directory<br> </li> <li>Delete a file or directory<br> </li> <li>Create a compressed archive of a directory</li> <li>Expand a compressed directory archive</li> <li>Create a new file or directory</li> <li>Edit a text file</li> </ul> <h3><a name="faq-doc_search"></a>Document Search and Indexing<br> </h3> <p>Document search and indexing is provided by the Xapian / Omega software. Additional indexing of M$ documents is achieved through PIM Fusion using Jakarta. The following document types are currently supported for indexing and search:<br> </p> <ul> <li>PDF</li> <li>M$ Word</li> <li>M$ PowerPoint</li> <li>HTML</li> <li>Text</li> </ul> To add additional documents to the database to support text searching, simply upload the document to any directory in the File Manager and click the Reindex button within the Document Search page. The new documents will then be indexed and available for text searches. <h3><a name="faq-remote"></a>Remote terminal sessions<br> </h3> <p>Support for remote terminal sessions through a web browser is provided by the Anyterm / Rote software. By using a web browser and http protocol, the ssh terminal connection is available without problems encountered by network firewalls.<br> </p> <h3><a name="faq-image_video"></a>Image and Video Gallery</h3> PIM Fusion provides an integrated image and video gallery using the SPGM software. The image gallery supports graphics files in the jpeg, png and gif file formats. SPGM was modified to additionally support Flash videos using the FlowPlayer flash video software.<br> <br> A source directory of images must be processed for use within SPGM. First, the filenames need to be normalized with all spaces removed or replaced with underscores. After filename normalization, set the source and destination directories in the spgm/tools/make_thumbnails script and execute the script. Upon completion, the gallery will be viewable within a web browser.<br> <h3><a name="faq-calendar"></a>Calendar</h3> <p>PIM Fusion includes a web calendar which is a derived work of the Proverbs web calendar. The calendar utilizes the MySQL database for storing calendar entries supporting view by year, month, week, or day.<br> </p> <p>When viewing in year mode, each month of the year is displayed as well as holidays and user defined events. New user defined events can be added in the webdocs/calendar/userevents.js file. Example:<br> </p> userEvents[index] = {<br> text: "Wedding Anniversary",<br> month: 3,<br> day: 11<br> }<br> <p>The current year displayed can be selected by either selection within the listbox or appending the year to the query string. <br> Example: calendar_year.htm?2008.<br> </p> <h3><a name="faq-contact_manager"></a>Contact Manager<br> </h3> <p>PIM Fusion includes a web based contact manager for managing contact information. The contact manager uses an Excel spreadsheet as a backing store, which allows the data to be readily accessible in M$ format.<br> </p> <p>The available spreadsheets are displayed in a listbox with the Contact Manager, allowing different groups of contacts to be stored separately. New spreadsheets can be created by copying the file from webdocs/phpCIM/backup/template.xls to a new name in the webdocs/phpCIM directory.<br> </p> <p>The spreadsheets contain two macros:<br> </p> <ul> <li>exportToVCF</li> <li>exportToXML</li> </ul> which can be used for exporting the data into VCF or XML formats respectively.<br> <h2><a name="faq-use_case"></a>Use Case Scenarios</h2> <h3><a name="faq-knowledge_base"></a>Web based knowledge base</h3> The following scenario describes using PIM Fusion as a web based knowledge base. <br> <ul> <li>A web site is identified as content desired to be added to the PIM Fusion knowledge base<br> </li> <li>Using a web browser such as firefox, the site is saved to the local file system.</li> <li>An archive is created using the site files saved locally (filename and associated directory) in a zip or tar file</li> <li>The zip file is uploaded to PIM Fusion via the file manager</li> <li>The archive is expanded using the expand archive function within the PIM Fusion file manager</li> <li>The PIM Fusion content is reindexed using the Document Search tool</li> <li>The content is then searchable within PIM Fusion</li> </ul> The same approach can be used for M$ Word documents, Power Point Presentations, and Adobe PDFs.<br> <h3><a name="faq-sync_contact"></a> Syncing Contact Information with Cell Phone<br> </h3> The following technique can be used to sync your cell phone with PIM Fusion contacts.<br> <ul> <li>Purchase or download a 3rd party software for your cell that allows importing contact data. (Requires phone to have a USB or Bluetooth connection)<br> </li> <li>Download the Excel Spreadsheet containing the contact information that is desired to be exported</li> <li>Execute the macro within the spreadsheet to export contact data to VCF or XML format</li> <li>Import the VCF or XML data into the 3rd party software cell phone software</li> <li>Use the phone software to sync to your cell phone</li> </ul> <h2><a name="faq-misc_questions"></a>Miscellaneous questions</h2> <h3><a name="faq-non_functional"></a>Why isn't the remote terminal or document search functional in the web demo?</h3> These components of PIM Fusion require web server customization with administrative (root) privilages. <br> <br> The web demo is hosted Source Forge so this is not possible, however, these components are complete and functional in the download. <hr> <p>If you have additional questions or want to provide feedback on the PIM Fusion project, please leave feedback in Source Forge.</p> </body> </html>
Wordwrap: (IE only)
PIM Fusion v1.0
QuiXplorer 2.3
-
the QuiX project