doc/de/Install.md

   1 Friendica Installation
   2 ==========
   3
   4 * [Zur Startseite der Hilfe](help)
   5
   6 Wir haben hart daran gearbeitet, um Friendica auf vorgefertigten Hosting-Plattformen zum Laufen zu bringen - solche, auf denen auch Wordpress Blogs und Drupal-Installationen laufen.
   7 Wir bieten eine manuelle und eine automatische Installation an.
   8 Aber bedenke, dass Friendica mehr als eine einfache Webanwendung ist.
   9 Es handelt sich um ein komplexes Kommunikationssystem, das eher an einen Email-Server erinnert als an einen Webserver.
  10 Um die Verfügbarkeit und Performance zu gewährleisten, werden Nachrichten im Hintergrund verschickt und gespeichert, um sie später zu verschicken, wenn eine Webseite gerade nicht erreichbar ist.
  11 Diese Funktionalität benötigt ein wenig mehr als die normalen Blogs.
  12 Nicht jeder PHP/MySQL-Hosting-Anbieter kann Friendica unterstützen.
  13 Viele hingegen können es. Aber **bitte** prüfe die Voraussetzungen deines Servers vor der Installation.
  14
  15 Wenn dir Fehler während der Installation auffallen, sag uns bitte über [Helper](http://forum.friendi.ca/profile/helpers) oder das [Entwickler Forum](https://forum.friendi.ca/profile/developers) Bescheid oder [erstelle ein Issue](https://github.com/friendica/friendica/issues).
  16 Gib uns bitte so viele Infos zu deinem System, wie du kannst, und beschreibe den Fehler mit allen Details und Fehlermeldungen, so dass wir den Fehler zukünftig verhindern können.
  17 Aufgrund der großen Anzahl an verschiedenen Betriebssystemen und PHP-Plattformen haben wir nur geringe Kapazitäten, um deine PHP-Installation zu debuggen oder fehlende Module zu ersetzen, aber wir tun unser Bestes, um allgemeine Code-Fehler zu beheben.
  18 Falls du noch keinen Friendica-Account hast, kannst du dir einen temporären Account hier erstellen: [tryfriendica.de](https://tryfriendica.de).
  19 Darüber kannst du den genannten Forum beitreten.
  20 Der Account wird nach 7 Tagen ablaufen, aber du kannst einen Server-Admin fragen, diesen Account länger zu erhalten, sollte das  Problem nicht innerhalb dieser Zeit gelöst sein.
  21
  22 Bevor du anfängst: suche dir einen Domain- oder Subdomainnamen für deinen Server.
  23 Dinge verändern sich und einige deiner Freunde haben möglicherweise Probleme, mit dir zu kommunizieren.
  24 Wir planen, diese Einschränkung in einer zukünftigen Version zu beheben.
  25
  26
  27 Requirements
  28 ---
  29
  30 * Apache mit einer aktiverten mod-rewrite-Funktion und dem Eintrag "Options All", so dass du die lokale .htaccess-Datei nutzen kannst
  31 * PHP  5.6+ (PHP 7 ist aufgrund der Performance empfohlen)
  32   * PHP *Kommandozeilen*-Zugang mit register_argc_argv auf "true" gesetzt in der php.ini-Datei
  33   * Curl, GD, PDO, MySQLi, xml, zip und OpenSSL-Erweiterung
  34   * Das POSIX Modul muss aktiviert sein ([CentOS, RHEL](http://www.bigsoft.co.uk/blog/index.php/2014/12/08/posix-php-commands-not-working-under-centos-7http://www.bigsoft.co.uk/blog/index.php/2014/12/08/posix-php-commands-not-working-under-centos-7) haben dies z.B. deaktiviert)
  35   * etwas in der Art eines Email-Servers oder eines Gateways wie PHP mail()
  36 * Mysql 5.5.3+ (oder eine äquivalente Alternative: MariaDB, Percona Server etc.)
  37 * die Möglichkeit, wiederkehrende Aufgaben mit cron (Linux/Mac) oder "Scheduled Tasks" einzustellen (Windows) [Beachte: andere Optionen sind in Abschnitt 7 dieser Dokumentation zu finden]
  38 * Installation in einer Top-Level-Domain oder Subdomain (ohne eine Verzeichnis/Pfad-Komponente in der URL) wird bevorzugt. Verzeichnispfade sind für diesen Zweck nicht so günstig und wurden auch nicht ausführlich getestet.
  39
  40 Installation
  41 ---
  42
  43 ### Friendica
  44
  45 Entpacke die Friendica-Daten in das Quellverzeichnis (root) des Dokumentenbereichs deines Webservers.
  46 Wenn du die Möglichkeit hierzu hast, empfehlen wir dir "git" zu nutzen, um die Daten direkt von der Quelle zu klonen, statt die gepackte .tar- oder .zip-Datei zu nutzen.
  47 Das macht die Aktualisierung wesentlich einfacher.
  48 Der Linux-Code, mit dem man die Dateien direkt in ein Verzeichnis wie "meinewebseite" kopiert, ist
  49
  50     git clone https://github.com/friendica/friendica.git -b master mywebsite
  51     cd mywebsite
  52     bin/composer.phar install
  53
  54 Stelle sicher, dass der Ordner *view/smarty3* existiert and von dem Webserver-Benutzer beschreibbar ist
  55
  56     mkdir view/smarty3
  57     chmod 775 view/smarty3
  58
  59 Falls Addons installiert werden sollen: Gehe in den Friendica-Ordner
  60
  61     cd mywebsite
  62
  63 Und die Addon Repository klonst:
  64
  65     git clone https://github.com/friendica/friendica-addons.git -b master addon
  66
  67 Um das Addon-Verzeichnis aktuell zu halten, solltest du in diesem Pfad ein "git pull"-Befehl eintragen
  68
  69     cd meinewebseite/addon
  70     git pull
  71
  72 Wenn du den Verzeichnispfad auf deinen Webserver kopierst, dann stelle sicher, dass du auch die .htaccess kopierst, da "Punkt"-Dateien oft versteckt sind und normalerweise nicht direkt kopiert werden.
  73
  74 Wenn du die Entwickler Version von Friendica verwenden möchtest kannst du auf den develop Branch im git Repository wechseln.
  75 Dies tust du mit den folgenden Befehlen
  76
  77     git checkout develop
  78     bin/composer.phar install
  79     cd addon
  80     git checkout develop
  81
  82 Die Entwickler Version kann nach einem fehlerhaften Commit vorübergehend Probleme haben oder gar nicht mehr funktionieren.
  83 Sollte dir so etwas passieren, lass es uns bitte wissen, damit der Fehler behoben werden kann.
  84
  85 ### Erselle eine Datenbank
  86
  87 Erstelle eine leere Datenbank und notiere alle Zugangsdaten (Adresse der Datenbank, Nutzername, Passwort, Datenbankname).
  88
  89 Friendica benötigt die Berechtigungen um neue Felder in dieser Datenbank zu ertellen (create) und zu löschen (delete).
  90
  91 Mit neueren Versionen von MySQL (5.7.17+) musst du den `sql_mode` zu `''` (blank) setzen.
  92 Benutze diese Einstellung, wenn der Installer nicht in der Lage ist, die Tabellen aufgrund eines Timestamp-Format Problems zu erstellen.
  93 Falls dem so ist, finde den `[mysqld]` Bereich in deiner `my.conf` Datei und füge diese Zeile hinzu:
  94
  95     sql_mode = ''
  96
  97 Starte MySQL dann neu und es sollte klappen.
  98
  99 ### Option A: Der manuelle Installer
 100
 101 Besuche deine Webseite mit deinem Browser und befolge die Anleitung.
 102 Bitte beachte jeden Fehler und korrigiere diese, bevor du fortfährst.
 103
 104 Falls du einen Port für die Datenbankverbindung angeben musst, kannst du diesen in der Host-Eingabe Zeile angeben.
 105
 106 *Wenn* die manuelle Installation aus irgendeinem Grund fehlschlägt, dann prüfe das Folgende:
 107 * "config/local.ini.php" existiert ... wenn nicht, bearbeite die „config/local-sample.ini.php“ und ändere die Systemeinstellungen. Benenne sie um in „config/local.ini.php".
 108 * die Datenbank beinhaltet Daten. ... wenn nicht, importiere den Inhalt der Datei "database.sql" mit phpmyadmin oder per mysql-Kommandozeile.
 109
 110 Besuche deine Seite an diesem Punkt wieder und registriere deinen persönlichen Account.
 111 Alle Registrierungsprobleme sollten automatisch behebbar sein.
 112 Wenn du irgendwelche **kritischen** Fehler zu diesen Zeitpunkt erhalten solltest, deutet das darauf hin, dass die Datenbank nicht korrekt installiert wurde.
 113 Du kannst bei Bedarf die Datei config/local.ini.php verschieben/umbenennen und die Datenbank leeren (als „Dropping“ bezeichnet), so dass du mit einem sauberen System neu starten kannst.
 114
 115 ### Option B: Starte das manuelle Installationsscript
 116
 117 Öffne die Datei htconfig.php im Friendica-Hauptordner mit einem Text-Editor.
 118 Entferne die `die('...');` Zeile und bearbeite die Einstellungen so, das sie zu deinem System passen (MySQL, Sprache, Theme etc.).
 119 Dann speichere die Datei (jedoch nicht umbenennen).
 120
 121 Gehe in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
 122
 123     bin/console autoinstall
 124
 125 Oder falls du alle optionalen Checks ausfürehn lassen möchtest, benutze diese Option:
 126
 127     bin/console autoinstall -a
 128
 129 *Wenn* die automatisierte Installation aus irgendeinem Grund fehlschlägt, dann prüfe das Folgende:
 130 * Existiert die `config/local.ini.php`? Falls ja, wird die automatisierte Installation nicht gestartet.
 131 * Sind Einstellungen in der `config/local.ini.php` korrekt? Falls nicht, bitte bearbeite diese Datei erneut.
 132 * Ist die leere MySQL-Datenbank erstellt? Falls nicht, erstelle diese.
 133
 134 Für mehr Informationen kannst du diese Option verwenden:
 135
 136     bin/console autoinstall -v
 137
 138 ### Einen Worker einrichten
 139
 140 Erstelle einen Cron job oder einen regelmäßigen Task, um den Poller alle 5-10 Minuten im Hintergrund ablaufen zu lassen.
 141 Beispiel:
 142
 143     cd /base/directory; /path/to/php bin/worker.php
 144
 145 Ändere "/base/directory" und "/path/to/php" auf deine Systemvorgaben.
 146
 147 Wenn du einen Linux-Server nutzt, benutze den Befehl "crontab -e" und ergänze eine Zeile wie die Folgende; angepasst an dein System
 148
 149 `*/10 * * * * cd /home/myname/mywebsite; /usr/bin/php bin/worker.php`
 150
 151 Du kannst den PHP-Pfad finden, indem du den Befehl „which php“ ausführst.
 152 Wenn du Schwierigkeiten mit diesem Schritt hast, kannst du deinen Hosting-Anbieter kontaktieren.
 153 Friendica wird nicht korrekt laufen, wenn dieser Schritt nicht erfolgreich abgeschlossen werden kann.
 154
 155 Falls das Einrichten des cron nicht möglich ist, kannst Du alternativ den "frontend worker" vom Administrationsinterface aus aktivieren.
 156
 157 ### Erstelle einen Backup Plan
 158
 159 Es werden schlimme Dinge geschehen.
 160 Sei es nun ein Hardwareversagen oder eine kaputte Datenbank.
 161 Deshalb solltest du dir, nachdem die Installation deines Friendica Knotens abgeschlossen ist, einen Backup Plan erstellen.
 162
 163 Die wichtigste Datei ist die `config/local.ini.php` im Stammverzeichnis deiner Friendica Installation.
 164 Und da alle Daten in der Datenbank gespeichert werden, solltest du einen nicht all zu alten Dump der Friendica Datenbank zur Hand haben, solltest du deinen Knoten wieder herstellen müssen.