qusal/docs/TROUBLESHOOTING.md
2024-06-18 15:16:46 +02:00

2.4 KiB

Troubleshooting

Qusal troubleshooting guidelines.

Table of Contents

Detect if your issue was already opened

If you encounter any problems, search the project's issue tracking system for Open and Closed issues, sorted by Recently updated. For finer grained search, consult the tracking system filter syntax.

Qrexec client shows Request refused

The Qrexec call was denied, either by a missing rule, an explicit deny or a typo in the configuration.

Therefore, it is recommended to:

  • Check if there is a rule for the service you want to call that would either result in ask or allow; and
  • Check again and again if you made a typo in the policy.

The examples below will use the qube dev and the RPC service qubes.GetDate and other common Qrexec RPC services as an example, substitute them with the qube and service you intend to use, such as qube code and service qusal.GitInit.

On dom0, watch the Qrexec policy logs:

sudo journalctl -fu qubes-qrexec-policy-daemon | cut -d " " -f 7-

If you ave many simultaneous calls being shown, get on the important ones:

sudo journalctl -fu qubes-qrexec-policy-daemon | cut -d " " -f 7- \
  | grep -e qubes.GetDate -e qubes.Filecopy

You can emulate the call from dom0:

qrexec-policy dev @default qubes.GetDate

On the qube making the call, run the qrexec-client-vm command directly rather than using a wrapper around it:

qrexec-client-vm @default qubes.GetDate

Salt wrapper qubesctl command fails

The Salt Project has troubleshooting page for a variety of problems you may encounter.

A nice summary of the states can be seen with the --show-output argument:

sudo qubesctl --show-output state.apply pkg.uptodate

Ending the Salt call with -l debug argument gives the most detailed output (may contain private information):

sudo qubesctl state.apply pkg.uptodate -l debug