Skip to main content
This guide is for IT administrators who installed Draftable Clean with the machine-wide MSI. The MSI does not update itself, so you deploy each new version yourself. If your users have the per-user EXE, updates are automatic; see Updating Draftable Clean.
Upgrading closes Draftable Clean and does not start it again. Anything a user is cleaning at the time is stopped. Deploy outside working hours where you can, and tell users beforehand. See What happens to Draftable Clean during the upgrade.

​
Before you start

  • You need administrator rights on each computer, or a deployment tool that runs as SYSTEM, such as Microsoft Intune or Microsoft Configuration Manager.
  • Test the new version on one computer before you deploy it widely.
  • Check the release log for what has changed, including any Group Policy template changes.
  • The Outlook add-in is updated separately. See The Outlook add-in is updated separately.

​
Upgrade the MSI

You do not need to uninstall the old version first. The new MSI finds the installed version and replaces it in one step. If the upgrade fails part way, Windows Installer rolls back and the previous version stays installed.
1

Download the new MSI

Download DraftableCleanSystem.msi, the same link as in Enterprise Deployment.
2

Use the same options as the original install

If you installed to a custom folder with INSTALLDIR, or chose features with ADDLOCAL, use the same values again. ADDLOCAL replaces the default features, so keep HttpListener in the list whenever you use it.
3

Deploy the new MSI

Deploy it with the tool you used for the original install, to the same computers. For an unattended upgrade from the command line:
The full command-line options are in Enterprise Deployment.
4

Check the version

On an upgraded computer, open Draftable Clean and check App Version in the status bar at the bottom right of the window. See Checking the current version. You can also see the version in Windows Settings > Apps > Installed apps.
An MSI cannot install an older version over a newer one. If you try, the installer stops with “A newer version is already installed. Please uninstall it first to proceed.”

​
What happens to Draftable Clean during the upgrade

  • Draftable Clean is closed before its files are replaced. When the upgrade runs with administrator rights or as SYSTEM, as Intune and Configuration Manager do, it closes Draftable Clean for every user signed in to the computer, including users in Remote Desktop or Citrix sessions. When a user runs the installer themselves and approves the administrator prompt, only that user’s copy is closed.
  • Work in progress is lost. Files that were being cleaned are not finished, and cleaned files that the user has not yet saved from Draftable Clean are lost when it closes. Users clean them again after the upgrade.
  • Microsoft Outlook and Office are not closed.
  • The Draftable Clean HTTP Listener service is stopped during the upgrade and started again when it finishes.
  • Draftable Clean is not started again. Users open it from the Start menu or the desktop shortcut. If your users have the Outlook add-in, it tries to start Draftable Clean in the background when the user opens the Draftable Clean pane or adds an attachment to an email.
Closing the app is done on a best-effort basis. If PowerShell is blocked on the computer, or the installation folder path contains an apostrophe, a running copy may not be closed. If Draftable Clean will not open after the upgrade, ask the user to quit it from the system tray and open it again, or restart the computer.

​
Your settings are kept

  • Group Policy and Intune settings are not part of the installation, so the upgrade does not change them.
  • Users’ own settings and personal cleaning profiles are stored for each user in the Windows registry, not in the installation folder, so they are kept.
  • License activation is stored for each user in %LocalAppData%\DraftableClean, not in the installation folder, so users do not need to activate again.
  • Check access to SharePoint and NetDocuments after the upgrade and sign in again if prompted. A browser profile change or cleared browser data can require a new sign-in.

​
Refresh the Group Policy templates

Each version installs its own templates in the GroupPolicy folder of the installation folder:
If the release changed the templates, copy the new .admx file and its matching .adml file to your Central Store, replacing the old pair. Keep the two files together, because both carry the same revision number. If you imported the templates into Microsoft Intune, update them there too. See Configuring preferences with Group Policy and Configuring preferences with Microsoft Intune.

​
The Outlook add-in is updated separately

The Outlook add-in is deployed from a manifest in the Microsoft 365 admin center, not by the MSI, so upgrading the MSI does not change it.
  • Latest manifest URL: the add-in updates itself within its major version.
  • Pinned manifest URL: the add-in stays on its version until you deploy a newer pinned manifest. See Updating the add-in.
Keep the desktop application and the add-in on a supported pair. If they are too far apart, the add-in pane shows one of these:
  • Draftable Clean Update Required: the desktop application is older than this add-in needs. Upgrade the MSI.
  • Add-in Update Required: the add-in is older than the desktop application needs. Deploy the current pinned manifest.
After you update either one, users click Recheck Version in the pane.

​
Next steps

Enterprise Deployment

MSI features, command-line options and removal.

Updating Draftable Clean

How updates work for each installer, and how to check the version.

Troubleshooting: Outlook Add-in

What to check if the add-in stops working after an update.