Add instructions to configure LibrePlan in openSUSE

README.openSUSE

@@ -0,0 +1,116 @@
+Configuring LibrePlan in openSUSE for first time
+================================================
+
+This section explains how to set up LibrePlan in openSUSE 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/createdb.sql
+
+
+2) Create libreplan user
+------------------------
+
+# psql -h localhost -U postgres < /usr/share/libreplan/pgsql/createuser.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) Download Java JDBC driver for PostgreSQL
+-------------------------------------------
+
+# wget http://jdbc.postgresql.org/download/postgresql-9.0-801.jdbc3.jar -O /usr/share/java/postgresql-jdbc3.jar
+
+
+6) Link Java JDBC driver for PostgreSQL in Tomcat6 libraries directory
+----------------------------------------------------------------------
+
+# ln -s /usr/share/java/postgresql-jdbc3.jar /usr/share/tomcat6/lib/
+
+
+7) Link LibrePlan WAR file in Tomcat6 we applications directory
+---------------------------------------------------------------
+
+# ln -s /usr/share/libreplan/webapps/libreplan.war /usr/share/tomcat6/webapps/
+
+
+8) Restart Tomcat6
+------------------
+
+# service tomcat6 restart
+
+
+LibrePlan should be running at http://localhost:8080/libreplan
+
+
+
+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.
+
+
+2) Restart Tomcat6
+------------------
+
+# service tomcat6 restart
+
+
+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