Embed Size (px)
Citation preview
Installation
1
Schulfilter Plus Installationsanleitung Ubuntu 14.04 und Ubuntu 16.04
Installation
2
Inhaltsverzeichnis 1 Installation .......................................................................................... 3
1.1 Vor der Installation ............................................................................... 3
1.1.1 Empfohlene Betriebssysteme ........................................................... 3
1.1.2 Generelle Systemvoraussetzungen .................................................. 3
1.1.3 Weitere Voraussetzungen für Schulfilter Plus 4 ................................ 3
1.2 Vorbereitung der Installation ................................................................ 4
1.2.1 Rechte als root .................................................................................. 4
1.2.2 Betriebssystemversion prüfen ........................................................... 4
1.2.3 TIME for kids Repository in Paketverwaltung integrieren .................. 5
1.2.4 Repository für kompatible Version von PHP 7.0 ergänzen ............... 7
1.2.5 Aktualisieren der Paketverwaltungs-Quellen .................................... 7
1.2.6 Aktualisieren der verwalteten Pakete ................................................ 8
1.3 Durchführung der Installation ............................................................... 9
1.4 Nach der Installation ........................................................................... 10
1.4.1 Login ............................................................................................... 10
1.4.2 Squid Konfiguration ......................................................................... 10
1.4.3 Firewall Konfiguration ..................................................................... 11
1.4.4 DNS Konfiguration für Sichere Suche ............................................. 12
2 Update ............................................................................................... 12
2.1 Automatisches Update ....................................................................... 12
2.2 Manuelles Update .............................................................................. 13
2.2.1 Schulfilter Plus 4 ............................................................................. 13
2.2.2 Schulfilter Plus 3 (ab 3.0.15) ........................................................... 14
2.2.3 Schulfilter Plus 3 (3.0.14 und kleiner) ............................................. 15
3 Vollständige Deinstallation .............................................................. 15
3.1 Schulfilter Plus 4 ................................................................................. 15
3.2 Schulfilter Plus 3.2 ........................................................................... 15
3.3 Schulfilter Plus 3.0.14 und kleiner ...................................................... 16
Installation
3
1 Installation
1.1 Vor der Installation
1.1.1 Empfohlene Betriebssysteme
Folgende Ubuntu Linux-Betriebssysteme wurden in Kombination mit dem
Schulfilter Plus getestet und werden daher von TIME for kids empfohlen:
• Ubuntu 14.04
• Ubuntu 16.04
1.1.2 Generelle Systemvoraussetzungen
Bitte prüfen Sie vor der Installation, ob Ihr System mindestens die folgenden
Anforderungen erfüllt:
• Intel® / AMD® Prozessor ab 1 GHz
• mind. 2 GB Arbeitsspeicher
• mind. 4 GB freier Festplattenspeicher
1.1.3 Weitere Voraussetzungen für Schulfilter Plus 4
Folgende TCP-Ports werden vom Schulfilter Plus 4 verwendet und dürfen nicht
belegt sein:
• 80, 83, 88, 443
• 1910-1929
• 3128
• 4450
• 9700, 9701
Installation
4
1.2 Vorbereitung der Installation
1.2.1 Rechte als root
Prüfen Sie bitte zuallererst, dass Sie als Benutzer mit root-Rechten angemeldet
sind. Um root-Rechte mit dem Standardbenutzer zu erhalten, verwenden Sie
folgenden Befehl: o sudo -i
Prüfen Sie bitte außerdem, dass das System über eine aktive Internetverbindung
verfügt.
1.2.2 Betriebssystemversion prüfen
Bitte stellen Sie sicher, dass es sich bei dem von Ihnen verwendeten
Betriebssystem um ein Ubuntu 14.04 oder 16.04 handelt.
Überprüfen Sie das beispielsweise mit: o cat /etc/issue
Abbildung 1 - Betriebssystemversion ermitteln
Installation
5
1.2.3 TIME for kids Repository in Paketverwaltung integrieren
1.2.3.1 Ubuntu 14.04 (Trusty)
Von der Konsole aus fügen Sie das für die Installation benötigte TIME for kids
Repository mit folgendem Befehl hinzu:
o echo " deb http://repository.time-for-kids.de/ubuntu1404/apt/debian trusty
main" > /etc/apt/sources.list.d/sfp.list
Anschließend wird der GPG-Key des Repositorys heruntergeladen und auf
Korrektheit überprüft. o wget -q http://repository.time-for-kids.de/tfk.gpg.key
o sha512sum tfk.gpg.key
Die hier ausgegebene Prüfsumme sollte die Folgende sein: 42f23722a1522844cc49c33f34e9bd8d333dbfa63ae9b1c54797987c99d15cb66fe0784d9bda362a0
1b773226d80bd3755ecd7cb2075c9f03f1f12b4c7cca645
Schlussendlich kann der Key importiert werden o apt-key add tfk.gpg.key
Installation
6
Abbildung 2 - Repository in Paketverwaltung integrieren
1.2.3.2 Ubuntu 16.04 (Xenial)
Von der Konsole aus fügen Sie das für die Installation benötigte TIME for kids
Repository mit folgendem Befehl hinzu:
o echo "deb http://repository.time-for-kids.de/xenial/apt/debian xenial
main" > /etc/apt/sources.list.d/sfp.list
Anschließend wird der GPG-Key des Repositorys heruntergeladen und auf
Korrektheit überprüft. o wget -q http://repository.time-for-kids.de/tfk.gpg.key
o sha512sum tfk.gpg.key
Die hier ausgegebene Prüfsumme sollte die Folgende sein: 42f23722a1522844cc49c33f34e9bd8d333dbfa63ae9b1c54797987c99d15cb66fe0784d9bda362a0
1b773226d80bd3755ecd7cb2075c9f03f1f12b4c7cca645
Schlussendlich kann der Key importiert werden
Installation
7
o apt-key add tfk.gpg.key
Abbildung 3 - Repository in Paketverwaltung integrieren
1.2.4 Repository für kompatible Version von PHP 7.0 ergänzen
Aktuell enthalten die Standard-Repositorys für Ubuntu 16.04 und 14.04 eine mit
dem Schulfilter Plus 4 inkompatible PHP-Version. Die aktuellere Version PHP 7
wird zwingend benötigt. Daher ist es notwendig ein Repository einzubinden,
welches aktualisierte Versionen von PHP enthält. Führen Sie dazu bitte folgenden
Befehl aus: o add-apt-repository ppa:ondrej/php
1.2.5 Aktualisieren der Paketverwaltungs-Quellen
Damit Sie die neu hinzugefügten Paketquellen nutzen können, muss die
Paketverwaltung aktualisiert werden. Dies können Sie mit folgendem Befehl
erledigen: o apt-get update
Installation
8
Abbildung 4 – Paketverwaltungs-Quellen wurden aktualisiert
1.2.6 Aktualisieren der verwalteten Pakete
Nach der Aktualisierung der Paket-Quellen sollten Sie im nächsten Schritt alle
verfügbaren Updates installieren. Führen Sie dafür folgenden Befehl aus:
o apt-get -y upgrade
Installation
9
Abbildung 5 - Verwaltete Pakete wurden aktualisiert
1.3 Durchführung der Installation
Für die Installation des TIME for kids Schulfilter Plus 4 müssen Sie nun das Paket
„tfk-schulfilterplus4“ aus der Paketverwaltung installieren. Verwenden Sie hierzu
folgenden Befehl: o apt-get -y install tfk-schulfilterplus4
Während der Installation werden verschiedene Schritte automatisch durchgeführt.
Einige dieser Schritte - zum Beispiel das Herunterladen der Datenbank – kann, je
nach Internetverbindung an Ihrem Standort, einige Zeit in Anspruch nehmen.
Installation
10
Abbildung 6 - Herunterladen der Datenbank während der Installation
Nach erfolgreicher Installation aller abhängigen und benötigten Pakete können Sie
den Zugang zu Ihrem TIME for kids Schulfilter Plus 4 über die Weboberfläche
unter Port 80 des Systems erreichen und konfigurieren. (z.B. http://192.168.0.1 )
1.4 Nach der Installation
Während der Installation wurden der Datei /etc/hosts Einträge für msd.tfk sowie
login.tfk hinzugefügt.
1.4.1 Login
Nach der Erstinstallation erfolgt das Login unter http://msd.tfk mit dem
Nutzernamen „tfkadmin“ und gleichnamigem Passwort.
1.4.2 Squid Konfiguration
Damit nach der Installation des TIME for kids Schulfilter Plus 4 sofort über den
Proxyserver Squid auf das Internet zugegriffen werden kann, müssen
entsprechende Zugriffsregeln konfiguriert werden. Dies kann automatisch während
Installation
11
der Installation des TIME for kids Schulfilter Plus 4 erfolgen, eine entsprechende
Abfrage wird Ihnen gestellt.
1.4.2.1 Manuelle Squid Konfiguration
Um den Squid manuell zu konfigurieren muss eine Konfigurationsdatei inkludiert
werden. Grund für dieses Vorgehen sind mögliche zukünftige Ergänzungen an der
Konfiguration.
Der Include kann mit folgendem Befehl ergänzt werden: o echo "include /etc/squid3/seep.conf" >> /etc/squid/squid.conf
Abbildung 7 – Anpassung Squid während der Installation des Schulfilter Plus
1.4.3 Firewall Konfiguration
Weiterhin muss die Firewall so konfiguriert werden, dass Clients der Zugriff auf
Funktionen von Schulfilter Plus erlaubt wird. Dies betrifft folgende Ports:
o TCP eingehend
o Ports 80, 83
o Port 443 falls Nutzung via HTTPS
o Ports 1910-1929
o Port 3128
Update
12
1.4.4 DNS Konfiguration für Sichere Suche
Browser setzen vermehrt auf den standardmäßigen Aufruf von Suchseiten via
HTTPS. In diesen Fällen kann keine automatische Umleitung auf eine interne
Sichere-Suche-Seite des Schulfilter Plus durchgeführt werden - stattdessen greift
eine Sperrung der verwendeten Suchseite, sodass diese nicht genutzt werden
könnte.
Abhilfe kann in einem solchen Fall eine Konfiguration des lokalen DNS
ermöglichen: Einige Suchanbieter bieten eine feste IP an, unter welcher die
Sichere Suche vom Suchanbieter selbst erzwungen wird. Werden die
entsprechenden IP-Domain-Zuordnungen innerhalb der DNS-Konfiguration
hinterlegt, kann die Sichere Suche auch genutzt werden, wenn der Suchanbieter
per HTTPS aufgerufen wird.
Die Konfiguration der Sicheren Suche im Schulfilter Plus ändert sich dadurch nicht
– das Filterregelwerk wirkt weiter so, wie es über die Bedienoberfläche eingestellt
wurde. Lediglich die Umleitung auf die interne Sichere-Suche-Seite des Schulfilter
Plus kommt durch die DNS-Konfiguration nicht mehr zustande. Stattdessen wird
die originale Suchanbieter-Seite – ohne TIME for kids-Banner und –Menü –
angezeigt.
Fügen Sie hierfür die nachfolgenden Zeilen der Hosts-Konfiguration
(Konfigurationsdatei /etc/host) auf dem Proxy-System hinzu:
216.239.38.120 www.google.com 216.239.38.120 www.google.de 216.239.38.120 google.com 216.239.38.120 google.de 204.79.197.220 www.bing.com
2 Update
2.1 Automatisches Update
Seit Version 3.0.14 bietet Schulfilter Plus eine Autoupdate-Funktionalität.
Standardmäßig ist diese Funktion aktiviert und gesetzt ist ein zufälliger Zeitpunkt
an einem Wochentag (Montag – Freitag) morgens.
Update
13
Sie können im Schulfilter Plus Cockpit unter Administration > Cockpiteinstellungen
den Zeitpunkt (Wochentag und Uhrzeit) konfigurieren und festlegen, ob
Autoupdate benutzt werden soll oder nicht.
Zum festgelegten Updatezeitpunkt kontaktiert der Schulfilter Plus - sofern das
System läuft und online ist - den Updateserver von Time for kids und fragt diesen
ob eine neuere Version vorhanden ist.
Gibt es eine neuere Version, so wird ein Update-Paket heruntergeladen und
dieses im Hintergrund und somit ohne Benutzerinteraktion installiert.
2.2 Manuelles Update
2.2.1 Schulfilter Plus 4
Zur Aktualisierung Ihres TIME for kids Schulfilter Plus nutzen Sie die
Paketverwaltung des Betriebssystems.
Achtung: Das verwendete Repository hat sich geändert. Falls noch nicht
geschehen, tauschen sie das bisher angebundene Repository durch das in 1.2.3.2
angegebene aus.
Update
14
Falls Sie von einer älteren Version von Schulfilter Plus 4 als 4.0.17 aktualisieren
möchten, müssen Sie zuerst, wie bereits in Schritt 1.2.4 beschrieben, das
Repository für eine kompatible Version von PHP 7.0 ergänzen: o LC_ALL=C.UTF-8 add-apt-repository ppa:ondrej/php
Zur Prüfung auf neue Pakete verwenden Sie den Befehl: o apt-get update
Sind neue Versionen von Paketen verfügbar, können Sie diese ganz einfach durch
folgenden Befehl einspielen: o apt-get -y dist-upgrade
Dabei werden alle Pakete ihres Systems, inklusive des bereits installierten
Schulfilter Plus 4, auf den aktuellsten Stand aktualisiert.
2.2.2 Schulfilter Plus 3 (ab 3.0.15)
Zur Aktualisierung Ihres TIME for kids Schulfilter Plus nutzen Sie die
Paketverwaltung des Betriebssystems.
Achtung: Das verwendete Repository hat sich geändert. Falls noch nicht
geschehen, tauschen sie das bisher angebundene Repository durch das in 1.2.3.2
angegebene aus.
Falls Sie von einer älteren Version von Schulfilter Plus 4 als 4.0.17 aktualisieren
möchten, müssen Sie zuerst, wie bereits in Schritt 1.2.4 beschrieben, das
Repository für eine kompatible Version von PHP 7.0 ergänzen: o LC_ALL=C.UTF-8 add-apt-repository ppa:ondrej/php
Zur Prüfung auf neue Pakete verwenden Sie den Befehl: o apt-get update
Sind neue Versionen von Paketen verfügbar, können Sie diese ganz einfach durch
folgenden Befehl einspielen: o apt-get -y dist-upgrade
Dabei werden alle bereits installierten Pakete ihres Systems auf den aktuellsten
Stand aktualisiert.
Vollständige Deinstallation
15
Zur Durchführung des Updates von Schulfilter Plus 3 auf Schulfilter Plus 4 ist
anschließend folgender Befehl zu nutzen: o apt-get -y install tfk-schulfilterplus4
2.2.3 Schulfilter Plus 3 (3.0.14 und kleiner)
Sollten Sie noch einen Schulfilter Plus nicht über die Paketverwaltung sondern
mittels Installationsskript auf ihrem System installiert haben, muss dieser zunächst
vom System entfernt werden. Lesen Sie dazu Kapitel 3.3. Anschließend
installieren Sie über die Paketverwaltung die aktuelle Version wie in Kapitel 1
beschrieben. Zur Datenübernahme empfiehlt es sich, vor der Entfernung eine
Datensicherung zu erstellen und zu exportieren, um diese nach Neu-Installation
wieder einzuspielen.
3 Vollständige Deinstallation
3.1 Schulfilter Plus 4
Mit dem folgenden Konsolenbefehl wird der TIME for kids Schulfilter Plus
dauerhaft und vollständig entfernt: o apt-get -y purge tfk-schulfilterplus4
Um auf Ihrem Linuxsystem ungenutzte Abhängigkeiten und nicht mehr
verwendete Pakete automatisch zu entfernen, verwenden Sie folgenden Befehl: o apt-get -y autoremove --purge
3.2 Schulfilter Plus 3.2
Mit dem folgenden Konsolenbefehl wird der TIME for kids Schulfilter Plus
dauerhaft und vollständig entfernt: o apt-get -y purge tfk-schulfilterplus
Um auf Ihrem Linuxsystem ungenutzte Abhängigkeiten und nicht mehr
verwendete Pakete automatisch zu entfernen, verwenden Sie folgenden Befehl: o apt-get -y autoremove --purge
Vollständige Deinstallation
16
3.3 Schulfilter Plus 3.0.14 und kleiner
Sollten Sie noch einen Schulfilter Plus nicht über die Paketverwaltung sondern
mittels Installationsskript auf ihrem System installiert haben, muss dieser zunächst
vom System entfernt werden.
Das Skript dazu kann unter http://repository.time-for-kids.de/sfp_uninstall.tar.gz
heruntergeladen werden.
Nachdem Sie die Datei auf Ihr Linux System heruntergeladen haben, muss diese
entpackt und anschließend das Deinstallationsskript ausgeführt werden. Folgende
Schritte sind dabei auszuführen:
• Herunterladen
o curl -O http://repository.time-for-kids.de/sfp_uninstall.tar.gz oder o wget http://repository.time-for-kids.de/sfp_uninstall.tar.gz
• Entpacken o tar xzf sfp_uninstall.tar.gz
• Ausführen o ./sfp_uninstall.sh
