Parcours de dépannage pratique

Votre Mac distant rencontre un problème ? Identifiez d’abord la couche concernée

Vérifiez successivement l’état du nœud, les identifiants de connexion, le réseau local, les sessions actives, le disque et la file des tâches. Chaque étape indique le critère de réussite, l’action suivante et les informations à fournir, afin d’éviter les descriptions vagues comme « impossible de se connecter » ou « c’est très lent ».

Orientation du problème

Sélectionnez le symptôme le plus proche

Votre choix vous mènera directement aux étapes correspondantes. Si plusieurs problèmes surviennent, commencez par « Impossible de se connecter », puis vérifiez les performances, le build ou le disque.

Aucun symptôme sélectionné.

Vérification du bureau distant

Vérifiez les conditions de connexion en quatre étapes

Terminez chaque couche avant de passer à la suivante. Ne modifiez pas sans cesse les paramètres du client lorsque l’état du nœud est inconnu et n’essayez pas d’utiliser la même session depuis plusieurs appareils à la fois.

  1. 01

    Vérifiez l’état du nœud

    Connectez-vous à la console pour confirmer que le nœud physique associé à la commande a bien été livré et que son nom correspond aux informations de connexion utilisées. Si l’état évolue encore, conservez le libellé affiché et évitez d’envoyer plusieurs demandes de connexion successives.

    • Critère de réussite : le bon numéro de commande, le nœud et le point d’accès à la connexion sont visibles.
    • Informations à noter : recopiez le texte exact de l’état, l’heure affichée et l’identifiant du nœud.
  2. 02

    Relisez les identifiants

    Vérifiez que l’adresse de l’hôte, le nom d’utilisateur et les identifiants temporaires proviennent de la même commande, sans espaces au début ni à la fin. Si les identifiants viennent d’être mis à jour, fermez l’ancienne fenêtre de connexion avant de créer une nouvelle configuration.

    • Critère de réussite : le client n’affiche plus d’échec d’authentification ni d’erreur de format des identifiants.
    • Opération interdite : ne collez pas de mot de passe, de clé privée ou de code de récupération dans le corps du ticket.
  3. 03

    Écartez les problèmes de réseau client

    Désactivez temporairement le proxy local qui modifie le routage, puis testez le réseau actuel et un autre réseau fiable. Notez la réussite de la résolution, l’établissement de la connexion TCP et les pertes de paquets lors de sondages continus, plutôt que de conserver un seul résultat de ping.

    • Critère de réussite : les sondages restent stables et la connexion n’expire pas pendant la négociation.
    • Informations à noter : type de réseau de l’opérateur, médiane aller-retour et taux de perte de paquets.
  4. 04

    Vérifiez l’occupation de la session

    Assurez-vous qu’aucun membre de l’équipe n’utilise simultanément la même session graphique. Si l’ancien client s’est fermé de manière anormale, attendez la libération de la session puis reconnectez-vous ; recréez la configuration uniquement si les identifiants sont corrects, le réseau accessible et l’ancienne session irrécupérable.

    • Recréation appropriée : configuration client corrompue, négociation de résolution constamment en échec ou ancien enregistrement de session invalide.
    • Recréation déconseillée : nœud inaccessible, informations de commande incohérentes ou pertes de paquets persistantes sur le réseau local.
Après le rétablissement de la connexion, effectuez une nouvelle vérification : Ouvrez l’interface graphique de macOS, effectuez une déconnexion puis une reconnexion et vérifiez le clavier, la mise à l’échelle de l’affichage et le presse-papiers avant de relancer les builds ou les tâches d’inférence.
Référence des allers-retours vers les nœuds

Médiane de latence des sondes vers cinq nœuds

Les valeurs ci-dessous correspondent à la médiane des allers-retours ICMP entre une sonde à haut débit fixe et chaque nœud. Elles servent à comparer les itinéraires et ne représentent pas les performances réelles d’un réseau utilisateur donné.

Réseau de la sonde Haut débit fixe régional, sortie unique
Période de test UTC 14:00–16:00
Méthode d’échantillonnage 60 mesures par itinéraire, médiane
Unité RTT en millisecondes
Médiane de latence aller-retour entre les principales régions d’accès et les nœuds de Singapour, Tokyo, Séoul, Hong Kong et de l’Ouest des États-Unis
Origine du test Singapour Japon (Tokyo) Corée du Sud (Séoul) Hong Kong Ouest des États-Unis
Singapour 8 ms 72 ms 83 ms 36 ms 171 ms
Japon (Tokyo) 70 ms 7 ms 31 ms 48 ms 104 ms
Corée du Sud (Séoul) 82 ms 32 ms 6 ms 43 ms 126 ms
Hong Kong 35 ms 47 ms 42 ms 6 ms 148 ms
Ouest des États-Unis 169 ms 103 ms 124 ms 146 ms 9 ms

Comment lire le tableau :Un bureau distant est plus sensible à un itinéraire aller-retour stable et continu. Un itinéraire à faible médiane mais avec des pertes occasionnelles peut sembler moins performant qu’un itinéraire légèrement plus lent mais stable.

Limites :La sonde ne passe ni par le Wi-Fi local de l’utilisateur, ni par un proxy, ni par la sortie d’entreprise. L’interconnexion des opérateurs, la congestion selon l’horaire, les interférences sans fil et la charge du client peuvent modifier les résultats ; ce tableau ne constitue pas une garantie de performance.

Optimisation des tâches

Analysez le réseau, le stockage et la file selon la charge de travail

Déterminez d’abord si le goulot d’étranglement concerne l’interaction, le CPU, la mémoire, le disque ou l’attente en file. Ne confondez pas directement un affichage distant saccadé avec un manque de puissance de calcul du nœud.

Bureau distant

Interface graphique interactive

Réseau
Mesurez en continu la médiane aller-retour, la gigue et les pertes de paquets ; privilégiez une connexion filaire stable.
Affichage
Réduisez d’abord la résolution et la qualité des couleurs, puis vérifiez si la latence des entrées diminue également.
Session
Fermez les clients en double et vérifiez qu’aucune session graphique ne se partage les ressources d’encodage.
Xcode

Compilation, tests et archivage

Environnement
Notez la version de Xcode, l’identifiant du commit, la commande de build et l’étape complète de l’échec.
Stockage
Vérifiez l’espace disponible dans l’espace de travail, DerivedData, le dossier d’archives et les répertoires temporaires.
Journaux
Conservez la première erreur ainsi que son contexte avant et après ; ne capturez pas uniquement la dernière ligne de sortie.
CI/CD

Pipelines parallèles

File d’attente
Déterminez si l’attente se produit lors de la planification, du téléchargement des dépendances, de l’exécution des tests ou de l’envoi de l’archive.
Concurrence
Réduisez progressivement le nombre de tâches concurrentes et comparez l’évolution du débit total et de la durée de chaque tâche.
Isolation
Séparez les répertoires de travail, les chemins de cache et les journaux pour chaque dépôt afin d’éviter les écrasements entre tâches.
Inférence locale

Expérimentation avec de grands modèles

Mémoire
Notez la taille du modèle, la méthode de quantification, la longueur du contexte et le pic d’utilisation en cours d’exécution.
Disque
Vérifiez l’intégrité des fichiers du modèle et assurez-vous que les répertoires de cache et de sortie se trouvent sur le volume prévu.
File d’attente
Ne modifiez qu’une variable à la fois parmi la taille de lot, le contexte et la concurrence, puis enregistrez le résultat.
diagnostic-snapshot
sw_vers
uname -m
df -h
vm_stat
system_profiler SPHardwareDataType

Lors de l’envoi des journaux, vous pouvez joindre la version du système, l’architecture, la capacité des volumes et l’état de la mémoire. Supprimez les noms d’utilisateur, les noms sensibles dans les chemins de projet et tout identifiant d’accès avant l’envoi.

Stockage et périphériques supplémentaires

Identifiez d’abord le volume, puis traitez les problèmes de capacité ou de montage

La capacité SSD de base dépend de la configuration choisie : OAM M4 16 dispose de 256GB, OAM M4 24 de 512GB et OAM M4P 64 de 2TB. Le stockage supplémentaire ne doit pas être confondu avec le volume système de base.

Ordre d’identification

Volume système, volume supplémentaire, liaison externe

  1. Vérifiez que l’appareil est reconnu par le système

    Dans Informations système et Utilitaire de disque, vérifiez le nom de l’appareil, le type de connexion, la capacité totale et l’état des partitions. Si l’appareil n’apparaît pas du tout, notez la topologie de connexion et cessez les réinitialisations répétées.

  2. Vérifiez que le volume est monté

    Si l’appareil existe mais que le volume est invisible, notez le système de fichiers, le nom du volume, le point de montage et l’erreur affichée par Utilitaire de disque. N’effacez pas et ne repartitionnez pas un volume dont l’usage n’est pas établi.

  3. Vérifiez l’emplacement d’écriture

    Vérifiez sur quel volume sont réellement écrits le projet, le modèle, le cache de build et le répertoire d’exportation. Le manque d’espace vient souvent du cache resté sur le volume système alors que le volume supplémentaire n’est pas utilisé pour le répertoire de travail.

  4. Rassemblez un instantané du problème

    Joignez la liste des appareils, la capacité des volumes, l’état du montage, la première apparition du problème, la dernière opération normale et les journaux associés, en précisant si la tâche ou le client a été redémarré.

SSD supplémentaire

+1TB SSD et +2TB SSD

Le SSD supplémentaire étend l’espace destiné aux données de travail, aux caches de build, aux fichiers de modèles ou aux médias. Après identification, définissez clairement le point de montage et les droits du répertoire avant de migrer les données.

  • Ne présentez pas la capacité supplémentaire comme la capacité de stockage de base du modèle.
  • Arrêtez les tâches de build ou d’inférence qui écrivent encore avant toute migration.
  • Les informations du problème doivent inclure la capacité de l’appareil, le nom du volume et le chemin de montage.
Interconnexion haut débit

Thunderbolt 5 en parallèle

Vérifiez chaque appareil dans l’ordre des connexions physiques, puis contrôlez la liaison et l’arborescence des appareils dans Informations système. Si plusieurs appareils posent problème, testez chaque connexion séparément pour isoler la cause.

  • Notez le nombre d’appareils en parallèle, l’ordre des connexions et l’emplacement de l’appareil défaillant.
  • Indiquez si l’appareil disparaît par intermittence, passe en lecture seule ou échoue lors du montage.
  • Ne débranchez et ne rebranchez pas à répétition un appareil en cours d’écriture sans vérification préalable.
Bonnes pratiques de sécurité

Le corps du ticket doit contenir des informations de diagnostic, jamais de secrets

N’envoyez pas de mot de passe, clé privée, code de récupération, jeton d’accès complet ou fichier de configuration non masqué dans un ticket, une capture d’écran, un journal ou un e-mail. L’assistance n’en a pas besoin pour commencer le diagnostic.

Vous pouvez fournir

Numéro de commande, nœud, message d’erreur exact, journaux masqués, étapes de reproduction, heure, version du client et résumé des tests réseau.

À supprimer impérativement

Secrets d’identité autres que le nom d’utilisateur, en-têtes d’autorisation, contenu des clés privées, codes de récupération, variables d’environnement complètes et chemins sensibles visibles sur les captures.

Si des informations sensibles sont nécessaires

Ouvrez d’abord un ticket sans secrets. Ne fournissez les éléments nécessaires qu’après réception d’une procédure contrôlée de la part de l’assistance, et uniquement dans le périmètre indiqué.

Préparer un ticket

Fournissez en une seule fois les informations nécessaires au diagnostic

Des informations complètes ne signifient pas qu’il faut tout envoyer. L’objectif est de permettre à l’assistance d’identifier l’objet concerné, d’établir une chronologie, de reproduire le problème et d’en évaluer l’impact.

01

Numéro de commande et nœud

Indiquez le numéro de commande, le modèle et le nœud affichés dans la console. Ne mentionnez pas uniquement le surnom de l’appareil.

02

Heure du problème

Indiquez le fuseau horaire, la première occurrence, la dernière reproduction et si le problème persiste.

03

Étapes de reproduction

Décrivez progressivement les actions à partir d’un état normal et indiquez à quelle étape le résultat attendu n’a pas été obtenu.

04

Erreurs et journaux

Collez le message d’erreur exact avec son contexte avant et après, en précisant s’il provient du client, de l’outil de build ou du système.

05

Captures et étendue de l’impact

Masquez les informations sensibles avant toute capture et précisez si l’impact concerne une seule tâche, un utilisateur ou toute l’équipe.

06

Vérifications déjà effectuées

Listez les tests réseau, client, reconnexion, capacité et file d’attente déjà réalisés afin d’éviter de répéter le diagnostic.

Comment rédiger le résumé d’un ticket « impossible de se connecter »

Utilisez comme titre « nœud + client + étape de connexion », puis indiquez dans le corps le numéro de commande, le nœud, l’heure, le système client, le message d’erreur exact, les résultats des tests réseau, la présence éventuelle d’une session active et les étapes de reconnexion déjà effectuées.

Quelles données fournir en cas de latence ou de build ralenti ?

Pour un problème de bureau distant, fournissez la médiane aller-retour, la gigue, les pertes de paquets, la résolution et le type de réseau client ; pour un problème de build, fournissez la commande, l’identifiant du commit, les heures de début et de fin, la première erreur, l’espace disque disponible et le nombre de tâches concurrentes.

Où envoyer un problème de commande ou de compte ?

Ouvrir un ticket depuis la console permet de l’associer à l’historique de la commande. Si vous ne pouvez pas vous connecter, écrivez à support@ownamac.com avec votre adresse e-mail professionnelle, l’identifiant de commande et un résumé du problème ; n’envoyez ni mot de passe ni code de récupération.

Prêt à envoyer

Regroupez le nœud, la chronologie et les étapes de reproduction dans un même ticket

Pour un incident en cours, ouvrez en priorité un ticket depuis la console afin d’associer la commande et le nœud. Si vous ne pouvez pas vous connecter, utilisez support@ownamac.com et envoyez uniquement des informations masquées.