Skip to content

Commit

Permalink
Merge pull request #549 from Eugenetanwl3881/w13/update-ug-parameter
Browse files Browse the repository at this point in the history
Update UG Troubleshooting
  • Loading branch information
bryanljx authored Nov 7, 2022
2 parents 57f49ba + a91f8c5 commit 8296826
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 26 deletions.
1 change: 0 additions & 1 deletion docs/_layouts/default.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
layout: compress
---
<!DOCTYPE html>
<html lang="{{ page.lang | default: site.lang | default: "en" }}">
Expand Down
29 changes: 4 additions & 25 deletions docs/_ug/Troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,56 +13,35 @@ The JAR file not launching even after double-clicking the file.
* Search for "terminal" and click it to launch.
1. On your terminal, run `java -jar "foodrem.jar"`

If the issue still persists it might be due to the following errors:

**Problem:**

The JAR file not launching in Windows Subsystem for Linux (WSL).

```note
WSL does not support GUI applications by default. WSL users have to manually install and set up a X-server to run such apps on WSL.
Options include:
* VcXsrv Windows X Server
* gWSL (which can be installed from the Microsoft Store and helps handle the setting up of X-server)
An exception is windows 11. There seems to be some support for running GUI applications in WSL 2 for windows 11 though it's limited to Windows 11 Build 22000 or later.
WSL does not support GUI applications by default.
```
**Solution:**

1. Our recommendation is to run FoodRem in windows natively and not on WSL.
1. Our recommendation is to run FoodRem on Windows and not on WSL.

**Problem:**

The JAR file not launching in Linux machines running Wayland.


To check if the Linux machine is running Wayland, run the following command:

```Bash
echo $XDG_SESSION_TYPE
```

If the output is `wayland`, then the Linux machine is indeed running Wayland.

**Solution:**

```info
Under the hood, FoodRem uses JavaFX 11 to render the UI for the GUI.
Unfortunately, JavaFX 11 has poor support for Wayland which is why FoodRem is unable to support Wayland currently.
```

1. Install Xorg if it is not present on the machine.
* Log out of the current session running Wayland and switch to a session running Xorg. The app should now launch properly in Xorg.
2. Install any virtual machine that is not running Wayland on a hypervisor such as VirtualBox or VMware.
* The app should also launch properly in the virtual machine if configured properly.
1. FoodRem is only supported on machines with the following operating systems: Windows, macOS and Linux11. Please use a computer running on these operating systems.

**Problem:**

Unable to exit/save FoodRem to data file

**Solution:**

1. Verify that the JAR file `foodrem.jar` is not placed in a write-protected folder where administrator privileges are required to write/save FoodRem to the data file. E.g of write-protected folders include `C:\WINDOWS\System32` in windows and the `/etc` dir in linux.

1. If the JAR file is located in a write-protected folder, move it to a folder that is not write-protected.
1. This error is due to `foodrem.jar` being started in a protected folder. (Examples of write-protected folders include `C:\WINDOWS\System32` in windows and the `/etc` dir in linux) <br> Please move the `foodrem.jar` file into another folder in your computer and start FoodRem from that folder.

0 comments on commit 8296826

Please sign in to comment.