Chapitre 19

Dépannage

Solutions aux problèmes courants, et emplacement où Manta consigne les erreurs. Si vous signalez un bug, le fichier journal est d’une grande aide.

Le fichier journal¶

Manta consigne les erreurs et les événements importants dans :

~/Library/Logs/Manta/manta.log

Pour le trouver :

1. Choisissez Aide → Afficher le fichier journal dans le Finder dans la barre des menus – ou ouvrez la palette de commandes avec ⇧⌘P et choisissez-y Afficher le fichier journal dans le Finder.
2. Le Finder ouvre le dossier des journaux (~/Library/Logs/Manta) avec le fichier manta.log – dans le Finder lui-même, même si Manta est votre gestionnaire de fichiers par défaut.

Chaque message d’erreur que Manta vous affiche y figure, avec l’erreur technique, le chemin et l’emplacement (local, serveur…). Le fichier est renouvelé à 5 Mo ; une copie plus ancienne est conservée.

Les plug-ins ont leurs propres journaux : Réglages → Plug-ins → Afficher le journal sur la carte du plug-in.

Signaler un bug¶

Vous avez trouvé un bug ? Signalez-le sur GitHub – le plus simple est Aide → Signaler un problème… (également dans la palette de commandes – tapez « bug » – et dans Réglages → Général → À propos de Manta → Commentaires). Manta ouvre le formulaire de rapport de bug dans votre navigateur, avec la version de Manta, la version de macOS et la puce (Apple silicon ou Intel) déjà renseignées. Manta lui-même n’envoie rien : vous voyez le formulaire et décidez de ce que vous envoyez. Il vous faut un compte GitHub gratuit.

Ce qui aide à trouver le bug :

• Versions de Manta et de macOS – renseignées par Manta ; sinon sous Manta → À propos de Manta et menu Pomme → « À propos de ce Mac ».
• Étapes pour reproduire – qu’avez-vous fait, étape par étape ?
• Comportement attendu et constaté – que devait-il se passer, et que s’est-il passé à la place ? Le message d’erreur exact aide.
• Une capture d’écran (⇧⌘4) ou un court enregistrement d’écran (⇧⌘5).
• Les lignes pertinentes du fichier journal ~/Library/Logs/Manta/manta.log – ouvrez-le avec Aide → Afficher le fichier journal dans le Finder, voir Le fichier journal.

Une idée ou une suggestion ? Aide → Suggérer une idée… ouvre le formulaire des idées. Toutes les options se trouvent aussi sur github.com/web-workers-com/manta/issues/new/choose.

Si Manta quitte de façon inattendue¶

Si Manta plante, il enregistre un rapport de plantage dans ~/Library/Logs/Manta : un fichier dont le nom commence par crash-, suivi de la date et de l’heure (UTC). Le rapport ne contient que ce qui est nécessaire pour trouver le bug : la version de Manta et de macOS, la puce, le message d’erreur et les adresses du programme au moment du plantage (le « backtrace »). Votre dossier de départ apparaît sous la forme ~, et les noms d’utilisateur, de serveur et d’hôte sont remplacés par des marqueurs comme <user> et <redacted>.

Au prochain lancement, Manta affiche une seule fois un avis en bas à droite : Manta a quitté de façon inattendue la dernière fois.

• Signaler sur GitHub ouvre le formulaire de rapport de bug avec les versions et un court résumé du rapport déjà remplis. Joignez le fichier du rapport au formulaire (faites-le glisser dans le champ de texte) : un lien ne peut pas transporter de fichier. Rien n’est envoyé tant que vous n’envoyez pas vous-même le formulaire sur GitHub.
• Afficher le rapport ouvre le rapport dans votre éditeur de texte, pour que vous voyiez exactement ce qu’il contient.
• Ignorer ferme l’avis. Le rapport reste dans le dossier ; Manta conserve les 10 plus récents.

Manta ne s’ouvre pas (Gatekeeper)¶

Problème : au premier lancement, macOS affiche « Élément « Manta » non ouvert » (« Apple n’a pas pu confirmer que « Manta » ne contenait pas de logiciel malveillant… ») ou, sur les anciennes versions de macOS, « … ne peut pas être ouvert, car Apple ne peut pas vérifier qu’il ne contient pas de logiciel malveillant ».

Cause : Manta n’est pas notarié par Apple. macOS bloque ces apps au premier lancement.

Solution :

1. Cliquez sur Terminé dans le message (et non sur Placer dans la corbeille).
2. Ouvrez Réglages Système → Confidentialité et sécurité et faites défiler jusqu’à la section Sécurité.
3. Cliquez sur Ouvrir quand même à côté de « « Manta » a été bloqué… », de nouveau sur Ouvrir quand même quand macOS le demande, puis confirmez avec votre mot de passe ou Touch ID.

S’il n’y a pas de bouton Ouvrir quand même, relancez Manta et regardez juste après : le bouton ne reste qu’environ une heure. Toutes les étapes en images, et la méthode par Terminal, se trouvent dans Le premier lancement : Gatekeeper.

Avant macOS 15 : clic droit (ou Contrôle-clic) sur Manta dans le dossier Applications → Ouvrir → Ouvrir.

« macOS a bloqué l’accès »¶

Problème : un dossier ne s’ouvre pas, ou Manta indique « macOS a bloqué l’accès à « … » (opération non autorisée) ».

Cause : vous n’avez pas autorisé Manta à accéder à ce dossier (ou vous avez cliqué sur « Refuser » par erreur), ou le dossier nécessite l’Accès complet au disque.

Solution :

1. Ouvrez Réglages Système → Confidentialité et sécurité → Fichiers et dossiers.
2. Trouvez Manta et activez le dossier (Bureau, Documents, Téléchargements, volumes amovibles, volumes réseau).
3. Pour des dossiers comme ~/Library/Mail : Accès complet au disque → activez Manta.
4. Quittez Manta et relancez-le.

Si Manta ne figure pas dans la liste, macOS n’a pas encore posé la question. Ouvrez une fois le dossier dans Manta et la question apparaît.

« Vous n’avez pas l’autorisation d’ouvrir ce dossier » est un autre problème : les autorisations Unix habituelles manquent. Demandez au propriétaire du dossier ou modifiez les autorisations dans le Finder (Lire les informations).

Fonctions qui pilotent le Finder ou Terminal¶

Problème : « Afficher dans le Finder », « Ouvrir dans Terminal.app » ou le placement des doublons dans la corbeille ne fonctionne pas.

Solution : Réglages Système → Confidentialité et sécurité → Automatisation → sous Manta, activez Finder et Terminal.

FTP : les dossiers ne se chargent pas, erreurs « TLS »¶

Problème : la connexion à un serveur FTPS fonctionne, mais les dossiers restent vides ou se chargent indéfiniment, ou Manta indique « le réseau bloque les connexions de données FTP chiffrées ».

Cause : certains réseaux et pare-feu d’entreprise réinitialisent les connexions de données FTP chiffrées.

Solution :

1. Clic droit sur le favori → Modifier la connexion… (ou ⌘K pour une nouvelle connexion).
2. Réglez Canal de données sur Automatique.
3. Reconnectez-vous.

Manta transmet alors les listes et les fichiers sans chiffrement ; la connexion reste chiffrée. Un bouclier d’avertissement sur la pastille d’emplacement l’indique.

Autres conseils pour FTP :

• « Impossible d’établir une connexion sécurisée » : le serveur ne prend pas en charge FTPS sur ce port (essayez FTP si c’est acceptable sur votre réseau), ou son certificat n’est pas approuvé.
• Manta ne prend pas en charge le FTPS implicite (port 990).

Un conteneur sans shell¶

Problème : un conteneur s’ouvre en lecture seule, ou Manta indique « Le conteneur n’a pas de shell ».

Cause : Manta a besoin de sh dans le conteneur pour lister et modifier les fichiers. Les images distroless et scratch n’ont pas de shell.

Solution :

• La lecture et la copie vers l’extérieur (F5, glisser-déposer) fonctionnent toujours – via docker cp.
• Pour apporter des modifications, il vous faut une image avec un shell (une variante de débogage de l’image, par exemple).
• Les pods Kubernetes ont besoin de sh, même pour la lecture.
• Les conteneurs arrêtés sont aussi en lecture seule : démarrez-les pour apporter des modifications.

Docker ou Kubernetes n’apparaissent pas¶

• « Docker n’est pas en cours d’exécution » : lancez Docker Desktop.
• « Docker n’est pas installé » : installez Docker Desktop, ou vérifiez que la commande docker se trouve dans votre PATH. Manta cherche aussi dans /opt/homebrew/bin, /usr/local/bin et dans l’app Docker Desktop.
• « kubectl n’est pas installé » : brew install kubectl.
• « Le cluster Kubernetes est inaccessible » : vérifiez le contexte et votre VPN, ou démarrez votre cluster local.

Connexions aux serveurs¶

Un transfert n’avance pas¶

Voir Suspendre et reprendre les transferts.

Une mise à jour échoue¶

Voir Mises à jour. Le plus souvent, Manta n’est pas exécuté depuis le dossier Applications.

Cloud : « Supprimer le téléchargement » ne fonctionne pas¶

Pour Google Drive, OneDrive, Dropbox et les autres, c’est l’app du fournisseur qui décide. Utilisez le Finder : clic droit → Supprimer le téléchargement. Voir Stockage cloud.

Un dossier affiche un contenu obsolète¶

Appuyez sur ⌘R. Manta ne voit les modifications effectuées par d’autres apps ou par le serveur qu’après une actualisation.

Réinitialiser Manta¶

En dernier recours :

1. Quittez Manta.
2. Renommez ~/Library/Application Support/Manta (en Manta ancien, par exemple).
3. Lancez Manta. Il démarre comme s’il s’agissait du premier lancement.

Vos favoris et vos actions rapides se trouvent toujours dans le dossier renommé.