Base de connaissances

Ce guide explique comment résoudre certaines erreurs Lite Sync macOS pouvant survenir avec l'app desktop kDrive (application de bureau sur macOS).

Blocage de synchronisation 1/10

Vérifiez si les autorisations macOS sont bien activées pour kDrive et les extensions Lite Sync:

1. Ouvrez les paramètres macOS.
2. Sous Général, cliquez sur Ouverture et extensions.
3. Descendez jusqu'à l'indication Endpoint Security Extensions :: kDrive LiteSync Extension:
   
4. Vérifiez que les autorisations sont activées et validez en bas:
   

Profitez-en pour faire le tour des autres éléments concernant kDrive afin de vérifier que tout soit bien activé.

Erreur de type "Unable to start Lite Sync plugin"

Afin de corriger une erreur de type "Unable to start Lite Sync plugin" qui survient généralement lorsque l'extension Lite Sync a disparu ou n'a pas les autorisations nécessaires…

… vérifier la présence de l'extension

Depuis une application de type Terminal (interface en ligne de commande, CLI /Command Line Interface) sur un appareil macOS :

% systemextensionsctl list

Le résultat s'apparente à:

1 extension(s)
--- com.apple.system_extension.endpoint_security
enabled active teamID bundleID (version) name [state]
* * 864VDCS2QY com.infomaniak.drive.desktopclient.LiteSyncExt (3.5.0/1) kDrive LiteSync Extension [activated enabled]

Si le résultat de la commande ne mentionne pas "kDrive LiteSync Extension", l'extension n'est pas présente:

• Supprimez la synchronisation et l'ajouter à nouveau.

Si le résultat de la commande n'a pas le statut [activated enabled]:

• Autorisez l'extension dans les Réglages Système / Confidentialité et Sécurité.

… vérifier les permissions de l'extension

Dans les Réglages Système / Confidentialité et Sécurité / Accès complet au disque de l'appareil macOS:

Accordez l'accès complet à kDrive ainsi qu'aux extensions Lite Sync:

… vérifier le fonctionnement de l'extension

Depuis un Terminal:

% ps -ef | grep LiteSyncExt

Le résultat s'apparente à:

0  7434     1   0  1:02   ??         0:25.42 /Library/SystemExtensions/6035BDE4-B7D6-477E-A6AB-C2281E3C7752/com.infomaniak.drive.desktopclient.LiteSyncExt.systemextension/Contents/MacOS/com.infomaniak.drive.desktopclient.LiteSyncExt

Si l'extension ne semble pas être en fonction, tentez les actions suivantes:

• Redémarrer l'app.
• Rebooter le Mac.
• Supprimer / ajouter la synchro.
• Désinstaller / réinstaller l'app.

Si ce n'est toujours pas OK

• Demandez les logs kDrive (niveau Debug):
  
• Vérifiez dans la Console s'il y a un rapport de blocage à la date du dernier démarrage de l'app et si oui, envoyez-les à Infomaniak:
  

Récupérez les messages kDrive dans la Console:

• Quittez l'app.
• Dans la Console, sélectionnez le Mac, filtrez sur[KD], cliquez sur Démarrer:
  
• Lancez l'app.
• Cliquez dans la liste des messages, sélectionnez-les (Ctrl+A), les copier (Ctrl+C) et envoyez-les à Infomaniak.

Ce guide explique comment résoudre les erreurs liées à l'extension Lite Sync Windows sur l'application de bureau kDrive.

Vérifier la présence de l'extension

Avant toute manipulation, assurez-vous que l'extension est bien enregistrée par le système :

1. Ouvrez les Paramètres de Windows.
2. Accédez à la rubrique Applications, puis Applications installées.
3. Dans la barre de recherche, tapez "kDrive".
4. Vérifiez que l'élément kDrive Windows Explorer Extension Package apparaît bien dans la liste:
   

Erreur de type "Unable to start Lite Sync"

Cette erreur survient généralement lorsque l'extension de l'Explorateur Windows est manquante ou corrompue.

Réinstallation manuelle de l'extension

Si l'extension n'apparaît pas ou ne fonctionne pas, vous pouvez l'installer manuellement sans réinstaller tout kDrive :

1. Fermez complètement l'application kDrive (vérifiez qu'elle ne soit plus en zone de notification).
2. Ouvrez votre explorateur de fichiers et rendez-vous dans le dossier :
   C:\Programs\kDrive\shellext\AppX\
3. Double-cliquez sur le fichier : 
   FileExplorerExtensionPackage_3.8.1.0_x64_arm64.msixbundle
4. Un assistant d'installation spécifique à l'extension va s'ouvrir. Suivez les étapes.
5. Redémarrez votre ordinateur pour valider l'intégration.

Si le problème persiste

Si malgré l'installation manuelle l'option LiteSync reste indisponible :

• Antivirus : Vérifiez que votre logiciel de sécurité ne bloque pas les processus situés dans C:\Programs\kDrive\.
• Conflits : Certains autres services cloud (comme OneDrive) peuvent parfois entrer en conflit avec les extensions d'icônes de kDrive.
• Logs : Si nécessaire, transmettez les logs kDrive (en mode Debug) au support Infomaniak.

Ce guide détaille l'option Lite Sync de l'app desktop kDrive (application de bureau sur macOS). L'option Lite Sync existe aussi sur Windows.

Préambule

• La fonctionnalité Lite Sync économise de l'espace en stockant virtuellement vos fichiers kDrive sur votre ordinateur, ne les téléchargeant que lorsque nécessaire.
  • Les fichiers sont toujours accessibles depuis l'app Web kDrive (service en ligne ksuite.infomaniak.com/kdrive) mais localement ils sont présents de façon "déshydratée", nécessitant un temps de chargement pour être pleinement accessibles.
  • Cela permet de visualiser, compléter et synchroniser le contenu de kDrive sans saturer le disque dur.
• L'option Lite Sync agit toujours:
  • sur un kDrive spécifique (dans le cas où vous en synchronisez plusieurs sur l'application).
  • et sur l'entièreté du kDrive (ou l'entièreté d'une synchronisation avancée).
  • et via une app kDrive spécifique (un autre utilisateur du même kDrive peut effectuer un choix Lite Sync différent du vôtre).
• En cas de problème, prenez connaissance de cet autre guide à ce sujet.

Activer l'option Lite Sync

Prérequis & périmètre d'utilisation de Lite Sync

• OS macOS version ≥ 10.15 — non disponible avec Linux
• Système de stockage de fichier sous NTFS / APFS (FAT32 exclu)

L'option Lite Sync peut être activée lors de l'installation de l'application (cela vous est proposé) ou par la suite:

1. Faites un clic gauche sur l'icône de l'app dans la zone de notification de votre ordinateur (en haut à droite sur macOS).
2. Cliquez sur le menu d'action ⋮ à droite de la fenêtre kDrive.
3. Sélectionnez Paramètres du kDrive:
   
4. Cliquez sur le menu d'action ⋮ à droite de la synchronisation en cours et du symbole nuage:
   1. Si le nuage est barré, vous pouvez activer Lite Sync car celle-ci n'était pas encore active:
      
   2. Au même endroit vous pouvez désactiver Lite Sync si le nuage n'était pas barré (lire également en fin de ce guide):
      

Actions sur les données synchronisées sur le disque

Toujours conserver sur cet appareil

Une fois la Lite Sync activée (et donc les données sur le disque devenues “virtuelles”), il vous est possible de malgré tout rendre disponible localement un dossier et ses sous-dossiers ou uniquement un ou plusieurs fichiers:

1. Depuis le Finder macOS, placez-vous sur un dossier synchronisé avec kDrive et faites un clic droit.
2. Sélectionnez l’option Rendre toujours disponible localement sous kDrive:
   
3. Le symbole visible sur l'icône des fichiers concernés va changer pour indiquer que le fichier n'est plus "dans le nuage" mais bien présent entièrement sur votre disque:
   

Libérer de l'espace

A l'inverse, une fois la Lite Sync activée, il vous est possible de libérer de l'espace, fichier par fichier ou dans un dossier et ses sous-dossiers.

1. Depuis le Finder macOS, placez-vous sur un dossier synchronisé avec kDrive et faites un clic droit.
2. Sélectionnez l’option libérer de l'espace local sous kDrive:
   
3. Le symbole visible sur l'icône des fichiers/dossiers concernés va changer pour indiquer que les données sont “dans le nuage” et non plus présentes entièrement sur votre disque:
   
   • L'action Libérer de l'espace aura pour effet de libérer de l'espace de stockage sur votre ordinateur.
   • Les fichiers resteront visibles mais ne seront plus accessibles sans connexion internet.

Exemple d'utilisation (espace de stockage nécessaire)

Si vous activez Lite Sync, l'espace occupé (900 Go par exemple) côté serveur Infomaniak sera libéré sur votre disque dur mais l'inverse est également vrai (par exemple 900 Go libre requis sur votre disque dur en cas d'activation de l'option Lite Sync en cours de route).

"Déshydratation" de fichiers

Comme expliqué en préambule, un fichier déshydraté est un fichier kDrive dont la version complète n'est pas présente sur le disque dur et en lieu et place c'est un "raccourci" de 1 Ko qui s'affiche, comportement normal quand Lite Sync est activée.

Dans certains cas (par exemple si vous copiez les fichiers de votre disque dur alors que Lite Sync est activée, et que vous recommencez une synchronisation vers un nouveau kDrive) l'application bloquera l'importation de ce type de fichier. Pour résoudre ces erreurs vous pouvez télécharger le fichier complet depuis l'app Web kDrive (service en ligne ksuite.infomaniak.com/kdrive).

Voici les icônes de statut qui sont utilisées et leurs explications:

Icônes de statut	Description
= en ligne	Sur un fichier cela signifie qu'il est uniquement sur le kDrive “dans le nuage” ; pour le consulter en local il faudra le télécharger. Sur un dossier cela signifie qu'il contient au moins un fichier ou sous-dossier présent sur le kDrive “dans le nuage”.
= toujours disponible	Sur un fichier cela signifie qu'il est toujours disponible complètement en local (et synchronisé avec la version en ligne). Sur un dossier cela signifie que le dossier ne contient que des fichiers ou sous-dossiers complètement en local (et synchronisés avec leur version en ligne).
= conflit de synchronisation	kDrive rencontre un conflit de synchronisation avec le fichier/dossier.
= erreur lors du transfert	Une erreur s'est produite pendant le transfert du fichier/dossier et celui-ci s'est interrompu.
= téléchargement en cours	Le cercle de progression indique un téléchargement en cours.

Désactiver l'option Lite Sync

Pour cela, suivez les étapes en haut de ce guide (le point 4.b notamment). Lors de la désactivation de LiteSync, deux cas de figure peuvent se produire en fonction de la place restante sur votre support de stockage de l'appareil utilisé:

1. S'il y a suffisamment d'espace sur votre ordinateur un message confirmant la désactivation s'affiche, il suffit de cliquer sur Continuer.
2. S’il n’y a pas suffisamment d’espace sur votre ordinateur, un message vous indiquera l’espace manquant pour permettre la désactivation de la Lite Sync ; la synchronisation de votre kDrive sera mise en pause le temps de sélectionner les fichiers à synchroniser sur votre ordinateur.

Ce guide détaille l'option Lite Sync de l'app desktop kDrive (application de bureau sur Windows). L'option Lite Sync existe aussi sur macOS.

Préambule

• La fonctionnalité Lite Sync économise de l'espace en stockant virtuellement vos fichiers kDrive sur votre ordinateur, ne les téléchargeant que lorsque nécessaire.
  • Les fichiers sont toujours accessibles depuis l'app Web kDrive (service en ligne ksuite.infomaniak.com/kdrive) mais localement ils sont présents de façon "déshydratée", nécessitant un temps de chargement pour être pleinement accessibles.
  • Cela permet de visualiser, compléter et synchroniser le contenu de kDrive sans saturer le disque dur.
• L'option Lite Sync agit toujours:
  • sur un kDrive spécifique (dans le cas où vous en synchronisez plusieurs sur l'application).
  • et sur l'entièreté du kDrive (ou l'entièreté d'une synchronisation avancée).
  • et via une app kDrive spécifique (un autre utilisateur du même kDrive peut effectuer un choix Lite Sync différent du vôtre).
• En cas de problème, prenez connaissance de cet autre guide à ce sujet.

Activer l'option Lite Sync

Prérequis & périmètre d'utilisation de Lite Sync

• OS Windows version ≥ 10 (21H2) — non disponible avec Linux
• Processeur 64 bits (compatible ARM64)
• Système de stockage de fichier sous NTFS (FAT32 exclu)

L'option Lite Sync peut être activée lors de l'installation de l'application (cela vous est proposé) ou par la suite:

1. Si nécessaire, cliquez sur le chevron ‍ dans la zone de notification de votre ordinateur (en bas à droite sur Windows, près de l'horloge) pour accéder à l'icône kDrive car Windows masque les icônes d'application.
2. Faites un clic gauche sur l'icône de l'app .
3. Cliquez sur le menu d'action ⋮ à droite de la fenêtre kDrive.
4. Sélectionnez Paramètres du kDrive.
5. Cliquez sur le menu d'action ⋮ à droite de la synchronisation en cours et du symbole nuage:
   
6. Cliquez sur l'élément de menu:
   1. Si le nuage est barré, vous pouvez activer Lite Sync car celle-ci n'était pas encore active (confirm.
   2. Au même endroit vous pouvez désactiver Lite Sync si le nuage n'était pas barré (lire également en fin de ce guide).
7. Confirmez l'opération puis patientez jusqu'au message confirmant la fin de l'opération.

Actions sur les données synchronisées sur le disque

Toujours conserver sur cet appareil

Une fois la Lite Sync activée (et donc les données sur le disque devenues “virtuelles”), il vous est possible de malgré tout rendre disponible localement un dossier et ses sous-dossiers ou uniquement un ou plusieurs fichiers:

1. Depuis l'Explorateur de fichiers Windows, placez-vous sur un dossier synchronisé avec kDrive et faites un clic droit.
2. Sélectionnez l'option Toujours conserver sur cet appareil sous kDrive:
   
3. Le symbole visible sur l'icône des fichiers concernés va changer pour indiquer que le fichier n'est plus "dans le nuage" mais bien présent physiquement sur votre disque.

Libérer de l'espace

A l'inverse, une fois la Lite Sync activée, il vous est possible de libérer de l'espace, fichier par fichier ou dans un dossier et ses sous-dossiers.

1. Depuis l'Explorateur de fichiers Windows, faites un clic droit sur le dossier ou fichier concerné.
2. Sélectionnez l'option Libérer de l'espace sous kDrive:
   
3. Le symbole visible sur l'icône des fichiers/dossiers concernés va changer pour indiquer que les données sont “dans le nuage” et non plus présentes entièrement sur votre disque:
   • L'action Libérer de l'espace aura pour effet de libérer de l'espace de stockage sur votre ordinateur.
   • Les fichiers resteront visibles mais ne seront plus accessibles sans connexion internet.

Exemple d'utilisation (espace de stockage nécessaire)

Si vous activez Lite Sync, l'espace occupé (900 Go par exemple) côté serveur Infomaniak sera libéré sur votre disque dur mais l'inverse est également vrai (par exemple 900 Go libre requis sur votre disque dur en cas d'activation de l'option Lite Sync en cours de route).

"Déshydratation" de fichiers

Comme expliqué en préambule, un fichier déshydraté est un fichier kDrive dont la version complète n'est pas présente sur le disque dur et en lieu et place c'est un "raccourci" de 1 Ko qui s'affiche, comportement normal quand Lite Sync est activée.

Dans certains cas (par exemple si vous copiez les fichiers de votre disque dur alors que Lite Sync est activée, et que vous recommencez une synchronisation vers un nouveau kDrive) l'application bloquera l'importation de ce type de fichier. Pour résoudre ces erreurs vous pouvez télécharger le fichier complet depuis l'app Web kDrive (service en ligne ksuite.infomaniak.com/kdrive).

Voici les icônes de statut qui sont utilisées dans l'explorateur Windows et leurs explications:

Icônes de statut	Description
= en ligne	Sur un fichier cela signifie qu'il est uniquement sur le kDrive “dans le nuage” ; pour le consulter en local il faudra le télécharger. Sur un dossier cela signifie qu'il contient au moins un fichier ou sous-dossier présent sur le kDrive “dans le nuage”.
= toujours disponible	Sur un fichier cela signifie qu'il est disponible physiquement sur le disque et synchronisé. Sur un dossier cela signifie que le dossier ne contient que des fichiers stockés localement.
= disponible (temporaire)	Fichier téléchargé temporairement par Windows (peut être libéré par l'OS).
= synchronisation	Le cercle de progression indique une action en cours ou en attente.
= hors ligne / erreur	Problème de synchronisation ou Lite Sync (contactez le support).

Désactiver l'option Lite Sync

Pour cela, suivez les étapes en haut de ce guide. Lors de la désactivation de LiteSync via les Paramètres du kDrive, deux cas de figure peuvent se produire en fonction de la place restante sur votre support de stockage de l'appareil utilisé:

1. S'il y a suffisamment d'espace sur votre ordinateur un message confirmant la désactivation s'affiche, il suffit de cliquer sur Continuer.
2. S'il n'y a pas suffisamment d'espace sur votre ordinateur, un message vous indiquera l'espace manquant pour permettre la désactivation de la Lite Sync ; la synchronisation de votre kDrive sera mise en pause le temps de libérer de l'espace ou sélectionner les fichiers à synchroniser.