Licenses
The Licenses node allows you to view and
The Licensing view allows you to add, edit and remove licenses, users as well as reset validation counts, generate the license audit and server usage reports. The licenses view also displays the amount of users, workflows and forms that can be created with your license. Use the server usage report to compare your license with deployed artifacts and determine whether you are within your license agreement.
Field | Description |
---|---|
Add | Add a new license. |
Edit | Edit a license, for example updating an evaluation license to a full version, or update license before expiration. |
Remove | Remove an existing license. |
Refresh | Refresh the list of available licenses. |
Reset Validation Count | Perform a reset of the validation count to "release" licenses consumed by users who should no longer consume licenses. (Used in conjunction with the Users tab) |
Audit Report | Generate a report on licensed users. |
Server Usage Report | Generate a report on usage data by month. |
- Go to the Nintex Customer Central page.
- Click the License section.
- Click the On Premises tab.
- You see all license keys currently assigned to you.
- To get a new license key, click Request K2 License.
- Select the product that you require. Select the License Type you need, then copy the System Key from the License Configuration page in the Setup Manager and specify the Server Name.
Copy the System Key to paste into the field in the Request K2 License dialog. - Click Submit. You see a confirmation message, and an email is sent to you with a temporary key that you can use to continue with the installation.
- Check your e-mail and copy the temporary license key into the License Configuration page in the Setup Manager.
- You will receive an email, within four days of your request, that contains the authorized license key for the type of environment you selected. Use the Setup Manager or Management to update the temporary license key with the authorized key.
Follow these steps to add a license to your environment. (You must request a license key using the system key to add a new license)
- Click Add on the Licenses page.
- The Add License page opens.
Field Description Notes Product The product to be licensed Select a product from the list. System Key The system key uniquely identifies the individual machine. You must provide your system key to request a license. License Key The license key for the Product to be registered. Enter the license key from the page used to request the new license or the license key returned in email by the licensing system. - Click Apply.
Follow these steps to edit a license. (You will have to obtain a license key for the system key to add a new license to your environment, or update your license before it expires)
- Select a license from the list in the Licenses view and click Edit .
- The Edit License page opens.
- Enter the new license key in the License Key field and click Apply.
Follow these steps to remove a license.
- Select a license from the list in the Licenses view and click Remove.
- On the Remove License? dialog, click OK to remove it.
- Removing all licenses from the Licenses page will cause you to be locked out of Management and an error is displayed.
To update or add a new license, see the How to Obtain and Manage License Keys KB article.
Use the refresh button when a license has been added, edited or deleted, to refresh the list of licenses in the Licenses view and display reflect recent changes.
The Reset Validation Count option allows you to extend an exceeded license after you have cleaned out the Users view in Management of users who should no longer "consume" a license. The validation count keeps track of users who have connected to the environment. Depending on the license type of the environment, when the validation count exceeds the number of users licensed, the system will prompt you to enter a validation reset key. You must contact Nintex Customer Central for a new validation key.
- Select a license in the Licenses view and click Reset Validation Count.
- The Reset Exceeded License page opens.
- Enter the validation key in the License Key field and click Apply.
The Audit Report allows you to generate a report of active and inactive users. An active user is a person who has opened a connection to the product. You must have Administrator rights to generate the report.
- Go to the Management site and use the following path:
Management > Licenses - Click Audit Report.
- The License Audit Options page opens.
Field Description Notes Sort Field Allows you to sort by user name, status, or last access date of the user Select a field from the list Sort Direction Sort by either ascending or descending order Display User Names? Displays user names in the report Uncheck this option if you do not want user names shown in the report Display License Details? Displays license details in the report Uncheck this option if you do not want license details shown in the report - Click OK.
-
Open the PDF by clicking the link or save it for later use.
- The report, by default, displays your license details and licensed users. All licensed products that are active within the environment are displayed. Each product will have a License Type and Expiration Date.
The License Details section displays license information by License Type and Expiration Date. A header graph shows a user count of licensed and exceeded users. The green section displays licensed users and red the section displays users that have exceeded the user license.- License Type: Displays the type of license associated with a specific product.
- Expiration: Displays the expiry date of a specific license.
- Objects: If the license type is subscription-based the number of objects (SmartObjects, forms, views and workflows) that have been created is displayed.
- Users: If the license type is user-based the number of licensed users is displayed.
The Licensed Users section displays a header graph with the number of active and inactive users followed by a list with the following columns:- User: Displays the user's full names or GUID ID depending on whether the Display User Names? option was selected in the License Report Options page.
- Last Logged In: Displays the date the user last logged in to the product. This Last Logged In column can help you determine whether users have been inactive for periods of time. You can remove inactive users to free up user licenses.
- Active: Displays active users with "Yes" and inactive users with "No".
Active users are users who have recently logged in and their credentials cached in the Security Credential Cache. Typically, these are users who are actively working with product applications.
Inactive users are users that were removed from the Users view in Management. Typically, these are users who have not logged in for some time or whose user accounts may have expired or been deleted in Active Directory. To update the list of users consuming your license, you have to manually remove them from the Users view.Only Active users are included in the license allocation logic.Take care when removing users from the Users list as this may prevent a user from accessing the product if all licenses are allocated.
- Edit the K2HostServer.exe.config file. The file can be found here:
[INSTALLDIR]\K2\Host Server\Bin - Under the AppSettings section add:
CopyAppSettings configuration
<add key="LicenseExpiryCheckHour" value="Enter 24 hour value here, like 14" />
Example:
In the example above, the check is done daily at 15h00. The value must be a 24 hour value, where 0=midnight. - Restart the K2 service.
- Request a new license from your product representative or from the License Key page on Nintex Customer Portal site. See Request a license for more information.
- Update your license using the Setup Manager or Management.
- You must provide the system key when requesting a new license. Take care when copying the key, ensuring that no character is missed or extra space (treated as a character) is added to the copied string. If an incorrect digit is supplied or additional spaces are included, the system and license keys will be invalid.
- The system key is found from the configuration manager, or from the Licenses node of the Management site.
- Adding, editing or deleting a License requires a restart of the K2 service. In a farm environment, you can use the management site to configure the license once for the environment, but you will then need to restart the K2 service on each server within the farm environment to apply the licensing changes.
- License keys can be obtained from the customer and partner portal at Nintex Customer Central portal.
- Keep backup copies of your license keys before making changes to your server's license.
- If you are locked out of Management due to a deleted or expired license, you can use the License Configuration page in the Setup Manager to update your license or contact Nintex Customer Central portal for assistance. Also see the article How to obtain and manage license keys for more information.
The Users view displays users who's credentials are cached (users who have connected to the product). From this page you are able to remove a user from the list. Use the Audit Report feature to see which users are active and consuming your license.
Field | Description |
---|---|
Remove | Remove a selected user from the Users list. |
Refresh | Refresh the Users list, when users have been removed. |
Audit Report | Generate a report on licensed users. |
Selected Filter | Select a default or custom filter to applied to the Users list. |
Quick Search | Quick search using the default fields. |
User | Displays a list of all user names. |
State |
Users actively consuming your license. |
Last Access Date | The last date the user was active on the environment. To reduce the number of users consuming your license, you can remove users who have not logged in for some time or whose user accounts may have expired or been deleted in Take care when removing users from the Users list as this may prevent a user from accessing Nintex K2 if all licenses are allocated. |
This option allows you to remove any users from your environment. This frees up licenses for other users.
Follow these steps to remove a user from the Users list.
- Search or select a user from the Users list for removal. Click Remove.
- On the Remove Licensed User dialog click OK to confirm that you want to remove the user.
The Server Usage report allows you to view the number of artifacts, such as workflow definitions, process instances, activity instances, event instances, SmartObjects, forms and views deployed in your environment. The purpose of this report is to compare this number with your license agreement. You can use the license audit report and the server usage report to determine if you are compliant with your license agreement.
Field | Description |
---|---|
Export Data button | Click the Export Data button to generate a PDF of the report |
Refresh | Refreshes the report |
Month | Displays the month of usage data |
Workflow Definitions | Displays the number of total workflow definitions |
Process Instances | Displays the number of process instances deployed |
Activity Instances | Displays the number of activity instances deployed |
Event Instances | Displays the number of event instances deployed |
SmartObjects | Displays the number of SmartObjects deployed |
Forms | Displays the number of forms deployed |
Views | Displays the number of views deployed |
- Click Export Data.
- Open the PDF report by clicking the link or save the PDF report for later use.
- The report opens.
- All data displayed begins when you first activated your license
- The data is also displayed in a cumulative format by month, allowing you to see how many new artifacts were deployed in that month. For example, let's say that in a previous month, 300 SmartObjects were deployed, and in the current month the count of SmartObjects deployed is 310. This means that 10 new SmartObjects were deployed this month.
- Copying a SmartObject adds to the count of deployed SmartObjects.