Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/LibrePlan/libreplan

LibrePlan - Open Web Planning
https://github.com/LibrePlan/libreplan

Last synced: 5 days ago
JSON representation

LibrePlan - Open Web Planning

Awesome Lists containing this project

README 

        
Configuring LibrePlan in Fedora for first time

==============================================



This section explains how to set up LibrePlan in Fedora after installing the

package.



It assumes that PostgreSQL is already running and configured to use ``md5`` as

the authentication method.



If this is not the case, go to section "Configuring PostgreSQL to use ``md5``

authentication method", at the end of this document.



1) Create libreplan database

----------------------------



# psql -h localhost -U postgres < /usr/share/libreplan/pgsql/create_db.sql



2) Create libreplan user

------------------------



# psql -h localhost -U postgres < /usr/share/libreplan/pgsql/create_user_postgresql.sql



3) Install LibrePlan database

-----------------------------



# psql -h localhost -U libreplan -W libreplan < /usr/share/libreplan/pgsql/install.sql



4) Link LibrePlan configuration file in Tomcat6 configuration directory

-----------------------------------------------------------------------



# ln -s /usr/share/libreplan/conf/libreplan.xml /etc/tomcat6/Catalina/localhost/



5) Link Java JDBC driver for PostgreSQL in Tomcat6 libraries directory

----------------------------------------------------------------------



# ln -s /usr/share/java/postgresql-jdbc3.jar /usr/share/tomcat6/lib/



6) Link LibrePlan WAR file in Tomcat6 we applications directory

---------------------------------------------------------------



# ln -s /usr/share/libreplan/webapps/libreplan.war /var/lib/tomcat6/webapps/



7) Restart Tomcat6

------------------



# service tomcat6 restart



LibrePlan should be running at http://localhost:8080/libreplan



Review INSTALL file for more information.



Upgrading LibrePlan a.b.c to LibrePlan x.y.z

============================================



This section explains how to upgrade LibrePlan from version a.b.c to version x.y.z.



1) Run upgrade scripts

----------------------



# psql -h localhost -U libreplan -W libreplan < /usr/share/libreplan/pgsql/upgrade_x.y.z.sql



*VERY IMPORTANT*: If there are other versions between a.b.c and x.y.z, we need to execute those scripts in order, so the upgrade is done correctly.



*WARNING*: If you are using PostgreSQL version 8 you will have to execute the next command over LibrePlan database in order to use the upgrade script for version 1.3.0:



# su postgres -c "createlang -d libreplan plpgsql"



2) Stop Tomcat6

---------------



# service tomcat6 stop



3) Remove current deployed aplication

-------------------------------------



# rm -rf /var/lib/tomcat6/webapps/libreplan/



4) Start Tomcat6

----------------



# service tomcat6 start



LibrePlan should be running at http://localhost:8080/libreplan



Configuring PostgreSQL to use ``md5`` authentication method

===========================================================



We assume that PostgreSQL is using ``md5`` as the authentication method, instead of default ``ident``.



These are the steps to change it.



1) Add a password to 'postgres' user (for instance, let's use 'postgres' as password')

--------------------------------------------------------------------------------------



# su postgres -c psql



postgres=# ALTER USER postgres WITH PASSWORD 'postgres';

postgres=# \q



2) Edit '/var/lib/pgsql/data/pg_hba.conf' and replace ``ident`` by ``md5``

--------------------------------------------------------------------------



# sed -i "/^host/s/ident/md5/g" /var/lib/pgsql/data/pg_hba.conf



3) Restart PostgreSQL

---------------------



# service postgresql restart