Installation Guide Update
I found the Installation Guide on http://rscds.sourceforge.net/installation.php not quite up to date, or things missing, especially after changing the name to DAViCal. Therefore, an updated version here:
- 1 Installation Guide
for version 0.9.3 on Debian (with PostgreSQL 8.1)
- install the packages as described on http://rscds.sourceforge.net/installation.php
- also make sure that a postgre-sql server is available to your DAViCal installation (version 8.1 or higher). This database server can be on the same system as DAViCal, or on a different machine on the network. (Which is why it is not considered a dependecy of the DAViCal package.)
Creating the Web User for the Database
sudo su su postgres -c "createuser --no-createdb --no-createrole general"
After this command you might get a question wheater your new user(role) should be a superuser, it is inherent to answer yes on this question.
Creating and Building the Database
su postgres -c /usr/share/rscds/dba/create-database.sh
Connecting to the Database
Once your database has been created, you also need to edit your /etc/postgresql/8.1/main/pg_hba.conf file in order to grant the application access to the database as the 'general' user.
In a simple installation, where you do not have untrusted users on your database server, and your database is on the same computer as the web server, the following line (near the top of the pg_hba.conf file) should be enough:
local davical general trust
Don't forget to restart the PostgreSQL Server:
Apache Web Server Configuration
If you do not want or need a Virtual Host, the following line added to /etc/apache2/sites-available/default should be sufficient:
Alias /cal/ /usr/share/rscds/htdocs/
Don't forget to restart the Apache Web Server:
Create the file /etc/rscds/<domain>-conf.php and copy the following content into it:
<?php // $c->domain_name = "calendar.example.net"; // $c->sysabbr = 'rscds'; $c->admin_email = 'firstname.lastname@example.org'; $c->system_name = "Really Simple CalDAV Store"; // $c->collections_always_exist = true; // $c->enable_row_linking = true; $c->default_locale = en_US.UTF-8; $c->pg_connect = 'dbname=davical port=5432 user=general'; ?>
Adjust the values where appropriate. Details: http://rscds.sourceforge.net/installation.php
Link the file to localhost-conf.php:
cd /etc/rscds/ ln -s <domain>-conf.php localhost-conf.php
Correct AWL includes
For some strange reason, the DAViCal PHP scripts could not find the AWL includes, although installed (seems to be an include_path issue). One solution is:
cd /usr/share/rscds/inc ln -s /usr/share/awl/inc/* .
The password should be printed on the screen during database creation. You can also retrieve it by
su postgres psql davical -c 'select username, password from usr;'
(the password is the bit after the '**' in the 'password' field of the 'usr' table)
Login to DAViCAL Admin
If all is going well you should now be able to browse to the admin pages and log in as 'admin' with the given password on <servername>/cal/.
I have to log in on every page! Make sure there is no newline after the php end tag (?>) in your /etc/davical/<hostname>-conf.php