Registry Keys for Inventory Beacon

IT Asset Management (Cloud)

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

In the following table, the default location for these keys is:

HKEY_LOCAL_MACHINE\SOFTWARE\ManageSoft Corp\ManageSoft\

Or, on 64-bit systems, the default location is:

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.

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

User interface: This inventory is reflected throughout the web interface for IT Asset Management 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. 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.

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.

AuthenticationType

Value type: String

Default value: Anonymous — user name and password are not required.

Optional value: Basic — user name and password are required.

Purpose: Controls the authentication type of the proxy server.

Registry key: [Registry]\Common\ProxySettings

User interface: Users can modify this key by using the Proxy connection dialog in the FlexNet Beacon interface.

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.

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.

Registry key: [Registry]\Beacon\CurrentVersion

User interface: This value is visible in the FlexNet Beacon interface as Beacon configuration > Parent connection > Parent URL .
Important: DO NOT edit this value manually in the registry, nor in the FlexNet Beacon interface. If you do so, authentication at the compliance server will fail. This value is set for each inventory beacon within the beacon configuration file downloaded from the central application server, and should not be edited.
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. This path is set for each inventory beacon within the beacon configuration file downloaded from the central application server, and should not be edited.

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

Registry key: [Registry]\Beacon\CurrentVersion

User interface: For a top-level inventory beacon reporting directly to the central application server, the presence of the password (obscured) is visible in the FlexNet Beacon interface under Beacon configuration > Parent connection > Password.
Important: DO NOT edit this value manually either in the registry or in the FlexNet Beacon interface. If you do so, authentication at the application server will fail. Passwords (and matching user names) for top-level inventory beacons are automatically generated by the IT Asset Management application server and downloaded within the inventory beacon configuration file. To change the BeaconServicesPassword for such a case, download a new configuration file.
For a child inventory beacon that reports to a parent inventory beacon, insert here the password for the account you created on the parent to run the web service that manages these communications (unless you are using anonymous authentication, in which case leave the Password field empty).
BeaconServicesUserName

Value type: String

Default value: none.

Purpose: The account name used to communicate with the application server endpoint. 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.

Registry key: [Registry]\Beacon\CurrentVersion

User interface: The user name is visible in the FlexNet Beacon interface under Beacon configuration > Parent connection > User Name.
Important: DO NOT edit this value manually either in the registry or in the FlexNet Beacon interface. If you do so, authentication at the application server will fail. Passwords (and matching user names) are automatically generated by the IT Asset Management application server and downloaded within the inventory beacon configuration file. This is true for both a top-level inventory beacon communicating directly with the application server, and a child inventory beacon communicating through the hierarchy of inventory beacons. To change the BeaconServicesPassword, download a new configuration file.
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.

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.

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.

Registry key: [Registry]\Common

User interface: Not applicable.

CheckServerCertificate

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

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

Purpose: When transferring data to or from an inventory beacon using the HTTPS protocol, a web server certificate is applied to the data being transferred. All components can (and by default do) validate the public certificates received from the inventory beacon against their local copy (on Windows, in the certificate store; and on UNIX in the PEM file). You can set this as a common registry entry, so that the same behavior occurs across all components; and you can override the common behavior by setting an overriding registry entry for any individual component if required. By default, this preference is set so that all components check the inventory beacon server certificate against the root CA certificate.

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 IT Asset Management. (This key maps to the LdapConnection.Timeout setting in the Microsoft API.)

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.

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.

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.

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.

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

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.

Registry key: [Registry]\PasswordStore

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.

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.

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.

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.

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

Value type: String

Default value: %CommonAppData%\Flexera Software (default behavior in code, not visible in the registry).

Optional value: Any valid file path on this inventory beacon. May be used, for example, to switch the distribution location to an alternative disk drive.

Purpose: Provides the base for the file paths for many log- and data-related folders on the inventory beacon (for details, see File Paths for Inventory Beacon).
Note: If DistributionLocation is not set, the following registry values are checked in order, and, if present, used in preference to the default:
  • ImportXMLDirectory
  • BaseDirectory.

Registry key: [Registry]\Beacon\CurrentVersion

User interface: Not applicable.

Enabled

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

Default value: False

Purpose: Controls whether the inventory beacon saves copies of uploaded files of selected types (see FileTypes) for a limited period (see RetentionDays).

Registry key: [Registry]\Common\ReplicationSettings

User interface: Not applicable.

ExternalProcessExecution

Value type: String

Default value: Oracle

Purpose: When attempting to gather Oracle inventory from a large number of databases (10K+), there is the possibility of the BeaconEgine.exe process crashing due to memory issues. To address this issue, you can execute the Oracle inventory process externally using FlxRemoteExecutionLauncher.exe, separate from the BeaconEngine.exe process. This approach allows memory to be returned to the system after the completion of each Oracle inventory task. If the ExternalProcessExecution registry entry is not present, the Oracle inventory process will continue to be executed within BeaconEngine.exe, as previously established.

Registry key: [Registry]\RemoteExecution\CurrentVersion

User interface: Not applicable.

FileTypes

Value type: String of comma/space separated file name extensions from the default values list.

Default value: gz, txt, xml, log, ndi, disco, msa, mmi, rea, red, rer, rev, taskstatus, mss, msel, vdi

Purpose: When file retention is enabled (for temporarily saving copies of uploaded files for inspection), specified the file types that may be saved.

Registry key: [Registry]\Common\ReplicationSettings

User interface: Not applicable.

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.

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: US production instance: https://app.flexera.com European production instance: https://app.flexera.eu APAC production instance: https://app.flexera.au

Purpose: The URL of the central application server (or the web application server, in a multi-server implementation). The value is set by the installer for the inventory beacon, determined by which cloud instance you are accessing, and should not be altered.
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.

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.

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.

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.

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.

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

User interface: Not applicable.

Location

Value type: String (giving an absolute file path on the inventory beacon)

Default value: %ProgramData%\Flexera Software\Replication

Purpose: Controls where the inventory beacon saves copies of uploaded files of selected types (see FileTypes) for a limited period (see RetentionDays). Files are saved in appropriate sub-directories of this folder that are created on demand.

Registry key: [Registry]\Common\ReplicationSettings

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.

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.

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.

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.

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.

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

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.

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.

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

Password

Value type: String

Default value: Blank

Purpose: Specifies the password used for the proxy server connection configured as the Basic authentication type.

Registry key: [Registry]\Common\ProxySettings

User interface: Users can modify this key by using the Proxy connection dialog in the FlexNet Beacon interface.

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 Common\ProxySettings 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.)

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 Common\ProxySettings 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.)

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

User interface: Not applicable.

ProxyServerConnectionEnabled

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

Default value: False

Purpose: Controls whether the proxy server connection is enabled or disabled on the inventory beacon.

Registry key: [Registry]\Common\ProxySettings

User interface: When this setting is true, the ProxySettings property is enabled and users can configure the ProxySettings property by using the Proxy connection dialog in the FlexNet Beacon interface.

ProxyServerURL

Value type: String

Default value: none

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

http://proxyServerURL:portNumber
Important: The ProxyServerURL 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://proxy12.tmnis.org:80
http://194.66.82.14:80

Registry key: [Registry]\Common\ProxySettings

User interface: Users can modify this key by using the Proxy connection dialog in the FlexNet Beacon interface.

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.

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 IT Asset Management Inventory Adapters and Connectors Reference.

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

User interface: Not applicable.

Replicator

Deprecated.

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

User interface: Not applicable.

RepositoryLocation

Value type: String

Default value: C:\ProgramData\Flexera Software\Repository

Purpose: Used by the inventory beacon installer as a possible input for setting WAREHOUSEDIR, which specifies the base folder for locations for data uploads.
Tip: If the DistributionLocation registry value is set, this is used in preference to RepositoryLocation. If neither of these is set, the first available of the following is used instead:
  • ImportXMLDirectory registry value
  • BaseDirectory registry value
  • The default value, built from the %CommonAppData% environment variable.

Registry key: [Registry]\Repository\CurrentVersion

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.

Registry key: [Registry]\ActiveDirectoryImporter\CurrentVersion

User interface: Not applicable.

RetentionDays

Value type: Whole number

Default value: 7

Purpose: Controls how long the inventory beacon keeps copies of uploaded files of selected types (see FileTypes).

Registry key: [Registry]\Common\ReplicationSettings

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.

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.

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.

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.

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.

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.

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.

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.

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

User interface: Not applicable.

Username

Value type: String

Default value: Blank

Purpose: Specifies the user name used for the proxy server connection configured as the Basic authentication type.

Registry key: [Registry]\Common\ProxySettings

User interface: Users can modify this key by using the Proxy connection dialog in the FlexNet Beacon interface.

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.

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 at https://docs.flexera.com/).

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

Registry key: [Registry]\Beacon\CurrentVersion

User interface: In general, the health of your inventory beacons can be monitored in the web interface for IT Asset Management, 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).

IT Asset Management (Cloud)

Current