Webtrees Handbuch/Anleitung für Webmaster
Systemarchitektur
Die Systemarchitektur für die Anwendung webtrees umfasst einen Client, einen Server und das Backend mit dem Archiv für webtrees bei GitHub.
Client
Der Client ist das Endgerät des Nutzers auf dem irgendein aktueller Browser installiert ist (Firefox, Chrome, Edge, Safari, usw.). Als Endgerät kommen etwa Laptop, Tablet oder Smartphone in Frage. Entsprechend der Rolle des Nutzers in webtrees werden teilweise neben dem Browser noch weitere lokal installierte Anwendungen benötigt.
Besucher sowie Mitglieder oder Moderatoren benötigten nur den Browser um auf alle Funktionen von webtrees zugreifen zu können. Mitglieder und Moderatoren benötigen für die erstmalige Anmeldung eine E-Mail-Möglichkeit. Der Administrator kann aus webtrees heraus E-Mails an die Nutzer verschicken.
Ein Verwalter oder Administrator benötigt darüber hinaus ein Programm mit dem er E-Mails empfangen kann. Er wird auf diesem Weg darüber informiert, dass ein neuer Nutzer ein Konto beantragt hat. Sobald eine neue Version von webtrees auf dem Backend-Server verfügbar ist, erfolgt ebenfalls eine Nachricht an die Administratoren.
Der Webmaster benötigt ein ftp-Programm (ftp-Client) mit dem er Daten auf den Server hochladen und von diesem herunterladen kann. Und er benötigt ein Programm mit dem er die webtrees-Datenbank verwalten kann. Näheres dazu ist im nachfolgenden Abschnitt "Werkzeuge für den Webmaster" beschrieben.
Server
Der webtrees-Server kann ein physischer oder ein virtueller Server sein. Als physischer Server kommt vor allem ein dedizierter oder geteilter Server bei einem Hosting-Anbieter in Frage (siehe nächster Abschnitt "Auswahl eines Hosting-Anbieters"), aber auch ein eigener Rechner zu Hause, wie etwa ein PC, ein RaspberryPi oder ein Netzlaufwerk (siehe nachfolgender Abschnitt "Lokal installierter Server"). Als virtueller Server kommt etwa ein Docker-Container in Frage. Eine Sonderform der Installation wäre, dass der Client und der Server auf dem selben Endgerät, also lokal, installiert sind.
Die einzelnen Komponenten des Servers sind
- Datenbank
- ftp-Server
- Zertifikatsspeicher
- Laufwerk mit den Programmdateien
- Web-Server
- PHP-Interpreter
- E-Mail-Server
|
Noch beschreiben: genaue Funktion aller Server-Komponenten mit ggf. einem Verweis auf die Abschnitte unter "Voraussetzungen"; insbesondere wie geht das mit der http-Kompression und wie geht das mit dem Interpretieren von PHP und wie geht das mit kompaktem JavaScript; fehlt noch eine Server-Komponente "JavaScript-Interpreter? |
|
|
|
Was ist mit Nachrichten über das Formular? Interne Benachrichtigung und/oder E-Mail? |
|
Backend-Server
Der Backend-Server für webtrees liegt bei GitHub, dort liegen die aktuelle Version von webtrees und die in Entwicklung befindlichen Versionen. Auch fast alle Erweiterungsmodule liegen bei GitHub. Beim automatischen Upgrade, veranlasst durch einen Administrator, lädt webtrees eigenständig eine neue webtrees-Version vom Backend-Server auf den webtrees-Server.
webtrees prüft über eine Abfrage der auf dem Backend-Server vorliegenden aktuellen Version, ob es dort eine neuere Version gibt. Dazu wird die Datei "dev.webtrees.net/build/latest-version.txt" vom Backend-Server geladen. Diese Prüfaktion wird immer dann angestoßen, wenn irgendeine webtrees-Seite aufgerufen wird; die Prüfung erfolgt aber maximal einmal alle 24 Stunden. Für den Fall, dass ein Upgrade vorliegt, werden die Administratoren per E-Mail einmalig darüber informiert und es erfolgt für einen angemeldeten Administrator an verschiedenen Stellen in der Bedienoberfläche ein Hinweis.
Um eine Übersicht über die weltweit installierten webtrees-Instanzen zu bekommen, wird bei dieser Prüfung auf eine neue Version auch eine Information mit den wichtigsten Parametern des webtrees-Servers übertragen. Die dabei übermittelten Informationen sind
- eine eindeutige, anonymisierte Kennung der webtrees-Installation
- installierte webtrees-Version
- verwendete PHP-Version
- Typ der genutzten Datenbank.
Die gewonnenen Statistikinformationen werden auf dieser webtrees-Seite publiziert.
Kommunikationsnetz
In den meisten Fällen kommunizieren die Client-Rechner mit dem webtrees-Server über eine Internet-Verbindung. Diese sollte möglichst schnell und verschlüsselt sein (https).
Die Verbindung zum Backend-Server erfolgt immer über das Internet und ist immer verschlüsselt.
|
|
Im gesamten obigen Abschnitt für die Fachbegriffe noch Links auf die wikipedia einfügen |
|
Server-Typen
Server im Internet
Auswahl eines Hosting-Anbieters
Nach der Entscheidung für einen Server-Typ muss entschieden werden, wer diesen Server betreibt. Wenn man den Server nicht lokal installiert und selbst betreiben möchte, dann kommt dafür ein Hosting-Anbieter in Frage. Mit diesem schließt man einen entsprechenden Vertrag, der meist auch die Bereitstellung einer Internet-Domäne beinhaltet.
Spezialisierte Hosting-Anbieter für webtrees
Es gibt zwei Hosting-Anbieter, die sich auf webtrees spezialisiert haben. Sie bieten eine fertige und speziell auf die Anforderungen von webtrees ausgerichtete Installation auf Servern in der EU an und kümmern sich um die grundlegende Betriebssicherheit. Die Installation auf einem Server in der EU ist wichtig, da somit die europäischen Datenschutzregelungen greifen.
Ein Webtrees-Hosting-Paket ist ideal für diejenigen, die webtrees nutzen möchten, sich aber nicht mit der Einrichtung und dem Betrieb der Anwendung herumschlagen möchten. Sie erhalten ein komplett installiertes und vorkonfiguriertes System und müssen sich nur um die genealogischen Daten kümmern. Alles andere erledigt der Dienstleister im Hintergrund. Er kümmert sich in der Rolle als Webmaster um die Technik, administriert das System und sorgt dafür, dass webtrees und die notwendigen Systemkomponenten immer auf dem neuesten Stand sind.
| Wer | Land | Sprache | Preis | Besonderheiten |
|---|---|---|---|---|
| GenOnline | Deutschland | de | 131,40 €/a | persönliche Beratung bei der Nutzung von webtrees |
| Hosting webtrees | Irland | en | 99 GBP/a | persönliche Beratung und kundenspezifische Anpassungen als Extra |
Hosting mit einem dedizierten oder geteilten Server im Internet
|
|
Hier muss man webtrees selbst installieren |
|
| Wer | Land | Sprache | Perfomance | Preis | Besonderheiten |
|---|---|---|---|---|---|
| Hetzner | DE | de | ? >5000 Personen |
22,80 €/a 58,80 €/a |
1 Datenbank, WordPress, u.v.m. 10 Datenbanken, WordPress, u.v.m. |
| Alfahosting | DE | de | ? | 24,00 €/a | 10 Datenbanken WordPress, Joomla!, Typo3, Drupal u.v.m. |
| Dogado | DE | de | ? | 48,00 €/a | 10 Datenbanken Joomla!, Typo3, Drupal u.v.m. |
| Strato | DE | de | ? | 48,00 €/a | 2 Datenbanken WordPress, Joomla!, Typo3, Drupall u.v.m. |
| ionos by 1&1 | DE | de | ? | 48,00 €/a | 5 Datenbanken WordPress, Joomla!, Typo3, Drupal u.v.m. |
| [ ] | |||||
| [ ] | |||||
| [ ] |
Lokal installierter Server
Für einen PC als lokalem Server kommen als Betriebssystem Windows, MacOS oder Linux in Frage. In Abhängigkeit davon werden für den Serverbetrieb unterschiedliche Softwarepakete benötigt, die im folgenden beschrieben werden.
Man kann webtrees aber auch auf einem Netzlaufwerk der Marke Synology oder auf einen Kleinstcomputer der Marke RaspberryPi betreiben.
Windows
MacOS
Linux
Synology Netzlaufwerk
RaspberryPi
Virtueller Server
|
|
docker beschreiben |
|
Installation von webtrees
Nachdem der Server und der Hosting-Anbieter ausgewählt worden sind, steht die Installation von webtrees auf dem Server an. Die im Folgenden beschriebenen Schritte sind dabei erforderlich
- Voraussetzungen für die Installation herstellen (Systemumgebung und Server-Zugang prüfen, PHP konfigurieren, Datenbank anlegen, Web-Server und Internet-Anbindung konfigurieren)
- Programmdateien auf den Server laden
- Konfigurationsassistenten für die Ersteinrichtung nutzen
- Installation testen und GEDCOM-Testdaten hochladen
- Erweiterungsmodule installieren
Anstatt webtrees selbst zu installieren, kann man auch fertige Installationsdienste oder vorgefertigte Container-Lösungen nutzen, wenn der vorgesehene Host das unterstützt (etwa Docker, Installatron, OpenSuse, Puppet, Softaculous, Yunohost). Dazu gibt es ergänzende Hinweise in der Original-webtrees-Dokumentation. Für einige Hosting-Anbieter und Servertypen liegen dort ebenfalls noch zusätzliche Hinweise (für Bluehost, Cloudflare, Microsoft/IIS, OVH). Ansonsten zeigen die folgenden Abschnitte exemplarisch alle Schritte bei der Installation. Da jeder Server und jede Installationsumgebung verschieden ist, wird es im Detail bei Ihrer Installation etwas anders aussehen.
Voraussetzungen für die Installation
Bevor webtrees installiert werden kann, muss die Systemumgebung geprüft oder vorbereitet werden. Bei den meisten Hosting-Angeboten wird bereits alles passend parat stehen, was für webtrees benötigt wird. Wenn man einen Server selbst aufsetzt, muss man die im folgenden beschriebenen Systemkomponenten installieren und konfigurieren.
Systemumgebung
|
|
Beschreiben: Anforderungen an Speicherplatz für Dateien, Dateizugriffsrechte, Server-Performance, ... |
|
|
|
Beschreiben: Zugang per ftp |
|
PHP
PHP muss für die aktuelle Version von webtrees in einer der folgenden Versionen installiert sein: 7.4, 8.0 oder 8.1. Die Version 7.4 wird noch bis zum 28. November 2022 gepflegt werden; danach wird diese Version auch nicht mehr von webtrees unterstützt werden, d.h. spätestens bis zu diesem Termin sollten alle alten webtrees-Installationen auf eine Version 2.1.x aktualisiert werden.
Je nachdem welche PHP-Version auf dem Web-Server installiert ist, können verschiedene Versionen von webtrees genutzt werden (näheres zu den Versionsbezeichnungen bei webtrees ist im nachfolgenden Abschnitt "Versionen von webtrees" beschrieben). Die folgende Tabelle zeigt die Abhängigkeiten zwischen den PHP- und den webtrees-Versionen.
| PHP-Version | webtrees-Version | Status |
|---|---|---|
| 8.0–8.1 | ab 2.1.0 | volle Unterstützung |
| 7.4 | 2.0.23 und ab 2.1.0 | volle Unterstützung bis zum 28.11.2022 |
| 7.1–7.3 | 2.0.23 | größere Fehler und Sicherheitsprobleme werden noch behoben |
| 5.3–7.3 | 1.7.19 | nicht mehr gepflegt |
| 5.2–5.6 | 1.4.6 | nicht mehr gepflegt |
webtrees benötigt die folgenden Erweiterungsbibliotheken
- ext-curl
- ext-gd
- ext-iconv
- ext-intl
- ext-json
- ext-pcre
- ext-pdo
- ext-session
- ext-simplexml
- ext-xml
- ext-zip
Die Situation ist allerdings nicht ganz einfach, denn es gibt für einige der erforderlichen Erweiterungen auch Ersatzlösungen („Artikel Polyfills. In: Wikipedia, Die freie Enzyklopädie.“). Zum Beispiel werden in webtrees Funktionen von „php-mbstring“ verwendet, aber diese werden zusätzlich auch über „symfony/polyfill-mbstring“ eingebunden. webtrees funktioniert also auch ohne die PHP-Erweiterung, wenngleich auch etwas langsamer.
Dasselbe gilt für „php-calendar“, das von „fisharebest/ext-calendar“ ersetzt werden kann. Es kann auch noch weitere Funktionen geben, die in ähnlicher Form, eventuell mit eingeschränkter Funktionalität arbeiten, wenn die eigentliche Bibliothek fehlt.
Welche PHP-Erweiterungen aktuell installiert sind, lässt sich über den Menüpunkt "Webseite / Server Information“ im Verwaltungsmenü anzeigen.
Datenbank
|
|
Beschreiben: welche Datenbanktypen kommen in Frage? Eigene Datenbank nur für webtrees oder Mitnutzung (Präfix wt_). Nutzer mit Passwort einrichten. |
|
|
Derzeit unterstützt webtrees bei der Zeichenkodierung in der Datenbank nur UTF8_MB3, aber nicht UTF8_MB4. Dadurch ist es nicht möglich Texte oder andere Datenfelder zu speichern, die etwa Emoji enthalten. |
|
Web-Server
|
|
Beschreiben: welche Webserver kommen in Frage (Apache, Microsoft IIS, ...)? |
|
Internet-Anbindung
Entweder ist eine Internet-Domäne bereits Bestandteil des Vertrages mit dem Hosting-Anbieter oder diese muss separat bei einem Anbieter von Internet-Domänen gemietet werden. Als Beispiel wird im Folgenden die Domäne musterfamilie.de verwendet.
Der Zugang zu webtrees sollte in jedem Fall verschlüsselt erfolgen, d.h. es sollte das Protokoll https zur Verwendung kommen. Von einer ungesicherten Anbindung mit http wird abgeraten.
Es gibt zwei mögliche Konfigurationen, wie webtrees über das Internet von einem Browser adressiert werden kann
- webtrees direkt in die Heimatseite integriert:
https://musterfamilie.de - webtrees in einer Subdomain, etwa "ahnen", zur Heimatseite:
https://ahnen.musterfamilie.de
Die Variante mit der Subdomain bietet sich insbesondere dann an, wenn noch weitere Anwendungen in der Domäne installiert werden sollen (etwa Wordpress). Nicht in jedem Mietvertrag für die Heimatseite wird es eine Option geben, die die freie Wahl von Subdomains vorsieht. Wenn man die Variante mit der Subdomain wählt, dann installiert man webtrees in einen Unterordner des Hauptverzeichnisses des Web-Servers, etwa in den Ordner "webtrees" und ordnet in der Domänen-Verwaltung des Servers diesen Unterordner der Subdomain zu.
Aber auch wenn man keine Subdomain nutzen möchte oder kann, sollte man webtrees in einen eigenen Unterordner des Hauptverzeichnisses des Web-Servers installieren, etwa in den Ordner "webtrees". Dann ist es möglich zukünftig auch noch andere Anwendungen in der Domäne zu betreiben und zu adressieren. Die Adressierung in einem auf webtrees zugreifenden Browser sieht dann so aus
- webtrees in einem Unterordner der Heimatseite integriert:
https://musterfamilie.de/wetrees
Die Anbindung an das Internet sollte eine hohe Datenrate bieten und ausfallsicher gestaltet sein. Wenn man ein Hosting-Angebot nutzt, wird man sich darum nicht kümmern müssen. Wenn man webtrees auf einem lokalen Server installiert hat und den Wunsch hat, dass dieser aus dem Internet erreichbar sein soll, dann muss man sich eine dynamische Internet-Adresse besorgen, diese einrichten und im eigenen Router eine Port-Weiterleitung zu dem eigenen Web-Server einrichten.
|
|
Noch beschreiben: Installation der Zertifikate für https (für Domain bzw. Subdomain) |
|
Werkzeuge für den Webmaster
Neben den Voraussetzungen auf der Seite des Servers, benötigt man als Webmaster noch lokale Programme.
|
|
Beschreiben: Browser, ftp-Programm, Datenbankmanagement-Programm, E-Mail, ... |
|
Werkzeuge für einen Programmierer
Erstinstallation von webtrees
|
|
Beschreiben: Aktuelle Version runterladen, entpacken, hochladen per ftp |
|
Ersteinrichtung
|
|
Noch beschreiben: Start des Einrichtungsassistenten, Screenshots zu allen folgenden Schritten |
|
Sprache festlegen
Server überprüfen
Datenbankanbindung konfigurieren
Administratorkonto einrichten
config.ini.php
Test der Installation
Nachdem die Erstinstallation abgeschlossen ist, sollte in einem ersten Test die einwandfreie Funktion der Website geprüft werden.
|
|
Noch beschreiben: wie testet man am besten? Hochladen von GEDCOM-Testdaten. |
|
Installation von Erweiterungsmodulen
Nach dem erfolgreichen Test können nun noch Erweiterungsmodule installiert werden (siehe dazu den Abschnitt "Erweiterungsmodule"). Dies sollte schrittweise erfolgen, damit bei eventuell auftretenden Problemen das verursachende Erweiterungsmodul leichter identifiziert werden kann.
Als Webmaster können Sie auf dem Server im Ordner "/modules_v4" installierte Erweiterungsmodule durch eine Umbenennung auf einfache Art deaktivieren. Dazu müssen Sie in den Ordnernamen einen "." (Punkt) einfügen, etwa indem Sie an den Ordnernamen ein ".disable" anhängen. Also indem Sie etwa den Ordner "jc-theme-justlight" in "jc-theme-justlight.disable" umbenennen. Solche Ordner sind dann für webtrees komplett unsichtbar. Durch das Entfernen des angehängten Namensbestandteils zu einem späteren Zeitpunkt, wird das Erweiterungsmodul wieder für webtrees sichtbar. Diese Funktion reicht somit tiefer als das Aktivieren oder Deaktivieren von Erweiterungsmodulen im Menü "Module" durch einen Administrator und ist immer dann zu empfehlen, wenn vermutet wird, dass ein Erweiterungsmodul Fehler verursacht.
Upgrade
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 Aktualisierung 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 Upgrades enthalten in der Regel eine erhebliche Anzahl von beseitigten Fehlern sowie Verbesserungen in der Bedienoberfläche oder Programmerweiterungen. Gefundene und behobene Sicherheitslücken führen 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.1.0, 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 Upgrade bei einem Wechsel der Hauptversion ist nur manuell möglich. Hierzu gibt es eine spezielle Anleitung und es müssen umfangreiche Vorbereitungen für das Upgrade 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 Erweiterungsmodule 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 und können deshalb weiter verwendet werden.
Eine Übersicht über alle bislang vorliegenden Versionen von webtrees ist im Kapitel "Allgemeine Erläuterung des Programms" aufgeführt.
Automatisches Upgrade
webtrees hat die Fähigkeit, sich automatisch zu aktualisieren. Alle 24 Stunden sucht webtrees nach einer aktualisierten Version. Sollte ein Upgrade verfügbar ist, dann erscheint eine Hinweiszeile mit einem Link, sofern man als Administrator angemeldet ist. Durch einen Klick auf den Link kann der Administrator den Upgrade-Assistenten für das automatische Update nutzen.
Automatische Upgrades sind von Berechtigungen und Ressourcen auf dem Server abhängig. Die verwendeten PHP-Skripte benötigen die Berechtigung
- Dateien vom webtrees-GitHub-Server über eine gesicherte Kommunikation auf den webtrees-Server zu kopieren.
- Dateien auf dem Server zu überschreiben. Wenn der Webserver Skripte als anonymer Benutzer ausführt, dann wird er keine Berechtigung haben, Dateien zu aktualisieren. Wenn Sie also aufgefordert werden, die Berechtigungen des Ordners /data auf 777 zu ändern, können Sie das automatische Upgrade nicht verwenden; sie müssen in diesem Fall dann ein manuelles Upgrade durchführen oder die Voraussetzungen für das automatische Upgrade schaffen.
Der Server muss ausreichend leistungsfähig sein, um das Upgrade abzuschließen, ohne CPU- und Speichergrenzen zu überschreiten. Der Server muss ungefähr 130 MB freien Speicherplatz haben, um die neue Version zu speichern und zu entpacken. Das Upgrade dauert normalerweise zwischen 15 und 60 Sekunden. Wenn nach fünf Minuten keine Antwort erfolgt ist, dann wurde wahrscheinlich ein CPU-Zeitlimit erreicht und das Upgrade ist fehlgeschlagen.
|
|
Noch beschreiben: was muss der Webmaster genau tun, damit sein Server die benötigten Fähigkeiten hat |
|
Der automatische Upgrade-Prozess erfolgt in den folgenden Schritten
- Falls die Vesta-Erweiterungsmodule installiert sind, erfolgt ggf. eine Warnung, dass diese [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule|| eventuell mit der neuen Version von webtrees nicht kompatibel sein könnten (siehe nebenstehende Abbildung). Hier sollte man also den Prozess ggf. abbrechen, wenn man erst die Kompatibilität prüfen möchte. Andere Erweiterungsmodule verwenden keine solche Benachrichtigungsfunktion. Hilfreich ist immer ein Blick ins webtrees-Forum und auf die GitHub-Seiten der installierten Erweiterungsmodule. Ein Upgrade auf einem webtrees-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 Moderator freigegeben wurden (siehe Abschnitt "Freigeben von Änderungen durch einen Moderator"). Der Upgrade-Prozess bricht aber nicht ab, wenn noch solche Änderungen vorliegen, es erfolgt lediglich eine Warnmeldung.
- 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 dann an die Zielstelle kopiert.
- Zum Abschluss öffnet sich das Verwaltungsmenü. Hier kann vom Administrator kontrolliert werden, ob die neue Version korrekt angezeigt wird.
Manuelles Upgrade
Beim manuellen Upgrade lädt der Webmaster eine neue, freigegebene Version von webtrees auf einen lokalen Rechner herunter und entpackt diese Version dort. Falls Erweiterungsmodule installiert sind, sollte überprüft werden, ob diese mit der neuen Version von webtrees kompatibel sind. Eventuell stehen für diese Module auch Upgrades zur Verfügung.
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 der Website eine Meldung sehen: "Die Webseite befindet sich im Wartungsmodus. Sie sollten es in einigen Minuten erneut versuchen.". Wenn die Datei "offline.txt" leer ist, dann wird diese Standardnachricht angezeigt; alternativ kann man eine besondere Nachricht in diese Datei schreiben, so dass die Besucher dann stattdessen diese Meldung erhalten. Nach dem Kopieren der Dateien auf den Server muss die Datei wieder in "/data/offline.txt.disable" umbenannt werden. Auch wenn der Administrator in der Systemsteuerung ein anderes Verzeichnis für den Datenordner gewählt haben sollte, der Speicherort für diese Datei ist immer im Verzeichnis "/data".
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".
|
|
Wie verläuft ein Upgrade, wenn man Composer einsetzt? |
|
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 bis 2.0.23: beim Update auf die Version 2.1 ändern sich in Vorbereitung auf den GEDCOM-Standard 7.0 einige Datenfelder
- 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 diese Anleitung vor dem Upgrade 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
Dateirechte
.htaccess
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
Suchmaschienenoptimierung
Die Auffindbarkeit von webtrees-Seiten durch Suchmaschinen kann erwünscht oder unerwünscht sein.
Wenn man nicht möchte, dass die Seiten gefunden werden, dann muss man die im Abschnitt "robots.txt" beschriebene Funktion nutzen und die Einstellungen in der webtrees-Verwaltung wie im Abschnitt "Datenschutz" verwenden, um Informationen für Besucher unsichtbar zu machen. Suchmaschinen greifen mit den selben Rechten auf webrees-Seiten zu wie Besucher.
Auf der anderen Seite kann es sinnvoll sein, dass einige der Informationen, die man in den Stammbäumen hinterlegt hat, durch Suchmaschinen indiziert werden. So können andere Familien- oder Ahnenforscher oder entfernte Familienmitglieder auf diese Informationen aufmerksam werden, wenn sie etwa nach einem Familiennamen im Internet suchen. Dadurch kann man dann mit diesen in Kontakt kommen und so die eigene Forschung entsprechend erweitern.
|
|
|
|
sitemap.xml
|
|
|
|
|
|
|
|
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.
Erweiterungsmodule
|
|
;Externer Link auf "Download/modules and themes" einfügen |
|
webtrees ist so konzipiert, dass es durch Module erweitert und modifiziert werden kann. Erweiterungsmodule sind entweder funktionale Erweiterungen des webtrees-Kerns oder zusätzliche Themen (Gestaltung der Bedienoberfäche), welche von Mitgliedern der webtrees-Gemeinschaft erstellt und der Allgemeinheit zur Verfügung gestellt wurden. Erweiterungsmodule sind nicht Bestandteil der Erstinstallation von webtrees oder von neuen webtrees-Releases und müssen daher separat installiert oder bei Updates aktualisiert werden.
In diesem Unterkapitel werden alle bekannten Erweiterungsmodule aufgeführt, welche entweder auf der Seite - Modules and themes oder in [1] veröffentlicht wurden.