replace letodms by seeddms

This commit is contained in:
Uwe Steinmann 2013-02-13 21:07:23 +01:00
parent 0487b37b51
commit d67075e1ef

80
README
View File

@ -1,16 +1,16 @@
-------------------------------------------------------------------
LetoDMS Installation Instructions
SeedDMS Installation Instructions
-------------------------------------------------------------------
NOTE FOR VERSION 4.0.0 ===================================================
Since version 4.0.0 of LetoDMS installation has been simplified.
Since version 4.0.0 of SeedDMS installation has been simplified.
ADOdb is no longer needed because the database access is done by
PDO.
IMPORTANT NOTE ABOUT TRANSLATIONS ========================================
as you can see letoDMS provides a lot of languages but we are not professional
as you can see SeedDMS provides a lot of languages but we are not professional
translators and therefore rely on user contributions.
If your language is not present in the login panel:
@ -33,25 +33,25 @@ If there is no help in your language:
- translate it
If you apply any changes to the language files please send them to the
letoDMS developers (www.letodms.com).
SeedDMS developers (www.seeddms.com).
BEFORE YOU START =========================================================
letoDMS has changed its installation process with version 3.0.0. This gives
you many more options in how to install letoDMS. First of all, letoDMS was
SeedDMS has changed its installation process with version 3.0.0. This gives
you many more options in how to install SeedDMS. First of all, SeedDMS was
split into a core package (LetoDMS_Core-<version>.tar.gz) and the web
application itself (letoDMS-<version>.tar.gz). The core is a pear package
application itself (seeddms-<version>.tar.gz). The core is a pear package
which could be installed as one. It is responsible for all the database
operations. The web application contains the gui not knowing anything about
the database layout. Second, one letoDMS installation can be used for
the database layout. Second, one SeedDMS installation can be used for
various customer instances by sharing a common source. Starting with
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
which can be downloaded from the letoDMS web page. Finally, letoDMS has
which can be downloaded from the SeedDMS web page. Finally, SeedDMS 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 SeedDMS:
1. with multiple instances
2. as a single instance
@ -67,7 +67,7 @@ on your web server.
0. Some preparation =======================================================
A common source of problems in the past have been the additional software
packages needed by letoDMS. Those are the PEAR packages Log and
packages needed by SeedDMS. Those are the PEAR packages Log and
HTTP_WebDAV_Server as well as Zend_Framework and ADOdb.
If you have full access to the server running a Linux distribution it is
recommended to install those with your package manager if they are provided
@ -80,7 +80,7 @@ php.ini or adding a line like
php_value include_path '/home/mypath:.:/usr/share/php'
to your apache configuration. Do not forget to add the standard include_path.
Another way to make letoDMS find all the additional software relies on the
Another way to make SeedDMS find all the additional software relies on the
ADOdb path in the configuration. The ADOdb path also extends the php
include path. This is done very early during the page creation. Consequently
all software installed below this path is found as well.
@ -95,9 +95,9 @@ 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/
http://localhost/seeddms/
* Point you web browser towards http://hostname/letodms/install/
* Point you web browser towards http://hostname/seeddms/install/
* Follow the instructions on the page and create a file ENABLE_INSTALL_TOOL
in the conf directory.
@ -128,7 +128,7 @@ LetoDMS_Lucene-<version>.tgz.
LetoDMS_Core-<version>.tgz' and 'pear install LetoDMS_Lucene-<version>.tgz'
* Unless ADODB is not already installed on your system, download
(http://adodb.sourceforge.net/) and unpack it in the letoDMS
(http://adodb.sourceforge.net/) and unpack it in the SeedDMS
directory
* The PEAR package Log is also needed. It can be downloaded from
@ -146,21 +146,21 @@ LetoDMS_Lucene-<version>.tgz.
For security reason the data folder should not be inside the public folders
or should be protected by a .htaccess file.
If you install letodms for the first time continue with the database setup.
If you install SeedDMS for the first time continue with the database setup.
* Create a new database on your web server
e.g. for mysql:
create database letodms;
create database seeddms;
* Create a new user for the database with all permissions on the new database
e.g. for mysql:
grant all privileges on letodms.* to letodms@localhost identified by 'secret';
grant all privileges on seeddms.* to seeddms@localhost identified by 'secret';
(replace 'secret' with you own password)
* Optionally import "create_tables.sql" in the new database
e.g. for mysql:
cat create_tables.sql | mysql -uletodms -p letodms
cat create_tables.sql | mysql -useeddms -p seeddms
This step can also be done by the install tool.
* create a file ENABLE_INSTALL_TOOL in the conf directory and point
your browser at http://host/<letodms-dir>/install
your browser at http://host/<seeddms-dir>/install
NOTE: UPDATING FROM A PREVIOUS VERSION
@ -168,26 +168,26 @@ NOTE: UPDATING FROM A PREVIOUS VERSION
- make a backup archive of your installation folder
- make a backup archive of your data folder
- dump your current database
- extract the letoDMS archive to your web server
- extract the SeedDMS archive to your web server
- edit the conf/settings.xml file to match your previuos settings
(you can even replace the file with your own one eventualy adding by hand
the missing new parameters)
- create a file ENABLE_INSTALL_TOOL in the conf directory and point
your browser at http://host/<letodms-dir>/install
your browser at http://host/<seeddms-dir>/install
The install tool will detect the version of your current letodms installation
The install tool will detect the version of your current SeedDMS installation
and run the required database updates.
3. Requirements ================================================================
letoDMS is a web-based application written in PHP. It uses the MySQL RDBMS to
SeedDMS is a web-based application written in PHP. It uses the MySQL RDBMS to
manage the documents that were uploaded into the application.
Make sure you have PHP 5.0 and MySQL 5 or higher installed. letoDMS
Make sure you have PHP 5.0 and MySQL 5 or higher installed. SeedDMS
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
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 SeedDMS will
work without gd, too).
You will also need to download and install the ADODB database
@ -241,12 +241,10 @@ files online. Load mod_rewrite and add to following lines to your conf:
IIS Users can download the IIS Rewrite Engine for example:
http://www.qwerksoft.com/products/iisrewrite/
Post any questions to the LetoDMS forum, please.
6. Nearly finished =============================================================
Now point your browser to http://your.server.com/letoDMS-<version>/index.php
Now point your browser to http://your.server.com/seedDMS-<version>/index.php
and login with "admin" both as username and password.
After having logged in you should first choose "My Account" and
change the Administrator's password and email-address.
@ -254,21 +252,21 @@ change the Administrator's password and email-address.
CONFIGURING MULTIPLE INSTANCES =================================================
Since version 3.0.0, letoDMS can be set up to run several parallel instances
Since version 3.0.0, SeedDMS can be set up to run several parallel instances
sharing the same source but each instance has its own configuration. This is
quite useful if you intend to host letoDMS for several customers. This
approach still allows to have diffenrent version of letoDMS installed
quite useful if you intend to host SeedDMS for several customers. This
approach still allows to have diffenrent version of SeedDMS installed
and will not force you to upgrade a customer instance, because other
instances are upgraded. A customer instance consists of
1. a directory containing mostly links to the letoDMS source and a
1. a directory containing mostly links to the SeedDMS source and a
configuration file
2. a directory containing the document content files
3. a database
1. Unpack the letoDMS distribution =============================================
1. Unpack the SeedDMS distribution =============================================
Actually there is no need to set up the database at this point but it won't
hurt since you'll need one in the next step anyway. The sources of letoDMS
hurt since you'll need one in the next step anyway. The sources of SeedDMS
can be anywhere you like. The do not have to be in you www-root. If you just
have access to your www-root directory, then put them there.
@ -280,10 +278,10 @@ Create a directory in your www-root or use www-root for your instance. In the
second case, you will not be able to create a second instance, because each
instance needs its own directory.
Go into that directory create the following links (<letoDMS-source> is the
directory of your initial letoDMS intallation).
Go into that directory create the following links (<seeddms-source> is the
directory of your initial SeedDMS intallation).
src -> <letoDMS-source>
src -> <seeddms-source>
inc -> src/inc
op -> src/op
out -> src/out
@ -292,7 +290,7 @@ styles -> src/styles
install -> src/install
index.php -> src/index.php
ln -s ../letoDMS-<version>
ln -s ../seeddms-<version>
ln -s src/inc inc
ln -s src/op op
ln -s src/out out
@ -305,7 +303,7 @@ Create a new directory named conf and run the installation tool.
Creating the links as above has the advantage that you can easily switch
to a new version and go back if it is necessary. You could even run various
instances of letoDMS using different versions.
instances of SeedDMS using different versions.
3. Create a database and data store for each instance ==========================
@ -316,7 +314,7 @@ Point your web browser towards the index.php file in your new instance.
LICENSING ======================================================================
LetoDMS is licensed unter GPLv2
SeedDMS is licensed unter GPLv2
Jumploader is licensed as stated by the author on th web site
(http://jumploader.com/)