Anleitung. zur Einrichtung & Konfiguration von Baikal (CalDAV / CardDAV Server) auf einem Cubieboard 2/ Stefan W. Lambert kontakt@stefanius.

Transkript

1 Anleitung zur Einrichtung & Konfiguration von Baikal (CalDAV / CardDAV Server) auf einem Cubieboard 2/ Stefan W. Lambert kontakt@stefanius.de

2 Copyright-Hinweis Dieses Dokument obliegt den Bestimmungen der GNU-Lizenz für freie Dokumentation (GNU Free Documentation License Version 1.2) und darf unter Beachtung der Bestimmungen dieser Lizenz frei genutzt werden. Haftungsausschluß Die Nutzung dieses Dokumentes erfolgt auf eigene Gefahr. Der Autor übernimmt keinerlei Haftung für Schäden, die durch die Verwendung des Dokumentes entstehen. Ebenso übernimmt der Autor keinerlei Haftung für inhaltliche oder fachliche Mängel des Dokumentes Autor Stefan W. Lambert - Seite 2 -

3 Inhaltsverzeichnis 0. Vorbemerkung Voraussetzungen Installation und Konfiguration von Baikal Start/Stop Webserver Apache konfigurieren Baikal Benutzer einrichten Seite 3 -

4 - Seite 4 -

5 0.Vorbemerkung Dieses Dokument beschreibt die notwendigen Arbeitsschritte zur Installation und Konfiguration von Baikal ( CardDAV/CalDAV Server) auf einem Cubieboard 2/3 mit aktuellem HomeServer bzw. HomeNAS SD-Card Image. Als Betriebssystem dient Ubuntu LTS, so dass diese Anleitung für alle Ubuntu basierten Linuxsysteme (auch x86) gelten sollte. Dies ist jedoch nicht getestet. Anmerkung: Dieses Dokument vermittelt keine Grundlagenkenntnisse zu den Themena 'CardDAV' und 'CalDAV'. Die folgende Abbildung beschreibt das, dieser Anleitung zugrundeliegende Beispiel-Heimnetzwerk. - Seite 5 -

6 Folgende Gegebenheiten werden In diesem Tutorial vorausgesetzt: Das Heimnetzwerk nutzt den (privaten) IP-Adressbereich /24 Der Domainname des Heimnetzwerkes lautet 'mynet.home' Das Heimnetzwerk verfügt über einen des DNS/DHCP-Server (Anleitung zur Einrichtung eines DNS/DCP-Server im Heimnetzwerk s. ). Der IP-Adressbereich bis wird als DHCP-Adressbereich eingerichtet. Das Cubieboard, das als Hardwareplattform für Baikal dient,ist bereits auf eine statische IPAdresse (im Beispiel ) konfiguriert. - Seite 6 -

7 1.Voraussetzungen Eigentlich gibt es für die Nutzung von Baikal keine Voraussetzungen. Dennoch möchte ich auf folgendes hinweisen: In diesem Tutorial wird Baikal als Apache Vhost eingerichtet. Aus diesem Grund empfehle ich den Einsatz eines DNS-Servers. Die Installation und Konfiguration von 'dnsmasq' als DNS-Server ist nicht kompliziert und wird von mir unter ' beschrieben. Falls der Einsatz eines DNS-Servers nicht möglich/ gewünscht ist, kann alternativ dazu die lokale 'hosts'-datei der Clientsysteme genutzt werden. Dazu wird auf jedem Rechner/ Smartphone/Tablet, der/das auf den/die Baikal-Kalender und Kontaktdaten Zugriff haben soll in der 'hosts'-datei für den Baikal-Server folgendes (zusätzlich) eingetragen: <IP-Adresse> <Hostname des Baikalserver> Beispiel: baikal.mynet.home Wichtiger Hinweis: Um auf Android-Smartphones/Tablets die 'host'-datei ändern zu können, muss das betreffende Gerät 'gerooted' sein. Mehr Informationen zum Thema 'hosts'-datei: - Seite 7 -

8 2. Installation und Konfiguration von Baikal Cubieboard starten, anmelden (an der Konsole oder per ssh) und per sudo -i zum Benutzer root wechseln Welcome to CubieNAS V3n based on Ubuntu LTS (GNU/Linux sun7i+ armv7l) * Documentation: Last login: Mon Oct 13 16:21: from akl14zorin.example.com linaro@cubienas:~$ sudo -i Systemaktualisierungen durchführen root@cubienas:~# apt-get update root@cubienas:~# apt-get dist-upgrade Benötigte Pakete installieren root@cubienas:~# apt-get install php5-sqlite php-sabredav Baikal herunterladen root@cubienas:~# wget tgz Baikal entpacken root@cubienas:~# tar xvf baikal-regular tgz Baikalverzeichnis in 'baikal' umbenennen & nach /var/www/ verschieben root@cubienas:~# mv baikal-regular baikal root@cubienas:~# mv baikal/ /var/www/ Eigentümer des Baikal-Verzeichnisses auf 'www-data' setzen root@cubienas:~# chown -R www-data:www-data /var/www/baikal/ Apache vhost Konfigurationsdatei nach '/etc/apache2/sites-available' kopieren root@cubienas:~# cp /var/www/baikal/specific/virtualhosts/baikal.apache2 /etc/apache2/sites-available/baikal.conf - Seite 8 -

9 Apache vhost Konfigurationsdatei editieren nano /etc/apache2/sites-available/baikal.conf Datei-Inhalt vor Bearbeitung <VirtualHost *:80> DocumentRoot /var/www/dav.mydomain.com/html ServerName dav.mydomain.com RewriteEngine On RewriteRule /.well-known/carddav /card.php [R,L] RewriteRule /.well-known/caldav /cal.php [R,L] <Directory "/var/www/dav.mydomain.com/html"> Options None Options +FollowSymlinks AllowOverride All </Directory> </VirtualHost> Datei-Inhalt nach Bearbeitung <VirtualHost *:80> DocumentRoot /var/www/baikal/html/ ServerName baikal.mynet.home RewriteEngine On RewriteRule /.well-known/carddav /card.php [R,L] RewriteRule /.well-known/caldav /cal.php [R,L] <Directory "/var/www/baikal/html/"> Options None Options +FollowSymlinks AllowOverride All </Directory> </VirtualHost> Die markierten Einträge müssen an die tatsächlichen Gegebenheiten im Heimnetzwerk angepasst werden Anmerkung für die Bedienung des Texteditors: zum Speichern: gleichzeitiges Drücken der <strg>-taste und 'o' zum Schließen des Editors: gleichzeitiges Drücken der <strg>-taste und 'x' - Seite 9 -

10 Anmerkung: Ist im Heimnetzwerk ein DNS-Server vorhanden, wird als 'ServerName' der Domainname (Vhost) des Baikalservers eingetragen. Zusätzlich muss der ServerName in der Host-Datei des DNSServers eingetragen werden und der DNS-Dienst neu gestartet werden. Ist kein DNS-Server im Heimnetzwerk vorhanden bestehen zwei Möglichkeiten. 1. Als 'ServerName' wird die IP-Adresse des Rechners, auf dem Baikal installiert wird (im Beispielnetzwerk ' ') eingetragen. Das funktioniert jedoch nur, wenn der Baikal Server der einzige Webdienst auf dem Rechner ist (auf dem Baikal installiert ist), der auf den Netzwerkport 80 'hört'. 2. Als 'ServerName' wird der Domainname (Vhost) des Baikalservers eingetragen. Zusätzlich wird auf jedem Rechner/ Smartphone/Tablet, der/das auf den/die Baikal-Kalender und Kontaktdaten Zugriff haben soll, in der lokalen 'hosts'-datei für den Baikal-Server zusätzlich folgender Eintrag vorgenommen: <IP-Adresse des Baikalserver> <Hostname des Baikalserver> im Beispiel: baikal.mynet.home Mehr Informationen zum Thema 'DNS-Server' im Heimnetzwerk sind unter zu finden. Datei 'ENABLE_INSTALL' im Verzeichnis '/var/www/baikal/specific' anlegen touch /var/www/baikal/specific/enable_install Apache-Modul 'rewrite' aktivieren a2enmod rewrite Vhost 'baikal.mynet.home' in Apache einbinden ln -s /etc/apache2/sites-available/baikal.conf /etc/apache2/sites-enabled/baikal.conf Apache neustarten service apache2 restart - Seite 10 -

11 Baikal Website ' im Browser aufrufen und Installation vervollständigen 1 => Baikal Website 2 => Zeitzone (Europe/Berlin) 3 => CardDAV aktivieren 4 => Admin-Passwort 5 => Admin-Passwort bestätigen 6 => Änderungen speichern 1 => Änderungen speichern - Seite 11 -

12 1 => Änderungen speichern 1 => Installation abschließen und Baikal starten Damit ist die Installation von Baikal abgeschlossen - Seite 12 -

13 3. Start/Stop Webserver Apache konfigurieren Automatischen Start von Apache aktivieren Zum automatischen Starten von Apache sind folgende Arbeitsschritte auszuführen: Auf einem beliebigen Rechner im lokalen Netzwerk einen Browser öffnen und in der Adresszeile folgendes eingeben HomeNAS>:10000 Einloggen in Webmin (Benutzer: linaro, Passwort. linaro) Im Hauptmenü auf der linken Seite des Browserfensters /System/System-Start und-stop auswählen Aus der Liste der installierten Serverdienste 'Apache2' auswählen (den Checkbutton setzen) Zum Ende der Liste scrollen und dort den Button jetzt starten & zur Bootzeit aktivieren auswählen Automatischen Start von Apache deaktivieren Arbeitsschritte 1 4 wie bei Beschreibung der Deaktivierung ausführen Zum Ende der Liste scrollen und dort den Button jetzt stoppen & zur Bootzeit deaktivieren auswählen - Seite 13 -

14 4. Baikal Benutzer einrichten An der Baikal-Weboberfläche ' als Admin anmelden 'Users and resources' auswählen - Seite 14 -

15 'Add user' auswählen Benutzerdaten eingeben und mit 'Save Changes' bestätigen - Seite 15 -

16 Durch Auswahl des Buttons 'Calendars' einen neuen Kalender des Benutzers anlegen Die 'Kenndaten' des Default-Kalender durch Auswahl des Button 'Edit ändern (optional) - Seite 16 -

17 Änderung der 'Kenndaten' des Kalenders und abspeichern der Änderungen mit 'Save Changes' Anmerkung: Der eingerichtete Kalender kann von jedem CalDAV-Client über folgende URL erreicht werden: Im Beispiel: - Seite 17 -

18 Durch Auswahl des Buttons 'Adress Book' ein neues Adressbuch des Benutzers anlegen Die 'Kenndaten' des Default-Adressbuches durch Auswahl des Button 'Edit ändern (optional) - Seite 18 -

19 Änderung der 'Kenndaten' des Adressbuches und abspeichern der Änderungen mit 'Save Changes' Anmerkung: Das eingerichtete Adressbuch kann von jedem CardDAV-Client über folgende URL erreicht werden: Im Beispiel: - Seite 19 -

20 - Seite 20 -