letodms for Debian
------------------

This package is the new upstream version of mydms package.
Since version 3.0.0 this package is officially named LetoDMS.
This package is based in mydms Debian package.


Configuring LetoDMS.
====================

Review /etc/letodms/settings.xml file to setup some global admin variables.
Once configured, LetoDMS is accesible by user 'admin', with password 'admin'
in http://localhost/letodms/
This password must be changed by security reasons.

By default, Apache configuration for LetoDMS allows access only to localhost,
see /etc/apache2/conf-available/letodms.conf:

<IfVersion >= 2.3>
	   Require local
</IfVersion> 

<IfVersion < 2.3>
	   Order deny,allow
	   Deny from all
	   Allow from 127.0.0.0/255.0.0.0 ::1/128
</IfVersion> 

If you need to allow remote access, you can change this settings
to allow it.  
For Apache 2.4 see https://httpd.apache.org/docs/2.4/howto/access.html
and Apache 2.2 see https://httpd.apache.org/docs/2.2/howto/access.html.

Please read more documentation about Apache web server in apache2-doc 
package or Apache web site:
http://httpd.apache.org/docs/2.2/ and http://httpd.apache.org/docs/2.4/

-----
Since letoDMS-3.3.11+dfsg-3, this package support Apache2.4.
By default, access is limited to localhost. If you want to
open access for all host you need to change the directive

<IfVersion >= 2.3>
	   Require local
</IfVersion> 

for this one:

<RequireAll>
    Require all granted
    Require not ip 10.252.46.165
</RequireAll>


For Apache2.4, please read the new access control documentation:
https://httpd.apache.org/docs/2.4/howto/access.html
------

In case of multiple instance follow the next steps.


Install multiple instances of LetoDMS.
======================================

Debian package installs one instance of LetoDMS. To install
more instances, follow the next steps:

1- Create the target directory in www server root directory,
commonly /var/www/<target_dir>

2- Create symlinks to some source dirs.

cd /var/www/<target_dir>
ln -s /usr/share/letodms/inc inc
ln -s /usr/share/letodms/op op
ln -s /usr/share/letodms/out out
ln -s /usr/share/letodms/languages languages
ln -s /usr/share/letodms/styles styles
ln -s /usr/share/letodms/index.php index.php
ln -s /usr/share/letodms/js js
ln -s /usr/share/letodms/utils utils

3- Create Letodms config file,

You can copy template config file settings.xml.template and set properly
the params.

mkdir /var/www/<target_dir>/conf
cp /usr/share/letodms/conf/settings.xml.template /var/www/<target_dir>/conf/settings.xml

4- Create a new data base for the new instance.
Using mysql:

create database <new_bdd>;

grant all privileges on <new_bdd>.* to <user>@localhost identified by
'<passwd>';

zcat /usr/share/doc/letodms/examples/create_tables.sql.gz | mysql -u<user> -p <new_bdd>
(You can use create_tables-innodb.sql file).

5- Set Data folder.

Create a directory writable by the web server user. This directory should
be out of the web public path for security reasons.
After this, set properly the contentDir in in 'server' tag settings file.
It is needed to set luceneDir and stagingDir parameters, writable by the web
server user too. (They can be subdirectories of contentDir parameter).

Once configured, LetoDMS is accesible by user 'admin', with password 'admin'
in http://localhost/letodms/
This password must be changed by security reasons.


Upgrade from previous myDMS versions.
=======================================

Please, before install this version save your old database with a backup.
After this, copy or rename the old mysql data base, named mydms, to new
letodms data base. 

The full proccess is as follows:

1- Copy or Rename old database to letodms.
2- Apply the letodms patchs by increasing order of version.

  http://localhost/letodms/install/update-1.8.1/update.php
  http://localhost/letodms/install/update-1.9/update.php
  http://localhost/letodms/install/update-2.0.1/update.php
  cat /usr/share/letodms/install/update-3.0.0/update.sql | mysql -u<user> -p letodms
  cat /usr/share/letodms/install/update-3.1.0/update.sql | mysql -u<user> -p letodms
  cat /usr/share/letodms/install/update-3.2.0/update.sql | mysql -u<user> -p letodms
  cat /usr/share/letodms/install/update-3.3.0/update.sql | mysql -u<user> -p letodms

Each script updates from a previous version.

4- Configure /etc/letodms/settings.xml properly 
with the database connect, old data folder, and any other needed settings.

Please, read /usr/share/doc/letodms/README.gz file for more information.

 -- Francisco Manuel Garcia Claramonte <francisco@debian.org>  Tue, 2 May 2012 18:27:58 +0200
