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
Custom Tags
Renewals
Customer Growth
Updates

Note that default values are listed as the first choice. Also, 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.

*

 

Support Center Link

http://www.revenera.com/support.htm
or specify

URL for your support center that is displayed on the Home page.

*

 

Communities Link

http://community.
revenera.com
or specify

URL for a community link.

*

 

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.

 

 

Interval to Poll the VCG

Value in ms (default 50)

After license generation process is submitted to VCG, FlexNet Operations polls VCG at this interval (in milliseconds) to check if license generation is complete.

*

 

Maximum Time to Wait for a Response from the VCG

 

Maximum time (in milliseconds) that the server waits for a response from a VCG when generating a license.

*

 

Maximum Lifetime for a VCG Process

Number of licenses (default 50)

Maximum number of licenses that a single VCG process generates, after which the VCG instance is shut down and another one generated.

*

 

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 (default 10)

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

*

 

Use SUPERSEDE or SUPERSEDE_SIGN Keyword

None (default)

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. GCS must carefully evaluate the risks before setting this flag. Refer to the product documentation to understand the risks.

 

 

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.

*

 

Line Items Page Size per Entitlement

10 or specify

Maximum number of line items loaded for each entitlement in page. If number of line items exceeds maximum, a more... link enables the others to be displayed. Setting value to -1 loads all line items associated with entitlement.

*

 

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

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 (default)
Equals
Starts With
Ends With

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

 

 

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 is 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
Super admin
LDAP 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).

 

 

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

Notification Classname

 

Set to class implementing the com.flexnet.operations.notification.EntityNotifier interface. Used to process notifications when certain entities are created, updated, or deleted.

 

 

RabbitMQ URL

Specify valid URL

URL used by notification framework (including login credentials and virtual host) in <protocol>://<hostname>:<port> format.

 

 

RabbitMQ Exchange Name

fno.public.transactions or specify

Exchange name used by notification framework.

 

 

License Fulfillment Service URL

Specify valid URL

URL used by license fulfillment framework in <protocol>://<hostname>:<port> format.

 

 

FlexNet Operations Cloud URL

Specify valid URL

URL for the FlexNet Operations Cloud replication service endpoint in <protocol>://<hostname>:<port> format.

 

 

Windows VCG Service URL

Specify valid URL

URL for the Windows VCG service endpoint in <protocol>://<hostname>:<port> format.

 

 

Linux VCG Service URL

Specify valid URL

URL for the Linux VCG service endpoint in <protocol>://<hostname>:<port> format.

 

 

Usage Analytics Service URL

Specify valid URL

URL for the usage analytics service endpoint in <protocol>://<hostname>:<port> format.

*

 

Electronic Software Delivery Host Name

Specify valid hostname

Electronic Software Delivery hostname in <protocol>://<hostname>:<port> format.

 

 

End-User Portal Host Name

Specify valid hostname

End-User Portal hostname in <protocol>://<hostname>:<port> format.

*

 

Electronic Software Delivery Service URL

Specify valid URL

URL of Electronic Software Delivery Service endpoint.

 

 

Custom License Generator Host

Specify valid host

Custom License Generator Host as protocol://host:port. This value can be referenced as {CUSTOM_TECH_HOST} in Custom License Technology URL.

 

 

CMS Consumer Queue Name

ops.cms.consumer or specify

Name of the CMS consumer queue in RabbitMQ.

*

Base FNOC Consumer Queue Name

ops.fnoc.consumer or specify

Base name of the tenant specific queue in RabbitMQ, which is concatenated with the tenantid to form the full queue name.

*

 

Audit Trail Queue Name

ops.audit.consumer or specify

Name of the audit trail queue in RabbitMQ.

*

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 other accounts also.

 

 

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.

 

 

Custom Tags

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

FlexNet Operations: Custom Tag Configurations

Name

Possible Values

Description

Rqd

Restart

Last in Head

 

Custom script tags added here are inserted last in the document <head/> of the Producer Portal.

 

 

Last in Body

 

Custom script tags added here are inserted last in the document <body/> of the Producer Portal.

 

 

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

*

 

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

*

 

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

*

 

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

*

 

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

*

 

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

 

 

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

 

 

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

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.

Version:This setting is only used for producers who have the FlexNet Customer Growth module.

Version: Sample implementations are available in the site/samples/renewal folder.

 

 

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