Eine Komponente entfernen

Wie Sie eine Komponente vollständig loswerden — und was danach noch da ist, obwohl DokuWiki „deinstalliert„ meldet.

Der wichtigste Satz vorweg: Eine Deinstallation löscht das Verzeichnis der Komponente und sonst nichts. Einstellungen, Datenbanken, Dateien und Seiteninhalte bleiben unangetastet liegen. Das ist so gewollt — eine versehentliche Deinstallation soll keine Daten kosten —, aber es heißt, dass die Aufräumarbeit Ihre ist.

• Ein Administratorkonto und Schreibzugriff auf lib/plugins/<kennung>/.
• Eine Sicherung, siehe Die Sicherung. Sie ist hier wichtiger als bei einer Aktualisierung: Schritt 3 und 4 dieser Anleitung sind nicht rücknehmbar.
• Die Gewissheit, dass nichts anderes darauf aufsetzt. Prüfen Sie die Abhängigkeitstabelle in der Spalte „Wird vorausgesetzt von“. Eine Komponente zu entfernen, auf die andere hart aufsetzen, nimmt diesen ihre Arbeitsgrundlage.

Entfernen Sie nicht sofort. Schalten Sie die Komponente zuerst ab und lassen Sie das Wiki einige Tage so laufen — siehe Eine Komponente aktivieren oder deaktivieren.

Das Abschalten ist wirkungsgleich mit dem Entfernen, aber in einem Handgriff rücknehmbar. Was in dieser Zeit an Ihnen vorbeigeht, hätte Sie nach der Entfernung mit erheblich mehr Aufwand eingeholt: eine Auszeichnung auf einer selten aufgerufenen Seite, ein Ablauf, der die Komponente einmal im Monat braucht, eine andere Komponente, die stiller degradiert als erwartet.

1. Administration → Erweiterungsverwaltung → Installierte Erweiterungen (?do=admin&page=extension).
2. Die Komponente aufklappen und Deinstallieren wählen.

php bin/plugin.php extension uninstall wkblog

Ein Template lässt sich nicht deinstallieren, solange es ausgewählt ist. Setzen Sie in Administration → Konfiguration die Einstellung template zuerst auf ein anderes — dokuwiki ist immer vorhanden —, dann entfernen Sie das nicht mehr benutzte.

Gehen Sie diese fünf Orte durch. Was Sie davon aufräumen, entscheiden Sie — wichtig ist, dass Sie wissen, dass es da ist.

Der Seiteninhalt bleibt in jedem Fall. Auszeichnungen einer entfernten Komponente stehen weiter im Quelltext der Seiten und erscheinen ab dem nächsten Rendern als Rohtext. Sie finden alle betroffenen Seiten über die Volltextsuche nach dem Auszeichnungspräfix — bei wksnippet etwa nach {{wk:snippet. Das ist Redaktionsarbeit und lässt sich nicht automatisieren, ohne Inhalte zu verändern.

Dieser Schritt gilt nur für die Komponenten, die Geheimnisse führen. Für alle anderen ist Schritt 3 vollständig.

Der Grund für einen eigenen Schritt: Ein gelöschter Datensatz ist kein vernichteter Datensatz. Er kann in einer Migrationssicherung, in einer Bandsicherung oder in nicht wiederbenutzten Datenbankseiten fortbestehen. „Sicher„ heißt hier: unbrauchbar für jemanden, der später an eine Kopie kommt.

Der Tresor verschlüsselt seine Einträge; die Stärke der Bereinigung hängt daran, wo der Hauptschlüssel liegt (Einstellung keysource).

1. data/dwdo/vault.sqlite entfernen.
2. Jede zugehörige Datei in data/dwdo/backup/ entfernen.
3. Das Schlüsselmaterial unbrauchbar machen — je nach Herkunft:

1. keysource und keysource_ref aus conf/local.php entfernen.

1. data/meta/wkidentity/ vollständig entfernen. Dort liegen die Geheimnisse der Authentifizierungs-Apps (<konto>.secret), die Wiederholungssperren (.totpreplay), die ausstehenden E-Mail-Codes (.emailcode) und die offenen Vorgänge als JSON-Dateien.
2. conf/wkidentity-policy.json entfernen — die Regelung, welche Namensräume einen zweiten Faktor verlangen.
3. $conf['plugin']['wkidentity']['enforce_login'] aus conf/local.php entfernen.

1. conf/wksqliteds.connections.json entfernen. Die Datei beschreibt die benannten Verbindungen und kann Zugangsdaten zu fremden Datenbankservern enthalten.
2. conf/wksqliteds.policy.json entfernen.
3. Die Datenbanken selbst liegen dort, wohin die Verbindungen zeigen — nicht zwingend unter data/. Gehen Sie die Verbindungsliste durch, bevor Sie die Datei löschen.

1. wkmail: Der Schlüssel password in conf/local.php hält entweder das Kennwort im Klartext oder einen Verweis auf wkvault. Im ersten Fall gehört die Zeile entfernt und das Kennwort beim Anbieter gewechselt — es hat in einer Konfigurationsdatei und damit in jeder Sicherung davon gestanden.
2. wkdoado: ado_secret_root nennt das Verzeichnis mit den Zugriffstoken. Token widerrufen, dann Verzeichnis entfernen. Ein gelöschtes Token bleibt gültig, bis es widerrufen wird.
3. wkresource: data/dwdo/resource.sqlite enthält Verbindungsangaben — Host, Port, Pfad —, aber keine Geheimnisse; ein Eintrag verweist auf sein Geheimnis nur über eine Referenz. Die Datei ist trotzdem eine Aufstellung Ihrer Infrastruktur.

Auf herkömmlichen Datenträgern hinterlässt ein gewöhnliches Löschen den Inhalt bis zum Überschreiben. Wo das eine Rolle spielt, überschreiben Sie die Datei vor dem Löschen (shred unter Linux, ein gleichwertiges Werkzeug unter Windows). Auf SSDs und in virtualisierten oder gehosteten Umgebungen ist das kein verlässlicher Nachweis der Vernichtung — dort ist die Verschlüsselung der Ablage der belastbare Weg, nicht das Überschreiben. Vergessen Sie über der aktiven Datei nicht die Sicherungen; sie sind der Ort, an dem Geheimnisse am längsten überleben.

1. Die Komponente ist fort. Administration → Erweiterungsverwaltung führt sie nicht mehr auf; php bin/plugin.php extension list -f i ebenso wenig. Das Verzeichnis lib/plugins/<kennung>/ existiert nicht mehr.

2. Nichts vermisst sie. Rufen Sie die Seiten und Oberflächen auf, die sie benutzt haben. Erwartet ist: Der Menüeintrag ist weg, die Auszeichnung erscheint als Rohtext, abhängige Komponenten zeigen ihre schlichtere Oberfläche. Nicht erwartet ist eine PHP-Fehlermeldung. Tritt eine auf, hat eine andere Komponente eine harte statt einer weichen Abhängigkeit — siehe Fehlerdiagnose.

3. Der Dienst ist abgemeldet. Mit $conf['allowdebug'] = 1 zeigt ?do=wkcore_diag die angemeldeten Dienste. Der Dienst der entfernten Komponente darf dort nicht mehr stehen. Steht er noch, liegt ihr Programmcode noch irgendwo — geprüft wird der Verzeichnisname, nicht der Anzeigename.

4. Die Reste sind gesichtet. Gehen Sie die fünf Orte aus Schritt 3 ein zweites Mal durch. Bei einer Komponente mit Geheimnissen gehört dazu die Frage, ob die alten Sicherungen weiterhin aufbewahrt werden — und ob das nach Schritt 4 noch die richtige Entscheidung ist.

• Komponentenmatrix — welche Orte für Ihre Komponente belegt sind.
• How to: Eine Komponente aktivieren oder deaktivieren — der rücknehmbare Zwischenschritt.
• Eine Komponente installieren — wenn die Komponente doch zurückkommt. Die verbliebenen Einstellungen wirken dann sofort wieder.
• Fehlerdiagnose — Symptome nach dem Entfernen.