Risoluzione dei Problemi

Problemi Comuni e Soluzioni#

Una Condivisione Non si Monta#

Se l’applicazione tenta di montare una condivisione ma fallisce:

  1. Connettività di Rete: Assicurati di essere connesso alla rete corretta (o VPN) e che il server sia raggiungibile.
  2. Profilo di Autenticazione: Verifica che il Profilo di Autenticazione assegnato contenga la password corretta e aggiornata.
  3. Ticket Kerberos: Se usi un profilo Kerberos, apri il Terminale di macOS e digita klist per assicurarti di avere un Ticket-Granting Ticket (TGT) valido e non scaduto.
  4. NetAuthSysAgent: NetAuthSysAgent è un processo in macOS responsabile del montaggio delle condivisioni di rete e della gestione dell’autorizzazione di rete. Quando necessario, può mostrare finestre di dialogo utilizzando NetAuthAgent. Sfortunatamente, per molte versioni di macOS c’è stato un problema in cui NetAuthSysAgent a volte si blocca. Questo è evidente quando una richiesta di montaggio non viene eseguita. In questo caso, l’unica soluzione è eseguire killall NetAuthSysAgent.

Una condivisione Kerberos in un namespace DFS segnala “invalid credentials”#

Se una condivisione Kerberos usa il nome di dominio invece del nome di un server (un namespace DFS basato sul dominio come smb://example.com/shares), il montaggio può non riuscire con “invalid credentials” anche se il ticket Kerberos è valido. macOS richiede infatti un ticket per il nome di dominio stesso (cifs/example.com), che Active Directory di solito non conosce. Puoi verificarlo nel Terminale: kgetcred cifs/example.com@EXAMPLE.COM segnala il server come sconosciuto.
Soluzione (macOS 26.5 o successivo, Mac non collegati ad Active Directory): Lascia che macOS risolva il namespace DFS tramite i domain controller. Crea il file ~/Library/Preferences/nsmb.conf con il seguente contenuto e riavvia il Mac:

[default]
srv_lookup_enabled=yes

Gli amministratori possono distribuire questa impostazione a tutti gli utenti come /etc/nsmb.conf (vedi Guida per l’amministratore IT (MDM)).

Errore di Nome Duplicato#

Se ricevi un errore di nome duplicato quando aggiungi una condivisione, significa che un’altra condivisione sta già utilizzando quel nome di cartella in ~/Networkshares/. Soluzione: Usa la funzione per i nomi personalizzati della Versione 4 per assegnare un nome locale univoco alla nuova condivisione.

Stato “Assegnazione Profilo Richiesta”#

Se una condivisione mostra questo stato nell’interfaccia utente, significa che le mancano le credenziali. Soluzione:

  1. Apri Preferences (Preferenze) → Network Shares (Condivisioni di Rete).
  2. Seleziona la condivisione interessata e clicca su modifica.
  3. Assegna manualmente un Profilo di Autenticazione dal menu a tendina.
  4. Clicca su Save Changes (Salva Modifiche).

Debugging Avanzato#

Per un’analisi approfondita dei problemi IT, Network Share Mounter registra la sua attività in modo nativo nel sistema di logging unificato di macOS. Apri l’app Console.app e filtra per il processo NetworkShareMounter per visualizzare i log di connessione in tempo reale e gli stati di errore:
log stream --predicate "subsystem == 'de.fau.rrze.NetworkShareMounter'" --level debug

Ora puoi inviare i log direttamente dall’applicazione agli sviluppatori per la risoluzione dei problemi:

  1. Apri le Settings (Impostazioni) e seleziona General (Generale) a sinistra.
  2. Clicca su Diagnostics (Diagnostica) 5 volte di seguito.
  3. Apparirà un nuovo pulsante che ti permetterà di inviare file diagnostici o log agli sviluppatori del Network Share Mounter.

I log dei componenti di macOS, come il client SMB, possono essere inclusi solo con diritti di amministratore. Senza questi diritti vengono inviati solo i log di Network Share Mounter stesso.