The readership command line utility allows you to monitor and maintain shared folder data which is held in the folder.db, peruser.db, and lright.db files. folder.db has a record for each folder that holds a copy of the ACLs. The peruser.db has an entry per user and mailbox that lists the various flags settings and the last date the user accessed any folders. The lright.db has a list of all the users and the shared folders for which they have lookup rights.
The readership command line utility takes the following options:
Table 18–5 readership Options
Options |
Description |
---|---|
-d days |
Returns a report, per shared folder, of the number of users who have selected the folder within the specified days. |
-p months |
Removes data from the peruser.db for those users who have not selected their shared folders within the specified months. |
-l |
List the data in lright.db. |
-s folder_identifier_rights |
Set access rights for the specified folder. This updates the lright.db as well as the folder.db. |
Using the various options, you can perform the following functions:
To find out how many users are actively accessing shared folders, issue the command:
readership -d days
where days is the number of days to check. Note that this option returns the number of active users, not a list of the active users.
Example: To find out the number of users who have selected shared folders within the last 30 days, issue the following command:
readership -d 30
To list users and the shared folders to which they have access, issue the command:
readership -l
Example output:
$ readership -l group=lee-staff@siroe.com: user/user2/lee-staff richb: user/golf user/user10/Drafts user/user2/lee-staff user/user10/Trash han1: user/public+hurling@siroe.com user/golf gregk: user/public+hurling@siroe.com user/heaving user/tennis
If you want to remove inactive users (those who have not accessed shared folders in a specified time period) issue the command:
readership -p months
where months is the number of months to check for.
Example: Remove users who have not accessed shared folders for the past six months:
readership -p 6
You can assign access rights to a new public folder, or change access rights on a current public folder.
For an example of how to set access rights with this command, see To Set or Change a Shared Folder’s Access Control Rights