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

Host Options

These settings correspond to the Host Options section of the License Fulfillment Service Configuration Settings page in System > Configure.

Embedded Devices: Host Option Configurations

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”.

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:

Feature Name
Feature Version
Vendor String
Notice
Serial Number
Expiration Date
Issuer
Version Date

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.

Retain Non-Printing Characters in Device ID and Alias

Selected or unselected

When selected, FlexNet Operations does not remove non-printing characters (if used) from the “Device ID” and “Alias” fields in the capability request. As a side effect, the Devices page will not load as expected.

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 an empty string (for example, the device name Test^BName is saved as TestName).

The following control characters are invalid: ^B, ^D, ^E, ^G, ^N, ^O, ^P, ^Q, ^R, ^S, ^T, ^U, ^W, ^X, ^Y, ^[, ^\, ^]

Important:When an invalid character is used in the “Device ID” or “Alias” field and subsequently removed by FlexNet Operations, the license will not be processed by the FlexNet Embedded toolkit.

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.

Capability Request Handling

These settings correspond to the Capability Request Handling section of the License Fulfillment Service Configuration page in System > Configure.

Embedded Devices: Capability Request Handling Configurations

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
Call-out

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.

License Generation

These settings correspond to the License Generation section of the License Fulfillment Service Configuration page in System > Configure.

Embedded Devices: License Generation Configurations

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.

History Logging

These settings correspond to the History Logging section of the License Fulfillment Service Configuration page in System > Configure.

Embedded Devices: History Logging Configurations

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,
Information,
Error

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