Diagnose PreVeil Drive Sync Issues with the CLI Doctor Tool

Have trouble keeping your files in sync with PreVeil Drive? This guide will show you how to use the built-in doctor tool to identify any sync issues.

Requirements:

• You must be using PreVeil Drive version 4.15.1 or higher.

  • What version of PreVeil software am I running?

Using the Doctor Tool:

1. Open Command Prompt (Windows) or Terminal (Mac): Locate and launch the appropriate application for running commands on your system.

2. Navigate to the PreVeil File Sync Directory:

   • Windows: Type cd c:\preveil\filesync and press Enter.

   • Mac: Type cd /Applications/PreVeil/filesync and press Enter.

3. Run the Doctor Tool: Execute the following command, replacing {your_preveil_address} with your actual PreVeil account address:

   .\preveil_client doctor {your_preveil_address}

4. Interpreting the Results:

   • "All items are synced" - Congratulations! Your PreVeil Drive is functioning properly and all your files are in sync.

   • "Error" with Sync Count: This indicates there are sync problems. The output will display the number of successfully synced items and the number of items with errors.

   • Top-Level Folder: The doctor tool will pinpoint the top-level folder where the sync issues reside. This helps narrow down the problematic area.

Troubleshooting Sync Issues:

1. Isolating the Problem Folder: If the doctor tool identifies a folder with sync errors, you can further diagnose the problem file by using the -p flag:

   .\preveil_client doctor -p {path/to/folder}

   Replace {path/to/folder} with the specific folder path indicated by the initial doctor tool output.
   Surround the path with double quotes (“) when using a path containing spaces in any folder name.
   For example, "C:\Users\PreVeil\PreVeil-desi@acme-e2ee.com\Project Folder\April 2024".

2. Drilling Down: If the problematic file resides within subfolders, the doctor tool will guide you by suggesting the next subfolder to investigate. Rerun the command with the new subfolder path to pinpoint the exact file.

3. Understanding the Error Message: Once you've identified the problematic file, the doctor tool's output might provide information about the reason behind the sync failure. This can help you determine further troubleshooting steps.

Additional Notes:

• The doctor tool offers various flags for more advanced users. You can access the list of available flags by running .\preveil_client doctor -h or .\preveil_client doctor --help.

• If you encounter persistent sync issues after using the doctor tool, consider contacting PreVeil support for further assistance.

This guide empowers you to leverage the PreVeil Drive doctor tool and effectively diagnose sync problems, ensuring your files remain up-to-date and accessible across your devices.

Flags:
-h, --help help for doctor
--include-tree include-tree set include-tree will include statuses for the whole subtree under this path
-p, --path string check sync status for a specific path

Global Flags:
--cpuprofile string cpu profile file path
--datadir string drive metadata directory (default "C:\\Users\<username>\AppData\Local\PreVeil\Data")
--dir string drive root directory (default "C:\\Users\<username>")
--localsync global local sync (default true)
--logdir string log dir location (default "C:\\Users\<username>\AppData\Local\PreVeil\drive\logs")
--logfetch activity log fetch (default true)
--memprofile string memory profile file path
--mode string PREVEIL_MODE (default "prod")
--port string port used to specify which drive daemon we are connecting to
--server string backend https://host:port
--stdout log to stdout as well as logdir
--tempdir string directory for writing temp data
--trace enable verbose logging from Trace log level
--wsaddress string backend wss://host:port