Skip to main content

Uninstall the FileWave Client on macOS

Description

Use

Thethese belowuninstallers methodswhen canyou be usedneed to uninstallremove the FileWave Client from macOS computers before archiving, deleting, selling, or otherwise removing those devices from FileWave management.

Remove the client while the Mac can still receive Filesets. After the FileWave Client is removed, the Mac will no longer check in to the FileWave Server through the client.

Before you begin

    Test the uninstaller on macOSa machines.small pilot

    Updatedgroup before broad deployment.

    Confirm whether the Mac is also MDM enrolled. Removing the FileWave Client does not remove the MDM enrollment profile. If the Mac should leave management entirely, remove the MDM profile, archive with versionthe 4.1.MDM-removal Versionoption 4when didappropriate, notor allow forwipe the removalMac as part of the FileWaveoffboarding VNCworkflow. client and

    Downloads

    as
    suchOptionDownloadUse willwhen causedevicesFilesetFileWaveUninstallermacOSv4.1.1-kiosk-path-fix-fileset.zipYou can still deploy Filesets to rebootthe andMacs notbeing uninstallremoved. Standalone scriptFileWaveUninstallermacOSv4.1.1.sh.zipYou need to run the FileWaveuninstaller Client.locally Pleaseor updatethrough toanother tool.

    Version 4.1.1 keeps the version 4.1 tobehavior avoidfor thisclients issue.that Versionno 4.1longer will still work with older version ofuse FileWave Client.VNC and corrects the FileWave Kiosk app path used by the removal script.

    Ingredients

      FileWave Uninstall, Fileset or Stanadalone

      Directionsdirections

      Fileset

      1. Download the attached Fileset and unzip it.
      2. Drag and drop the unzipped Fileset ininto to your Filesets tab. Please make sure to drag it in yourthe root level of yourthe Filesets structuretab so it is not accidentally deployed tofrom devices.inside Thisanother Fileset will uninstall the client and break communication to your FileWave server.folder.
      3. Associate the Fileset to machinesthe Macs that youshould wantbe removed from FileWave management.
      Run a Model Update. Confirm the uninstall has had time to removerun fromon FileWave.the targeted Macs. OnceArchive or delete the FilesetFileWave isrecords sentas outappropriate, thethen devicesrun willanother notModel check back in and can be deleted from FileWave.Update.

      Standalone script ↓ macOS FileWave Download.png

      Standalone

      directions
      1. Download and unzip the attachedstandalone scriptscript.
      2. Use Terminal to runRun the script locally as root with zsh:
      sudo /bin/zsh ./FileWaveUninstallermacOSv4.1.1.sh
↓

      Do macOS

      not run the FileWave Download.pngscript with sh. The script uses zsh syntax, and running it with sh can produce a syntax error near the process-substitution line.

      MDM enrollment note

      This will uninstalluninstalls the FileWave Client, but it willdoes not remove an MDM enrolmentenrollment profileprofile. if installed.  As such,If the deviceMac is still MDM enrolled, FileWave may still behave ablean toMDM connect backchannel to the FileWavedevice, Serverand over MDM, but will be unmanageable.  Additionally, if the Custom PKG isa configured tocustom instal beyond initial enrolment, MDMPKG can reinstall the clientFileWave ontoClient during enrollment or later MDM-driven installation.

      If the deviceMac again.should Ensureleave FileWave management entirely, also handle the MDM profile isor alsowipe removedworkflow. ifSee removingArchiving Clients and Wipe Device for macOS.

      Uninstaller scope

      The macOS uninstaller uses the FileWave Client package receipt to identify installed client components. That works for normal installations, but heavily upgraded or manually modified clients may have files that no longer match the receipt. If the client was upgraded many times or the uninstall does not fully clean up the device, review the remaining files manually or contact FileWave Technical Support.

      Related Content

        Retiring a device from FileWave.FileWave Archiving Clients Wipe Device for macOS
        Back to top