Difference between revisions of "Installation Guide Update"

From Davical
Jump to navigationJump to search
(Imported from MoinMoin)
 
(Category:Installation)
 
(22 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
{{Languages|Installation Guide Update}}
 +
Please follow the installation instructions at [http://www.davical.org/installation.php http://www.davical.org/installation.php] which should be the most current official installation instructions.
  
 +
If you find problems with that document, please '''''do not''''' write an update in the wiki, but tell us about it on one of the [[DAViCal Mailing Lists|Mailing Lists]], or via the [[IRC|DAViCal IRC Channel]].  By all means do collect your thoughts together in a private document beforehand though.
  
I found the Installation Guide on [http://rscds.sourceforge.net/installation.php 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:
+
You may also want to review other people's [[Installation Experiences]] in specific distributions / versions, or visit the [[Installation Stuff]] page where there are some other links to distribution specific pages.
  
===Installation Guide===
+
[[Category:Installation]]
 
 
for version 0.9.3 on Debian (with PostgreSQL 8.1)
 
 
 
====Install Packages====
 
 
 
# install the packages as described on [http://rscds.sourceforge.net/installation.php http://rscds.sourceforge.net/installation.php]  
 
# also make sure that the postgre-sql server is installed (which for some strange reason is no dependecy of the DAViCal package)
 
 
 
====Creating the Web User for the Database====
 
 
 
<pre>sudo su
 
su postgres -c "createuser --no-createdb --no-createrole general"
 
</pre>
 
 
 
 
 
 
====Creating and Building the Database====
 
 
 
<pre>su postgres -c /usr/share/rscds/dba/create-database.sh
 
</pre>
 
 
 
 
 
 
====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:
 
 
 
<pre>local  davical    general  trust
 
</pre>
 
 
 
...
 
 
 
'''Don't forget to restart the PostgreSQL Server:'''
 
 
 
<pre>/etc/init.d/postgresql-8.1 restart
 
</pre>
 
 
 
====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:
 
 
 
<pre>Alias /cal/ /usr/share/rscds/htdocs/
 
</pre>
 
 
 
 
 
 
'''Don't forget to restart the Apache Web Server:'''
 
 
 
<pre>/etc/init.d/apache2 restart
 
</pre>
 
 
 
====DAViCal Configuration====
 
 
 
Create the file '''/etc/rscds/<domain>-conf.php''' and copy the following content into it:
 
 
 
<pre><?php
 
//  $c->domain_name = "calendar.example.net";
 
//  $c->sysabbr    = 'rscds';
 
  $c->admin_email = 'admin@example.net';
 
  $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';
 
 
 
?>
 
</pre>
 
 
 
Adjust the values where appropriate. Details: [http://rscds.sourceforge.net/installation.php http://rscds.sourceforge.net/installation.php]  
 
 
 
Link the file to '''localhost-conf.php''': <pre>cd /etc/rscds/
 
ln -s <domain>-conf.php localhost-conf.php
 
</pre>
 
 
 
====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:
 
 
 
<pre>cd /usr/share/rscds/inc
 
ln -s /usr/share/awl/inc/* .
 
</pre>
 
 
 
====Admin Password====
 
 
 
The password should be printed on the screen during database creation. You can also retrieve it by
 
 
 
<pre>su postgresql
 
psql davical -c 'select username, password from usr;'
 
</pre>
 
 
 
(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/'''.
 

Latest revision as of 20:49, 21 January 2016

Help
Available languages

Please follow the installation instructions at http://www.davical.org/installation.php which should be the most current official installation instructions.

If you find problems with that document, please do not write an update in the wiki, but tell us about it on one of the Mailing Lists, or via the DAViCal IRC Channel. By all means do collect your thoughts together in a private document beforehand though.

You may also want to review other people's Installation Experiences in specific distributions / versions, or visit the Installation Stuff page where there are some other links to distribution specific pages.