- updated to new installation process

This commit is contained in:
steinm 2011-10-26 07:30:20 +00:00
parent 3c6b087a74
commit cb9710c08f

63
README
View File

@ -41,21 +41,46 @@ the database layout. Second, one letoDMS installation can be used for
various customer instances by sharing a common source. Starting with various customer instances by sharing a common source. Starting with
version 3.2.0 a full text search engine has been added. This requires version 3.2.0 a full text search engine has been added. This requires
the zend framework and another pear package LetoDMS_Lucene-<version>.tar.gz the zend framework and another pear package LetoDMS_Lucene-<version>.tar.gz
which can be downloaded from the letoDMS web page. which can be downloaded from the letoDMS web page. Finally, letoDMS has
got a web based installation, which takes care of most of the installation
process.
Before you proceed you have to decide how to install letoDMS: Before you proceed you have to decide how to install letoDMS:
1. with multiple instances 1. with multiple instances
2. as a single instance 2. as a single instance
Both have its pros and cons but as a general rule, try a setup for Both have its pros and cons, but
multiple instances first, even if your currently only planing for 1. setting up a single instance is easier if you have not shell access to
one instance. the web server
2. the installation script is only tested on single instances
Installation for multiple instances shares the same source by many Installation for multiple instances shares the same source by many
instances but requires to create links which is not in any case possible instances but requires to create links which is not in any case possible
at your web hoster. on your web server.
0. Quick installation instructions (single instance) =========================== 1. Using the installation tool ============================================
The installation tool currently does not support to update an existing
letoDMS installation!
Unpack LetoDMS-<version>.tar.gz and LetoDMS_Core-<version>.tar.gz on
your web server. For the full text search engine support, you will also
need to unpack LetoDMS_Lucene-<version>.tar.gz. For the following instructions
we will assume the files of LetoDMS-<version>.tar.gz are accessible through
http://localhost/letodms/
* Point you web browser towards http://hostname/letodms/install/
* Follow the instructions on the page and create a file ENABLE_INSTALL_TOOL
in the conf directory.
* Clicking on 'Start installation' will show a form with all necessary
settings for a basic installation.
* After saving your settings you are ready to log in as admin and continue
customizing your installation with the 'Admin Tools'
2. Detailed installation instructions (single instance) =====================
You need a working web server with MySQL/PHP5 support and the files You need a working web server with MySQL/PHP5 support and the files
LetoDMS-<version>.tar.gz and LetoDMS_Core-<version>.tar.gz. For the LetoDMS-<version>.tar.gz and LetoDMS_Core-<version>.tar.gz. For the
@ -73,9 +98,12 @@ LetoDMS_Lucene-<version>.tar.gz.
http://pear.php.net/package/Log. Unpack it a place where it can be http://pear.php.net/package/Log. Unpack it a place where it can be
found be php. found be php.
* Create a data folder somewhere in your web server. The data folder created * The package HTTP_WebDAV_Server is also needed. It can be downloaded from
by the letoDMS archive should work for a test installation and must be http://pear.php.net/package/HTTP_WebDAV_Server. Unpack it a place where
writable by the web-server user. it can be found be php.
* Create a data folder somewhere on your web server and make sure it is
writable by your web server.
For security reason the data folder should not be inside the public folders. For security reason the data folder should not be inside the public folders.
@ -111,12 +139,12 @@ one in the folder name. For example to update from a 1.7.1 to 1.9 you need
to run both UPDATE-v1.8.1/update.php and UPDATE-v1.9/update.php. to run both UPDATE-v1.8.1/update.php and UPDATE-v1.9/update.php.
1. Requirements ================================================================ 3. Requirements ================================================================
letoDMS is a web-based application written in PHP. It uses the MySQL RDBMS to letoDMS is a web-based application written in PHP. It uses the MySQL RDBMS to
manage the documents that were uploaded into the application. manage the documents that were uploaded into the application.
Make sure you have PHP 5.0 and MySQL 4 or higher installed. letoDMS Make sure you have PHP 5.0 and MySQL 5 or higher installed. letoDMS
will work with PHP running in CGI-mode as well as running as module under will work with PHP running in CGI-mode as well as running as module under
apache. If you want to give your users the opportunity of uploading passport apache. If you want to give your users the opportunity of uploading passport
photos you have to enable the gd-library (but the rest of letoDMS will photos you have to enable the gd-library (but the rest of letoDMS will
@ -124,15 +152,16 @@ work without gd, too).
You will also need to download and install the ADODB database You will also need to download and install the ADODB database
abstraction library from http://adodb.sf.net/ unless it is not installed abstraction library from http://adodb.sf.net/ unless it is not installed
on your system already. on your system already. The webdav server uses the pear packages 'Log' and
'HTTP_WebDAV_Server'. Both can be downloaded from http://pear.php.net.
If you plan to use the full text search engine you will have to install If you plan to use the full text search engine you will have to install
the zend framework, too. the zend framework, too.
2. Installation & Configuration ================================================ 4. Installation & Configuration ================================================
Unzip the downloaded file (LetoDMS-<version>.tar.gz) in a directory that is Unpack the downloaded file (LetoDMS-<version>.tar.gz) in a directory that is
accessible via your web server. Do the same for the file accessible via your web server. Do the same for the file
LetoDMS_Core-<version>.tgz and LetoDMS_Lucene-<version>.tgz. LetoDMS_Core-<version>.tgz and LetoDMS_Lucene-<version>.tgz.
These files may not be unpacked below the These files may not be unpacked below the
@ -193,7 +222,7 @@ should also change the value for "post_max_size" and make sure that
your web-server does not limit the size either). your web-server does not limit the size either).
3. Email Notification ========================================================== 5. Email Notification ==========================================================
A notification system allows users to receive an email when a A notification system allows users to receive an email when a
document or folder is changed. This is an event-based mechanism that document or folder is changed. This is an event-based mechanism that
@ -208,7 +237,7 @@ their notification subscriptions. This can be found in the "My Account"
section under "Notification List". section under "Notification List".
4. Auto-conversion to HTML ===================================================== 6. Auto-conversion to HTML =====================================================
Version 1.3.0 introduces a new feature: Documents can automatically be Version 1.3.0 introduces a new feature: Documents can automatically be
converted to HTML when uploading. converted to HTML when uploading.
@ -238,7 +267,7 @@ http://www.qwerksoft.com/products/iisrewrite/
Post any questions to the LetoDMS forum, please. Post any questions to the LetoDMS forum, please.
5. Nearly finished ============================================================= 7. Nearly finished =============================================================
Now point your browser to http://your.server.com/letoDMS-<version>/index.php Now point your browser to http://your.server.com/letoDMS-<version>/index.php
and login with "admin" both as username and password. and login with "admin" both as username and password.