Installation

Kuonen.Verzeichnis läuft auf einem Linux-Rechner im eigenen Netz. Ein Skript fragt alles Nötige, prüft den Rechner und richtet die Domäne ein. Danach geschieht alles in der Weboberfläche. Wer erst schauen will: Ausprobieren geht ohne Server auf dem eigenen PC.

Voraussetzungen

• Ein Linux-Rechner mit Debian oder Ubuntu, Arch, Fedora oder Gentoo (mit systemd-Profil). Red Hat und seine Nachbauten (Rocky, Alma, CentOS) gehen nicht, weil ihnen der Domänencontroller von Samba fehlt.
• systemd, Root-Rechte und eine feste IPv4-Adresse im LAN.
• Für die Betriebsart Docker (Vorgabe): vier weitere freie Adressen im LAN ausserhalb des DHCP-Bereichs des Routers (Domänencontroller, Datei-, Druckserver, Weboberfläche) und eine für den Rechner selbst. Docker installiert das Skript, wenn es fehlt.
• Ein Name für die Domäne, etwa ad.firma.ch – eine Unterdomäne einer eigenen Domain, nicht .local.
• Freie Ports: immer 8443 (Wärter). Laufen die Dienste direkt auf dem Rechner (Betriebsart lokal oder Docker mit dem Netz wirt), dazu 53, 88, 135, 389, 445, 464, 636, 3268, 3269 und 443 für die Weboberfläche. Mit dem Netz macvlan hat jeder Container seine eigene Adresse; dann prüft das Skript nur 8443.

1. Herunterladen und prüfen

Das Archiv und seine Prüfsumme von der Seite Download holen, dann:

sha256sum -c kuonen-verzeichnis-2.6.0.0.tar.gz.sha256
tar xzf kuonen-verzeichnis-2.6.0.0.tar.gz
cd kuonen-verzeichnis-2.6.0.0

Die Prüfsumme ist mit OpenPGP signiert (.sha256.asc); die Programme im Archiv sind über die Zertifikatsstelle Kuonen signiert.

2. Einrichten

sudo ./dist/einrichten/verzeichnis-einrichten.sh

Das Skript arbeitet in fünf Schritten:

1. Rechte und Distribution prüfen.
2. Fragen: Betriebsart, Domäne, Adressen, Kennwort des Administrators. Was die Fragen bedeuten, steht unter Konfiguration.
3. Den Rechner prüfen: feste Adresse, systemd, freie Ports. Ist etwas nicht bereit, bricht das Skript ab, bevor es etwas ändert.
4. Einrichten: Zertifikate der Domäne, Docker oder Pakete, zuerst der Domänencontroller, dann Datei-, Druckserver und Weboberfläche, zuletzt der Wärter.
5. Die Ampel: jede Prüfung grün, gelb oder rot.

Das Kennwort des Administrators geben Sie ein, oder das Skript erzeugt eines (20 Zeichen) und zeigt es einmal an. Notieren Sie es: Es steht danach in keiner Datei, keiner Umgebungsvariable und keinem Protokoll.

Ohne Fragen, etwa für eine wiederholbare Einrichtung, geht es mit einer Antwortdatei – siehe Konfiguration.

3. Der Weboberfläche vertrauen

Die Domäne hat eine eigene Zertifikatsstelle. Damit der Browser der Weboberfläche ohne Warnung vertraut, die Datei /etc/kuonen-verzeichnis/zertifikate/ca.crt vom Server auf die PCs kopieren und dort als vertrauenswürdige Stammzertifizierungsstelle eintragen (Windows: Doppelklick → Zertifikat installieren → Lokaler Computer → „Vertrauenswürdige Stammzertifizierungsstellen“; macOS: Schlüsselbundverwaltung → System → „Immer vertrauen“).

4. Erste Anmeldung

Im Browser https://<Adresse der Weboberfläche>/ öffnen und als Administrator mit dem Kennwort anmelden. Die Übersicht zeigt den Zustand der Domäne, der Bereich Zustand die Ampel. Wie es weitergeht, steht im Handbuch: zuerst Benutzer und Gruppen anlegen, dann Freigaben und Gruppenrichtlinien.

5. Geräte in die Domäne bringen

Windows:

1. Am PC als DNS-Server die Adresse des Domänencontrollers eintragen (oder im Router per DHCP verteilen).
2. Einstellungen → Konto → Auf Arbeits- oder Schulkonto zugreifen → „Diesen Computer einer lokalen Active Directory-Domäne hinzufügen“ → Name der Domäne → Administrator und Kennwort.
3. Neu starten und mit DOMÄNE\benutzer anmelden.

Mac und Linux: mit dem Kuonen-Client – das Paket steht in der Weboberfläche unter „Übersicht“ und auf der Seite Download. Die Schritte stehen im Handbuch unter Windows, Mac und Linux.

Ein zweiter Lauf, Prüfen, Entfernen

Aktualisieren

• Neue Fassung: das neue Archiv auspacken und das Skript darin laufen lassen. Es legt nichts neu an, übernimmt die bestehende Domäne, setzt die Programme und Abbilder der neuen Fassung ein und gibt die Ampel aus.
• Innerhalb einer Fassung: In der Weboberfläche unter Zustand → Aktualisieren holt der Wärter die Abbilder der eingerichteten Fassung neu und startet die Container (Betriebsart Docker) bzw. aktualisiert die Pakete (lokal).