User Settings Main Page -> Uninstall awaberry

Uninstall awaberry

Summary

This page guides you through the process of completely removing awaberry from your computer. You'll find specific instructions tailored for MAC, LINUX, and Windows operating systems. Please read the important warning about remote access functionality before proceeding with the uninstallation.

Page Access

You can access this page by navigating to: /user_uninstall

Page Functionalities

Uninstall Instructions Title

Clearly indicates the purpose of the page, making it easy to understand what the user can accomplish here.

Important Warning

A prominent message, highlighted in red, warns users about a crucial consequence: uninstalling awaberry will cause the loss of all remote connection and device automation capabilities. This ensures users are fully informed before proceeding.

Uninstall on MAC Section

This dedicated section provides clear, concise instructions specifically for users on a MAC operating system. It includes:

  • Guidance on opening the terminal.
  • A copyable command box for brew uninstall awaberry, simplifying the process and reducing typing errors.

Uninstall on LINUX Section

This section offers detailed instructions tailored for LINUX users, covering the necessary steps for a complete uninstallation. It features:

  • Instructions on opening the terminal and acquiring root/sudo permissions.
  • Multiple copyable command boxes for sudo su, cd /root/awaberrybaseinstaller, and ./awaberryuninstaller.sh, facilitating a step-by-step uninstallation.

Uninstall on Windows Section

Designed for Windows users, this section outlines the uninstallation process specifically when using the Windows Subsystem for Linux (WSL). It provides:

  • Instructions on how to open the WSL terminal and obtain root/sudo permissions.
  • Several copyable command boxes for sudo su, cd /root/awaberrybaseinstaller, and ./awaberryuninstaller.sh, guiding users through the WSL-based uninstallation.

Copy-to-Clipboard Functionality

All command-line snippets throughout the page are equipped with a convenient copy-to-clipboard feature. Users can simply click on a command to copy it, thereby preventing manual typing errors and streamlining the uninstallation process.

Scenario Executions

Possible usage steps within this page

1. Uninstalling on a MAC

  1. Understand the Warning: Read the red warning message carefully to understand that uninstalling awaberry will remove all remote connection and device automation capabilities.
  2. Open Terminal: Locate and open the 'Terminal' application on your MAC. This is usually found in Applications > Utilities.
  3. Copy Command: Click on the command brew uninstall awaberry within the "Uninstall on MAC" section. This will automatically copy the command to your clipboard.
  4. Paste and Execute: Paste the copied command into your Terminal window (Cmd+V) and press Enter.
  5. Follow Prompts: If prompted, enter your administrator password. awaberry will then be uninstalled from your MAC system.

2. Uninstalling on LINUX

  1. Understand the Warning: Read the red warning message carefully to understand the implications of losing remote functionality.
  2. Open Terminal: Open your preferred terminal application on your LINUX system.
  3. Gain Root Permissions: Click on sudo su to copy it, paste into the terminal, and press Enter. Enter your administrator password when prompted to gain root access. This is necessary for the uninstallation script.
  4. Navigate to Uninstaller Directory: Click on cd /root/awaberrybaseinstaller to copy. Paste this command into the terminal and press Enter. This changes your current directory to where the uninstaller script is located.
  5. Run Uninstaller: Click on ./awaberryuninstaller.sh to copy. Paste this command into the terminal and press Enter. Follow any on-screen prompts to complete the uninstallation.

3. Uninstalling on Windows (via Windows Subsystem for Linux)

  1. Understand the Warning: Read the red warning message carefully regarding the loss of remote functionality.
  2. Open WSL Terminal: Open your Windows Subsystem for Linux (WSL) terminal (e.g., 'Ubuntu' from your Start Menu).
  3. Gain Root Permissions: Copy sudo su, paste it into the WSL terminal, and press Enter. Provide your administrator password when requested to obtain root privileges.
  4. Navigate to Uninstaller Directory: Copy cd /root/awaberrybaseinstaller, paste, and execute it in the WSL terminal to go to the uninstaller's location.
  5. Run Uninstaller: Copy ./awaberryuninstaller.sh, paste, and execute it. Follow any prompts that appear in the terminal to finish the uninstallation.

Possible errors which may occur on this page

Error: Command Not Found (MAC - brew)

If you execute brew uninstall awaberry on a MAC and receive an error message such as "command not found: brew", it indicates that Homebrew, the package manager, is not installed or not correctly configured on your system. This often means awaberry was not installed through Homebrew, or Homebrew itself needs to be installed first. To resolve this, you would need to either determine the original installation method for awaberry or install Homebrew if you wish to use it for package management.

Error: Permission Denied (LINUX/Windows WSL)

When attempting to run ./awaberryuninstaller.sh on LINUX or within Windows Subsystem for Linux, if you encounter a "Permission denied" error, it signifies that you lack the necessary administrative (root) rights. This typically occurs if you have not successfully executed sudo su or if you entered an incorrect password. The uninstallation script requires elevated privileges to modify system files. Always ensure you have successfully gained root access before attempting to run the uninstaller script.

Error: Directory Not Found (LINUX/Windows WSL)

An error message like "No such file or directory: /root/awaberrybaseinstaller" after trying to execute cd /root/awaberrybaseinstaller means that the uninstaller's directory is not present in the expected location. This could be due to awaberry being installed in a different custom path or an issue during the initial installation where the directory was not created correctly. To proceed, you will need to manually locate the actual installation path of awaberry and navigate to it before running the uninstaller script.

Error: General Command Line Errors

Common issues such as typos when manually entering commands (instead of using the copy functionality) or problems with your terminal environment can lead to various "command not found" or syntax errors. To prevent these, it is highly recommended to always use the provided copy-to-clipboard functionality for each command.

Up to User Manual Main Page