Fehlerbehebung

Logs, Dienststatus und typische Installations- oder Setup-Probleme.

Erste Diagnose

adpki status
sudo adpki logs
sudo systemctl status nginx php8.4-fpm
sudo systemctl status adpki-ca adpki-worker adpki-reverb

Relevante Protokolle:

/var/log/adpki/installer/adpki-install.log
/var/log/adpki/setup/adpki-setup.log
/var/log/adpki/backend/
/var/log/adpki/ca-core/
/var/log/adpki/nginx/
/var/log/letsencrypt/letsencrypt.log

`adpki-setup` meldet fehlende Runtime

Das Setup startet nur, wenn adpki-install erfolgreich abgeschlossen wurde und Backend, Frontend sowie CA-Core vorhanden sind.

sudo adpki-install

Prüfe danach:

test -x /opt/adpki/ca-core/adpki-ca
test -f /opt/adpki/backend/artisan
test -f /opt/adpki/frontend/dist/index.html

Datenbankverbindung schlägt fehl

Host, Port, Datenbank und Benutzer prüfen
Netzwerkfreigabe und pg_hba.conf beim vorhandenen PostgreSQL-Server prüfen
sicherstellen, dass Datenbank und Benutzer bereits existieren
CREATE- und DROP-Rechte auf der AD-PKI-Datenbank gewähren

Test:

PGPASSWORD='<PASSWORT>' psql \
  -h '<DB-HOST>' -p 5432 -U '<DB-BENUTZER>' -d '<DB-NAME>' \
  -c 'SELECT version();'

TLS-Schritt schlägt fehl

Das Setup benötigt:

korrekt aufgelöste Domain,
erreichbaren Port 80,
laufenden CA-Core auf 127.0.0.1:8080,
freien Port 80 während der Certbot-Challenge.

getent hosts pki.example.com
curl -I http://pki.example.com/
curl http://127.0.0.1:8080/acme/directory
sudo ss -lntp | grep -E ':(80|443)\b'

CA-Datei wird nicht gefunden

Der Setup-Wizard akzeptiert nur existierende Dateien und erwartet absolute Pfade:

realpath ~/pki/root/certs/root-ca.cert.pem
realpath ~/pki/intermediate/certs/intermediate-ca.cert.pem
realpath ~/pki/intermediate/private/intermediate-ca.key.pem

Prüfe Zertifikat und Schlüssel vor dem Import:

openssl x509 -noout -subject -issuer -in <ZERTIFIKAT>
openssl pkey -check -in <PRIVATE-KEY>