(wie fast immer) als pdf-Dokument

Anleitung
zur Einrichtung & Konfiguration
von Baikal
(CalDAV / CardDAV Server)
auf einem Cubieboard 2/3
© 2015 Stefan W. Lambert
[email protected]
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
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
 [email protected]
Stand: 24.02.15
- Seite 2 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
Inhaltsverzeichnis
0. Vorbemerkung........................................................................................5
1. Voraussetzungen....................................................................................7
2. Installation und Konfiguration von Baikal........................................8
3. Start/Stop Webserver Apache konfigurieren.................................13
4. Baikal Benutzer einrichten ................................................................14
Stand: 24.02.15
- Seite 3 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
Stand: 24.02.15
- Seite 4 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
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 14.04.1 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.
Stand: 24.02.15
- Seite 5 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
Folgende Gegebenheiten werden In diesem Tutorial vorausgesetzt:
•
Das Heimnetzwerk nutzt den (privaten) IP-Adressbereich 192.168.1.0/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.
http://stefanius.de/installation-und-konfiguration-eines-dnsdhcp-servers-auf-cubieboard2-bzwcubietruck ).
Der IP-Adressbereich 192.168.1.200 bis 192.168.1.254 wird als DHCP-Adressbereich
eingerichtet.
Das Cubieboard, das als Hardwareplattform für Baikal dient ,ist bereits auf eine statische IPAdresse (im Beispiel 192.168.1.3) konfiguriert.
•
Stand: 24.02.15
- Seite 6 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
1.Voraussetzungen
Keine
Stand: 24.02.15
- Seite 7 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
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 14.04.1 LTS (GNU/Linux 3.4.104-sun7i+
armv7l)
* Documentation: https://help.ubuntu.com/
Last login: Mon Oct 13 16:21:03 2014 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 http://baikal-server.com/get/baikal-regular-
0.2.7.tgz
•
Baikal entpacken
root@cubieNAS:~# tar xvf baikal-regular-0.2.7.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/hosts-available'
kopieren
root@cubieNAS:~# cp baikal/Specific/virtualhosts/baikal.apache2
/etc/apache2/sites-available/baikal.conf
Stand: 24.02.15
- Seite 8 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
•
Apache vhost Konfigurationsdatei editieren
root@cubieNAS:~# 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'
Stand: 24.02.15
- Seite 9 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
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, wird als 'ServerName' die IP-Adresse des
Rechners, auf dem Baikal installiert wird (im Beispielnetzwerk '192.168.1.3') 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'.
Mehr Informationen zum Thema 'DNS-Server' im Heimnetzwerk sind unter
http://stefanius.de/installation-und-konfiguration-eines-dnsdhcp-servers-auf-cubieboard2-bzwcubietruck zufinden.
•
Datei 'ENABLE_INSTALL' im Verzeichnis '/var/www/baikal/Specific' anlegen
root@cubieNAS:~# touch /var/www/baikal/Specific/ENABLE_INSTALL
•
Apache-Modul 'rewrite' aktivieren
root@cubieNAS:~# a2enmod rewrite
•
Vhost 'baikal.mynet.home' in Apache einbinden
root@cubieNAS:~# ln -s /etc/apache2/sites-available/baikal.conf
/etc/apache2/sites-enabled/baikal.conf
•
Apache neustarten
root@cubieNAS:~# service apache2 restart
Stand: 24.02.15
- Seite 10 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
•
Baikal Website 'http://baikal.mynet.home/admin/install/' 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
Stand: 24.02.15
- Seite 11 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
1 => Änderungen speichern
1 => Installation abschließen und Baikal starten
Damit ist die Installation von Baikal abgeschlossen
Stand: 24.02.15
- Seite 12 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
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 https://<ip-adresse 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
Stand: 24.02.15
- Seite 13 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
4. Baikal Benutzer einrichten
•
An der Baikal-Weboberfläche 'http://baikal.mynet.home/admin' als Admin anmelden
•
'Users and resources' auswählen
Stand: 24.02.15
- Seite 14 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
•
'Add user' auswählen
•
Benutzerdaten eingeben und mit 'Save Changes' bestätigen
Stand: 24.02.15
- Seite 15 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
•
Durch Auswahl des Buttons 'Calendars' einen neuen Kalender des Benutzers anlegen
•
Die 'Kenndaten' des Default-Kalender durch Auswahl des Button 'Edit ändern (optional)
Stand: 24.02.15
- Seite 16 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
•
Ä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:
http://domainaname/baikal/cal.php/calendars/<benutzername>/<kalender>/
Im Beispiel:
http://baikal.mynet.home/baikal/cal.php/calendars/mmustermann/default
Stand: 24.02.15
- Seite 17 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
•
Durch Auswahl des Buttons 'Adress Book' ein neues Adressbuch des Benutzers anlegen
•
Die 'Kenndaten' des Default-Adressbuches durch Auswahl des Button 'Edit ändern
(optional)
Stand: 24.02.15
- Seite 18 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
•
Ä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:
http://domainaname/baikal/card.php/addressbooks/<benutzername>/<Adressbuch>/
Im Beispiel:
http://baikal.mynet.home/baikal/card.php/addressbooks/mmustermann/default
Stand: 24.02.15
- Seite 19 -
Ersteller: Stefan W. Lambert
Anleitung zur Einrichtung & Konfiguration von
Baikal (CalDAV / CardDAV-Server) auf einem Cubieboard 2/3
Stand: 24.02.15
- Seite 20 -
Ersteller: Stefan W. Lambert