Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Desktop access troubleshooting docs update #45461

Closed
wants to merge 8 commits into from
Closed
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions docs/pages/enroll-resources/desktop-access/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -393,3 +393,34 @@ to force the policy update:
```code
$ gpupdate.exe /force
```
### Shared Directory Error

Attempts to share directory on a remote desktop session results in the error:

```
Encountered shared directory error 1
```
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you think about moving this configuration to the setup guide instead of mentioning this poor error message here in the troubleshooting guide?

We can file a separate issue to improve the error message as well.


**Solution:** Review and disable configured Device Redirection Group Policy
oshati marked this conversation as resolved.
Show resolved Hide resolved

First, make sure that all [Directory sharing](https://goteleport.com/docs/enroll-resources/desktop-access/directory-sharing/#prerequisites) prerequisites has been met.

Teleport requires device redirection policies to be disabled in RDP policies to allow directory sharing from a remote computer in an RDP session
oshati marked this conversation as resolved.
Show resolved Hide resolved

To fix this issue, review and disable the `Device and resource redirection policy` within the `Remote Desktop session host` path below:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To fix this issue, review and disable the `Device and resource redirection policy` within the `Remote Desktop session host` path below:
To fix this issue, review the _Device and resource redirection_ group policy settings at the path below:


```text
Computer configuration > Policies > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Device and Resource Redirection > *
oshati marked this conversation as resolved.
Show resolved Hide resolved
```

Some key policies to lookout for:

- Do not allow COM port redirection
- Do not allow drive redirection
- Do not allow LPT port redirection
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wouldn't expect COM port redirection or LPT port redirection to matter for directory sharing.

In fact, I can disable these and directory sharing still works as expected:

image

As soon as I disable device redirection I do get the original error, so I think you can remove these two.


After disabling the policies, run the following command from the Windows Command prompt as an administrator to force the policy update:

```code
$ gpupdate.exe /force
```
Loading