Tutorial zur Einbindung einer Seafile Bibliothek (gültig für 'Dual Cubie Homeserver SD-Card Images' V3n u. V4n) 2015 Stefan W. Lambert kontakt@stefanius.de
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 kontakt@stefanius.de Stand: 31.03.15 - Seite 2 - Ersteller: Stefan W. Lambert
Inhaltsverzeichnis 0. Vorbemerkung...5 1. Voraussetzungen...7 2. Einbinden der Seafile-Bibliotheken...9 3. Zugriffstest von einem DLNA-Client aus durchführen...13 4. Fehlerbehebung falls die Mediadateien im DLNA Client nicht angezeigt werden...16 5. minidlna-datenbank per Cronjob aktualisieren...15 Stand: 31.03.15 - Seite 3 - Ersteller: Stefan W. Lambert
Stand: 31.03.15 - Seite 4 - Ersteller: Stefan W. Lambert
0.Vorbemerkung Tutorial zur zur Einbindung einer Seafile Bibliothek Dieses Dokument beschreibt die notwendigen Arbeitsschritte zur Einbindung einer (oder mehrerer) Seafile-Bibliothek(en). 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 Themen 'Seafile', 'Apache' und 'minidlna'. Dieses Tutorial wurde durch eine Anfrage eines Computeranwenders iniziert, der wissen wollte, ob es möglich ist, Mediadateien, die in Seafile gespeichert sind, mittels minidlna ins lokale Netzwerk zu streamen. Aus dem Grund zeige ich dieser Anleitung wie Seafile-Bibliotheken in die Verzeichnisstruktur von minidlna eingebunden werden. Grundsätzlich ist es jedoch möglich Seafile Bibliotheken an jedem Ort im Dateisystem eines Unix/Linuxrechners einzuhängen. Ebenso ist es möglich Seafile Bibliotheken in das Dateisystem anderer Linuxrechner im lokalen Netzwerk einzubinden. Als Seafile Benutzer wird in diesem Tutorial der in der Seafile- Grundkonfiguration angelegte Seafile-Admin genutzt. Grundsätzlich kann jedoch jeder in Seafile angelegte Benutzeraccount verwendet werden. In dieser Anleitung werden die Seafile-Bibliotheken durch den Linuxbenutzer 'root' in das Dateisystem eingebunden. Es ist jedoch auch möglich, dass weniger privilegierte Linuxbenutzer Seafile-Bibliotheken in das Linux- Dateisystem einhängen können. Mehr Informationen dazu sind unter 'http://wiki.ubuntuusers.de/webdav' zu finden. Stand: 31.03.15 - Seite 5 - Ersteller: Stefan W. Lambert
Empfehlung zur Speicherung von Mediadateien in Seafile für das Streaming mittels minidlna Der Streaming-Server minidlna kann nur mit Mediadateien umgehen. Aus dem Grund empfehle ich zur Speicherung von Mediadateien in Seafile eine der beiden nachfolgend beschriebenen Vorgehensweisen zu befolgen. Variante 1 In Seafile getrennte Bibliotheken für Musik, Bilder und Videos anlegen und die entsprechenden Mediadateien ausschließlich in der dafür vorgesehenen Bibliothek speichern. Variante 2 Eine Seafile-Bibliothek ausschließlich für Mediadaten anlegen, darin getrennte Verzeichnisse für Musik, Bilder und Videos erzeugen und die entsprechenden Mediadateien ausschließlich in der dafür vorgesehenen Verzeichnissen speichern. Die beiden Empfehlungen sind zwar nicht zwingend vorgeschrieben, ich bitte jedoch um Verständnis, dass ich nur dann Support leiste, wenn eine der beschriebenen Varianten eingesetzt wird. In diesem Tutorial nutze ich die Variante 1 Stand: 31.03.15 - Seite 6 - Ersteller: Stefan W. Lambert
1.Voraussetzungen Tutorial zur zur Einbindung einer Seafile Bibliothek Die wichtigste Voraussetzung für dieses Tutorial ist, daß Seafile gemäß der Anleitung 'http://stefanius.de/seafile-auf-apachewebserver-umstellen-und-seafile-webdav-aktivieren' auf den Apache Webserver umgestellt ist, und daß die Seafile_Webdav Erweiterung aktiviert ist. Stand: 31.03.15 - Seite 7 - Ersteller: Stefan W. Lambert
Das Testscenario Tutorial zur zur Einbindung einer Seafile Bibliothek Für dieses Tutorial sind in Seafile für den Seafile-Benutzer 'seafile_adm@seafile.local' folgende Bibliotheken angelegt: Jede der Bibliotheken enthält eine Mediadatei SeafileMusic TestSong.mp3 SeafileVideos TestVideo.mp4 SeafileFotos TestFoto.jpg Zum späteren Einbinden der Seafile-Webdav Verzeichnisse ins Dateisystem werden in den Mediaverzeichnissen von minidlna Unterverzeichnisse angelegt. Diese Verzeichnisse heißen jeweils 'FromSeafile' /srv/fileserver/multimedia Bilder FromSeafile Musik FromSeafile Videos FromSeafile Stand: 31.03.15 - Seite 8 - Ersteller: Stefan W. Lambert
2. Einbinden der Seafile-Bibliotheken 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 1. Benötigte Programmpakete installieren root@cubienas:~# apt-get install ca-certificates davfs2 2. Erzeugen 'Mount'-Verzeichnisse für Seafile root@cubienas:~# mkdir -p /srv/fileserver/multimedia/videos/fromseafile root@cubienas:~# mkdir -p /srv/fileserver/multimedia/musik/fromseafile root@cubienas:~# mkdir -p /srv/fileserver/multimedia/bilder/fromseafile 3. Eigentümer setzen für Verzeichnis root@cubienas:~# chown -R linaro:fsusers /srv/fileserver/multimedia/ Stand: 31.03.15 - Seite 9 - Ersteller: Stefan W. Lambert
4. Seafile-Webdav Verzeichnis testweise mit root-rechten mounten root@cubienas:~# mount -t davfs http://seafile.mynet.home/seafdav /srv/fileserver/multimedia/videos/fromseafile/ Gib bitte den Benutzernamen für den Server http://seafile.mynet.home/seafdav an; wenn du keinen angeben willst, drücke Return. Benutzername: seafile_adm@seafile.local Gib bitte das Passwort von seafile_adm@seafile.local für den Server http://seafile.mynet.home/seafdav an; wenn du keines angeben willst, drücke Return. Passwort: seafile 5. Vorbereitung Automount 5a. Vorbereitung 'Passwort-Datei' /etc/davfs2/secrets root@cubienas:~# mv /etc/davfs2/secrets /etc/davfs2/secrets.org root@cubienas:~# nano /etc/davfs2/secrets Geänderte /etc/davfs2/secrets # Syntax <Mountpoint / WebDAV-URL> <login> <passwort> # http://seafile.mynet.home/seafdav/seafilevideos/ seafile http://seafile.mynet.home/seafdav/seafilemusic/ seafile http://seafile.mynet.home/seafdav/seafilefotos/ seafile seafile_adm@seafile.local seafile_adm@seafile.local seafile_adm@seafile.local 5b. Zugriffsrechte für /etc/davfs2/secrets setzen root@cubienas:~# chmod 600 /etc/davfs2/secrets Stand: 31.03.15 - Seite 10 - Ersteller: Stefan W. Lambert
5c. 'mount'-befehl in /etc/rc.local einfügen root@cubienas:~# nano /etc/rc.local Geänderte /etc/rc.local #!/bin/sh -e # # rc.local sleep 15 mount -t davfs http://seafile.mynet.home/seafdav/seafilevideos /srv/fileserver/multimedia/videos/fromseafile/ # mount -t davfs http://seafile.mynet.home/seafdav/seafilemusic /srv/fileserver/multimedia/musik/fromseafile/ # mount -t davfs http://seafile.mynet.home/seafdav/seafilefotos /srv/fileserver/multimedia/bilder/fromseafile/ exit 0 Anmerkung: sleep 15 bewirkt, dass nach dem Hochfahren des Rechners eine Wartezeit von 15sec bis zum mounten der Seafile-Bibliotheken eingehalten wird. Dadurch soll sichergestellt werden, dass bevor der 'Mount'-Befehl ausgeführt wird, der Seafile-Server und Seafile-Webdav verfügbar ist. 6. System rebooten root@cubienas:~# reboot Stand: 31.03.15 - Seite 11 - Ersteller: Stefan W. Lambert
7.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 8. ein paar Sekunden abwarten, dann überprüfen ob das Webdav- Verzeichnis eingebunden ist root@cubienas:~# cd /srv/fileserver/ root@cubienas:/srv/fileserver# tree multimedia multimedia Bilder FromSeafile lost+found TestFoto.jpg Musik FromSeafile lost+found TestSong.mp3 Videos FromSeafile lost+found TestVideo.mp4 minidlnatest.mp4 Stand: 31.03.15 - Seite 12 - Ersteller: Stefan W. Lambert
3. Zugriffstest von einem DLNA-Client aus durchführen Der Test erfolgt von einem Android Tablet 1. Auswahl des DLNA-Servers Stand: 31.03.15 - Seite 13 - Ersteller: Stefan W. Lambert
2. Auswahl des Ordners 'Bilder' Stand: 31.03.15 - Seite 14 - Ersteller: Stefan W. Lambert
3. Auswahl des Ordners FromSeafile Schritt 2-3 für die Verzeichnisse 'Musik' und 'Video' wiederholen Stand: 31.03.15 - Seite 15 - Ersteller: Stefan W. Lambert
4. Fehlerbehebung falls die Mediadateien im DLNA Client nicht angezeigt werden In der Regel aktualisiert der minidlna-server, wenn Mediadateien hinzugefügt oder entfernt werden, seine Datenbank automatisch. Falls die Seafile-Mediadateien im DLNA-Client nicht innerhalb einer Zeitspanne von 10 Minuten nach dem Einbinden der Seafile-Webdav Verzeichnisse in das Dateisystem, angezeigt werden, sollte die minidlna-datenbank manuell aktualisiert werden. Dazu sind folgende Arbeitsschritte auszuführen: 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 Minidlna Datenbank Aktualisierung durchführen root@cubienas:~# service mindlna reload Stand: 31.03.15 - Seite 16 - Ersteller: Stefan W. Lambert
5. minidlna-datenbank per Cronjob aktualisieren Für den Fall, dass die automatische Aktualisierung der minidlna- Datenbank dauerhaft nicht funktionieren sollte, ist im CubieNAS SD- Card Image bereits ein Cronjob, der lediglich noch aktiviert werden muss, definiert. Um den Cronjob zu aktivieren sind folgende Arbeitsschritte notwendig: 1. Von einem beliebigen Rechner im Heimnetzwerk per Browser auf dem Cubieboard Webmin aufrufen, als Benutzer 'linaro' anmelden, dann System => geplante Aufträge (cron) auswählen und einen Doppelklick auf 'service minidlna force-reload' ausführen Stand: 31.03.15 - Seite 17 - Ersteller: Stefan W. Lambert
2. Im Fenster 'Cron-Auftrag bearbeiten' können die Einstellungen zum Cronjob, insbesondere die Ausführungszeit(en) (markierter Bereich 1) geändert werden. Als Vorgabe wird der Cronjob zur Aktualisierung der minidlna-datenbank alle 15min ausgeführt. Falls Änderungen vorgenommen worden sind, werden diese durch Auswahl des Buttons 'Speichern' gespeichert. 3. Den Cronjob durch Auswahl des Checkbutton (1) auswählen und mit dem Button 'Aktiviere ausgewählte Aufträge' aktivieren Stand: 31.03.15 - Seite 18 - Ersteller: Stefan W. Lambert