diff --git a/docs/website/administration.php b/docs/website/administration.php index 4702f861..d9078546 100644 --- a/docs/website/administration.php +++ b/docs/website/administration.php @@ -98,14 +98,14 @@ P4 ==>> Administers Group ==> G -
The RSCDS client setup page on sourceforge has information on how +
The DAViCal client setup page on sourceforge has information on how to configure Evolution, Mozilla Calendar (Sunbird & Lightning) and Mulberry to use remotely hosted calendars.
The administrative interface has no facility for viewing or modifying calendar data.
-If you can read this then things must be mostly working already.
-The RSCDS installation page on sourceforge has +
The DAViCal installation page on sourceforge has some further information on how to install and configure this application.
diff --git a/docs/website/inc/page-header.php b/docs/website/inc/page-header.php index f2433937..6fa74c3b 100644 --- a/docs/website/inc/page-header.php +++ b/docs/website/inc/page-header.php @@ -17,10 +17,14 @@ if ( isset($title) ) { echo $title; } else { +<<<<<<< HEAD:docs/website/inc/page-header.php echo "DAViCal CalDAV Server"; +======= + echo "DAViCal"; +>>>>>>> Rename to DAViCal in the documentation.:docs/website/inc/page-header.php } ?> -If you are interested in helping, there are several areas where I need help at the moment:
-to your /etc/apt/sources.list. Once you have done that you
can use apt-get or synaptic or some other equivalent package
-manager to fetch and install rscds and all the dependencies.
DAViCal and all the dependencies.
This repository is signed by Andrew McMillan's public key, which you can install so that you don't get asked for confirmation all the time:
@@ -31,15 +31,15 @@ notes to pages somewhere under here:We have created RPM packages of DAViCal and libawl-php from the .deb packages -using "alien". I don't know how well these work, so would appreciate feedback -about your success with them.
+using "alien". These are reported to work fine, so use them and then proceed to the +Pre-requisites section below.On SuSE Linux you may need to look in /var/lib/pgsql/data/ for the pg_hba.conf file.
You will need to download the latest versions of the rscds and awl packages
+
You will need to download the latest versions of the DAViCal and awl packages
from the sourceforge download page for DAViCal.
You will need to untar these. Preferably you will untar them from within the "/usr/share" directory and everything
will be in it's expected location (well, except the docs, but it will at least be tidy and everything will be in one place).
The following other software is also needed:
Since the CalDAV store takes over a significant amount of path -hierarchy, it is designed to be installed in it's own virtual -host. However if you want it to operate within the web root of some +hierarchy, it can be easier in it's own virtual +host. If you want it to operate within the web root of some other application there are instructions on the Wiki about doing this, -and other fancy tricks such as URL rewriting to shorten the path.
+as well as other fancy tricks such as configuring URL rewriting in +order to shorten the path.-su postgres -c /usr/share/rscds/dba/create-database.sh +su postgres -c /usr/share/davical/dba/create-database.sh
You can create a symlink from an existing web root directory to the +/usr/share/rscds/htdocs directory, such as:
+ ++cd /my/apache/docroot +ln -s /usr/share/davical/htdocs davical ++ +You will need to change your global PHP configuration to include the +directory '/usr/share/awl/inc' in the 'include_path' setting, along with +any other directories already needed by other applications. + +You will also need to ensure that 'magic_quotes_gpc' is off. + +
Your Apache instance needs to be configured for Virtual Hosts. If this is not already the case you may want to read some documentation about that, and you most likely will want to ensure that any existing -site becomes the **default** virtual host, with RSCDS only being a +site becomes the **default** virtual host, with DAViCal only being a single virtual host.
I use a Virtual Host stanza like this:
# -# Virtual Host def for Debian packaged RSCDS +# Virtual Host def for Debian packaged DAViCal <VirtualHost 123.4.56.78 > - DocumentRoot /usr/share/rscds/htdocs + DocumentRoot /usr/share/davical/htdocs DirectoryIndex index.php index.html ServerName davical.example.net ServerAlias calendar.example.net - Alias /images/ /usr/share/rscds/htdocs/images/ + Alias /images/ /usr/share/davical/htdocs/images/ php_value include_path /usr/share/awl/inc php_value magic_quotes_gpc 0 php_value register_globals 0 @@ -204,30 +222,30 @@ installed from a package.Once your VHost is installed an working correctly, you should be able to browse to that address and see a page telling you that -you need to configure RSCDS.
+you need to configure DAViCal.On Debian systems (or derivatives such as Ubuntu), when you are using Apache 2, you should put this definition in the /etc/apache2/sites-available directory and you can use the 'a2ensite' command to enable it.
-RSCDS Configuration
+DAViCal Configuration
-The RSCDS configuration generally resides in /etc/rscds/<domain>-conf.php +
The DAViCal configuration generally resides in /etc/davical/<domain>-conf.php and is a regular PHP file which sets (or overrides) some specific variables.
<?php // $c->domain_name = "calendar.example.net"; -// $c->sysabbr = 'rscds'; +// $c->sysabbr = 'DAViCal'; // $c->admin_email = 'admin@example.net'; -// $c->system_name = "Really Simple CalDAV Store"; +// $c->system_name = "DAViCal Server Administration"; // $c->collections_always_exist = true; // $c->enable_row_linking = true; // $c->default_locale = en_NZ.UTF-8; -// $c->pg_connect[] = 'dbname=rscds port=5433 user=general'; - $c->pg_connect[] = 'dbname=rscds port=5432 user=general'; + $c->pg_connect[] = 'dbname=davical port=5433 user=general'; + $c->pg_connect[] = 'dbname=davical port=5432 user=general'; ?>@@ -246,7 +264,7 @@ creation of calendar collections.The "enable_row_linking" option controls whether javascript is used to make the entire row clickable in browse lists in the administration pages. Since this doesn't work in Konqueror you may want to set this -to false if you expect people to be using Konqueror with the RSCDS +to false if you expect people to be using Konqueror with the DAViCal administration pages.
You should set the 'domain_name' and 'admin_email' as they are used @@ -283,7 +301,7 @@ are supported on your system.
pages and log in as 'admin' (the password is the bit after the '**' in the 'password' field of the 'usr' table so:-psql rscds -c 'select username, password from usr;' +psql davical -c 'select username, password from usr;'should show you a list. Note that once you change a password it @@ -301,8 +319,8 @@ about your experiences in the Wiki, including distribution specific notes, to pa
Upgrades
-Whenever you upgrade the RSCDS application to a new version you will need to -run dba/update-rscds-database which will apply any pending database patches, as well as +
Whenever you upgrade the DAViCal application to a new version you will need to +run dba/update-davical-database which will apply any pending database patches, as well as enabling any new translations.
In due course the running of this script will be able to be handled by