Policy Server Guides › Policy Server Administration Guide › Policy Server Tools › XPSCounter

XPSCounter

To comply with the terms of your CA SiteMinder® license, you can count the number of users in your CA SiteMinder® environment. The following process describes how to configure your directories and count the CA SiteMinder® users stored within them:

1. Make the following changes to each user directory you want to count:

   Note: For more information, see the CA SiteMinder® Policy Server Configuration Guide.

   • Require the use of Administrator Credentials by entering the user name and password of the directory administrator in the Administrative UI.
   • Define a Universal ID and other user attribute mappings using the Administrative UI.
2. For Microsoft Active Directory user stores, map the inetOrgPerson attribute using the Administrative UI.
3. Determine the number of users associated with CA SiteMinder® policies.

Map the Active Directory inetOrgPerson Attribute

If your CA SiteMinder® user stores are on Microsoft Active Directory servers, map the inetOrgPerson in each server before counting the CA SiteMinder® users.

Follow these steps:

1. Log in to the Administrative UI.
2. Click Infrastructure, Directory.
3. Click User Directories.
4. Search for the user directory you want and click the directory name.
5. Click Modify.
6. Click Create in the Attribute Mapping List section.
7. Select the option to create an object and click OK.
8. Type the following name:

   inetOrgPerson

9. Type the following description:

   Custom Mapping to Count Active Directory Users (with XPSCounter)

10. Do the following in the Properties section:
    1. Be sure that the Alias option is selected.
    2. Type the following definition:

       User

11. Click OK.
12. Click Submit.

    The inetOrgPerson attribute is mapped.

Determine the Number of Users Associated with CA SiteMinder® Policies

To comply with the CA SiteMinder® licensing terms, you can determine how many users in your organization are associated with CA SiteMinder® policies.

Note: If you do not have write access to the CA SiteMinder® binary files (XPS.dll, libXPS.so, libXPS.sl), an Administrator must grant you permission to use the related XPS command line tools using the Administrative UI or the XPSSecurity tool.

To determine the number of users

1. Open a command window on the Policy Server, and then enter the following command:

   XPSCounter
   

   The tool starts and displays the name of the log file for this session, and the License Parameters menu opens.

2. Enter 1.

   The Parameter menu appears.

3. Enter C.

   The Counter menu appears.

4. Enter I.
5. Enter ? to search for a user directory XID. Only those user directories that are defined in your policy store appear in the list.
6. Enter the number of the directory that contains the users you want to count.

   Note: This tool counts the number of user objects in each directory that you specify. It does not account for the same user object being listed in multiple directories or multiple user objects for the same user in a directory. You must consider this when interpreting the results provided by this tool.

7. (Optional) Enter a comment to describe the results.

   The users are counted and a confirmation message appears.

8. (Optional) Repeat Steps 5 through 8 to count the users in another directory.
9. Enter V.

   The following information appears for each directory counted:

   XID

   Displays the unique identifier for the specified user directory.

   Example: CA.SM::UserDirectory@0e-50ea30f0-b5c0-450c-a135-1e317dd25f11

   Name

   Displays the name of the specified user directory (as defined in the Administrative UI).

   : count

   Displays the most-recent user count of the specified user directory. You do not have to delete any previous values stored in the counter because this value is updated automatically every time the counter is run.

   Example: : 23

   Total

   Displays the total of number of users from all of the user directories you counted. For example, if you counted number of users for two different directories, and each directory has 23 users, the total shown will be 46.