Manually Overriding the Group List
Last modified on 14 July 2014 09:50 AM
Larger sites can have an enormous number of groups, for example, one PaperCut site has over 250,000 groups! When there are so many groups, the PaperCut window for choosing which groups to add to PaperCut can take a very long time to retrieve the information from the Active Directory and can actually time out. This can make selecting groups to add to PaperCut using the application web interface slow or unusable.
To work around this problem, there are two configuration options.
Option 1 - AD Group Organizational Unit Filter
If you are using Active Directory, you can set the config key
Few examples are listed below:
yourdomain.com/Import OU/Sub Import OU yourdomain.com/Users
Option 2 - Manually list the set of groups
To work around this problem, there is a configuration setting that can be made where one can manually list the set of groups. Once this configuration is set, PaperCut will no longer query Active Directory, LDAP, etc. to retrieve the list of groups but will rather use the list specified in the configuration settings to populate the Available Groups window.
To enable this work-around do the following:
Now you can test this setting out:
The available list of Groups should now have your list from above: e.g.
Important: If you have groups already entered in the interface, make sure they appear in your list. This key overrides/replaces any of your existing groups settings.
AD Organizational Unit Name Format
When entering a “group” override list, you may also use Active Directory Org Units. PaperCut expects the Org Unit names in a particular format as follows:
The name must be prefixed with the with OU: which indicates to PaperCut that this is an AD Org Unit and not a normal group. Some examples include:
OU:yourdomain.com/Users OU:anotherdomain.com/Staff OU:domain.com/DivisionA/Staff
Group List Override Greater Than 1000 Characters
To create a list of groups larger than the maximum configuration key size of 1,000 characters, additional configuration keys can be added for the “group-list-override”. Each new key created in the format below can store an additional one thousand characters.