Configuring System Settings

A user must be assigned a role with the View and Manage Configurations permission to modify configuration settings for FlexNet Operations settings 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 change FlexNet Operations-specific configuration settings through the FlexNet Operations Producer Portal

1. Click System > Configure.
2. Click FlexNet Operations to open the configuration page for FlexNet Operations-specific settings.
3. View or change the values of the settings below.
4. Click Save Configs to save changes.

The Producer Portal saves your configuration changes. Keep in mind that before certain settings are active in the Producer Portal, FlexNet Operations must be restarted.

Configuration options for FlexNet Operations appear in the following groups:

General Options
External Services Configuration
Embedded Device Settings
Renewals
Customer Growth
Updates

Required fields are indicated with an asterisk. Fields marked with the icon require that the FlexNet Platform Server be restarted for their changes to take effect.

General Options

These settings correspond to the General Options section of the FlexNet Operations configuration page in System > Configure.

FlexNet Operations: General Option Configurations

Name

Possible Values

Description

Rqd

Restart

Max Recently Used Records

4 or specify

The number of recently used items to display in the product packaging pages.

*

 

Description Max Length

15 or specify

Maximum number of characters in the description field displayed in tables.

*

 

ID Generator Classname

com.flexnet.
operations.generator.
OpsEsnGenerator
or specify

Set this parameter to the class that implements the com.flexnet.operations.publicapi.IDGenerator interface: It is used to generate entitlement IDs, activation IDs, and web register keys.

*

 

Fulfillment ID Generator Classname

com.flexnet.
operations.generator.
OpsFIDGenerator

or specify

Set this parameter to the Java class that implements com.flexnet.operations.publicapi.FulfillmentIDGenerator interface: It is used to generate fulfillment IDs and consolidated license IDs.

*

 

Host ID Validator

com.flexnet.operations.
publicapi.HostIDValidator
or specify

Set this parameter to the Java class that implements custom validations of host IDs.

 

 

Basic IP Address Host ID Validation

Selected or unselected

Permits or prohibits basic validation of IP address values by FlexNet Operations.

Default: Selected.

When selected, FlexNet Operations and the VCG validate the octet values of IP addresses according to the special host id types validation rules.

To disable IP address validation, unselect this setting and use a version 12.8.0.1 or later VCG configured to disable validation for internet host IDs. (Some minimal validation—requiring numeric values or asterisks—still occurs based on FlexNet Publisher requirements.)

 

 

License File Name

license or specify

This is the base name used to generated names for license files based on a custom license technology that is saved to disk or sent as an email attachment. These types of license files do not incorporate FlexNet capabilities. The default setting is license. If this field is left blank, the file name for a non-FlexNet license file or email attachment is license.lic.

If the file name is set by the CustomGenerator class in the GeneratorResponse object, the system uses that file name.

 

 

Allow License Headers and Trailers

Selected or unselected

Selecting this allows header and trailer text to be entered for products.

 

 

Always Display Page Count of Search Results

Selected or unselected

Determining the number of pages of search results is often time consuming. Deselect this box to prevent automatic display of the number of pages returned. This reduces the time needed to load the landing pages for Entitle Customers, Activate Licenses, and Support Licenses.

 

 

Entitlement Records per Page

Number of records

Number of records displayed on the Entitle Customers landing page. This setting overrides the Default Records Per Page setting in the user interface configuration.

Default: 10.

*

 

Use SUPERSEDE or SUPERSEDE_SIGN Keyword

 

None

Use SUPERSEDE for Upgrade

Use SUPERSEDE for Renewal

Use SUPERSEDE for upgrade and renewal

Use SUPERSEDE_SIGN for Upgrade

Use SUPERSEDE_SIGN for Renewal

Use SUPERSEDE_SIGN for upgrade and renewal

Select to use either SUPERSEDE or SUPERSEDE_SIGN for upgrade or renewal of licenses. You must carefully evaluate the risks before setting this flag. Refer to Using the SUPERSEDE and SUPERSEDE_SIGN Keywords to understand the risks.

Default: None.

Note:By default, this option is hidden and not editable. Contact Revenera support if you want to change this value.

 

 

Show Consolidate Licenses Functionality

Selected or unselected

Selecting this allows users to see functionality related to Consolidate Licenses. If you change the flag, you must log out and re-login for the changes to be effective.

 

 

Override Older Fulfillments on Host Using SUPERSEDE_SIGN Keyword

Selected or unselected

When fulfillment A is upgraded or renewed to create fulfillment B, if SUPERSEDE_SIGN keyword is enabled, licenses in fulfillment B supersede signatures in fulfillment A. If fulfillment B is upgraded or renewed to fulfillment C and this is selected, fulfillment C supersedes signatures from fulfillments A and B. Ensures that counts provided by fulfillment A are disabled even if user removes fulfillment B license from their server. However, this increases length of license line (limited to 4096 bytes).

 

 

Enable Host ID Policies

Selected or unselected

Selecting this allows host ID policies to be configured and enforced.

 

 

Number of Allowed Retries

Number of retries

For the createLicense web service only: enter an integer value greater than zero to retry the createLicense transaction if there is a failure due to concurrent modification exception.

 

 

Allow Multiple Owners

Selected or unselected

If selected, multiple users are able to map a line item, web register key, or entitlement to themselves.

 

 

Do Not Sort Results by Default

Selected or unselected

If selected, search results are not sorted by Last Modified Date on Operations landing pages.

 

 

Show Line Items with Zero Copies by Default

Selected or unselected

Configures the End-User Portal to show line items with zero copies remaining on the Activatable Items and the Manage Entitlements pages.

Default: Unselected.

 

 

Entitlement Certificate File Name

EntitlementCertificate.
html
or specify

Default file name used for the HTML entitlement certificate. The file extension should be either .html or .htm for browser display.

 

 

Email for On-Hold Fulfillments or On-Hold Entitlements

Valid email address

Enter an email address to notify when On-Hold fulfillment or On-Hold Entitlement is generated.

 

 

Send Email on Set License for On-Hold Fulfillments

Selected or unselected

Determines whether to send email to an end user while a license is set for on-hold fulfillments.

 

 

Drop Existing Supersede Sign Signatures

Selected or unselected

When selected, drops old SUPERSEDE_SIGN signatures and ensures that license length cannot exceed 4096 bytes. This feature is available in VCG 12.0 or later.

 

 

Mapped Users or Account Records in Create Account and User Page

Number of records

Number of Mapped User or Account records displayed on the Create Account and User Page. This setting overrides the default Records Per Page setting in the User Interface configuration.

*

 

Filter UMN1 Keys

One or more UMN1 values

In some rare scenarios (For example, client machines using RAID disks), the UMN1 value is not unique. In these cases, UMN1 value is being set as the model type of the client machine, rather than its disk serial number. As UMN1 is treated as a primary identifier for re-installation requests, non-unique UMN1 values can lead to problems during reinstalls, returns and rehosts. In these cases, the machine identifier (MID) is a better host identifier. This parameter can be set to a comma separated list of UMN1 values. If the trusted storage activation request contains any of these values, FlexNet Operations ignores the UMN1 value and uses the MID instead.

 

 

Add Default Comment Line in License File

Selected or unselected

For FlexNet license files containing non-ASCII characters, the first line in the license file must be a comment line. This comment line is added by default by FlexNet Operations. If this comment line is causing issues with downstream applications, deselect this setting.

 

 

Enable Product Lines for Products, Users, and Accounts

Selected or unselected

If selected, the Product Line feature is enabled for products, users, and accounts, including visibility restrictions for users and accounts.

Producers can define product lines, assign products to product lines, and link producer accounts and customer user accounts with those product lines.

When this setting is enabled, End-User Portal views are filtered to show only entitlement line items for products in product lines to which the user’s account is linked.

To enable product lines functionality without enforcing visibility restrictions, deselect this setting and check Enable Product Lines for Products, instead.

Default: Unselected.

 

 

Bulk Operation Batch Size

Number of records

The number of SQL statements to group as a batch during a bulk operation.

*

 

Bulk Operation ‘Select All Line Items’ Batch Size

Number of records

The number of entitlement line items to group as a batch.

*

 

Bulk Operation Retry

Number of attempts

Number of times to retry a bulk operation.

*

 

Bulk Operation Retry Sleep Interval

Number of seconds

The time, in seconds, to sleep before retrying a bulk operation.

*

 

Default Country for Users and Account Addresses

Unspecified or a two-letter country code (as specified by ISO 3166 guidelines)

A two-character country code that FlexNet Operations uses as the default country for users and accounts. Use Unspecified if you do not want FlexNet Operations to supply a default value.

*

 

Allow Editing of Deployed Entities

Selected or unselected

Permits some modification of product, suite, feature bundle, entitlement, and line item attributes post-deployment.

Default: Unselected.

When enabled, editing of the following elements is possible:

Products: name, version, package name, package version, feature/feature bundle list (can add to, or remove from list), and Can be used on a device? setting.
Suites: name, version, package name, package version, product list (can add to, or remove from list), and Can be used on a device? setting.
Feature bundles: name, version, and feature list (can add to, or remove from list).
Entitlements
Line items
Custom attributes for license models

Note that inactive or obsolete entities cannot be changed.

 

 

Send Email When New Entitlement Is Created After Split

Selected or unselected

Configures FlexNet Operations to send a notification email when a new entitlement is created as the result of a split. (Entitlements can be split, by publisher and partner users, on the End-User Portal.)

Default: Selected.

 

 

By Default Show Product Information in the Select Host Page

Selected or unselected

Shows product information on the Select License Host page (part of the Generate License wizard), both in the Producer Portal and in the End-User Portal. When you hide the product information FlexNet Operations still provides a link that, when clicked, shows the product information for a specific host.

Default: Selected.

 

 

Default Operator Used for Simple Search

Contains
Equals
Starts With
Ends With

Sets the default operator for simple searches in the Producer Portal.

Default: Contains.

 

 

Always Attach Entitlement Certificate in Email

Selected or unselected

Select to attach entitlement certificate in email.

 

 

Enable Product Lines for Products

Selected or unselected.

Show or hide product lines functionality for products only. No visibility restrictions for users and accounts are applied.

When this setting is selected, producers can define product lines, assign products to product lines

Requires that the configuration setting for Enable Product Lines for Products, Users, and Accounts be unselected.

Default: Selected.

 

 

Cloud License Service URL

test or specify

The URL used when auto-provisioning a Cloud Licensing Service instance during entitlement creation. Intended to be used in entitlement creation emails.

 

 

Data Extract File Location

flexnet-data\site or specify

The relative path to the location where the output (artifact files) of optional data extract jobs are stored.

For Data Extract File Location, specify a valid path on the local file system.

For more information about scheduling data extract jobs, see Administering Alerts.

 

 

Auto upgrade batch size

10 or specify

Number of line items to be processed in a single transaction during automatic product upgrade. Defaults to 10.

 

 

Highlight Latest Upgrade Line Items

Selected or unselected

By default, show only line items for the most recent version in the End‑User Portal’s List Entitlements page and Map Entitlements page. Related, older version are grouped under the most recent version when related, older versions are available.

When Highlight Latest Upgrade Line Items is unselected, the List Entitlements page and Map Entitlements page show a mixed, flat list of line items—including parent line items and older versions along with the most recent version.

Default: Selected.

 

 

Enable User Expiration

Selected or unselected

Enables an expiration date when a user no longer has access to an account. This is applicable to all users except:

Contacts
Shared login users

To disable the expiration date for all users, unselect the box. This prevents all users’ account access from expiring.

 

 

Show environment with email subject

Selected or unselected

Enables the addition of the environment in the subject of the email. If selected the name of the environment (UAT, CI, QA, etc., except PROD or DR) that triggered the email will be included in the subject line.

Default: Unselected.

 

 

Show maintenance line items custom attributes in Entitlements Page

Selected or unselected

Controls whether custom attributes for maintenance lines are visible in the Producer Portal and End-User Portal in the following locations:

on the List Entitlements and List Entitlements By Order pages
on the Maintenance Line Item Details panel

Default: Unselected (custom attributes for maintenance lines are not visible).

 

 

Apply Manage Users permission to users in shared accounts

Selected or unselected

Manages the behavior when a customer user belongs to more than one account.

If selected, a customer user logged in at the End-User Portal has Manage Users permissions (view, edit, reset password, link or remove an account) for other customer users that belong to the same account.

Default: Unselected

 

 

Verify user ID validity during password reset

Selected or unselected

If selected, the validity of the user ID is verified, and the user is only prompted to reply to a security question if they entered a valid user ID. If the entered user ID is invalid, an error is displayed.

If unselected, the behavior is the same for valid and invalid user IDs: the user is prompted to select the answer to a security question. (If the entered user ID is invalid, a random question is displayed.)

Default: Unselected

 

 

Allow used entitlement/line item state change to Inactive or Obsolete

Selected or unselected

Controls whether entitlements or line items that have been activated on a device can have their state changed to Inactive or Obsolete.

When not selected, attempting to change such an entitlement’s or line item’s state to Inactive or Obsolete triggers an error message. The state can only be changed after the entitlement or line item has been unmapped from the device.

When this configuration option is selected, an entitlement or line item that has been activated on a device can still be used until the license expires, even if the entitlement or line item has been deactivated or made obsolete.

Default: Selected.

 

 

Preserve Product Custom Attributes when changing a Product Line

Selected or unselected

Manages the behavior when a product line for a given product is changed.

If selected, all custom attributes for a given product are preserved if the product line for the product is changed.

Default: Selected.

 

 

Remove licenses from CLS when line item state is changed to Inactive/Obsolete

 

Selected or unselected

If selected, licenses mapped to CLS are removed when a line item’s state is changed to Inactive or Obsolete (using the setLineItemState SOAP request).

Requires that the configuration setting for Allow used entitlement/line item state change to Inactive or Obsolete be unselected.

Default: Unselected.

 

 

Process all line items in an Entitlement during Batch Rehost

Selected or unselected

If selected, all line items in the entitlement are included for processing during batch rehost. In scenarios where a large number of line items are associated with a single entitlement, selecting this option might significantly increase the time required for processing the batch rehost.

If unselected, only the default number of 10 line items are included for processing during batch rehost.

Default: Unselected.

 

 

Use Recaptcha validation when sending entitlement emails

Selected or unselected

If selected, entitlement emails will only be sent after re-authentication using the Google reCAPTCHA mechanism.

Requires that the configurations for Recaptcha Site key and Recaptcha Secret password be set.

In this case, the List Entitlements email preview page of the Producer Portal shows the “I’m not a robot” check box which enables the user to send an entitlement email.

Default: Unselected.

 

 

Show upgrade/upsell line items related to the license (activation ID)

Selected or unselected

Enables producers to control which line items are displayed on the Support Licenses And Maintenance page in the Producer Portal and End-User Portal.

Unselected—During an upgrade or upsell operation, the Support Licenses And Maintenance page lists all upgrade or upsell line items that belong to a specified activation ID.
Selected—During an upgrade or upsell operation, only child line items that are related to the upgraded or upsold activation ID are displayed on the Support Licenses And Maintenance page.

Default: Unselected.

 

 

External Services Configuration

These settings correspond to the External Services Configuration section of the FlexNet Operations configuration page in System > Configure.

FlexNet Operations: External Service Configurations

Name

Possible Values

Description

Rqd

Restart

Use Soap Service for VCG

Selected or unselected

Select to use the SOAP service for secure license generation, instead of the Windows VCG Service or the Linux VCG Service.

Default: Unselected.

 

 

VCG Service soap URL

Valid URL

The URL of the SOAP service hosted by the producer. FlexNet Operations must be able to access this over the internet.

 

 

VCG Service User Name

Valid user name in the format domain/username

The user name used to authenticate the SOAP service for generating the secure license.

 

 

VCG Service User Password (Confirm)

 

The password for the user name used to authenticate the SOAP service for generating the secure license.

 

 

VCG service credential in SOAP request header

 

If selected, users are authenticated using SOAP header-based authentication instead of basic http authentication.

Only available if Use Soap Service for VCG is selected.

Default: Unselected.

 

 

Embedded Device Settings

These settings correspond to the Embedded Device Settings section of the FlexNet Operations configuration page in System > Configure.

FlexNet Operations: Embedded Device Settings

Name

Possible Values

Description

Rqd

Restart

Allow Adding Backup Server for Producer

Selected or unselected

Allow or prevent adding backup servers via web services and Producer Portal.

 

 

Server Deployment Choice

Local
Cloud
Both

Select whether FlexNet Embedded server deployments can be local, cloud, or both.

 

 

Skip Account Check – for hosts (see next row for devices)

Selected or unselected

Hosts: If selected, allows a host to have line items belonging to multiple accounts.

 

 

Skip Account Check – for devices (see previous row for hosts)

Selected or unselected

Devices: Controls sharing of devices across accounts. By default, FlexNet Operations applies rules to limit the mapping of entitlements to devices based on the device owner account.

Generally, enabling Skip Account Check permits entitlements that belong to accounts other than the device owner and its sub-accounts to be mapped to a device. (See About Device Management for more information.)

Unselected (Default)

The FlexNet Embedded license generator executes the activation request when

the device is owned by the same account as activation ID
the device is owned by the parent account and the activation ID is owned by one of its child accounts

The FlexNet Embedded license generator produces an error when the activation ID is owned by the parent account and the device is owned by one of its child accounts.

Selected

The FlexNet Embedded license generator executes the activation request without regard to the account that owns the device.

 

 

Auto-provision error email recipient(s)

Valid email address

Comma-separated email IDs that receive any error emails related to auto-provisioning.

 

 

Device user option

Off (default)
On with no validation
On with validation

Select to offer the option to assign a user to a device, as well as whether the system checks the validity of the user.

 

 

Override license expiration date

Selected or unselected

If selected, allows user to shorten license expiration term.

 

 

Enable Producer User for CLS

Selected or unselected

If selected, allows a user to reset the Cloud Licensing Service producer user password for both existing and future Cloud License Server (CLS) instances. This producer password can be used to obtain Authorization tokens for all instances.

 

 

Producer User’s Password for CLS (Confirm)

Password fulfilling the requirements

The Cloud Licensing Service password must fulfill the following requirements:

8-30 characters
1 uppercase character
1 lowercase character
1 digit
1 of the following special characters:
( ^*$-+?_&=!%{}/# )
No spaces

 

 

Prepopulate quantity to add with available count in Map by Activation IDs page

Selected or unselected

Select if the Qty to add field—located on the Map by Activation IDs page in the Producer Portal and End-User Portal—should show the maximum license count that is available to the end-user.

When unselected, the Qty to add field is blank and requires the user to type in the desired license count.

Default: selected.

 

 

Update entitlement last modified date

Selected or unselected

When selected, an entitlement’s last modified date is updated together with the line item’s last modified date whenever the available license count changes for a device.

When unselected, only the line item’s last modified date changes when the available license count changes for a device.

Default: unselected.

 

 

Renewals

These settings correspond to the Renewals section of the FlexNet Operations configuration page in System > Configure. For producers who use FlexNet Operations with the FlexNet Customer Growth module, these settings determine how FlexNet Operations behaves when the Expiring Entitlements job or Expired Entitlements job runs. These settings are required for producers who use FlexNet Operations with the FlexNet Customer Growth module; otherwise, they are not used.

Note:For more information about using the Expiring Entitlements and Expired Entitlements jobs, see Administering Alerts .

FlexNet Operations: Renewal Configurations

Name

Possible Values

Description

Rqd

Restart

Renewal
Look Ahead

200 or specify.

Default: 200 days.

The number of days in the future, including the day the Expiring Entitlements job runs, to search for entitlements to include in the Renewal Reminder email message.

This value is also used as the upper limit for line items that appear on the Expiring Entitlements page in the End-User Portal. Those entitlements with expiration dates further out than the Renewal Look Ahead are excluded from the list.

Note:This setting is also used to limit the number of expired entitlements shown on pages that list expired entitlements. Entitlements that are more than 200 days (using the default setting) past their expiration date are not shown.

Tip:The Renewal Look Ahead value must be greater than the Expiring Window value.

*

 

Expiring Window

90 or specify.

Default: 90 days.

The number of days in the future, including the day the Expiring Entitlements job runs, to search for entitlements that are soon to expire.

Together with the Expiring Email Frequency, Expiring Window determines whether or not FlexNet Operations sends a Renewal Reminder email message. See More About the Expiring Entitlements Job for details.

This value and the Renewal Critical value determine the way line items are highlighted on the Expiring Entitlements page in the End-User Portal. Line items that expire in the span between the Renewal Critical setting and the Expiring Window setting are highlighted in yellow.

Tip:The Expiring Window value must be smaller than the Renewal Look Ahead value.

*

 

Expiring Email Frequency

30 or specify.

Default: 30 days.

The minimum number of days to wait before sending out the next Renewal Reminder email message to a particular account.

For example, using the default system configuration settings, FlexNet Operations limits the number of renewal reminders sent to an account to one every 30 days.

Together with the Expiring Window, Expiring Email Frequency determines whether or not FlexNet Operations sends a Renewal Reminder email message. (Renewal Reminder email messages are based on the Renewal Reminder email template.)

See More About the Expiring Entitlements Job for details.

*

 

Expired Email Frequency

30 or specify.

Default: 30 days.

The minimum number of days to wait before sending out the next expired entitlements message to a particular account.

If FlexNet Operations has sent an expired entitlements message to an account within the number of days specified, no new email messages are sent, even if newly expired entitlements are discovered when the Expired Entitlements job runs. (Expired entitlements messages are based on the Renewal Reminder for Expired Entitlements email template.)

See More About the Expired Entitlements Job for details.

*

 

Renewal Critical

30 or specify.

Default: 30 days.

Number of days from an entitlement’s expiration date to mark the entitlement as critical.

This value and the Expiring Window value determine the way line items are highlighted on the Expiring Entitlements page in the End-User Portal. Line items that expire within the number of days specified in the Renewal Critical setting are highlighted in red.

*

 

Request Renewal Notification Email

Valid email address

An email address, managed by the producer, to which an end user’s intent-to-renew messages are sent.

In the End-User Portal, the Expiring Entitlements page includes a Request button. When an end user selects expiring entitlements and clicks Request, the End-User Portal sends an intent-to-renew message (based on the Renewal Intent for End Customer email template) to the email address you specify here.

Request Renewal Notification Email is optional.

The Renewal Callout and the Request Renewal Notification Email are not mutually exclusive. If both are present, FlexNet Operations runs the callout code and sends an email to the address indicated by Request Renewal Notification Email. If neither setting has a value, the Request button is suppressed in the End-User Portal.

 

 

Renewal Failed Notification Email

Valid email address

An email address to which FlexNet Operations sends renewal notifications when an account with expiring or expired entitlements has no end users who have subscribed to receive renewal reminders. Producers can use this address to receive the renewal reminders on behalf of their customer accounts.

 

 

Renewal Callout

Classname or URL

Optionally identify a callout to use when an end user clicks the Request button on the End-User Portal’s Expiring Entitlements page. Specify a callout as an external SOAP endpoint that implements the RenewalService interface. (Click the Test Connection button to verify connectivity between FlexNet Operations and your endpoint.).

Version:The Renewal Callout and the Request Renewal Notification Email are not mutually exclusive. If both are present, FlexNet Operations runs the callout code and sends an email to the address indicated by Request Renewal Notification Email. If neither setting has a value, the Request button is suppressed in the End-User Portal.

 

 

Customer Growth

These settings correspond to the Customer Growth section of the FlexNet Operations configuration page in System > Configure.

FlexNet Operations: Customer Growth Configurations

Name

Possible Values

Description

Rqd

Restart

Consumption Thresholds (Low,High)

0-100,0-100

Default: 30,70

The low and high markers for service consumption levels. Consumption is considered unhealthy if below the low threshold and very healthy if at or above the high threshold.

 

 

Renewal Health Thresholds (Low,High)

0-100,0-100

Default: 30,70

The low and high markers for a customer's renewal health. A low renewal health score is indicative of a risky renewal. A renewal health at or above the high mark translates to a high probability of the renewal.

 

 

Account Health Thresholds (Low,High)

0-100,0-100

Default: 30,70

The low and high markers for an account's overall health. The account is considered unhealthy if below the low threshold and very healthy if at or above the high threshold.

 

 

Alert Period

0-30

Default: 5

The period in days to wait before generating another alert for the same account and score type.

 

 

Enable running health aggregation job on demand

Selected or unselected

Enables the health aggregation job to be run for this specific tenant on demand.

 

 

Updates

These settings correspond to the Updates section of the FlexNet Operations configuration page in System > Configure.

FlexNet Operations: Updates Configurations

Name

Possible Values

Description

Rqd

Restart

Platforms

 

Comma separated list of custom platforms which are available for an Update when defining the Release To packages.

 

 

See Also