Scenario Executions

Possible usage steps within this page

Scenario: Uninstall awaberry on macOS successfully

This scenario describes the process of correctly uninstalling awaberry from a macOS system.

1. Read the "Uninstall awaberry" title and the warning message carefully.
2. Locate the "Uninstall on mac" section.
3. Read the instruction "Open terminal and type".
4. Click on the code box containing brew uninstall awaberry to copy the command.
5. Open a new Terminal window on your macOS.
6. Paste the copied command (brew uninstall awaberry) into the Terminal.
7. Press Enter to execute the command.
8. Follow any on-screen prompts from Homebrew to complete the uninstallation.

Scenario: Uninstall awaberry on Linux successfully

This scenario describes the process of correctly uninstalling awaberry from a Linux system.

1. Read the "Uninstall awaberry" title and the warning message carefully.
2. Locate the "Uninstall on linux" section.
3. Read the instruction "Open terminal get root and type".
4. Open a new Terminal window on your Linux system.
5. Click on the first code box containing sudo su to copy it, paste into Terminal, and press Enter (enter your password if prompted).
6. Click on the second code box containing cd /root/awaberrybaseinstaller to copy it, paste into Terminal, and press Enter.
7. Click on the third code box containing ./awaberryuninstaller.sh to copy it, paste into Terminal, and press Enter.
8. Follow any on-screen prompts from the uninstaller script to complete the uninstallation.

Scenario: Uninstall awaberry on Windows (using WSL) successfully

This scenario describes the process of correctly uninstalling awaberry from a Windows system using Windows Subsystem for Linux (WSL).

1. Read the "Uninstall awaberry" title and the warning message carefully.
2. Locate the "Uninstall on windows" section.
3. Read the instruction "Open windows sub linux and type".
4. Open your Windows Subsystem for Linux (WSL) terminal (e.g., Ubuntu, Debian).
5. Click on the first code box containing sudo su to copy it, paste into WSL Terminal, and press Enter (enter your password if prompted).
6. Click on the second code box containing cd /root/awaberrybaseinstaller to copy it, paste into WSL Terminal, and press Enter.
7. Click on the third code box containing ./awaberryuninstaller.sh to copy it, paste into WSL Terminal, and press Enter.
8. Follow any on-screen prompts from the uninstaller script to complete the uninstallation.

Possible errors which may occur on this page

Error: Command 'brew' not found when uninstalling on macOS

This error occurs if you try to uninstall awaberry on macOS using the brew uninstall awaberry command, but the Homebrew package manager is not installed on your system, or the command was mistyped. The terminal will typically respond with something like "command not found: brew" or "zsh: command not found: brew".

To resolve: Ensure Homebrew is installed correctly, or manually remove awaberry if it was installed by other means. Double-check the command for typos.

Error: "Sorry, try again." or "Authentication failure" when using 'sudo su' on Linux/WSL

This error happens when you enter an incorrect password after typing sudo su to gain root privileges. The system will not grant you elevated access, preventing you from proceeding with the uninstallation steps that require root permissions.

To resolve: Carefully re-enter the correct password for your user account. If you've forgotten it, you may need to reset your user password or contact your system administrator.

Error: "No such file or directory" when changing directory to '/root/awaberrybaseinstaller' on Linux/WSL

This error indicates that the installation directory for awaberry, expected at /root/awaberrybaseinstaller, does not exist or has been moved. This could happen if awaberry was installed in a different location, or if the directory was accidentally deleted.

To resolve: Verify the actual installation path of awaberry. You might need to use commands like find / -name "awaberryuninstaller.sh" to locate the correct directory, or consult your original installation instructions.

Error: "Permission denied" or "command not found" when executing './awaberryuninstaller.sh' on Linux/WSL

This error means that the uninstaller script awaberryuninstaller.sh cannot be found in the current directory, or you do not have the necessary permissions to execute it. This can occur if the file was deleted, has a typo in its name, or its file permissions do not allow execution (e.g., if it's not marked as executable).

To resolve: First, ensure you are in the correct directory (/root/awaberrybaseinstaller). Then, check if the file exists using ls -l awaberryuninstaller.sh. If it exists but is not executable, you might need to change its permissions using chmod +x awaberryuninstaller.sh. If the file is missing, you may need to manually remove awaberry components or reinstall and then properly uninstall.