FNMS-SVM.exe Command Line

FlexNet Manager Suite 2020 R1 (On-Premises)

This topic provides a reference summary of the command line options for the FlexNet Manager Suite Inventory Export Tool executable, FNMS-SVM.exe. The command line options are identical whether the executable is invoked manually or through a Microsoft Windows Scheduled Task.

The command line is run from the bin directory in the installation of FlexNet Manager Suite on your application server. For larger implementations that have scaled up to multiple central servers, the installation should be on the batch server, or on the server which is hosting this functionality. The default path to the installed tool is C:\Program Files (x86)\Flexera Software\FlexNet Manager Platform\DotNet\bin.

Note: In the unlikely event that you have multiple separate implementations of FlexNet Manager Suite, each must be linked to a separate company account within Software Vulnerability Manager. In the same way, managed service providers (MSPs) must provide a separate company account for each tenant.

Synopsis

FNMS-SVM.exe verb [options]

Each verb has its own set of supported options. Each option has both a verbose name and a single-letter short form. Notice that the verbose option names are preceded by two dashes, but the short form alternatives have a single dash.

set [-a | --accesstoken ] svmAccessToken  [-u | --url] svmUploadLocation
dump [-f | --folder]  folderPath  
export
\?

Note: Managed service providers (MSPs) must add the following option to every invocation of the tool:

[-t | --tenantUID]  tenantuid

However, this option must not be used for single tenant, on-premises implementations.

Command line verbs and options are not case sensitive. Details about the verbs (listed alphabetically) and associated options are:

Verb	Option	Notes
(All verbs)	-t | --tenantUID tenantuid	Do not use this option in a single tenant, on-premises implementation. Managed service providers (MSPs) must supply this option at every invocation of the utility.
dump	-f | --folder folderPath	Runs the data gathering part of the export process, and dumps the result in a .csv file on the server where the Inventory Export Tool is executing. This file uses a tab delimiter to separate values. The path option is mandatory, and defines the folder for saving .csv files. The file name is a fixed format, defined as: AssetList_[tenantuid_]dateTime.csv where: tenantuid is omitted for a single tenant, on-premises implementation. For a multi-tenant system, it is copied from the command line option that identified the tenant. The dateTime identified the run time of the dump command, in a 14-digit format YYYYMMDDHHMMSS. Therefore, in a default single tenant environment, if you gave a command line option -f d:\temp, an example of a saved .csv file path is: D:\temp\AssetList_20161018011000.csv Tip: If you have multiple queries in your configuration file, all of them are executed at every invocation of FNMS-SVM.exe, and the .csv file contains the union of all query results. For more information, see Customizing the Configuration File.
export	(No options for single tenant implementation)	In normal operation for a single tenant, on-premises implementation, the executable is invoked with the export verb and no options. (Managed service providers must include the --tenantUID option.) It then exports all records of applications installed in the enterprise (no matter whether these records were created automatically through matching rules supplied in the Application Recognition Library, or were created manually), and all other installer evidence found within your enterprise inventory but not yet linked to any application. It also exports the installation count for each entry. The combined dataset is then handed off to Software Vulnerability Manager as an asset list, by default called FNMS_Import (and configurable in the configuration file, described in Customizing the Configuration File).
set	-a | --accesstoken svmAccessToken	Run the command once to configure the utility (this must be done before commencing exports). The access token option is mandatory, and the value is saved in the ComplianceTenantSetting table of the compliance database for use at each subsequent connection to Software Vulnerability Manager. (If for any reason you are ever issued a replacement token, re-run the command with both options.) The access token is available from the web interface for Software Vulnerability Manager (for details, see Installing and Configuring the Inventory Export Tool). Note: Managed service providers (MSPs) must supply a separate svmAccessToken value for each tenant, and register it while including the --tenantUID option in the command line.
set	-u | --url svmUploadLocation	Run the command including this option once to configure the utility (this must be done before commencing exports). The URL for upload to Software Vulnerability Manager is mandatory, and is saved in the ComplianceTenantSetting table of the compliance database for subsequent connection. Tip: The URL you enter is not validated by running this command. Run the FNMS-SVM.exe export command manually (without options) to check the connection and data results. The FNMS-SVM.log log file, where you can check results, is saved to the location declared in FNMS-SVM.exe.config file (which is installed in the bin directory with the executable). The default log file path is C:\ProgramData\Flexera Software\Compliance\Logging\SVM. Note: Managed service providers (MSPs) must register the svmUploadLocation separately for each tenant, and include the --tenantUID option in the command line while doing so.
\?	(No options)	Display relevant help (for example, if this is appended to the executable alone, it lists all available verbs; and if it is appended after any valid verb, it lists the options available for that verb). The appropriate command line help is also displayed for any unrecognized input values.

Examples

Configure the Inventory Export Tool in a single-tenant implementation, supplying both the mandatory options: the URL for upload to Software Vulnerability Manager and the token supplied from Software Vulnerability Manager:

FNMS-SVM.exe set -a 3434343== -u https://api.app.secunia.com/api/fnms/sync/

Run a test export of the data to a .csv file in the \temp directory of the D: drive on the application server for FlexNet Manager Suite, so that you can inspect the records that are created:

FNMS-SVM dump -f d:\temp

Export the application and unrecognized installer evidence data from your FlexNet Manager Suite database directly to Software Vulnerability Manager (this is the command that you should set up in a Microsoft Scheduled Task):

FNMS-SVM export

The same command when set up by a managed service provider must include the 16-character tenant UID, such as:

FNMS-SVM export -t 654SDF24SD6F5Z74