Fehlerbehebung

Häufige Probleme & Lösungen#

Eine Freigabe wird nicht eingebunden#

Wenn die Anwendung versucht, eine Freigabe einzubinden, aber fehlschlägt:

  1. Netzwerkverbindung: Stelle sicher, dass du mit dem richtigen Netzwerk (oder VPN) verbunden bist und der Server erreichbar ist.
  2. Authentifizierungsprofil: Prüfe, ob das zugewiesene Authentifizierungsprofil das richtige, aktuelle Passwort enthält.
  3. Kerberos-Tickets: Wenn du ein Kerberos-Profil verwendest, öffne das macOS Terminal und gib klist ein, um sicherzustellen, dass du ein gültiges, nicht abgelaufenes Ticket-Granting Ticket (TGT) hast.
  4. NetAuthSysAgent: NetAuthSysAgent ist ein Prozess in macOS, der für das Einbinden von Netzwerkfreigaben und die Behandlung der Netzwerkautorisierung verantwortlich ist. Er kann bei Bedarf Dialoge über NetAuthAgent anzeigen. Leider gab es bei vielen Versionen von macOS ein Problem, bei dem der NetAuthSysAgent manchmal hängen bleibt. Das wird deutlich, wenn eine Mount-Anfrage nicht ausgeführt wird. In diesem Fall ist die einzige Lösung, killall NetAuthSysAgent auszuführen.

Kerberos-Freigabe in einem DFS-Namespace meldet “invalid credentials”#

Verwendet eine Kerberos-Freigabe den Domänennamen statt eines Servernamens (ein domänenbasierter DFS-Namespace wie smb://example.com/shares), kann das Einbinden mit “invalid credentials” fehlschlagen, obwohl das Kerberos-Ticket gültig ist. macOS fordert dann ein Ticket für den Domänennamen selbst an (cifs/example.com), das Active Directory meist nicht kennt. Das kannst du im Terminal prüfen: kgetcred cifs/example.com@EXAMPLE.COM meldet den Server als unbekannt.
Lösung (ab macOS 26.5, Macs ohne Active-Directory-Bindung): Lass macOS den DFS-Namespace über die Domain Controller auflösen. Lege die Datei ~/Library/Preferences/nsmb.conf mit folgendem Inhalt an und starte den Mac neu:

[default]
srv_lookup_enabled=yes

Administratoren können diese Einstellung für alle Benutzer als /etc/nsmb.conf verteilen (siehe IT-Administrator-Handbuch (MDM)).

Fehler bei doppeltem Namen#

Wenn du beim Hinzufügen einer Freigabe einen Fehler wegen eines doppelten Namens erhältst, verwendet bereits eine andere Freigabe diesen Ordnernamen in ~/Networkshares/. Lösung: Nutze die Funktion für benutzerdefinierte Namen der Version 4, um der neuen Freigabe einen eindeutigen lokalen Namen zuzuweisen.

Status “Profilzuweisung erforderlich”#

Wenn eine Freigabe diesen Status in der Benutzeroberfläche anzeigt, bedeutet dies, dass die Anmeldedaten fehlen. Lösung:

  1. Öffne Preferences (Einstellungen) → Network Shares (Netzwerkfreigaben).
  2. Wähle die betroffene Freigabe aus und klicke auf Bearbeiten.
  3. Weise manuell ein Authentifizierungsprofil aus dem Dropdown-Menü zu.
  4. Klicke auf Save Changes (Änderungen speichern).

Erweitertes Debugging#

Für tiefgreifende IT-Fehlerbehebung protokolliert Network Share Mounter seine Aktivitäten nativ in das einheitliche Protokollsystem von macOS. Öffne die App Console.app und filtere nach dem Prozess NetworkShareMounter, um Echtzeit-Verbindungsprotokolle und Fehlerzustände anzuzeigen:
log stream --predicate "subsystem == 'de.fau.rrze.NetworkShareMounter'" --level debug

Du kannst nun Protokolle direkt aus der Anwendung zur Fehlerbehebung an die Entwickler senden:

  1. Öffne die Settings (Einstellungen) und wähle links General (Allgemein).
  2. Klicke 5 Mal hintereinander auf Diagnostics (Diagnose).
  3. Es erscheint ein neuer Button, mit dem du Diagnose- oder Protokolldateien an die Entwickler des Network Share Mounters senden kannst.

Logs von macOS-Komponenten wie dem SMB-Client können nur mit Administratorrechten mitgesendet werden. Ohne diese Rechte werden nur die Logs von Network Share Mounter selbst gesendet.