Skip to content

Commit

Permalink
adapt debugging hints (#1136)
Browse files Browse the repository at this point in the history
## Problem

With SSL changes debugging tips no longer reflect reality.


## Solution

Adapt -> succeed
  • Loading branch information
jreidinger authored Apr 8, 2024
2 parents 5e1d4b2 + 3123d1c commit c118d06
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions web/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ This can work also remotely, with a Agama instance running in a different
machine (a virtual machine as well). In that case run

```
AGAMA_SERVER=<IP> npm run server -- --open
AGAMA_SERVER=https://<IP>:<port> npm run server -- --open
```

Where `AGAMA_SERVER` is the IP address, the hostname or the full URL of the
Expand All @@ -40,11 +40,12 @@ Example of running from different machine:
```
# backend machine
# using ip of machine instead of localhost is important to be network accessible
agama-web-server serve --address 10.100.1.1:3000
# second address is needed for SSL which is mandatory for remote access
agama-web-server serve --address :::3000 --address2 :::443
# frontend machine
# ESLINT=0 is useful to ignore linter problems during development
ESLINT=0 AGAMA_SERVER=10.100.1.1:3000 npm run server
ESLINT=0 AGAMA_SERVER=https://10.100.1.1:3000 npm run server
```

### Debugging Hints
Expand All @@ -54,6 +55,8 @@ The first place is the browser's console which can give
some hints. The second location to check for errors or warnings is output of `npm run server`
where you can find issues when communicating with the backend. And last but on least is
journal on backend machine where is logged backend activity `journalctl -b`.
If the journal does not contain the required info, you can inspect the D-Bus communication
which can give hint about data flow. Command is `busctl monitor --address unix:path=/run/agama/bus`

### Special Environment Variables

Expand Down

0 comments on commit c118d06

Please sign in to comment.