Schule als Staat EDV-System Einrichtung der Datenbank und Front-End Software Letzte Änderungen: 26.11.2017 1
Inhalt 1 Einführung... 3 1.1 Systemanforderungen... 3 1.2 Wissensanforderungen... 3 2 Setup... 4 2.1 Datenbank... 4 2.2 Front-End Software... 4 2
1 Einführung Dieses Dokument befasst sich mit dem Einrichten der Front-End Software und der Datenbank auf eurem eigenen Webserver. Falls ihr jedoch das Webserver-Paket gekauft habt, dann wird euch diese Arbeit genommen und ihr könnt direkt anfangen mit dieser Software zu arbeiten. Wenn dies nicht der Fall ist, dann befolgt bitte genau den Anweisungen in diesem Dokument. 1.1 Systemanforderungen 1.1.1 Webserver PHP (empfohlene Version: 5.6+) MySQL oder MariaDB externer Zugriff benötigt 1.2 Wissensanforderungen Umgang mit Webserver FTP-Programme (z.b. FileZilla), ggf..htaccess-dateien Umgang mit MySQL Datenbanken phpmyadmin 3
2 Setup Zu Beginn erhaltet ihr ein Zip-Paket namens SaS EDV-System.zip, das du bitte in einen beliebigen Ordner entpackst. Dort wirst du folgende Ordner vorfinden: Software_Back-End Software_Front-End Sonstiges 2.1 Datenbank Importiere die SQL-Datei Sonstiges/SaS EDV-System Datenbank.sql in eure Datenbank. Dies kannst du zum Beispiel mit phpmyadmin machen. 2.2 Front-End Software Jetzt musst du die Front-End Software konfigurieren und auf euren Webserver hochladen. Dafür benötigst du ein FTP-Programm (z.b. FileZilla) und einen Codeeditor (z.b. Notepad++). Befolge bitte genau diesen Anweisungen, um die Wahrscheinlichkeit für mögliche Fehler danach zu reduzieren. 2.2.1 Einstellungen I Zuerst musst du ein paar Einstellungen in der Front-End Software vornehmen. Benutze dafür einen Codeeditor (z.b. Notepad++) und nicht den Standard-Texteditor von Windows! Ordner: Software_Front-End/software_sas/ Öffne die Datei app/config/parameters.yml und gib unter database_[...] die Zugangsdaten zu eurer Datenbank ein (der Port ist standardmäßig 3306). Ordner: Software_Front-End/web_sas/ Hier findest du die Bild-Dateien favicon.ico und SaS-Flagge.png. Falls ihr ein eigenes Favicon und eine eigene Flagge von eurem Staat angezeigt haben möchtet, dann ersetze bitte diese beiden Bild-Dateien mit demselben Namen. 2.2.2 Upload Öffne das FTP-Programm (z.b. FileZilla) und stelle eine Verbindung zu eurem Webserver her. Erstelle jetzt einen Ordner in dem Document Root (meistens /web, /htdocs, /public_html oder ähnliches) mit dem Namen sas und einen Ordner außerhalb des Document Roots mit dem Namen software_sas, sofern es auf diesem Webserver möglich ist. Lade nun den gesamten Inhalt des Ordners Software_Back- 4
End/software_sas/ auf euren Webserver in den Ordner software_sas hoch. Dies kann eine gewisse Zeit beanspruchen. Lade danach den gesamten Inhalt des Ordners Software_Front-End/web_sas/ auf euren Webserver in den Ordner sas hoch. 2.2.3 Einstellungen II Zuletzt fehlen nur noch zwei Schritte: Gewähre auf dem Webserver jede Schreib- und Leseberechtigungen für den Ordner software_sas/var/ und dessen Unterordner und Dateien (Dateiberechtigungen rekursiv setzten). Der numerische Wert für diese Dateiberechtigung wäre 777. Falls du die Kommandozeile benutzt, führe bitte den Befehl» chmod R 777 [path-to]/var aus. Öffne zum Schluss auf dem Webserver die Datei sas/app.php, wo du folgende Zeilen finden wirst:» $loader = require DIR.'/../../software_sas/app/autoload.php';» include_once DIR.'/../../software_sas/var/bootstrap.php.cache'; Diese beiden Zeilen beinhalten den Pfad zu zwei Dateien in den software_sas/app/ und software_sas/var/ Ordnern. Je nachdem, wie du die Ordnerstruktur auf dem Webserver angelegt hast, musst du diese Pfade anpassen. Der Ordner /.. bedeutet, dass aus dem aktuellen Ordner in den höher gelegenen Ordner gesprungen wird. Überordner 1 Ordner 1 Unterordner 1 Unterordner 2 start.txt Ordner 2 Ordner 3 ziel.txt Pfad aus dem Ordner der Datei start.txt zur Datei ziel.txt: /../../Ordner3/ziel.txt 2.2.4 Testen & Fehlersuche Nachdem nun alle Einstellungen vorgenommen wurden, solltest du das Front-End unter www.domain.de/path-to/sas aufrufen und sich bereits mit deinen Zugangsdaten 5
anmelden können, sofern diese in der Datenbank gespeichert wurden. Es ist jedoch gut möglich, dass gleich am Anfang nicht alles funktionieren wird und vielleicht nur eine leere Seite erscheint. Um genauere Fehler ausgeben zu können, öffne die Datei sas/app.php und entferne die folgenden // vor den Zeilen:» //Fehler ausgeben (ACHTUNG: hohes Sicherheitsrisiko!! nur für Testzwecke aktivieren)» //ini_set("error_reporting", "-1");» //ini_set("display_errors", "1"); Rufe dann erneut das Front-End auf und es sollten genauere Fehlerangaben erscheinen, die du dann beheben musst. Bei Fragen und Problemen kannst du mich gerne kontaktieren. Vergesse aber bitte nicht, die // nach der Fehlerbehebung wieder hinzuzufügen, um eine genaue Fehlerausgabe zu verhindern. Dies könnte nämlich ein Sicherheitsrisiko darstellen. 2.2.5 Cache Dir sollte bewusst sein, dass die Front-End Software für eine bessere Performance zwischenspeichert ( Cache). Das heißt, wenn du Änderungen an der Back-End Software vornimmst (sowohl bei Einstellungen als auch bei Fehlerbehebungen), muss ggf. dieser Cache geleert werden, damit deine Änderungen auch angewendet werden. Dazu musst du den Cache-Ordner software_sas/var/cache/prod entfernen, der dann automatisch wieder von der Front-End Software mit den neuen Änderungen erstellt wird. Da das Löschen eine gewisse Zeit in Anspruch nimmt, aber während dem Löschen das Front-End über den Webbrowser nicht aufgerufen werden darf, ist es am sinnvollsten, den Ordner umzubenennen (z.b. in prod_alt). Denn dadurch ist dieser Ordner für die Front- End Software sozusagen gelöscht worden und jetzt kannst du diesen Ordner in Ruhe löschen. Jedoch ist die Front-End Software nicht die einzige Komponente, die zwischenspeichert, sondern auch sehr wahrscheinlich dein Internetbrowser. Wenn also eine Änderung nicht zu Tage kommt, dann leere bitte auch den Internetbrowser-Cache und lade die Webseite der Front-End Software neu. 2.2.6 Fortgeschrittene Einstellungen SSL Verschlüsselungen aktivieren: Sofern ihr ein SSL-Zertifikat für euren Webserver habt, könnt ihr das auch für das Front-End anwenden. Öffne dafür die Datei sas/.htaccess auf dem Webserver und entferne die folgenden # vor den Zeilen: 6
» #SSL aktivieren» #RewriteCond %{HTTPS} off» #RewriteRule ^ https://%{http_host}%{request_uri} [R=301,L] Redirect zur Subdomain aktivieren: Falls du das Front-End über eine Subdomain laufen lassen möchtest, die auf den Ordner sas zeigt, dann kannst du auch eine Weiterleitung zu dieser Subdomain aktivieren. http://subdomain.domain.de http://domain.de/sas Weiterleitung (Redirect) Überordner web (Document Root) sas Unterordner 2 Ordner 2 Öffne dafür die Datei sas/.htaccess auf dem Webserver, entferne die folgenden # vor den Zeilen und passe den Pfad und die URL an:» #Redirect: Directory --> Subdomain» #Redirect 301 /path-to/sas http://subdomain.domain.de Performance durch Cache erhöhen: Um dies aktivieren zu können, musst du das PHP- Modul Alternativer PHP Cache (APC veraltet) oder APC User Cache (APCu) auf dem Webserver installiert haben. Dies kannst du mithilfe der phpinfo()-funktion auf dem Webserver nachprüfen. Öffne dann die Datei software_sas/app/config/config.yml und entferne die folgenden # vor den Zeilen:» #Performance durch Cache erhöhen» #metadata_cache_driver: apc» #result_cache_driver: apc» #query_cache_driver: apc 7