Grouping tool – KB3003
The Group Reporting Interface facilitates a flexible method to define groups of users based on the active directory database of the organization, and query the OpenLM server to get license usage reports for these groups.
The Group Reporting Interface serves as an extension to the groups and projects capabilities on the “Active Directory” tab in the OpenLM server configuration tool. It demonstrates enhanced flexibility, and usage history logging.
Configuring the Group Reporting Interface
Server Settings Configuration
Open the OpenLM Grouping Tool application, follow this path: Windows Start → All Programs → OpenLM → OpenLM Grouping Tool
1. Select the Settings tab
2. Type in the OpenLM Server; Enter either its IP or Host Name
3. Type in the OpenLM Server Port. This port number is the same as the User interface http server port set in the OpenLM Server Configuration tool under the Port Settings tab. Its default value is 7014
4. Click Save to compile the new settings
1. Throughout the OpenLM Grouping Tool, the user may click the Cancel link in order to return to the previously selected window. Specifically in the Settings window, clicking Cancel would lead the user back to the OpenLM Grouping Tool main window.
2. Click the Check Connectivity link in order to perform a connectivity test with the OpenLM server.
Active Directory Domains Settings
1. Click the Domains tab.
2. Click Add, and type in the available Active Directory domains in the organization.
3. Click Connect to test and save the added connection.
Domains may also be edited by clicking the Edit tab. In such a case, the Domain window will reappear for editing:
Defining Groups– Organizational Units
This tab enables the user to connect to an Active Directory and to define groups of users. The usage report produced from the tool will be based on these groups. In order to add a group of users, go through the following action list:
1. Select the Define Groups tab, and click Add. The New Group dialog window appears.
2. Provide a name to the new group in the pink background text box.
3. Select a criterion for the required filtered selection of the organization’s data, e.g.: “From Organizational Unit”.
4. Select a Domain name from the Domain drop down list. If no such domain exists, click the green + symbol adjacent to the Domain drop down list. The New Domain Connection window appears, and the user is prompted to present a new domain(see further below).
5. Click Refresh in the Filtered Users area. The users that fit the filter conditions are shown.
6. Filters may be applied to this pool of users. These filters use AND logic, i.e. – all conditions must comply in order for a user to pass. In order to create an OR condition, click any criteria again (e.g. “From Organizational Unit”). Another frame would consequently open, to apply further OR logic. See the screenshot below for clarification.
8. Click Save, in order to save the new group.
Defining Groups– By Security Groups and By Name
The Grouping tool’s groups can also be defined in a very similar manner by relating to the Active directory’s Security groups or named users. The following images demonstrate this:
Click the Define Groups tab in order to see a summary of the saved groups:
Setting a New Domain
As stated above in Defining Groups-Organizational Units section (see item #4), the user may require to add a new group domain. In order to do so, click the green + symbol adjacent to the Domain drop down list. The New Domain Connection form appears.
1. Type in the domain name in the upper Domain Name text box (e.g.: olm.openlm.com).
2. Type in the Controller (DC) number (e.g.: 18.104.22.168)
3. Select whether to use a Windows Identity, or manually insert Custom Credentials. If the latter is chosen, provide a User name and Password in the designated text boxes.
The Group reporting Interface tool queries the OpenLM Server for the total license usage of all the users in the predefined groups. This report can only be obtained after configuring Settings, Domains and Groups, as elaborated above.
In order to obtain a report of the license usage query, follow these steps:
1. Click the Run Query tab.
2. Select the date interval for the query occurrence.
3. Check the required groups check boxes.
4. Click Server, Vendor, and/or Feature in order to see those items in the report.
5. Click the Run to process the query.
The query’s output is a summary report of the total license usage for each of the selected groups.