Registry Keys for Inventory Beacon

FlexNet Manager Suite 2020 R2 (On-Premises)

The inventory beacon stores many configuration items and preferences in the Windows registry.

Many of these registry settings are also used on the application server.

In the following table, the default location for these keys is HKEY_LOCAL_MACHINE\SOFTWARE\ManageSoft Corp\ManageSoft\ (or, on 64-bit systems, HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ManageSoft Corp\ManageSoft\). In normal operation, these keys exist only in the HKLM hive. However, if a user runs any executable manually, corresponding keys are created on demand under HKCU\. These various paths are all represented with the abbreviation [Registry].

Preference name Details
ActiveDirectory

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\ActiveDirectory

Purpose: The folder where inventory collected from Active Directory is stored. On an inventory beacon, upload of the Active Directory data is triggered as soon as collection is completed.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: This inventory is reflected throughout the web interface for FlexNet Manager Suite in identifying users and devices.

ActiveDirectoryImporter
A registry folder containing settings to manage the behavior of the utility that imports Active Directory information for inclusion in inventory. For details, see the following keys in this listing, each of which may be added under [Registry]\ActiveDirectoryImporter\CurrentVersion:
  • ConnectionTimeout
  • MaxQueryAttempts
  • PageSize
  • RequestTimeout
  • SSLPort
  • VerifyServerCertificate.
These registry keys do not exist by default, and the system then uses the default values documented in each case below. You may add any (or all) of these keys to override the system defaults and use specific values. As always, an administrator may manually edit the required registry keys on an individual inventory beacon, or you may use your preferred deployment method to deploy specific settings to multiple inventory beacons. Customized values for any of these settings are preserved through the self-update process for inventory beacons. These keys are equally applicable to an inventory beacon co-installed on your application server, or installed on a separate server. Some of these settings are a subset of those supported by the Microsoft API for LDAPS connections or Active Directory queries, and more information is available through Microsoft documentation (for example, see https://msdn.microsoft.com/en-us/library/aa367019(v=vs.85).aspx).
ActivityStatus

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\ActivityStatus

Purpose: The folder used for staging uploads of status information, primarily on the execution of discovery and inventory rules.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: This inventory is reflected in the activity results, for example when you expand details of a rule on the Rules tab of Discovery & Inventory > Discovery and Inventory Rules.

BaseDirectory

Value type: String

Default value: %CommonAppData%\Flexera Software\Beacon

Purpose: The top level folder that the inventory beacon uses to store the files that it manages, including generated packages and configuration.

Applies to: inventory beacon; batch server

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Not applicable.

BeaconServicesEndpoint

Value type: String

Default value: none.

Purpose: For a top-level inventory beacon, this is the URL of the compliance server that this inventory beacon communicates with. For a child inventory beacon further down the hierarchy, this is the URL for its parent inventory beacon. The URL is used for services including uploading packages, and downloading the current importer configuration files.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: This value is editable only in the FlexNet Beacon interface as Beacon configuration > Parent connection > Parent URL .
Important: DO NOT edit this value manually in the registry. If you do so, authentication at the compliance server will fail. Make any changes through the user interface as described above.
BeaconServicesEndpointPath

Value type: String

Default value: inventory-beacons

Purpose: The name of the virtual directory on the application server (or on a parent inventory beacon in a hierarchy) used for inventory beacon communication. The default value is set in the code, so that this key may not be present in your registry; but where critical for advanced (and well-informed) implementations, you may manually set this key to over-ride the default.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Not applicable.

BeaconServicesPassword

Value type: Encrypted string

Default value: none.

Purpose: The password used by the inventory beacon to communicate with the application server endpoint (or, in larger systems, the inventory server). If this inventory beacon is a child in a hierarchy that reports to another inventory beacon, the password is used for these communications.
Tip: If a parent inventory beacon is running the built-in web server (and supporting anonymous authentication for communication with UNIX-like inventory devices), the password may correctly be empty.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: The password is editable in the FlexNet Beacon interface under Beacon configuration > Parent connection > Password. This must be the password you created on the parent device for the account running the connecting web service. Alternatively, if the parent is another inventory beacon using anonymous authentication, the password may be left blank.
Important: DO NOT edit this value manually in the registry. If you do so, authentication at the parent will fail. Make any changes through the user interface as described above.
BeaconServicesUserName

Value type: String

Default value: none.

Purpose: The account name used to communicate with the application server endpoint (or, in larger systems, the inventory server). If this inventory beacon is a child in a hierarchy that reports to another inventory beacon, the user name is used for these communications.
Tip: If a parent inventory beacon is running the built-in web server (and supporting anonymous authentication for communication with UNIX-like inventory devices), the user name may correctly be empty.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: The user name is editable in the FlexNet Beacon interface under Beacon configuration > Parent connection > User Name. This must be the user name you created on the parent device for the account running the connecting IIS web service. Alternatively, if the parent is another inventory beacon using anonymous authentication on the built-in web server to communicate with UNIX-like devices, the user name may be left blank.
Important: DO NOT edit this value manually in the registry. If you do so, authentication at the parent will fail. Make any changes through the user interface as described above.
BeaconStatus

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\BeaconStatus

Purpose: The staging folder for data on the current status of the FlexNet Beacon software on the inventory beacon.

Applies to: inventory beacon

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Accessible in the web interface through Discovery & Inventory > Beacons.

BeaconUIClientTimeoutSecs

Value type: String (integer)

Default value: 120
Tip: This default applies when the key is not present in the registry. To change to a different value, create the registry key and supply your changed value.

Purpose: The number of seconds before the inventory beacon client (GUI) times out while waiting for a response from the beacon service, which in turn is waiting for a response from a connection under test. You should ensure that the remote connection is correctly configured and operational. After a timeout, the FlexNet Beacon automatically retries and restores the link between the beacon client and the beacon service.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Not applicable.

CheckCertificateRevocation

Value type: String (Boolean case-insensitive literals true or false)

Default value: True (when preference is absent from registry).

Purpose: When transferring data between an inventory beacon and the application server using the HTTPS protocol, a web server certificate is applied to the data being transferred. When receiving web server certificates from servers, the appropriate agent checks the CA (certification authority) server to ensure that the certificates are not on the CRL (certificate revocation list). If an agent cannot check the CRL (for example, the CA server is firewalled and cannot be contacted, or a proxy server prevents access), the system can stall. To avoid this stalling, you can add the Common\CheckCertificateRevocation preference and set it to False to prevent code agents performing the CRL check.
Important: This approach is "for emergency use only" and is not recommended practice for normal operation. Failing to check for certificate revocation introduces a security weakness that is unacceptable in most operational environments.
Tip: OCSP Stapling is not supported.

This preference is not normally present in the registry, with default behavior specified in the FlexNet Beacon code. You can manually add the preference to the registry when it is needed.

Applies to: inventory beacon

Registry key: [Registry]\Common

User interface: Not applicable.

ConnectionTimeout

Value type: String (integer)

Default value: 30 (this value of 30 seconds is used when the ConnectionTimeout key is not specified in the registry).

Purpose: Specifies the number of seconds to spend in an attempt to establish a connection from the inventory beacon to a domain controller before a timeout. This value is relevant only to the collection of Active Directory information for import to FlexNet Manager Suite. (This key maps to the LdapConnection.Timeout setting in the Microsoft API.)

Applies to: inventory beacon

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

CredentialTestTimeout

Value type: String (integer)

Default value: 30 (seconds)

Purpose: When the inventory beacon is about to attempt a remote execution task on a target inventory device (such as adoption or inventory collection), its first phase is to test whether the supplied credentials can connect to the target. This preference sets the maximum number of seconds that the inventory beacon may wait for a response from the target inventory devices. If this countdown expires, the remote execution task is logged as a connection failure. This registry key is not present by default, in which case the same default value is automatically applied. You may override the default by creating the registry key and giving it a different integer value.

Applies to: inventory beacon

Registry key: [Registry]\RemoteExecution\CurrentVersion

User interface: Not applicable.

CustomImportXMLDirectory

Value type: String

Default value: %CommonAppData%\Flexera Software\Compliance\ImportProcedures\CustomInventory

Purpose: The path used to store the customized version of the importer configuration files.

Applies to: inventory beacon; application server

Registry key: [Registry]\Compliance\CurrentVersion

User interface: Not applicable.

CyberArkAppId

Value type: String

Default value: Flexera_FlexNetBeacon

Purpose: Specifies the application ID to be used by CyberArk to recognize and authorize the inventory beacon engine. Once authorized, the local Password Manager can request credentials from the CyberArk Vault. The format of the default value follows the best practice documented for CyberArk.

Applies to: inventory beacon

Registry key: [Registry]\PasswordStore

User interface: When CyberArkVaultEnabled is true, the read-only Application ID field on the Password management page of the FlexNet Beacon interface displays the application ID value for you to copy and paste into the CyberArk Password Vault Web Access web page.

CyberArkVaultEnabled

Value type: String (Boolean case-insensitive literals true or false)

Default value: Determined by presence of CyberArk Credential Provider on this inventory beacon. (Do not edit.)

Purpose: Records the discovery of the CyberArk Credential Provider in the expected installation path.

Applies to: inventory beacon

Registry key: [Registry]\PasswordStore

User interface: When this setting is true, the Password management page of the FlexNet Beacon interface displays details needed for integration with CyberArk; and the local Password Manager includes an option to select the Vault.

CyberArkVaultRetryTime

Value type: Int32

Default value: 300 (this value of 300 seconds is used when the CyberArkVaultRetryTime key is not specified in the registry).

Purpose: Relevant only when CyberArk Credential Provider is installed on this inventory beacon, so that credentials may be retrieved from a CyberArk Vault. If an attempt to retrieve a credential times out (which by default takes 30 seconds), Password Manager records the failure and does not attempt to retrieve other credentials for a wait period specified in this setting. This allows faster reporting of time-out errors, which may indicate problems with CyberArk, transient network conditions, or other issues. (Without this mechanism, Password Manager would continue requesting credentials, waiting 30 seconds to each request to time out, and so on — which may stall remote discovery and inventory tasks for hours in a large environment.)

Applies to: inventory beacon

Registry key: [Registry]\PasswordStore

User interface: Not applicable.

CyberArkVaultTimeout

Value type: Int32

Default value: 30 (this value of 30 seconds is used when the CyberArkVaultTimeout key is not specified in the registry).

Purpose: Relevant only when CyberArk Credential Provider is installed on this inventory beacon, so that credentials may be retrieved from a CyberArk Vault. As a parameter attached to credential requests, it specifies the amount of time that the CyberArk Credential Provider should wait for a response from the central CyberArk Vault before issuing a time-out error.

Applies to: inventory beacon

Registry key: [Registry]\PasswordStore

User interface: Not applicable.

DatabaseConnectionString

Value type: String

Default value: filepath

Purpose: The connection string using which other servers in your on-premises implementation may access the operations databases on your database server. Used by the Business Adapter Studio when building business adapters to run in connected mode, where they have direct network access to the operations databases.

Applies to: application server

Registry key: [Registry]\Reporter\CurrentVersion

User interface: Not applicable.

DefaultPingSweepOptions

Value type: String

Default value: -PI (default behavior in code, not visible in the registry)

Optional value: -PS

Purpose: Specifies the options passed to MgsIPScan and used in scanning the network to discover devices. (MgsIPScan is a customized version of nmap.) The default value uses an ICMP ping sweep of the network to identify devices for further testing. To turn off the ping sweep, you must add the optional value -PS to the registry key listed below (when passed through to MgsIPScan, this switches from a ping sweep to a TCP SYN/ACK scan). Turning off the ping sweep has the side effect of slowing down the port scans that also form part of the discovery process.
Note: If you have multiple inventory beacons and wish to prevent ping sweeps, you should create this registry setting on all inventory beacons.

Applies to: inventory beacon

Registry key: [Registry]\Discovery\CurrentVersion

User interface: Modifies the network scanning behavior enabled by the Network scan check box (in Discovery & Inventory > Discovery and Inventory Rules > Actions tab, when creating or editing an action, in the Discovery of devices section).

DefaultPortScanOptions

Value type: String

Default value: -PN (default behavior in code, not visible in the registry)

Optional value: Any scanning setting accepted by MgsIPScan (same settings as for nmap).

Purpose: This option is passed only to the MgsIPScan command line used on known discovered devices, the list of which has been automatically downloaded from the central application server to the inventory beacon. The default value turns off the ping sweep (switching to a TCP NULL scan), so that no host discovery is attempted. The resulting command line then applies the required port scanning options to the known discovered devices, assuming that these discovered hosts are online.

Applies to: inventory beacon

Registry key: [Registry]\Discovery\CurrentVersion

User interface: Modifies the discovery behavior enabled with the Use previously discovered devices check box (in Discovery & Inventory > Discovery and Inventory Rules > Actions tab, when creating or editing an action, in the Discovery of devices section). This setting causes the distinct MgsIPScan command line to be applied to known discovered devices.

DefaultTcpScanTypeOptions

Value type: String

Default value: -sS (default behavior in code, not visible in the registry)

Optional value: -sT

Purpose: This option is passed to the MgsIPScan command lines used for both discovery of new devices and port scanning on known discovered devices. The default value attempts a TCP SYN scan, while the optional value attempts an ACK scan. This sets the behavior of the inventory beacon in applying the port scanning rules received in beacon policy from the central application server. The same scanning method is used for all the different port scanning settings available in the web interface.

Applies to: inventory beacon

Registry key: [Registry]\Discovery\CurrentVersion

User interface: Modifies the port scanning behavior enabled in Discovery & Inventory > Discovery and Inventory Rules > Actions tab, when creating or editing an action, with the following settings:
  • Network scan (in the Discovery of devices section)
  • Discover VMware infrastructure (in the VMware infrastructure section)
  • Discover Oracle VM infrastructure (in the Oracle VM infrastructure section)
  • Port scan (in the Oracle database environments section when Discover Oracle database environments is selected)
  • Port scan (in the Microsoft SQL Server section when Discover Microsoft SQL Server is selected).
DefaultUdpScanTypeOptions

Value type: String

Default value: -sU (default behavior in code, not visible in the registry)

Optional value: Any UDP scanning setting accepted by MgsIPScan/nmap (or an empty string).

Purpose: This option is passed to the MgsIPScan command lines used for both discovery of new devices and port scanning on known discovered devices. The default value attempts a UDP scan. A typical use case is to set this to an empty string, which turns off the UDP scan.

Applies to: inventory beacon

Registry key: [Registry]\Discovery\CurrentVersion

User interface: Modifies the port scanning behavior enabled in Discovery & Inventory > Discovery and Inventory Rules > Actions tab, when creating or editing an action, with the following settings:
  • Network scan (in the Discovery of devices section)
  • Discover VMware infrastructure (in the VMware infrastructure section)
  • Discover Oracle VM infrastructure (in the Oracle VM infrastructure section)
  • Port scan (in the Oracle database environments section when Discover Oracle database environments is selected)
  • Port scan (in the Microsoft SQL Server section when Discover Microsoft SQL Server is selected).
FnmpConnectionsEnabled

Value type: String (Boolean case-insensitive literals true or false)

Default value: True

Purpose: Controls whether the inventory beacon will attempt to connect to an application server for uploading data packages and downloading importer configuration files.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Reflects the setting Enable parent connection on the Parent connection page of the FlexNet Beacon interface.

FNMPWEBUIURL

Value type: String

Default value: The URL of your web application server, specified during installation.

Purpose: The URL of the central application server (or the web application server, in a multi-server implementation). This is normally set by the installer for the inventory beacon, based on your input to the installation wizard.
Note: This registry value must be set even for a disconnected inventory beacon that cannot access the Internet. Use Beacon\CurrentVersion\FnmpConnectionsEnabled to turn off attempts to access to this URL.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Not applicable.

HideTaskConfirmationDialog

Value type: String (Boolean case-insensitive literals true or false)

Default value: False
Tip: This value applies when the key is not present in the registry.

Purpose: Suppresses the presentation of confirmation dialogs in the FlexNet Beacon interface.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Set to True when an operator selects Do not show me this again in any confirmation dialog for an inventory or business import, or any rule, in the FlexNet inventory agent interface. This single setting affects the confirmation dialogs for all local executions at once. The value may be reset (so that all confirmation dialogs are displayed again) by opening the system menu on the inventory beacon (top left corner) and choosing Restore notification defaults; or by setting this key to False, or removing the key from the registry.

http_proxy (common)

Value type: String

Default value: none.

Purpose: If the inventory beacon must access the central application server through a proxy (and using the HTTP protocol), identify the URL and port number in this setting, using the format:

http://proxyServer:portNumber
The proxyServer placeholder may be replaced with the fully-qualified host name, or with an IP address. For example:
http://proxy12.tmnis.org:80
http://194.66.82.12:80
Tip: Only one of the Common\http_proxy and Common\https_proxy keys may be defined on each inventory beacon.

Applies to: inventory beacon

Registry key: [Registry]\Common

User interface: Not applicable.

http_proxy (Launcher)

Value type: String

Default value: none.

Purpose: If the inventory beacon must access the central application server through a proxy (and using the HTTP protocol), identify the URL and port number in this setting, using the format:

http://proxyServerURL:portNumber
The proxyServer placeholder may be replaced with the fully-qualified host name, or with an IP address. For example:
http://proxy12.tmnis.org:80 
Tip: Only one of the Launcher\CurrentVersion\http_proxy and Launcher\CurrentVersion\https_proxy keys may be defined on each inventory beacon.

Applies to: inventory beacon

Registry key: [Registry]\Launcher\CurrentVersion

User interface: Not applicable.

https_proxy (common)

Value type: String

Default value: none.

Purpose: If the inventory beacon must access the central application server through a proxy (and using the HTTPS protocol), identify the URL and port number in this setting, using the format:

https://proxyServerURL:portNumber
The proxyServer placeholder may be replaced with the fully-qualified host name, or with an IP address. For example:
https://proxy14.tmnis.org:443
https://194.66.82.14:443
Tip: Only one of the Common\http_proxy and Common\https_proxy keys may be defined on each inventory beacon.

Applies to: inventory beacon

Registry key: [Registry]\Common

User interface: Not applicable.

https_proxy (Launcher)

Value type: String

Default value: none.

Purpose: If the inventory beacon must access the central application server through a proxy (and using the HTTPS protocol), identify the URL and port number in this setting, using the format:

http://proxyServerURL:portNumber
Important: This is not a typographical error. The HTTPS proxy for the Launcher must be specified with the leading protocol value of http://.
The proxyServer placeholder may be replaced with the fully-qualified host name, or with an IP address. For example:
http://proxy14.tmnis.org:443
Tip: Only one of the Launcher\CurrentVersion\http_proxy and Launcher\CurrentVersion\https_proxy keys may be defined on each inventory beacon.

Applies to: inventory beacon

Registry key: [Registry]\Launcher\CurrentVersion

User interface: Not applicable.

ImportXMLDirectory

Value type: String

Default value: %CommonAppData%\Flexera Software\Compliance\ImportProcedures\Inventory

Purpose: The path used to store the standard version of the importer configuration files.

Applies to: inventory beacon; application server

Registry key: [Registry]\Compliance\CurrentVersion

User interface: Not applicable.

Launcher

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\Logs

Purpose: The folder where log files from the Launcher (ndlaunch.exe) are staged for upload. This is a code component of the FlexNet inventory agent.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory\

User interface: Not applicable.

LoggingBaseDirectory

Value type: String

Default value: %CommonAppData%\Flexera Software\Compliance\Logging

Purpose: The path used to store logging configuration and the log files generated by each process.

Applies to: inventory beacon

Registry key: [Registry]\Compliance\CurrentVersion

User interface: Not applicable.

MaxKeepAliveLifetime

Value type: String (integer)

Default values:

60 seconds (on Windows platforms) 0 (on UNIX-like platforms) – no maximum age by default

Purpose: Maximum age (in seconds) of a reusable (persistent) HTTP/HTTPS connection. After expiry, the inventory beacon must request a new connection. Special case of "0" means no maximum age.
Tip: Works with MaxKeepAliveRequests: when either limit is reached, both counters are reset.

Applies to: inventory beacon

Registry key: [Registry]\Uploader\CurrentVersion

User interface: Not applicable.

MaxKeepAliveRequests

Value type: String (integer)

Default values:

50 (on Windows platforms) 0 (on UNIX-like platforms)

Purpose: Maximum number of uploads attempted on a persistent HTTP/HTTPS connection before requesting a new connection. Special case of "0" means no maximum (that is, reuse the same connection continuously).
Tip: Works with MaxKeepAliveLifetime: when either limit is reached, both counters are reset.

Applies to: inventory beacon

Registry key: [Registry]\Uploader\CurrentVersion

User interface: Not applicable.

MaxQueryAttempts

Value type: String (integer)

Default value: 3 (this value is used when the MaxQueryAttempts key is not specified in the registry).

Purpose: The maximum number of times that the Active Directory import utility may retry each query to Active Directory, in the event that the query times out.

Applies to: inventory beacon

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

MaxUploadedPackageAge

Value type: DWORD

Default value: 14
Tip: This default applies when the key is not present in the registry. To change to a different value, create the registry key and supply your changed value.

Purpose: The maximum age, in days, that a package may be kept on the inventory beacon before it is deleted.

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Not applicable.

NetworkTimeout

Value type: String (integer number of seconds)

Default value: 600 (ten minutes)

Purpose: Determines the length of time in seconds of inactivity after which a network operation will time out. Notice that the sending of keep-alive TCP packets is ignored for this purpose — these do not count as network activity (see SendTCPKeepAlive for socket-level keep-alive).

Applies to: inventory beacon

Registry key: [Registry]\Uploader\CurrentVersion

User interface: Not applicable.

NumParallelCommands

Value type: String (integer)

Default value: 16

Purpose: When the inventory beacon is managing remote execution tasks (such as adoption, remote inventory collection from a general target device, direct collection of inventory from an Oracle database instance, collection of VMware or XenDesktop inventory, and so on), this preference sets the maximum number of these high-level tasks that may be initiated at a time. When this maximum is reached, one of the current tasks must be completed before the next queued task may be commenced. This registry key is not present by default, in which case the same default value is automatically applied. You may override the default by creating the registry key and giving it a different integer value.
Tip: If you create the registry key and the value is corrupted, or evaluates to zero, only a single task is undertaken at a time, and each task must be completed before the next is commenced.

Applies to: inventory beacon

Registry key: [Registry]\RemoteExecution\CurrentVersion

User interface: Not applicable.

PageSize

Value type: String (integer)

Default value: 1000 (this value is used when the PageSize key is not specified in the registry).

Purpose: The number of data rows to be returned in each paged response by Active Directory to a query for gathering inventory information. This setting relates to Microsoft search requests, and for more information see https://msdn.microsoft.com/en-us/library/system.directoryservices.protocols.pageresultrequestcontrol.pagesize(v=vs.110).aspx.

Applies to: inventory beacon

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

PolicyClient

Deprecated.

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Not applicable.

Proxy (for downloads)

Value type: String

Default value: none (by default, this registry key does not exist, and is added only when required).
Tip: If this registry key is not defined and a proxy is in use, the setting in either Common\http_proxy or Common\https_proxy is used.

Purpose:

If the inventory beacon must access the central application server through a proxy, this registry key can be added to identify the protocol, server URL, and port number, using this format:
protocol://proxyServerURL:portNumber
The proxyServer placeholder may be replaced with the fully-qualified host name, or with an IP address. For example:
https://proxy14.tmnis.org:443
http://194.66.82.14:443

Since (typically) the same proxy server controls both uploads and downloads between the inventory beacon and application server, this setting is normally kept in sync with the value in Common\UploadSettings\ReplicatorParent\Proxy. (Strictly, the ReplicatorParent may refer to a parent inventory beacon in a hierarchy; but typically proxies are required only for those accessing the central application server.)

Applies to: inventory beacon

Registry key: [Registry]\Common\DownloadSettings\ReplicatorParent

User interface: Not applicable.

Proxy (for uploads)

Value type: String

Default value: none (by default, this registry key does not exist, and is added only when required).
Tip: If this registry key is not defined and a proxy is in use, the setting in either Common\http_proxy or Common\https_proxy is used.

Purpose:

If the inventory beacon must access the central application server through a proxy, this registry key can be added to identify the protocol, server URL, and port number, using this format:
protocol://proxyServerURL:portNumber
The proxyServer placeholder may be replaced with the fully-qualified host name, or with an IP address. For example:
https://proxy14.tmnis.org:443
http://194.66.82.14:443

Since (typically) the same proxy server controls both uploads and downloads between the inventory beacon and application server, this setting is normally kept in sync with the value in Common\DownloadSettings\ReplicatorParent\Proxy. (Strictly, the ReplicatorParent may refer to a parent inventory beacon in a hierarchy; but typically proxies are required only for those accessing the central application server.)

Applies to: inventory beacon

Registry key: [Registry]\Common\UploadSettings\ReplicatorParent

User interface: Not applicable.

PublicToolsShare

Value type: String

Default value: Points to the file share mgsRET$, which by default is set to %ProgramFiles%\Flexera Software\Inventory Beacon\RemoteExecution\Public\Inventory.

Purpose: Specifies the share used for Zero-footprint inventory collection, driven by the inventory beacon. From this folder, the mgsreservice service on a target inventory device executes ndtrack.exe (for Windows); or the FlexNet Beacon engine downloads ndtrack.sh (for UNIX-like platforms). This key is set by the inventory beacon installer, and should not be altered or removed.

Applies to: inventory beacon

Registry key: [Registry]\RemoteExecution\CurrentVersion

User interface: Not applicable.

RemoteApplication

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\RemoteApplication

Purpose: The folder name used for storing .raa files uploaded from the AppVMgmtSvr.ps1 PowerShell script deployed on App-V Management Servers (for App-V release 5.0 or later). For more information about the App-V adapter, see the FlexNet Manager Suite Inventory Adapters and Connectors Reference PDF, available through the title page of online help.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Not applicable.

Replicator

Deprecated.

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Not applicable.

RequestTimeout

Value type: String (integer)

Default value: 30 (this value is used when the RequestTimeout key is not specified in the registry).

Purpose: The length of time, specified in seconds, to wait for results to be returned from a request for Active Directory data. For a request that produces multiple pages of data (see PageSize), this is the time allowed for each page of data to be returned.

Applies to: inventory beacon

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

SecurityEvent

Deprecated.

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Not applicable.

SendTCPKeepAlive

Value type: String (Boolean case-insensitive literals true or false)

Default value: true

Purpose: Determines whether the uploader sends keep-alive TCP (socket level) packets to the destination server at 3 minute intervals. This is helpful when resolving large files (10MB or more) into the inventory database in the central application server, as it prevents network infrastructure from assuming the connection is idle and closing it (prematurely closing the connection prevents the inventory beacon receiving a success message, and triggers repeated upload attempts). Once the application server sends a success message for the final upload of a given file type (or if the server fails 10 times over to respond within 10 seconds of a keep-alive packet), the uploader may terminate the connection.

Applies to: inventory beacon

Registry key: [Registry]\Uploader\CurrentVersion (or, with less specificity, [Registry]\Common)

User interface: Not applicable.

SSLPort

Value type: String (integer)

Default value: 636 (this value is used when the SSLPort key is not specified in the registry).

Purpose: The Active Directory query can use the Lightweight Directory Access Protocol (LDAP) through a Secure Sockets Layer (SSL) link to communicate with the domain controller, for which this is the port number. This setting applies to the LDAP connection, and for more information see https://msdn.microsoft.com/en-us/library/system.directoryservices.protocols.ldapdirectoryidentifier.portnumber(v=vs.110).aspx.
Note: Use of LDAP over SSL requires that you have set the Use SSL check box in the Active Directory page of the FlexNet Beacon user interface. For details, see Importing from Active Directory. If this check box is clear on an inventory beacon that is gathering Active Directory data, any value for this key is ignored.

Applies to: inventory beacon

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

StagingDirectory

Value type: String

Default value: Staging

Purpose: The name of the folder, relative to the BaseDirectory, used to temporarily store generated packages while they are being received.

Applies to: inventory beacon; inventory server

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Not applicable.

SystemStatus

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\SystemStatus

Purpose: The folder where uploaded status files are stored.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Results from these files are visible through the system menu, under System Health.

TenantUID

Value type: String

Default value: none.

Purpose: If the compliance server is configured for multi-tenancy, the inventory beacon must know to which tenant it is assigned. The TenantUID is used to uniquely identify each tenant in the system.

Applies to: inventory beacon

Registry key: [Registry]\Common

User interface: Editable in the FlexNet Manager Platform tab of the FlexNet Beacon interface as Tenant Unique Identifier.

Timeout

Value type: String (integer)

Default value: 3600 (seconds)

Purpose: When the inventory beacon initiates any remote execution task on a target inventory device (such as adoption or inventory collection), but no response is received within the number of seconds specified in this preference, the remote execution task times out and is logged as a failure. This registry key is not present by default, in which case the same default value is automatically applied. You may override the default by creating the registry key and giving it a different integer value.

Applies to: inventory beacon

Registry key: [Registry]\RemoteExecution\CurrentVersion

User interface: Not applicable.

Tracker

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\Inventories

Purpose: The folder where inventory files (.ndi) collected by the Tracker (ndtrack) are staged for uploading.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: See all the inventory-related pages under the Discovery & Inventory menu.

UsageData

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\UsageData

Purpose: The folder where usage data uploaded from the FlexNet inventory agent (ndtrack) is stored.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Not applicable.

VdiAccess

Value type: String

Default value: %ProgramData%\Flexera Software\Incoming\VdiAccess

Purpose: The folder storing uploaded access and usage data (collected by the FlexNet inventory agent) for virtualized applications accessed through VDI.

Applies to: inventory beacon; application server (or, if scaled up, the inventory server)

Registry key: [Registry]\Reporter\CurrentVersion\IncomingDirectory

User interface: Not applicable.

VerifyServerCertificate

Value type: String (Boolean case-insensitive literals true or false)

Default value: true (this value is used when the VerifyServerCertificate key is not specified in the registry).

Purpose: When an SSL connection to the Active Directory domain controller has been specified (see SSLPort for more details), VerifyServerCertificate determines whether the security certificate for the connection should be validated. This setting applies only to the collection of Active Directory data, and has no bearing on the use of security certificates for communications between the FlexNet inventory agent and an inventory beacon (for details of which see the Gathering FlexNet Inventory PDF file, available through the title page of online help).

Applies to: inventory beacon

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

WebServerStatus

Value type: String (drop-down list)

Default value: Ready

Purpose: Only present when the local, built-in web server is used to communicate with installed FlexNet inventory agents on managed devices (in preference to Microsoft IIS). The values may be:
  • Ready (the default) — communications with installed FlexNet inventory agents are operating normally, including both the delivery of policy when requested, and the upload of inventory and discovery results.
  • Initializing — the self-hosted web server is preparing itself, but is not yet able to communicate with FlexNet inventory agent.
  • Offline — the self-hosted web server has been disabled through the FlexNet Beacon interface (see Configuring Inventory Collection).

Applies to: inventory beacon

Registry key: [Registry]\Beacon\CurrentVersion

User interface: In general, the health of your inventory beacons can be monitored in the web interface for FlexNet Manager Suite, by navigating to either:
  • The the system menu ( in the top right corner)System Health > System Health Dashboard
  • Discovery & Inventory > Beacons (in the Network group).

FlexNet Manager Suite (On-Premises)

2020 R2