Configuring Embedded Devices Settings
A user must be assigned a role with the View and Manage Configurations permission to modify configuration settings for Embedded Devices through the Producer Portal.
Note:Before changing any configuration settings in a working FlexNet Operations instance, it is advisable to export the working configuration settings. If there is a problem with the new settings, you have a backup of working settings to restore.
To configure embedded devices settings
1. | Click System > Configure. |
2. | Click Embedded Devices to open the configuration page. |
3. | View or change the values of the settings below. |
4. | Click Save Configs. |
The Producer Portal saves your configuration changes.
Settings appear in the following groups:
• | Host Options |
• | Capability Request Handling |
• | License Generation |
• | History Logging |
These settings correspond to the Host Options section of the License Fulfillment Service Configuration Settings page in System > Configure > Embedded Devices.
Name |
Possible Values |
Description |
||||||||||||||||||||||||
Default Client Host Type |
FLX_CLIENT or specify |
The default host type FlexNet Operations uses when creating an unknown client device from a request, if the request does not specify a host type. This value is also used when claiming a client device from the End-User Portal, if not supplied by the request, the portal UI, or a call-out. Default: FLX_CLIENT. |
||||||||||||||||||||||||
Default Server Host Type |
FLX_SERVER or specify |
The default host type FlexNet Operations uses when creating an unknown server device from a request, if the request does not specify a host type. This value is also used when claiming a server device from the End-User Portal, if not supplied by the request, the portal UI, or a call-out. Default: FLX_SERVER. |
||||||||||||||||||||||||
Excluded Client Host ID Types |
Specify |
Use this option to select which of the normally supported host ID types should be excluded from the choices presented when editing the allowed ID types for a host type that supports clients. |
||||||||||||||||||||||||
Excluded Server Host ID Types |
Specify |
Use this option to select which of the normally supported host ID types should be excluded from the choices presented when editing the allowed ID types for a host type that supports servers. |
||||||||||||||||||||||||
Entitlement Map Overlap |
Value in days |
Maximum elapsed time, in days, that an entitlement mapping can exceed the limits specified by any applicable host series definitions. |
||||||||||||||||||||||||
Allow Duration License Decrease |
Selected or unselected |
Select to allow licenses with duration based features to have their copies reduced. Normally, licenses using durations only allow increasing the number of copies. |
||||||||||||||||||||||||
Allow Duration License Decrease for Producer |
Selected or unselected |
Select to allow licenses with duration based features to have their copies reduced by a producer. Normally, licenses using durations only allow increasing the number of copies. |
||||||||||||||||||||||||
Consume Copies When Mapping |
Selected or unselected |
Immediately deduct the number of copies from the appropriate line item when a request to increase a host’s license copies is processed. If this option is not selected, the additional copies are not deducted until the license is generated. |
||||||||||||||||||||||||
Clone Detection |
Selected or unselected |
Select to record the clone suspect events in the back office. |
||||||||||||||||||||||||
Limit Binding Break Repairs for License Server |
Selected or unselected |
Select to limit the number of times a local license server can repair a binding break. If selected, configure the number of allowed binding break repairs in Maximum Number of Binding Break Repairs Allowed for License Server. If unselected, unlimited binding break repairs are permitted. Default: Unselected. Note:This configuration option works in conjunction with the binding.break.policy in the producer-settings.xml file for the local license server. For more information, refer to the FlexNet Embedded License Server Producer Guide, section “Binding-Break Detection with Grace Period”. |
||||||||||||||||||||||||
Retain mapping of the parent activation to the devices when mapping a child activation |
Selected or unselected |
When selected, the parent license remains mapped to the device even when a child license (for a renewal, upgrade or upsell) is applied. This means that the parent license continues to be available after the child line item has been mapped. Selecting this option allows producers to issue renewal licenses well before the parent license expires, and it enables customers to apply the renewal license early. Default: Unselected Important:Producers are responsible for explicitly unmapping unused/expired activations. |
||||||||||||||||||||||||
Maximum Number of Binding Break Repairs Allowed for License Server |
Specify |
Available if the option Limit Binding Break Repairs for License Server is selected. Sets the maximum number of times the local license server is allowed to repair a binding break. If set to 0, no binding break repairs are allowed. The local license server will cease to serve licenses if the number of binding break repairs exceeds the maximum number of allowed repairs, and no further repairs are allowed. Default: 3 |
||||||||||||||||||||||||
Use Activation start date without compensating time zone |
Selected or unselected |
When a device is activated and the activation date is equal to the current date in Pacific Standard Time (PST), the start date calculation logic applies a -1 day rollback. This is to compensate for timezones that are ahead of the database server time in PST. Select this option if you do not want to apply a -1 day rollback to the start date. Default: Unselected. Important:Selecting this option affects the start date of a license. Consult Revenera support before selecting it. For example, without the -1 day rollback, a customer who activates a license on 27-Jan-2023 06:00pm PST, which is equivalent to 28-Jan-2023 2:00am GMT, can only start using the license the following day (27-Jan-2023 12:00am PST). |
||||||||||||||||||||||||
Allow Removing or Reducing Metered Features From a License Server |
Selected or unselected |
When selected, allows the removal or reduction of metered features from a license server instance in the FlexNet Cloud Licensing Service. Default: Unselected. |
||||||||||||||||||||||||
Support Multiple License Servers |
Selected or unselected |
Select to allow served clients to have multiple parent license server instances concurrently. If selected, the Producer Portal and the End-User Portal show the multiple parent servers of served clients. Default: Unselected. |
||||||||||||||||||||||||
Consolidate Licenses |
Selected or unselected |
When selected, FlexNet Operations consolidates the licenses that contain multiple line items for the same feature if the following entities are identical for all line items:
Selecting this option may help improve the local license server’s performance. Default: Unselected. Note:When using the option Consolidate Licenses, the option Enable feature count aggregation (under System > Configure > FlexNet Operations > Embedded Device Settings) must be unselected. |
||||||||||||||||||||||||
Use UTC timezone for license issue date |
Selected or unselected |
When selected, the issue date of a license for a standalone device or license server is displayed in Coordinated Universal Time (UTC). If this option is unselected, the issue date that is returned by the /features endpoint is calculated in Pacific Time. In certain scenarios, this can result in mismatched dates for issued and receivedTime in the /features endpoint response. Default: Unselected. |
||||||||||||||||||||||||
Retain Non-Printing Characters in Device ID and Alias |
Selected or unselected |
When this option is unselected, invalid characters in the “Device ID” and “Alias” fields in the capability request (such as ASCII control characters) are replaced with their respective hexadecimal values. For example, the device name Test^BName will be saved as TestName. The following control characters are invalid: ^B, ^D, ^E, ^G, ^N, ^O, ^P, ^Q, ^R, ^S, ^T, ^U, ^W, ^X, ^Y, ^[, ^\, ^], ^F, ^C, ^^, ^A, ^V, ^_ Examples for Control Characters and their referenced hexadecimal values:
Important:When an invalid character is used in the “Device ID” or “Alias” field and subsequently replaced with its hexadecimal value, the license will not be processed by the FlexNet Embedded toolkit. When selected, FlexNet Operations does not replace non-printing characters (if used) in the “Device ID” and “Alias” fields in the capability request. As a side effect, the Devices page will not load as expected. Default: Unselected. |
||||||||||||||||||||||||
Allow expired line items to be mapped to devices or servers |
Selected or unselected |
Select to allow expired activation IDs to be mapped to devices in the License Fulfillment Service. Important:This configuration option only works in conjunction with the option Allow mapping of expired entitlements (under System > Configure > FlexNet Operations > Embedded Device Settings). To allow mapping of expired activation IDs to devices, both options must be selected. For more information, see Behavior When Mapping Expired Line Items. |
These settings correspond to the Capability Request Handling section of the License Fulfillment Service Configuration page in System > Configure > Embedded Devices.
Name |
Possible Values |
Description |
Device Response Lifetime |
Time value in seconds, minutes, hours, days, or weeks |
Lifetime for device responses generated when a device request is received. You can specify the value to explicitly identify the time unit as seconds, minutes, hours, days, or weeks with a suffix of s, m, h, d, or w. If no suffix is used, the value is assumed to be in seconds. If the value is zero (0), the responses never expire. |
Allow Adding Unknown Hosts |
Selected or unselected |
Select to allow an unknown host to be added as a result of processing a capability request. An unknown server is added only if the capability request contains a valid activation ID. (To add a server when the request contains no activation ID, select Allow Server Without Activation IDs.) |
Allow Server Without Activation IDs |
Selected or unselected |
Select to allow unknown servers to be added as a result of processing a capability request, even if the request does not contain any activation IDs. |
Prohibit Virtual Hosts |
Selected or unselected |
Select to prohibit capability requests for hosts running on virtual machines. If this option is not selected (default), capability requests are served regardless of the machine type. |
Capability Request Call-out |
URL or classname |
The base URL of a REST server or name of a class that implements the com.flexnet.lm.bot.service.CapabilityRequestCallOut interface. If specified, it is called to customize handling of capability requests and generated responses. |
Capability Request Finalize Host Call-out |
Selected or unselected |
Select to invoke call-out just before creating an unknown host. Additional attributes can be defined before it is persisted. It can also be used to cancel creation of the new host instance. |
Capability Request Access Check Call-out |
Selected or unselected |
Select to invoke call-out after (optionally) creating an unknown host, before proceeding with processing an off-line request. The return value can be used to deny access to the targeted host. |
Capability Request Finalize Response |
Selected or unselected |
Select to invoke call-out after an incoming host request has been validated, but before the capability response has been generated. |
Call-out Includes Host Details |
Selected or unselected |
Select to send details about the target host in the request body. Otherwise, just send the host id and id type, host class, host type, and alias. |
Call-out Includes Add-on Details |
Selected or unselected |
Select to send add-on details in the request body. Otherwise, just send list of activation IDs. |
These settings correspond to the License Generation section of the License Fulfillment Service Configuration page in System > Configure > Embedded Devices.
Name |
Possible Values |
Description |
Default Borrow Interval |
Time value in seconds, minutes, hours, days, or weeks |
The default borrow interval for features that do not specify an override. You can specify the value to explicitly identify the time unit as seconds, minutes, hours, days, or weeks with a suffix of s, m, h, d, or w. If no suffix is used, the value is assumed to be in seconds. If the value is zero (0), the interval is unlimited. |
Default Renew Interval |
Percentage of borrow interval |
The default renew interval expressed as a percentage of the borrow interval, for features that do not specify an override. If set to zero (0), the renew interval is at the client discretion. |
Include Issued Date |
Selected or unselected |
If selected, include the Issued Date attribute in generated licenses for devices. Default: Selected. |
Include Start Date |
Selected or unselected |
If selected, include the Start Date attribute in generated licenses for devices. Default: Selected. |
Default Metered Undo Interval |
Time value in seconds, minutes, hours, days, or weeks |
The default value of the undo interval for metered features that do not explicitly define an undo interval and are not reusable. You can specify the value to explicitly identify the time unit as seconds, minutes, hours, days, or weeks with a suffix of s, m, h, d, or w. If no suffix is used, the value is assumed to be in seconds. |
Skip Confirmation |
Selected or unselected |
When selected, no confirmation capability request is required when reducing the number of copies of a license. |
Skip Confirmation for Producer |
Selected or unselected |
When selected, no confirmation capability request is required for a producer when reducing the number of copies of a license. |
Skip Confirmation for Product Line |
Selected or unselected |
When selected, no confirmation capability request is required for a producer when reducing the number of copies of a license for a specified product line. You specify the product lines for which licenses can be reduced without requiring a confirmation in the Skip Confirmation column on the Package Products | Product Lines page (available under Products > Product Lines). Default: Unselected. |
Date-based Version Format |
yyyy.MM or yyyy.MMdd |
When a feature that uses a date-based version format is created, this format is used when converting the version date to a version representation. For a date of May 15, 2018, yyyy.MM is 2018.05 and yyyy.MMdd is 2018.0515. |
Enable Multiple Signature Strengths |
Selected or unselected |
This option helps publishers using FlexNet Embedded migrate to a different signature strength. If selected, a publisher identity created using the Publisher Identity utility (pubidutil) can include one additional signature strength (in addition to the original signature strength). Publishers must then upload the updated back-office identity file (IdentityBackOffice.bin) generated by pubidutil to FlexNet Operations using the Update Identity page. Currently, only standalone devices support two signature strengths. Default: Unselected. Note:For more information about updating identity files, see Updating a Publisher Identity. For more information about the Publisher Identity utility, see the FlexNet Embedded License Server Producer Guide. |
These settings correspond to the History Logging section of the License Fulfillment Service Configuration page in System > Configure > Embedded Devices.
Name |
Possible Values |
Description |
Successful Capability in Request History |
Selected or unselected |
When selected, successful capability requests and matching responses are recorded in the request history. By default, successes are recorded only in the host history. |
Record Sync in Request History |
Selected or unselected |
When selected, sync messages and acknowledgments are recorded in the request history. By default, messages are recorded only in the host history, at debug log level. |
Write License History Events |
Selected or unselected |
When selected, individual license host history events are included in the request history for backward compatibility. Recording such events has been deprecated and replaced by adding fulfillment details in other events. |
Host History Log Level |
Debug, |
Include events in host history that are at or above the specified log level. The lowest log level is Debug; the highest is Error. |
See Also