superops_agent_uninstall_macos.sh - limehawk/rmm-scripts GitHub Wiki

superops_agent_uninstall_macos.sh

Uninstalls the SuperOps RMM agent from macOS systems.

Overview

Uninstalls the SuperOps RMM agent from macOS systems by executing the agent's built-in uninstall script. This provides a clean removal of the agent and all associated components.

Purpose

Uninstalls the SuperOps RMM agent from macOS systems by executing the agent's built-in uninstall script. This provides a clean removal of the agent and all associated components.

Prerequisites

  • Bash shell
  • macOS operating system
  • Sudo privileges (for uninstallation)
  • SuperOps RMM agent must be installed
  • Uninstall script must exist at /Library/superops/uninstall.sh

Configuration

Required Inputs

  • UninstallScriptPath : "/Library/superops/uninstall.sh" (Path to the SuperOps-provided uninstall script on macOS)

Settings

  • Uses the official SuperOps uninstall script
  • Executes with sudo privileges
  • Validates script existence before execution
  • No additional cleanup needed (handled by uninstall script)

Behavior

  • Validates that the uninstall script exists at expected path
  • Executes the SuperOps-provided uninstall script with sudo
  • Reports progress and status to stdout
  • Exits with code 0 on success, 1 on failure
  • All-or-nothing: any failure stops the script immediately

Security Notes

  • No secrets or credentials used
  • Executes only the official SuperOps uninstall script
  • Requires sudo elevation for uninstallation
  • Does not store or transmit any data

Exit Codes

  • 0 success
  • 1 failure

Example Output

[ INPUT VALIDATION ]
--------------------------------------------------------------
Uninstall Script: /Library/superops/uninstall.sh

[ OPERATION ]
--------------------------------------------------------------
Checking for uninstall script...
Uninstall script found
Executing uninstall script with sudo...
Removing SuperOps RMM Agent...
Stopping services...
Removing launch agents...
Removing files...
Uninstallation complete

[ RESULT ]
--------------------------------------------------------------
Status: Success

[ FINAL STATUS ]
--------------------------------------------------------------
SuperOps agent uninstalled successfully

[ SCRIPT COMPLETED ]
--------------------------------------------------------------

Version History

  • 2025-11-02 v1.0.0 Initial migration from SuperOps
    • Converted to Limehawk Style A format (bash)
    • Added comprehensive error handling
    • Added validation checks
    • Added structured console output
    • Made installation path configurable

Links