Policy Server Administration Guide › Policy Server Tools › How to Count the Users in your SOA Security Manager Environment › Determine the Number of Users Associated with SOA Security Manager Policies

Determine the Number of Users Associated with SOA Security Manager Policies

To comply with the SOA Security Manager licensing terms, you can determine how many users in your organization are associated with SOA Security Manager policies.

Note: If you do not have write access to the SOA Security Manager 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.