Administration – Denials Collection Filter GUI
License denial information is presented in the OpenLM EasyAdmin web interface in the Denials report screen ([Start] > [Reports] > [Denials]). Individual organizations have reason to exclude certain denials from reports in order to handle data more efficiently. The OpenLM Denials Collection Filter allows user organizations to create rules that avoid collection of specific denial records so that those records will not be included in the database or reports.
This setup is achieved in the Denials administration screen in EasyAdmin ([Start] > [Administration] > [Denials] see Figure 1). Denials Settings and Excluded Denials panels affect the denial data that is collected.
Figure 1: The Denials Administration screen in EasyAdmin.
This document covers the following:
Please also see the Monitoring License Denials document for additional information on setup of denials.
The two settings on the Denials Settings panel of the Denials screen affect what denial records are stored. After being denied a software license, a user may request it again repeatedly, or perhaps be granted a license from another license server. OpenLM is capable of filtering out such license requests to show only cases in which the user was ultimately denied a license. These are referred to as “True” denials.
When checked, Track True Denials Only will exclude all false denials from different license pools from being registered in the OpenLM system. This setting acts as a global option, impacting the Denials report. If it has been checked during the time period that a Denials report has been generated for, checking the Track True Denials Only box in the Denials report window will have no effect because the false denials would have not been recorded.
The Tolerance Interval (“License consumption on different server tolerance interval”) is a span of time in seconds where a denial is considered as false if any successful license pull occurs on a different server than the initial request.
A denial record will not be stored and included in reports when the record matches the License Server and either the Major Error Code or Error Message value entered. If no Major Error Code or Error Message value is entered, all records will be recorded (records are not excluded based on License Server alone).
- Determine the Error Message Code(s) and/or Error Message(s) which should be excluded from denials collections. These can be found in completed reports, database queries or license manager documentation.
- Open EasyAdmin Denials administration screen ([Start] > [Administration] > [Denials]).
- Click the [+Add] button at the bottom of the License Servers panel (See Figure 2). This will create a new row in the panel and indicate the required fields.
Figure 2: A new row inserted into the License Servers panel via the [+Add] button.
- Click the down arrow to the right of the Name field. This will reveal a list of choices for configured servers as well as a selection for [All Servers]. Choose an option from drop the list by clicking on it.
- Press [Return/Enter] or tab-off the Name field. The Type field will automatically populate based on the configuration of the license server. The [+Add] button in the Denials Data panel will become available. [NOTE: The Type will not populate when selecting [All Servers].]
- Click the [+Add] button in the Denials Data panel, This will create a new row in the panel.
- Enter a Major Error Code and/or Error Message in the new row. [NOTE: These should be ‘Major Error Codes’ only. ‘Minor Error Codes’ were not meant to be used for filtering and will not yield correct results.]
- Press [Return/Enter] to commit the change for the field.
- Repeat Step #6 to Step #8 to add additional codes for that server.
- Repeat Step #3 to Step #9 to add additional servers and their error codes.
- Click the [Save] button to commit the changes (see Figure 3).
Figure 3: Click [Save] to commit the changes.
This completes the setup for Excluded Denials. The next section allows users to test the setup to be sure it is working as planned.
It is possible to check that the denials are working by running reports with restricted parameters that reflect the newly enacted rules
- Open EasyAdmin from the Windows Start menu.
- Navigate to Denials: [Start] > [Reports] > [Denials].
- Input the Server Name and a Denial Error Message added to the Excluded Denials panel as in the previous section of the document.
- Change the Start Time (e.g., current DD/MM/YYYY and HH:MM) to limit the report query to a period after the Exclude Denials settings were saved.
- Click [Apply] to see the report result (see Figure 4).
Figure 4: The report result should show “No Results Found.”
- If the Denials chart displays results, please contact OpenLM support (email@example.com).
- [Optional] Run the report for a broader period where you will expect that the same denial records will have been recorded. So long as the records appear in the report for the term before the rule was put in place, the setup is functioning as expected.