Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
de:server:start [27.12.2020 09:49] – [Systemanforderungen] admin | de:server:start [03.06.2021 12:43] – [Installation auf einem Webserver] admin | ||
---|---|---|---|
Zeile 3: | Zeile 3: | ||
Dieses Kapitel beschreibt die Installation von SoSci Survey auf einem eigenen Webserver. | Dieses Kapitel beschreibt die Installation von SoSci Survey auf einem eigenen Webserver. | ||
- | Falls Sie eine bestehende Installation von SoSci Survey aktualisieren möchten, lesen Sie bitte [[update|Update der Installation]]. | + | Falls Sie eine bestehende Installation von SoSci Survey aktualisieren möchten, lesen Sie bitte die Anleitung |
**Hinweis: | **Hinweis: | ||
- | **Hinweis: | + | **Hinweis: |
- | ===== Systemanforderungen ===== | + | Wenn Sie mit der Installation von Web-Applikationen vertraut sind, ist das Vorgehen einfach: |
- | Für die Installation von SoSci Survey | + | - Datenbank vorbereiten |
+ | * Legen Sie in MySQL einen Datenbank-Nutzer und | ||
+ | * eine Datenbank für SoSci Survey | ||
+ | * stellen | ||
+ | - Kopieren Sie alle Dateien aus dem Setup-ZIP in ein Verzeichnis auf dem Webserver | ||
+ | - Stellen Sie sicher, dass der Webserver Schreibzugriff auf dieses Verzeichnis hat | ||
+ | - Rufen Sie im Browser die URL '' | ||
+ | - Ergänzen Sie eventuell fehlende | ||
+ | - E-Mail-Versand | ||
+ | * Tragen Sie in den '' | ||
+ | * Alternativ tragen Sie in den Server-Einstellungen einen SMTP-Server für den Mailversand ein. | ||
+ | - Richtigen Sie zwei Cronjobs für SoSci Survey | ||
- | * Webserver (i.d.R. Apache oder IIS) oder Webspace (s. unten) | + | Die einzelnen Schritte werden in den folgenden Anleitungen genauer beschrieben. |
- | * PHP ab Version 5.6.0 | + | |
- | * MySQL-Datenbank ab Version 5.5.3 | + | |
- | Für den optimalen Betrieb empfohlen: | + | * [[:de: |
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
- | * PHP 7.4 | ||
- | * Möglichkeit zur zeitgesteuerten Ausführung von Skripten (Cron-Jobs) | ||
- | * Betrieb von PHP ohne Einschränkungen (PHP nicht im Safe-Mode) | ||
- | Die Aufgabe des Webservers ist es, Inhalte vom Server im Internet/ | ||
- | |||
- | **Tipp:** Sofern Sie noch keinen Webserver haben und einen lokalen Server unter Windows einrichten möchten, spart das Installationspaket [[http:// | ||
- | |||
- | **Notiz:** Die meisten günstigen Webspace-Angebote der Hoster sind sog. Shared Hosting. Dabei laufen auf einem Webserver hunderte oder tausende Internetangebote. Dieser Webspace wird schon zu Preisen von unter 2 EUR pro Monat angeboten. Damit sich die Angebote auf so einem Server nicht in die Quere kommen, werden die Funktionen aber oftmals ein wenig eingeschränkte (z.B. läuft PHP im sog. Safe Mode). Im Gegenzug muss man sich um die Installation und Einrichtung des Webservers beim Shared Hosting nicht weiter kümmern. | ||
- | |||
- | ===== Vorbereitung ===== | ||
- | |||
- | Folgende Software ist für die Installation hilfreich bzw. erforderlich: | ||
- | |||
- | * Falls der Server nicht auf dem lokalen Computer läuft, benötigen Sie ein FTP-Programm zum Übertragen von Dateien auf den Server, z.B. [[http:// | ||
- | * Für die Wartung der Datenbank ist ein Frontend hilfreich, z.B. [[http:// | ||
- | * Sofern noch nicht geschehen, laden Sie sich das aktuelle Installationspaket für SoSci Survey im [[https:// | ||
- | |||
- | Falls Sie nicht eingehend mit der Rechteverwaltung auf Webservern vertraut sind, lesen Sie bitte [[users|Prozesse und Benutzer auf einem Webserver]]. | ||
- | |||
- | ===== Server vorbereiten ===== | ||
- | |||
- | Damit der Server korrekt mit SoSci Survey arbeitet, müssen Sie ein Verzeichnis für SoSci Survey anlegen und u.U. weitere Anpassungen vornehmen. | ||
- | |||
- | * [[prepare1|Vorbereitung des Servers I]] | ||
- | * [[prepare2apache|Vorbereitung des Servers II (Apache)]] | ||
- | * [[prepare2iis|Vorbereitung des Servers II (Microsoft IIS)]] | ||
- | |||
- | ===== Datenbank konfigurieren ===== | ||
- | |||
- | Damit SoSci Survey auf die Datenbank zugreifen kann, benötigen Sie Benutzername und Kennwort für die Datenbank. | ||
- | |||
- | **Wichtig: | ||
- | |||
- | Falls Sie für den Zugriff auf die Datenbank entgegen der Empfehlung das Benutzerkonto des Datenbank-Administrators verwenden (z.B. " | ||
- | |||
- | * Legen Sie auf dem Datenbankserver eine Datenbank für SoSci Survey an. SoSci Survey kann alternativ auch in einer bestehenden Datenbank installiert werden (falls z.B. nur eine Datenbank zur Verfügung steht). **Wichtig: | ||
- | * Legen Sie auf dem Datenbankserver ggf. einen neuen Nutzer für SoSci Survey an, der alle Rechte für die SoSci Survey-Datenbank besitzt (Tabellen anlegen, löschen, ändern, etc.), aber keine Rechte für andere Datenbanken. Dieser Nutzer sollte sich __nur__ vom Webserver aus (normalerweise ist das " | ||
- | |||
- | ===== SoSci Survey auf den Webserver kopieren ===== | ||
- | |||
- | Entpacken Sie das SoSci Survey Installationspaket und kopieren Sie die Dateien in das Verzeichnis, | ||
- | |||
- | Die folgenden Beispiele gehen davon aus, dass Sie SoSci Survey auf dem Server // | ||
- | |||
- | Testen Sie zunächst, ob Sie SoSci Survey über das Intranet bzw. Internet erreichen. Rufen Sie dafür die URL // | ||
- | |||
- | Nachfolgend sind einige häufige Probleme geschildert. Bitte lesen Sie ggf. auch nochmal die Anleitung [[prepare2apache|Vorbereitung des Servers II (Apache)]] bzw. [[prepare2iis|Vorbereitung des Servers II (Microsoft IIS)]]. | ||
- | |||
- | * Falls der Browser lange lädt und anschließend eine leere Seite oder einen Timeout anzeigt, wurde der Webserver entweder noch nicht gestartet, der Domainname stimmt nicht (beachten Sie, dass neue Domains erst nach einigen Stunden erreichbar sind) oder der Server ist nicht erreichbar (z.B. weil die Firewall die Verbindung blockiert). | ||
- | * Falls Sie eine Fehlermeldung "404 not found" (oder ähnlich) erhalten, stimmt das angegebene Verzeichnis nicht oder das Installationsverzeichnis ist nicht im Pfad für Webdokumente bzw. es wurde kein Alias definiert. Überprüfen Sie zur Sicherheit auch noch einmal, ob die Domain/ | ||
- | * Falls Sie eine Fehlermeldung " | ||
- | * Falls Sie HTML-Code sehen, liefert Ihr Webserver die Datei als Textdatei und nicht als HTML aus. In diesem Fall müssen die MIME-Einstellungen des Webservers für PHP-Dateien korrigiert werden. | ||
- | |||
- | Testen Sie nun, ob PHP-Skripte korrekt verarbeitet werden. Rufen Sie dazu in ihrem Internetbrowser die URL // | ||
- | |||
- | * Falls " | ||
- | |||
- | ===== Zugriffsrechte ===== | ||
- | |||
- | Meist darf der Webserver Dateien auf der Festplatte nur lesen. Daher müssen Sie für einige Verzeichnisse manuell Schreibrechte vergeben. Die Einrichtung der Schreibrechte variiert je nach Server: | ||
- | |||
- | * Wenn Sie via FTP auf den Server zugreifen: [[permissions_ftp|Schreibrechte (FTP)]] | ||
- | * Wenn Sie einen Linux-Server verwenden: [[permissions_linux|Schreibrechte (Linux)]] | ||
- | * Wenn Sie einen Windows-Server verwenden: [[permissions_win|Schreibrechte (Windows)]] | ||
- | |||
- | Bitte erteilen Sie dem Webserver (also dem Betriebssystem-Benutzer, | ||
- | |||
- | * Das Installationsverzeichnis, | ||
- | * Alle Dateien und Verzeichnisse im Unterverzeichnis //system//, falls dieses bereits vorhanden ist. Hier wird die Konfiguration gespeichert und Logfiles sowie temporäre Dateien abgelegt. **Hinweis: | ||
- | |||
- | Auf einige Verzeichnisse muss der Webserver zugreifen, aber Webserver-Benutzer (Internet-Surfer) dürfen keinen Zugriff erhalten. Dies muss durch eine entsprechende Konfiguration des Webservers sichergestellt werden. | ||
- | |||
- | Das Installationspaket enthält einige Dateien mit dem Namen .htaccess -- diese Dateien regeln u.a. die Zugriffsrechte auf einem standardmäßig konfigurierten Apache-Webserver die Zugriffsrechte. Testen Sie die korrekte Funktion, indem Sie die URLs '' | ||
- | |||
- | * Wenn Sie ein " | ||
- | * Wenn Sie auf die Dateien zugreifen können und einen Apache-Server verwenden, wurde die Konfiguration via .htaccess vermutlich deaktiviert. In diesem Fall müssen Sie den Zugriff in der Apache-Konfiguration (z.B. /// | ||
- | |||
- | < | ||
- | < | ||
- | Order allow,deny | ||
- | deny from all | ||
- | </ | ||
- | < | ||
- | Order allow,deny | ||
- | deny from all | ||
- | </ | ||
- | < | ||
- | Order allow,deny | ||
- | deny from all | ||
- | </ | ||
- | </ | ||
- | |||
- | * Wenn Sie den IIS 7 einsetzen: | ||
- | * Wählen Sie //IIS Request Filtering// | ||
- | * Wählen Sie den Karteireiter //URL// | ||
- | * Klicken Sie auf //Deny Sequence// | ||
- | * Geben Sie im PopUp "/ | ||
- | * Wenn Sie einen älteren IIS verwenden: | ||
- | * Öffnen Sie das Konfigurationstool (// | ||
- | * Navigieren Sie zum Installationsverzeichnis und dort zu ''/ | ||
- | * Lassen Sie sich mit einem Rechtsklick die Einstellungen für das Verzeichnis anzeigen: Properties -> Directory Security -> IP address and domain name restrictions -> Edit | ||
- | * Wählen Sie "By default, all computers will be: Denied access" | ||
- | * Wiederholen Sie die letzten beiden Schritte für ///system// | ||
- | |||
- | |||
- | ===== PHP-Einstellungen ===== | ||
- | |||
- | Die Installations-Routine (s. unten) überprüft die PHP-Einstellungen und warnt bei möglichen Problemem. Eine Einstellung, | ||
- | |||
- | * Standardmäßig akzeptiert PHP beim Hochladen von Dateien in einem Formular nur Dateien bis 2 MB. Soll SoSci Survey auch das Hochladen von Mediendateien unterstützen, | ||
- | * Stellen Sie daher für den Wert '' | ||
- | * Falls die Variable '' | ||
- | * Sollte für die Einstellung '' | ||
- | * Wenn in einer Befragung viele Dateien (z.B. Bilder) hochgeladen werden sollen, ist die Übertragung aller Bilder in einem Arbeitsschritt sinnvoll. Wie viele Dateien zugleich übertragen werden, regel die Einstellung '' | ||
- | |||
- | Die anderen PHP-Einstellungen sind bei einer Standard-Installation bereits für SoSci Survey geeignet. Nachfolgend sind die nötigen Änderungen beschrieben, | ||
- | |||
- | * Der Safe Mode von PHP sollte deaktiviert sein, damit Skripte nicht nach 30 Sekunden abgebrochen werden. | ||
- | * Die maximale Laufzeit für PHP-Script wird durch die PHP-Einstellung " | ||
- | * Zur Deaktivierung des Safe Mode suchen Sie in der PHP.INI den Eintrag **safe_mode** und tragen den Wert **off** ein. | ||
- | * Es ist __nicht__ sinnvoll, die Einstellung für **max_execution_time** in der PHP.INI zu ändern. Der Standardwert von 30 Sekunden sorgt dafür, dass fehlerhaft programmierte Fragebögen (z.B. mit einer Endlosschleife) abgebrochen werden. | ||
- | * SoSci Survey erfordert für den korrekten Betrieb eine Reihe von PHP-Modulen. | ||
- | * Benötigt werden: `mysql`, `mbstring`, `zip`, `gd`, `curl` und unter PHP 5 evtl. `pcre` und `zlib` | ||
- | * Unter Linux werden diese Bibliotheken über entsprechende Pakete installiert, | ||
- | * Unter Windows (z.B. XAMPP) lässt sich eine Bibliothek einfach aktivieren, indem in der //PHP.INI// das Semikolon vor der entsprechenden '' | ||
- | * Nach der Aktivierung/ | ||
- | |||
- | ===== MySQL-Einstellungen ===== | ||
- | |||
- | Eine MySQL Standard-Installation ist für den Betrieb von SoSci Survey normalerweise gut geeignet. Werfen Sie dennoch einen Blick auf folgende Einstellungen. Eine Einstellung können Sie mit dem SQL-Befehl '' | ||
- | |||
- | * MySQL sollte ausreichend Verbindungen zur Datenbank erlauben. Ist die maximale Anzahl erlaubter Verbindungen pro Nutzer '' | ||
- | * Bei Shared Hosting Angeboten sollte man das Verhältnis der Einstellungen für '' | ||
- | |||
- | ===== Initialisierung ===== | ||
- | |||
- | * Rufen Sie das SoSci Survey Verzeichnis im Browser auf -- und zwar via HTTP bzw. HTTPS: (// | ||
- | * Sie sollten nun einen Hinweis sehen, dass eine Installation erforderlich ist -- folgen Sie dem Link. | ||
- | * **Hinweis: | ||
- | * **Hinweis: | ||
- | * Die Installationsroutine möchte von Ihnen nun die Zugangsdaten für den Datenbankserver (Datenbank-Benutzer) sowie einige weitere Angaben wissen. Bitte nehmen Sie auch die Hinweise der Installationsroutine auf mögliche Probleme ernst. | ||
- | * **Hinweis: | ||
- | * **Hinweis: | ||
- | * **Hinweis: | ||
- | |||
- | ===== Abschluss der Installation ===== | ||
- | |||
- | Nach erfolgreicher Installation können Sie sich als Administrator anmelden. Sie sollten umgehend ein Passwort festlegen: | ||
- | |||
- | * Melden Sie sich im Administrator-Login " | ||
- | * Nach dem Login geben Sie bitte zunächst eine E-Mail-Adresse für das Administratorkonto an, unter **Benutzerkonto** -> **Benutzerdaten**. | ||
- | * Unter **Server-Verwaltung** -> " | ||
- | |||
- | Nun ist die Installation abgeschlossen. Ab sofort können weitere Benutzerkonten registriert und Befragungsprojekte eingerichtet werden ([[de: | ||
- | |||
- | |||
- | ===== Automatisierung regelmäßiger Aufgaben ===== | ||
- | |||
- | Für die optimale Ausführung von SoSci Survey sollten zwei PHP-Skripte regelmäßig aufgerufen werden: Die [[maintenance|regelmäßige Wartung des Servers]] (einmal täglich) und die [[: | ||