Share

Handling Unhealthy Environments

Topics in this section:


Overview

Does your workspace show no files or folders?

No Files Folders

Do you have a sync icon continuously showing up? Pending Sync Icon

Important: These can be the cause of the Docs connector in a bad state.
Note:

This page will outline Desktop Connector behavior when an unhealthy environment is identified and define the steps needed to clean up your unhealthy Desktop Connector environment.


Workflows

The following detailed workflows may result in an unhealthy environment:

  • You tried to uninstall Autodesk Desktop Connector, but it failed and Desktop Connector is still running. The removal process has been completed in the control panel, yet Desktop Connector continues to run in the background.

  • To resolve, refer to Properly Uninstall Desktop Connector.

  • If you uninstall Desktop Connector, it will remove the databases but workspace files will stay on your device. Before reinstalling Desktop Connector, the workspace needs to be cleared. If it isn't, the outcome will depend on which Desktop Connector version you're running.

    • Starting from version 16.13, the previous Desktop Connector folder will be renamed to prevent an unhealthy environment. Refer to Managing leftover workspace files for guidance.

    • In version 16.12 and below, you will be shown a dialog box to resolve the issue.

      • Selecting the offending folder path will open up Windows Explorer and take you to the folder where you can delete or move the data.
      • Selecting Shut Down Button will close the dialog box and allow the user to manually delete the files and folders.

    Clear Connector

  • Desktop Connector will present the user with a dialog box when the system detects files or folders in the workspace which are not affiliated with your Autodesk Docs project selections. This most often means that files or folders were added to the workspace location when Desktop Connector was not running, then when Desktop Connector is started this dialog is visible.

    • The offending files/folders are listed in the dialog box and you need to either delete or move the data outside the Desktop Connector workspace.
    • Selecting the offending files and folders will open up Windows explorer and take you to the folder where you can correct the problem.
    • Shutdown will close the dialog box and exit Desktop Connector and allow the user to manually delete the files and folders.

    Clear Connector Alternative

  • When Desktop Connector isn't able to fully cleanup or identify the cause of the problem, you may need to follow the steps in this link to Reset Desktop Connector version 16.x to default.

    • These steps will manually clean up the Desktop Connector environment.

    DC Reset Connector


Related Concepts:

Was this information helpful?