Fehlerbehebung

6. Fehlerbehebung#

Dieses Kapitel beschreibt, wo der Connector protokolliert, was er tut, und was Sie bei den häufigsten Problemen tun können.

6.1. Logdatei#

Der Connector schreibt in /var/log/univention/asm.log. Die Datei enthält das Log jedes Laufs auf Debug-Level, einschließlich der Lehrer, die ein LDAP-Filter aus einer Klasse ausgeschlossen hat. Die App-Einstellungen zeigen den Zeitpunkt des letzten Uploads in asm/last_upload. asm/last_upload/ACCOUNT enthält den Zeitpunkt des letzten Uploads in jedes Konto.

Die Logrotation richtet sich nach den UCR-Variablen logrotate/* des Systems. Der Connector schreibt seine eigene Konfiguration nach /etc/logrotate.d/asm.

Quellcode 6.1 Synchronisationslauf verfolgen#
$ tail -f /var/log/univention/asm.log

6.2. Aussagekräftigere Fehlermeldungen von Apple School Manager erhalten#

Apple School Manager meldet Fehler in den hochgeladenen Daten nur spärlich. Die Seite, die die SFTP-Zugangsdaten anzeigt, gibt genauer an, welche Daten Apple School Manager ablehnt. Der SFTP-Upload kann dabei verbunden bleiben.

  1. Öffnen Sie die Seite mit den SFTP-Zugangsdaten, wie in SFTP-Zugangsdaten ermitteln beschrieben.

  2. Lassen Sie die Seite geöffnet und starten Sie einen Synchronisationslauf, wie in Synchronisation ausführen beschrieben.

Die Seite zeigt die Fehler jedes Uploads an, während der Upload läuft.

6.3. Benutzer erscheinen nicht in Apple School Manager#

Prüfen Sie Folgendes in dieser Reihenfolge:

  1. Der Benutzer hat keine primäre E-Mail-Adresse. Der Connector exportiert den Benutzer ohne E-Mail-Adresse, und Apple School Manager kann für den Benutzer keinen Apple Account anlegen.

  2. Die Anonymisierung hat die E-Mail-Adresse entfernt. Die Anonymisierung ist standardmäßig aktiviert. Ist student.anonymize oder staff.anonymize für das Konto aktiviert, exportiert der Connector statt der Adresse den Ersatzwert, der standardmäßig leer ist. Siehe Anonymisierung.

    Quellcode 6.2 Anonymisierung in /etc/asm-connections.json ausschalten#
    "defaults": {
    "student": {"anonymize": false},
    "staff": {"anonymize": false}
}

  3. Die Schule steht nicht auf der Liste. Der Connector exportiert nur Schulen, die der Abschnitt schools der Einstellungsdatei aufführt, und nur in das Konto, auf das die Schule verweist. Siehe Schulen.

  4. Ein LDAP-Filter schließt den Benutzer aus. Die Logdatei nennt keine Benutzer, die ein Filter ausgeschlossen hat. Führen Sie den Filter mit univention-ldapsearch aus, um zu prüfen, welche Benutzer er auswählt. Siehe Benutzer mit einem LDAP-Filter auswählen.

6.4. Apple School Manager lehnt einen Upload ohne Schüler ab#

Apple School Manager lehnt einen Upload ab, der keinen Schüler enthält, und zeigt einen Fehler an. Jedes Konto braucht mindestens einen Schüler in seinem Upload.

Ein Upload enthält in den folgenden Fällen keine Schüler:

Um den Fehler zu sehen, folgen Sie Aussagekräftigere Fehlermeldungen von Apple School Manager erhalten.

6.5. Der Lauf bricht mit einem Fehler bei den Zugangsdaten ab#

Der Connector bricht ab, bevor er Daten sammelt, wenn /etc/asm-connections.json fehlt oder ungültig ist oder wenn eine Passwortdatei fehlt oder leer ist. Die Meldung in der Logdatei nennt die Datei und den Eintrag.

Quellcode 6.3 Meldung in der Logdatei#
No Apple School Manager account configured. Create /etc/asm-connections.json as described in the Apple School Manager Connector manual.

Konfigurieren Sie die Konten, wie in Konten in Apple School Manager beschrieben. Wenn die Zugangsdaten gesetzt sind, Apple sie aber ablehnt, erzeugen Sie in Apple School Manager neue Zugangsdaten und tragen Sie diese ein.

6.6. Der Upload bricht mit einem fehlenden Host-Schlüssel ab#

Der Connector prüft den Host-Schlüssel des SFTP-Servers gegen /etc/asm_public_key. Das Paket liefert diese Datei mit. Fehlt sie oder passt sie nicht mehr zum Server, schlägt der Upload mit Could not find /etc/asm_public_key oder mit einem SSH-Fehler fehl.

Installieren Sie das Paket erneut, um die Datei wiederherzustellen. Wenn Apple den Host-Schlüssel geändert hat, melden Sie dies Univention, siehe Hilfe erhalten, damit eine neue Version der App den neuen Schlüssel mitliefern kann.

6.7. Der Upload in ein Konto bricht mit einem ungültigen LDAP-Filter ab#

Ein LDAP-Filter mit einem Syntaxfehler bricht den Upload in das Konto dieser Schule ab. Der Connector lädt trotzdem in die übrigen Konten hoch und endet am Schluss mit einem Exit-Status ungleich null. Die Logdatei nennt den Filter und das Konto.

Quellcode 6.4 Meldungen in der Logdatei#
Invalid LDAP-filter for students: '(ucsschoolRole=student'
Invalid LDAP filter, nothing uploaded to account north.

Korrigieren Sie den Filter in der Einstellungsdatei oder entfernen Sie den Schlüssel ldap_filter der Schule, damit der Filter aus defaults greift. Siehe Benutzer mit einem LDAP-Filter auswählen.

6.8. Klassen haben weniger Lehrer als erwartet#

Apple School Manager unterstützt höchstens 15 Lehrer pro Klasse. Der Connector exportiert die ersten 15 und schreibt eine Warnung mit dem Namen der Klasse in die Logdatei. Das ist eine Einschränkung von Apple School Manager, nicht des Connectors.

Auch ein LDAP-Filter für Lehrer kann die Anzahl verringern. Die Logdatei verzeichnet jeden Lehrer, den ein Filter aus einer Klasse ausgeschlossen hat.

6.9. Die Föderation für eine Domain schlägt beim zweiten Mal fehl#

Wenn Sie die Föderation für eine Domain deaktivieren und anschließend wieder aktivieren, zeigt Apple School Manager einen Fehler an.

Solange die Föderation aktiv ist, bietet Apple School Manager an, die Domain zu trennen, statt sie zu entfernen. Das Trennen nimmt die Domain nur aus der Föderation heraus. Die Domain selbst bleibt in Apple School Manager erhalten.

Um die Föderation für die Domain wieder zu aktivieren, gehen Sie wie folgt vor:

  1. Trennen Sie in Apple School Manager die Verbindung zum Identity Provider.

  2. Verbinden Sie ihn erneut, wie in Identity Provider verbinden beschrieben.

  3. Aktivieren Sie die Föderation für die Domain, wie in Föderation für die Domain aktivieren beschrieben.

6.10. Hilfe erhalten#

  • Das Forum Univention Help für Fragen aus der Community.

  • Ihr Univention-Supportvertrag für eine unterstützte Umgebung.

Wenn Sie ein Problem melden, hängen Sie den relevanten Ausschnitt aus /var/log/univention/asm.log an.

Auf dieser Seite