LibreSource, the other forge
                      Version 2.5 - 2008/05/21 - Paris


1) Introduction

  LibreSource is a versatile collaborative platform. Open Source, modular and highly customizable, 
  LibreSource is adapted to the collaborative software development, groupware, community leading, 
  e-archiving and Web publishing.

  Effective communication is a fundamental requirement for agile project management. 
  LibreSource embed the Tigase Jabber server and the Jeti Jabber client. 
  This integration allows notifications and informal communication thru instant messaging. 
  LibreSource simplifies the creation of a dynamic community and help to maintain and enhance 
  team relationship in order to improve the cooperative efficiency.

  LibreSource brings performance improvement and the support of JBoss. LibreSource enforce its 
  advantages. Several bugs have been fixed, the way security is handled has been smoothed, the server 
  is now faster, with a smaller memory footprint, and a better packaging. 
  Installation, configuration, customization and upgrade are now easier than ever.

  On a single server, LibreSource can host several projects, several groups of users, and grant 
  fine grain access to the resources. Based on Java/J2EE technology, LibreSource is a modular 
  web server that users can customize online by combining resources and rights: wiki pages, forum, 
  trackers, SCMs, files, download areas, dropbox, forms, etc.

  Sources, installer and community: http://www.libresource.org
  Additional support and services: 
     - Artenum company : http://www.artenum.com/libresource 
     - E-Mail : contact@artenum.com
     - or see the sections below

2) How to configure LibreSource

  LibreSource is a J2EE application that run under JONAS application server. 
  So the configuration is relative to the configuration of the JONAS application server.

  Those files have been modified from the default jonas package to integrate LibreSource. 
   - carol.properties : To set the jeremie protocol for RMI.
   - jaas.config      : To add the libresource login module
   - jonas.properties : To add mail service and load libresource specific configuration files.
 
  Specific configuration files:
   - libresourceDS.properties     : Specify the JDBC connection to the postgres database
   - libresourceMail.properties   : Specify the mail server to use for mail notification
   - libresourceConfig.properties : Used to configure any dynamic property of the libresource platform. 
                                    (host name, working directory, default working node, subversion configuration)
                                    
  For more information please read the INSTALL_JONAS.txt file.

3) How to Start and Stop LibreSource

  Execute the start.bat/start.sh script available in the root installation directory in order to start jonas. 
  Execute the stop.bat/stop.sh script in order to stop jonas.

  Caution: 
    - If you are working under windows, be aware that jonas does not support any space caractere in it's path.
    - Be sure that the database process is available to write in the "tmp-work/files" directory.

4) How to Start and Stop Tigase

  Tigase is the Jabber server embeded in LibreSource, and requires a JDK 1.6.
  To run it just execute the start script availble in its root directory, 
  and to stop it just kill the process.

  Caution: 
    - Tigase start script needs to be run from its current directory.
    
5) Support for the community

  Need help ?
   - http://dev.libresource.org/home/community/forum

  Need to report a bug ?
   - http://dev.libresource.org/home/development/bug
   
  Want something new in the next release ?
   - http://dev.libresource.org/home/development/new
  
  Need a specific deployement, development, commercial license ?
   - Please contact us at contact@artenum.com

6) Advanced services

   More advanced services are provided by the Artenum company. 
   
   Please see our website:
     - http://wwww.artenum.com/

   Libresource enterprise solution : 
     - http://wwww.artenum.com/fr/groupware/services.php

   Libresource product
     - http://www.artenum.com/libresource 

7)  Contact

    E-mail: contact@artenum.com

    Mail: Artenum SARL
          24 rue Louis Blanc
          75010 PARIS, FRANCE

    Phone: +33(0)1 46 94 67 54

    Owned :
      - Artenum SARL Paris
      - INRIA France

    The Libresource community thanks all other contributors, 
    please see the www.libresource.org for an exhaustive list.