Tutorial
Transcription
Tutorial
Tutorial zur Umstellung von Seafile – http auf Apache Webserver und zur Aktivierung der Seafile Webdav Erweiterung (gültig für 'Dual Cubie Homeserver SD-Card Images' V3n u. V4n) © 2015 Stefan W. Lambert [email protected] Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 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: 30.03.15 - Seite 2 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) Inhaltsverzeichnis 0. Vorbemerkung........................................................................................5 1. Voraussetzungen....................................................................................7 2. Umstellung auf Apache u. Aktivierung Seafile-Webdav................8 3. Start/Stop Webserver Apache konfigurieren.................................13 4. Seafile Webinterface testen..............................................................14 5 Seafile Webdav testen.........................................................................15 Stand: 30.03.15 - Seite 3 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) Stand: 30.03.15 - Seite 4 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) Stand: 30.03.15 - Seite 5 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 0.Vorbemerkung Dieses Dokument beschreibt die notwendigen Arbeitsschritte zur Umstellung von Seafile – http auf Apache Webserver und zur Aktivierung der Seafile Webdav Erweiterung. 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' und 'Apache'. Die folgende Abbildung beschreibt das, dieser Anleitung zugrundeliegende Beispiel-Heimnetzwerk. Stand: 30.03.15 - Seite 6 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 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-dnsdhcpservers-auf-cubieboard2-bzw-cubietruck ). Der IP-Adressbereich 192.168.1.200 bis 192.168.1.254 wird als DHCPAdressbereich eingerichtet. Das Cubieboard, das als Hardwareplattform für Seafile dient ,ist bereits auf eine statische IP-Adresse (im Beispiel 192.168.1.3) konfiguriert. Stand: 30.03.15 - Seite 7 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 1.Voraussetzungen Seafile ist gemäß der 'Anleitung zur Basiskonfiguration des CubieNAS SD-Card Image V4n' oder der 'Anleitung zur Basiskonfiguration des CubieNAS SD-Card Image V3n' eingerichtet und funktioniert fehlerfrei. Zum Thema DNS In diesem Tutorial wird Seafile als Apache Vhost eingerichtet. Aus diesem Grund empfehle ich den Einsatz eines DNS-Servers im lokalen Netzwerk. Die Installation und Konfiguration von 'dnsmasq' als DNS-Server ist nicht kompliziert und wird von mir unter ' http://stefanius.de/installation-undkonfiguration-eines-dnsdhcp-servers-auf-cubieboard2-bzw-cubietruck' 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 SeeafileServer Zugriff haben soll, in der 'hosts'-Datei für den Seafile-Server folgendes (zusätzlich) eingetragen: <IP-Adresse> <Hostname des Seafile-Server> Beispiel: 192.168.1.3 seafile.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: http://de.wikipedia.org/wiki/Hosts-Datei Stand: 30.03.15 - Seite 8 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 2. Umstellung von Seafile – http auf Apache Webserver u. Aktivierung Seafile-Webdav 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 1. Systemaktualisierungen durchführen root@cubieNAS:~# apt-get update root@cubieNAS:~# apt-get dist-upgrade 2. Installation der benötigten Programmpakete root@cubieNAS:/# apt-get install python-flup libapache2-mod-fastcgi 3. Benötigte Apache Module aktivieren root@cubieNAS:/# a2enmod rewrite root@cubieNAS:/# a2enmod fastcgi root@cubieNAS:/# a2enmod proxy_http 4. apache2.conf bearbeiten root@cubieNAS:~# cp /etc/apache2/apache2.conf /etc/apache2/apache2.conf.org root@cubieNAS:~# nano /etc/apache2/apache2.conf am Ende der Datei folgende Textzeilen einfügen: FastCGIExternalServer /var/www/seafile/seahub.fcgi -host 127.0.0.1:8000 FastCGIExternalServer /var/www/seafile/seafdav.fcgi -host 127.0.0.1:8080 Stand: 30.03.15 - Seite 9 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 5. Verzeichnis '/var/www/seafile' anlegen root@cubieNAS:/# mkdir -p /var/www/seafile 6.Datei 'seafile.conf' in /etc/apache2/sites-available anlegen und mit Inhalt füllen Inhalt der Datei: <VirtualHost *:80> ServerName seafile.mynet.home DocumentRoot /var/www/seafile Alias /media /home/seafile/seafile-server-4.0.6/seahub/media # # # # # # Anmerkung zu Alias: folgender Alias funktioniert nicht Alias /media /home/user/seafile/seafile-server-latest/seahub/media Fehler: Die Website wird nicht richtig dargestellt RewriteEngine On <Location /media> Require all granted </Location> # # seafile fileserver # ProxyPass /seafhttp http://127.0.0.1:8082 ProxyPassReverse /seafhttp http://127.0.0.1:8082 RewriteRule ^/seafhttp - [QSA,L] # # seafile webdav # RewriteCond %{HTTP:Authorization} (.+) RewriteRule ^(/seafdav.*)$ /seafdav.fcgi$1 [QSA,L,e=HTTP_AUTHORIZATION:%1] RewriteRule ^(/seafdav.*)$ /seafdav.fcgi$1 [QSA,L] # # seahub # RewriteRule ^/(media.*)$ /$1 [QSA,L,PT] RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ /seahub.fcgi$1 [QSA,L,E=HTTP_AUTHORIZATION:% {HTTP:Authorization}] </VirtualHost> Die markierte Konfigurationseinstellung muss den individuellen 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: 30.03.15 - Seite 10 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) Anmerkung: Bei einem Update/Ugrade von Seafile muss hier das Verzeichnis der neuen Seafile Version eingetragen werden. Die Datei 'seafile.conf' kann von 'http://dl.stefanius.de/cubie/Software/seafile_apache/seafile.conf' heruntergeladen werden Zum Thema DNS-Server und Namensauflösung: In diesem Tutorial wird Seafile als Apache Vhost eingerichtet. Aus diesem Grund empfehle ich den Einsatz eines DNS-Servers im lokalen Netzwerk. Die Installation und Konfiguration von 'dnsmasq' als DNSServer ist nicht kompliziert und wird von mir unter ' http://stefanius.de/installation-und-konfiguration-eines-dnsdhcpservers-auf-cubieboard2-bzw-cubietruck' 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 Seeafile-Server Zugriff haben soll in der 'hosts'-Datei für den Seafile-Server folgendes (zusätzlich) eingetragen: <IP-Adresse des Seafile-Server> <Hostname des Seafile-Server> im Beispiel: 192.168.1.3 seafile.mynet.home Mehr Informationen zum Thema 'DNS-Server' im Heimnetzwerk sind unter http://stefanius.de/installation-und-konfiguration-eines-dnsdhcp-serversauf-cubieboard2-bzw-cubietruck zu finden. 7.Symbol. Link in /etc/apache2/sites-enable erzeugen root@cubieNAS:~# ln -s /etc/apache2/sites-available/seafile.conf /etc/apache2/sites-enabled/seafile.conf 8.Datei 'ccnet.conf' bearbeiten root@cubieNAS:~# su seafile seafile@cubieNAS:/root$ cd ~/ccnet Stand: 30.03.15 - Seite 11 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) seafile@cubieNAS:~/ccnet$ nano ccnet.conf Inhalt der Datei nach der Bearbeitung [General] USER_NAME = SeafileServer ID = b0fa63377c4ec91c5ca99156ba659abf17c4e1ad NAME = SeafileServer SERVICE_URL = http://seafile.mynet.home [Network] PORT = 10001 [Client] PORT = 13418 Die markierte Konfigurationseinstellung muss den tatsächlichen Gegebenheiten im Heimnetzwerk angepasst werden 9.Datei 'seahub_settings.py' bearbeiten root@cubieNAS:/home/seafile/ccnet# cd .. root@cubieNAS:/home/seafile# nano seahub_settings.py am Ende der Datei folgende Textzeilen einfügen: FILE_SERVER_ROOT = 'http://seafile.mynet.home/seafhttp' Stand: 30.03.15 - Seite 12 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 10.Für Seafile-Webdav Datei 'seafdav.conf' im Verzeichnis '/home/seafile/conf' bearbeiten root@cubieNAS:/home/seafile# cd conf root@cubieNAS:/home/seafile/conf# nano seafdav.conf Inhalt der Datei vor der Bearbeitung [WEBDAV] enabled = false port = 8080 fastcgi = false share_name = / Inhalt der Datei nach der Bearbeitung [WEBDAV] enabled = true port = 8080 fastcgi = true share_name = /seafdav Durchzuführende Änderungen 11.In Datei '/etc/init.d/seafile-server' die Textzeile 'fastcgi=false' in 'fastcgi=true' ändern Damit sind alle Einstellungen zur Umstellung von Seafile auf den Apache-Webserver und zur Aktivierung von Seafile-Webdav ausgeführt. Stand: 30.03.15 - Seite 13 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 3. Start/Stop Apache Webserver 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/SystemStart 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 Stand: 30.03.15 - Seite 14 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 4.Seafile Webinterface testen Aufruf der Seafile-Url von einem beliebigen Rechner im Heimnetzwerk Stand: 30.03.15 - Seite 15 - Ersteller: Stefan W. Lambert Tutorial zur Umstellung von Seafile – http auf Apache Webserver und Aktivierung Seafile Webdav Erweiterung (gültig für Dual CubieNAS SD-Card Images V3n und V4n) 5. Seafile-Webdav testen Aufruf der Seafile-Webdav-Url von einem beliebigen Rechner im Heimnetzwerk Stand: 30.03.15 - Seite 16 - Ersteller: Stefan W. Lambert