Webtrees Handbuch/Anleitung für Webmaster
- Handbuch Im Aufbau...
Bitte haben Sie noch ein wenig Geduld..
Auswahl eines Hosters
Hoster eigener Server
- Bitte ergänzen...
Hier kann man "webtrees" selbst installieren und gestalten.
| Wer | Land | Spr. | Perfomance | Preis | Besonderheiten |
|---|---|---|---|---|---|
| Hetzner | DE | de | ? >5000 Pers. |
22,80 /J 58,80 /J |
1 Datenbank, WordPress, u.v.m. 10 Datenbanken, WordPress, u.v.m. |
| Alfahosting | DE | de | ? | 24,00 €/J | 10 Datenbanken WordPress, Joomla!, Typo3, Drupal u.v.m. |
| Dogado | DE | de | ? | 48,00 €/J | 10 Datenbanken Joomla!, Typo3, Drupal u.v.m. |
| Strato | DE | de | ? | 48,00 €/J | 2 Datenbanken WordPress, Joomla!, Typo3, Drupall u.v.m. |
| ionos by 1&1 | DE | de | ? | 48,00 €/J | 5 Datenbanken WordPress, Joomla!, Typo3, Drupal u.v.m. |
| [ ] | |||||
| [ ] | |||||
| [ ] |
Hoster für webtrees
Es gibt zwei Hoster, die sich auf webtrees spezialisert haben. Sie bieten eine fertige Installation von "webtrees" auf Servern in der EU an und kümmern sich in ihrer Rolle als Webmaster um alle notwendigen Pflegearbeiten.
| Wer | Land | Sprache | Preis | Besonderheiten |
|---|---|---|---|---|
| GenOnline | DE | de | 131,40 €/a | persönliche Beratung bei der Nutzung von webtrees |
| [hosting.webtrees.net Hsoting webtrees] | IR | en | ? €/a | persönliche Beratung und kundenspezifische Anpassungen |
Voraussetzungen
Installation
Ersteinrichtung
Upgrade
|
Composer wie verläuft ein Update, wenn man Composer einsetzt? |
|
Eine Aktualisierung von webtrees geht schnell und einfach. Falls der Kern von webtrees auf einen neuen Versionsstand gebracht werden soll, dann stehen zwei verschiedene Wege zur Verfügung: das automatische und das manuelle Verfahren. Für die Aktualisierug eines Erweiterungsmoduls steht nur das manuelle Verfahren zur Verfügung.
Upgrade von webtrees
Das Vorliegen einer neuen Version wird dem Administrator in einer Hinweiszeile angezeigt. Es wird dringend empfohlen, die Installation zu aktualisieren, sobald eine neue Version von webtrees zur Verfügung steht. Selbst kleinere Updates enthalten in der Regel eine erhebliche Anzahl von beseitigten Fehlern sowie Verbesserungen in der Benutzungsoberfläche oder Programmerweiterungen. Gefundene und behobene Sicherheitslücken fürhren immer zu einer neuen Version, die dann schnellstmöglich eingespielt werden sollte. Falls nicht sowieso regelmäßig Datensicherungen erstellt werden, sollte vor einem Update immer eine Sicherung durchgeführt werden.
Versionen von webtrees
Die Versionsnummern von webtrees in der Form x.y.z, also etwa 2.0.19, folgen folgendem Schema
- die erste Zahl "x" kennzeichnet eine Hauptversion, die nicht miteinander kompatible Versionen unterscheidet.
Die Datenbankstruktur von webtrees in der Version 1 und die internen Schnittstellen der Module von webtrees passen nicht zur Version 2 von webtrees. Erweiterungsmodule für webtrees 1 funktionieren also nicht mit der Version 2 und umgekehrt. Ein Update bei einem Wechsel der Hauptversion ist nur manuell möglich. Hierzu gibt es eine spezielle Anleitung und es müssen ggf. umfangreiche Vorbereitungen für ein Update getroffen werden.
- die zweite Zahl "y" kennzeichnet eine neue Version, die grundsätzlich neue Funktionen und geänderte interne Schnittstellen mit sich bringt.
Erweiterungsmodule können kompatibel sein, sind es aber wahrscheinlich eher nicht. Vor dem Einspielen eines Updates sollte also geprüft werden, ob alle im Einsatz befindlichen Erweiterugsmodule in einer kompatiblen Version vorliegen. Der Wechsel von Version 2.0 zur Version 2.1 etwa betrifft so viele interne Schnittstellen, dass die meisten Erweiterungsmodule angepasst werden müssen. Bei einem Wechsel der webtrees-Version kann es auch vorkommen, dass andere Versionen von PHP unterstützt werden, so dass der Webmaster gleichzeitig auch einen Wechsel der PHP-Version vornehmen kann oder muss.
- die dritte Zahl "z" kennzeichnet eine Unterversion, die etwa gefundene Fehler behebt oder kleinere Anpassungen mit sich bringt.
Im Normalfall werden die meisten Erweiterungsmodule von diesen Änderungen nicht betroffen sein.
Automatisches Upgrade
webtrees hat die Fähigkeit, sich automatisch zu aktualisieren. Sobald eine neue Version von webtrees vorliegt, erscheint eine Hinweiszeile sofern man sich als Administrator angemeldet hat. Durch einen Klick auf den Link kann der Administrator den Upgrade-Assistenten für das automatische Update nutzen.
Dieser Assistent basiert auf folgenden Server-Funktionen.
- Die Fähigkeit, entfernte Dateien über eine gesicherte Kommunikation per HTTPS zu holen.
- Die Fähigkeit, lokale Dateien zu überschreiben. Dies bedeutet, dass der Webserver Skripte mit dem selben Eigentümer-Konto ausführen muss. Wenn der Webserver Skripte als anonymer Benutzer ausführt, wird er keine Berechtigung haben, Dateien zu aktualisieren.
Wenn eine dieser Eigenschaften nicht vorliegen sollte, wird der Administrator aufgefordert, ein manuelles Update durchzuführen.
|
|
hier muss noch beschrieben werden, was der Webmaster genau tun muss, damit sein Server die benötigten Fähigkeiten hat |
|
Der automatische Upgrade-Prozess erfolgt in den folgenden Schritten
- Falls Erweiterungsmodule installiert sind, erfolgt ggf. eine Warnung, dass diese Erweiterungsmodule eventuell mit der neuen [Version] von webtrees nicht kompatibel sein könnten.
Hier sollte man also den Prozess ggf. abbrechen, wenn man erst die Kompatibilität prüfen möchte. Hilfreich sind dazu ein Blick ins webtrees-Forum und auf die GitHub-Seiten der installierten Erweiterungsmodule. Ein Upgrade auf einem Testserver kann die Sicherheit bringen, dass sich die installierten Erweiterungsmodule mit der neuen webtrees-Version vertragen werden; erst danach sollte dann das Upgrade im Produktivsystem eingespielt werden.
- Danach wird ein Verzeichnis /data/tmp/upgrade angelegt in das temporär die neuen Dateien geladen werden
- Nun wird geprüft, ob es noch Änderungen von Daten in den Stammbäumen gibt, die noch nicht vom Verwalter freigegeben wurden.
- Es werden alle Stammbäume automatisch exportiert, d.h. es wird für jeden Stammbaum im Verzeichnis /data eine aktuelle GEDCOM-Datei angelegt (der Dateiname enthält das Datum des Exports).
- Vom webtrees-GitHub-Server wird die neue webtrees-Version als zip-Datei in das im Schritt 2 angelegte Verzeichnis kopiert.
- Die zip-Datei wird in das temporäre Verzeichnis entpackt und die entpackten Dateien werden an die Zielstelle kopiert.
- Zum Abschluss öffnet sich das Verwaltungsmenü. Hier kann vom Administrator kontrolliert werden, ob die neue Version korrekt angezeigt wird.
|
|
Bricht der Prozess in Schritt 2 ab, wenn noch unbestätigte Änderungen vorliegen? Link auf Abschnitt "Annehmen von Änderungen" setzen! |
|
Es kann vorkommen, dass ein vom Admnistrator gestartetes automatisches Update nicht erfolgreich verläuft und abbricht, etwa weil nicht genug Speicherplatz zur Verfügung steht oder weil die für den Server zur Verfügung stehende Prozessorzeit nicht ausreicht. Dann sollte der Webmaster zuerst versuchen das zu Grunde liegende Problem zu lösen und dann ein manuelles Update durchführen. Das Verzeichnis /data/tmp/upgrade auf dem Server sollte in diesem Fall manuell gelöscht werden.
Manuelles Upgrade
Beim manuellen Update lädt der Webmaster eine neue, freigegebene Version von webtrees auf einen lokalen Rechner herunter und entpackt diese Version dort. Dann werden alle Ordner und Dateien mit einem ftp-Programm in das webtrees-Verzeichnis auf dem Webserver kopiert.
Während die neuen Dateien hochgeladen werden, würde ein Besucher der Website auf eine Mischung aus alten und neuen Dateien stoßen. Dies könnte ein unvorhersehbares Verhalten oder Fehler verursachen. Um dies zu verhindern, muss vor dem Kopieren die Datei data/offline.txt.disable in data/offline.txt umbenannt werden. Solange diese Datei existiert, werden die Besucher die Meldung "Die Webseite befindet sich im Wartungsmodus. Sie sollten es in einigen Minuten erneut versuchen." sehen. Nach dem Kopieren der Dateien auf den Server muss die Datei wieder in data/offline.txt.disable umbenannt werden.
Beim Wechsel von einer Unterversion zu einer anderen, kann man üblicherweise den Inhalt der Dateien auf dem Server einfach überschreiben. Beim Wechsel zu einer neuen Version oder gar einer Hauptversion empfiehlt es sich alle Dateien im webtrees-Verzeichnis auf dem Server zuvor zu löschen. Davon ausgenommen ist die Datei .htaccess im Stammverzeichnis von webtrees und die Dateien im Unterverzeichnis data.
Upgrade in Abhängigkeit von der Ausgangsversion
Wenn Sie derzeit eine der unten aufgeführten Versionen von webtrees verwenden, gibt es beim Upgrade zusätzliche Dinge zu beachten.
- webtrees 2.0.8: Diese Version enthält einen Fehler im Auto-Upgrade-Code; diese Version wurde schnell zurückgezogen, aber einige Benutzer haben sie installiert. Um den automatischen Upgrade-Assistenten wieder verwenden zu können, müssen zwei Dateien bearbeitet werden
- Bearbeiten Sie zunächst app/Factories/FilesystemFactory.php und ändern Sie Zeile 40 von „/../../..“ in „/../…“. Dies behebt den Fehler.
- Bearbeiten Sie zweitens app/Webtrees.php und ändern Sie Zeile 101 von „2.0.8“ in „2.0.7“. Dadurch wird das automatische Upgrade wieder aktiviert.
- webtrees 1.7.10 – 1.7.19: Es sind vor einem manuellen Upgrade auf die Version 2 diverse Änderungen an den Einstellungen, der Serverkonfiguration und eventuell auch Anpassungen in den genealogischen Daten notwendig. Daher sollte Sie unbedingt die Hinweise in der englischsprachigen Dokumentation vor diesem Umstieg beachten.
- webtrees 1.4.0 – 1.7.9: Es muss vor einem Umstieg auf die Version 2 erst ein Upgrade auf die Version 1.7.19 erfolgen.
- webtrees 1.0.0 – 1.3.2: Zuerst muss die „Medien-Firewall“ deaktiviert werden (siehe Anleitung in englischer Sprache); dann muss ein manuelles Upgrade auf die Version 1.7.19 durchgeführt werden.
- phpGedView: In webtrees 1.7.19 ist ein spezieller Migrationsassistent für das Vorgänger-Programm phpGedView integriert. Sie sollten daher diese Version als neue Instanz neben phpGedView installieren und dann den Migrationsassistenten nutzen. Beachten Sie, dass Sie keine funktionierende phpGedView-Installation benötigen. Sie benötigen nur die Datenbank und den Ordner index. Nähere Hinweise finden Sie in der englischsprachigen Dokumentation.
Alle hier eventuell benötigten älteren Versionen von webtrees findet man auf der webtrees-Download-Übersichtsseite.
Upgrade eines Erweiterungsmoduls
Wenn eines der Erweiterungsmodule in einer neuen Version vorliegt, erhält der Administrator beim Aufruf der Verwaltungsseite eine entsprechende Nachricht.
|
|
Noch beschreiben: wie findet man heraus welches Erweiterungsmodul die Meldung erzeugt hat und wo man die aktuellere Version findet |
|
Dann lädt man als Webmaster das neue Release des Erweiterungsmoduls auf den lokalen Rechner herunter und entpackt den Inhalt. Eventuell muss man den gefundenen Ordnernamen noch entsprechend der Anleitung zu diesem Modul umbenennen, etwa von einer angehängten Versionsnummer befreien. Danach lädt man den Ordner mit einem ftp-Programm ins Verzeichnis modules_v4 der webtrees-Installation und überschreibt den dortigen Inhalt (man kann auch den alten Ordner mit dem Erweiterungsmodul auf dem Server zuvor löschen).
Zum Abschluss muss im Browser das Fenster mit webtrees erneut geladen, d.h. aufgefrischt werden, damit die Änderung sichtbar wird.
Pretty URLs
Datensicherheit und Datenschutz
Sichere Kommunikationsverbindung
https ...
Logfile-Überwachung
Zugriffsschutz
robots.txt
Datenschutzerklärung und Impressum
|
|
Das folgende sind nur erste Stichpunkte zu den relevanten Positionen ... |
|
- Standard-Erklärung versus eigenes Modul
- Google-Diagramme führen zur Weitergabe von IP-Adressen an Google in USA
- Tracking-Funktionen in webtrees
- Einbindung von webseiten im html-Blöcken auf der Startseite
- Einbindung von Funktionen im CCS/Javascript-Modul
Backup der genealogischen Daten und der Datenbank
Da ein jedes IT-System durch technische Probleme, durch Fehlkonfigurationen oder durch Cyber-Attacken gestört werden kann, ist es unbedingt erforderlich ein Backup-Konzept zu erstellen. Die webtrees-Anwendung selbst kann jederzeit wieder frisch installiert werden, aber die genealogischen Daten und die in der Datenbank hinterlegten Einstellungen müssen regelmäßig gesichert werden.
Eventuell legt der Hosting-Anbieter bereits automatisch regelmäßige Backups an. Wenn dies nicht der Fall sein sollte, dann muss der Webmaster sich selbst darum kümmern.
Backup der genealogischen Daten
Um die genealogischen Daten zu sichern, sollten alle in webtrees angelegten Stammbäume regelmäßig durch den Webmaster als GEDCOM-Datei exportiert werden. Diese GEDCOM-Dateien sollten mit einem Datum im Dateinamen versehen werden und nicht nur auf dem Server gespeichert werden, sondern auch auf einem anderen sicheren Datenträger archiviert werden. Dieser Datenträger sollte nicht online sein, d.h. er sollte nicht permanent aus dem Internet zugänglich sein.
Die Mediendateien, die etwa im webtrees-Verzeichnis "data/media" gespeichert sind, müssen ebenfalls regelmäßig mit Hilfe eines ftp-Programms gesichert werden. Die Vorschaubilder (thumbnails) brauchen nicht gesichert zu werden, da sie bei Bedarf jederzeit automatisch wieder neu erzeugt werden.
Auch die Einstellungen in data/config.ini müssen gesichert werden.
webtrees bietet alternativ auch die Möglichkeit, dass der Verwalter oder der Administrator statt dem Webmaster die Datensicherung übernehmen können. Dazu muß der Verwalter für seinen Stammbaum oder der Administrator für alle Stammbäume das Verwaltungsmenü aufrufen und dort einen Export der GEDCOM-Daten und der zugehörigen Mediendateien, in einer zip-Datei verpackt, anstossen.
Backup der webtrees Datenbank
Jeder Hosting-Anbieter bietet einen Zugang zu der von webtrees genutzten Datenbank, etwa durch das Werkzeug "phpMyAdmin".
|
|
|
|
Wählen Sie für die Datensicherung im Hauptfenster von phpMyAdmin im oberen Menü „Exportieren“ und dann „Los“. Wählen Sie nach einigen Sekunden aus, wohin Sie exportieren möchten, und klicken Sie auf die Schaltfläche „Speichern“, um die Sicherung auf Ihren Computer herunterzuladen.
Wenn Sie eine gesicherte Datenbank wieder installieren möchten, dann nutzen Sie dafür ebenfalls phpMyAdmin. Wählen Sie im Hauptfenster im oberen Menü „Importieren“ und dann „Los“, damit die vorhandenen Tabellen durch die gesicherten ersetzt werden.
Neuinstallation von Webtrees-Dateien
Löschen Sie alle Ordner im webtrees-Verzeichnis bis auf den Ordner "data". Löschen Sie im Hauptverzeichnis alle Dateien bis auf die Datei ".htaccess". Nun laden Sie wie bei der Erstinstallation die aktuellste Version von webtrees auf ihren lokalen PC und dann mit einem ftp-Programm auf ihren Server ins Verzeichnis webtrees.