AgenDAV 1.2.3 documentation

1. Installation

In this section you will be able to install AgenDAV.

1.1. Prerequisites

AgenDAV 1.2.3 requires the following software to be installed:

  • A CalDAV server (developed mainly with DAViCal
  • A web server
  • PHP > 5.2
  • PHP mbstring extension
  • MySQL > 5.1

1.2. Downloading AgenDAV and uncompressing

AgenDAV 1.2.3 can be obtained at AgenDAV official webpage, but you can use GitHub to download latest version. Have a look at http://github.com/adobo/agendav.

Uncompress it using tar:

$ tar xzf adobo-agendav-...tar.gz
$ cd adobo-agendav-.../

1.3. Database and tables

AgenDAV needs a MySQL database with several tables created. There is a file called schema.sql inside the directory sql/ which contains the table schemas.

Create an user in MySQL like this:

$ mysql -uroot -p
Enter password:
[...]
mysql> GRANT ALL PRIVILEGES ON agendav.* TO agendav@localhost IDENTIFIED BY 'yourpassword'
mysql> CREATE DATABASE agendav CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> FLUSH PRIVILEGES;
mysql> ^D

And then run the schema creation file:

$ mysql -uagendav -p agendav < sql/schema.sql
Enter password:
$

Now your database is ready.

1.4. Configuring Apache web server

Apache has to be configured to point to web/public directory, using its own VirtualHost or just an Alias.

Example using a dedicated virtualhost:

<VirtualHost 1.2.3.4:443>
 ServerAdmin admin@email.host
 DocumentRoot /path/to/agendav/web/public
 ServerName agendav.host
 ErrorLog logs/agendav_error_log
 CustomLog logs/agendav_access_log common
</VirtualHost>

Example using the Alias directive:

Alias /agendav /path/to/agendav/web/public

1.4.1. Other web servers

AgenDAV should work on all other web server software if they support PHP scripts, but this is untested.