Create product packages
You can create product packages in 10Duke SysAdmin.
Before you start
-
Make sure you have created a license model.
-
You need at least one licensed item to create a product package.
-
You can create simple licensed items with just a name and description while you’re creating the product package.
-
If you want to use, for example, aggregated licensed items, create all the licensed items needed from the licensed item table.
-
Step 1: Create a product package
-
In the left sidebar, go to PRODUCT CONFIGURATION > Product packages.
-
Select Actions > Create. A dialog opens.
-
In Name, define a name for the product package. The name must be unique in the system.
-
In Description (optional), write a short description.
-
In Type (optional), select a type that you can use to categorize and filter product packages.
This field is only metadata for administrative purposes, it’s not used by the system.
Select a type:
-
Default: You would typically use this for standard or generic products.
-
Mono: You would typically use this for product packages with a single product.
-
Bundle: You would typically use this for a group of products that you sell as a single unit with one price.
-
Define a custom type by entering the name in the field.
-
-
In License Model, select a license model to control this product package’s licenses.
-
Click Save to create the product package.
Select the new product package in the table: on the Details tab that opens below, the Id field shows the unique ID of the product package. This product package ID must be included in the request path when calling some of the 10Duke API endpoints.
By default, a new product package is active and valid indefinitely starting from the current date.
To change this:
-
Click the product package in the table. Its details open below the table.
-
Go to the Details tab:
-
To deactivate the product package, disable the Active toggle.
You can only grant licenses with an active product package.
-
To change the validity time:
-
Valid from: Define the date when the product package validity starts (at the start of the day in UTC time). Use the format YYYY-MM-DD.
-
Valid until (optional): Define the date when the product package validity ends (at the start of the day in UTC time). Use the format YYYY-MM-DD.
You can only grant licenses while the product package is valid.
-
-
-
Click Save.
Step 2: Add the licensed items to the package
Next, add the licensed items to the product package:
-
Go to the Licensed Items tab.
-
Add new or existing licensed items:
-
To add existing licensed items, select Actions > Add Item(s) to product. Search and select the items you want and click Save.
-
To create a new licensed item and add it to this product package, select Actions > Create a new Licensed Item. Define a name and (optionally) write a short description, and click Save.
-
To remove licensed items from the product package, select a licensed item in the table and select Actions > Remove Item(s). (This doesn’t delete the licensed item from the system.)
Step 3: Define advanced settings for licensed items
With the default settings, each licensed item will grant a seat-based license that has one seat and uses the same license model as the product package.
You can change the credit and license model for each licensed item as needed, and define optional settings such as allowed software versions:
-
On the Licensed Items tab, click the pen icon next to a licensed item.
The settings section opens below.
-
Define the advanced settings:
-
License Model: Select a license model for this licensed item. By default, a licensed item uses the same license model as the product package.
We recommend that all the license models used within a product package use the same type of credit: either seat count, use count, or use time.
If you later change the license model of the product package, you can choose whether to apply the same license model to all the licensed items in the product package as well.
-
Version range: Define the software versions that this licensed item applies to. The end user can only use the defined software versions.
You can only use this option with a custom license model that defines a version constraint.
For example, 1.0.0 - 1.0.7 allows versions within this range, and 1.0.7 or 1.0.7 - 1.0.7 only allows access to one version.
You can change the version information later per granted license if needed.
-
Display name for version range: Define a user-friendly display name for the software version information.
If defined, the display name is shown in the 10Duke OrgAdmin UI instead of the version range. You can also use the display name in any custom UIs you build.
-
Seat count: Define the number of seats included.
For example, if you’re selling a product that by default provides a certain number of seats, define the seat count here.
The minimum value is 1. If you want to grant licenses with no seats, set the value to zero. To grant unlimited seats, leave the field empty.
-
Seat reservation count: If the product package (or licensed item) uses a custom license model that requires named seats and only allows seats to be reassigned for a limited number of times, define how many seat reservations altogether can be made for this licensed item’s seats (first-time assignments or reassignments).
You do this by defining a multiplier for the license’s seat count.
As an example, let’s say you grant 10 seats when granting a license with this product package. If this multiplier is set to 2, altogether 20 seat reservations can be made for this license. Now, if every seat is assigned to a user, each seat can be reassigned one more time to some other user.
To allow unlimited seat reservations, leave the value empty or set it to zero (0). Use this option if the product package (or licensed item) uses either a floating license model or a named-seat custom license model that allows unlimited reassignments.
Only affects licenses provisioned through the REST API. Licenses granted using SysAdmin have unlimited seat reassignments.
-
Use count: Define the use count included.
The minimum value is 1. If you want to grant licenses with no use count, set the value to zero.
When you grant licenses using SysAdmin, the use count you define there overrides this value.
-
Use time: Define the use time included (in milliseconds).
The minimum value is 1. If you want to grant licenses with no use time, set the value to zero.
When you grant licenses using SysAdmin, the use count you define there overrides this value.
-
-
Click the save icon in the corner of the section.
If you want to track the seat count, use count, or use time for the licenses, and you’re using a custom license model, make sure the custom license model has tracking enabled for that credit type.
Next steps
Now you can grant licenses using the product package.
You can either use SysAdmin or the 10Duke Entitlement Management REST API.