Debug output from the Active Directory provider

KB Home   |   Debug output from the Active Directory provider

If requested by support please follow the instructions below to gather debug output from the Active Directory user provider (the component of PaperCut that retrieves information from Active Directory).

To get debug output:

1. Open a command prompt on the server running PaperCut. e.g. Start→Run and enter cmd.exe.

2. Change to directory containing UserDirAD.exe. e.g.:

cd “C:\Program Files\PaperCut NG\server\bin\win”

3. Run one of the following commands (as requested by support)

To list all users:
UserDirAD.exe enable-debug all-users > all-users.txt 2>&1
To list all users, excluding disabled users:
UserDirAD.exe "enable-debug|enabled-users-only" all-users > all-users-enabled.txt 2>&1
To list all users with Card/IDs from the pager field:
UserDirAD.exe "enable-debug|card-id-field=pager" all-users > all-users-pager.txt 2>&1
To list all groups:
UserDirAD.exe enable-debug all-groups > all-groups.txt 2>&1
To list members of a group (usernames only):
UserDirAD.exe enable-debug group-member-names "your-group" > your-group.txt 2>&1
To list members of a group (full details):
UserDirAD.exe enable-debug group-members "your-group" > your-group.txt 2>&1
To list details of a single user:
echo yourusername | UserDirAD.exe enable-debug get-user-details > details.txt 2>&1
echo yourusername > username.txt
UserDirAD.exe enable-debug get-user-details < username.txt > details.txt 2>&1
To check one user is in one group:
UserDirAD.exe enable-debug is-user-in-group "username" "your-group" > isuseringroup.txt 2>&1
Multiple domains can be queried by adding the domains option, e.g.:
UserDirAD.exe "enable-debug|;" all-users > multi-domain-all-users.txt 2>&1
UserDirAD.exe "enable-debug|;" all-groups > multi-domain-all-groups.txt 2>&1

4. Wait until the UserDirAD.exe process exits - use Task Manager to view the process list. It may take a few minutes to run on large networks.

5. Email the generated file (e.g. all-users.txt and/or all-groups.txt) to the PaperCut developers.

Note: if the files are large, please place in a zip or equivalent archive before sending.

Categories: Domains / Directories, Troubleshooting, Debugging

Keywords: debug ad


Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.

Article last modified on October 21, 2016, at 08:15 PM
Printable View   |   Article History   |   Edit Article