VM Manager Tool settings

You can configure settings of VM Manager Tool by editing the vmmmainconf.properties file that is stored in the BES Client\LMT\VMMAN\config directory.

Important: The following settings cannot be changed for the main instance of VM Manager Tool that is installed on the BigFix server. Any changes are overwritten during the next action performed on VM managers. To configure VM managers on the main instance of VM Manager Tool, see: Adding VM managers in central mode.
Table 1. Global configuration parameters
Parameter Unit Default Minimum Maximum
check_vm_managers_uniqueness

Distinguishes unique VM managers from duplicates.

 Boolean (true/false) True
uuid_filtering_enabled

Enables UUID filtering.

 Boolean (true/false) False
9.2.2 vmm_collecting_hostnames_enabled

Specifies whether host names should be collected and saved in the log files. Available for VMware.

You can enable this parameter to solve problems with duplicated UUIDs. In the case of found duplicates, the host names are written in the log files.

 Boolean (true/false) False
9.2.3 vmm_collecting_host_serials_enabled

Specifies whether serial numbers of VM manager hosts are collected for VM managers from which data is collected by the VM Manager tool. Available for Hyper-V, VMware 5.0 and higher, and Oracle VM Server for x86.

To display information about serial numbers in the Server ID column on the reports, adjust the Server ID template that is specified by the managedServerTagTemplate parameter. For more information, see: Advanced server settings.

 Boolean (true/false) False
vmm_connection_timeout

Specifies the time after which the connection with a VM manager is ended.

 Seconds 90 10 3600 (1 hour)
vmm_data_transfer_period

Determines how often the scan data is transferred to the agent to be uploaded to the server if subsequent scans have the same results.

 Minutes 720 0 10080
9.2.7 vmm_fix_parameters_enabled

Attempts to fix the most common problems with VM manager connection parameters, such as adding default URL suffix, correcting the user name format, and testing the WinRM and PowerShell protocols for Hyper-V VM managers.

 Boolean (true/false) False
9.2.7 vmm_http_connection_allowed

Allows the VM manager to connect by using the HTTP protocol when the defined HTTPS connection is not available.

 Boolean (true/false) True
9.2.9 vmm_keystore_password_do_not_change_it

Contains the encrypted password to the VM Manager tool keystore. The parameter is specified only if you changed the default password by using the regeneratekeystorepassword command. For more information, see: Improving security of storing VM manager passwords.
Important: Do not change the value of this parameter.
vmm_max_subsequent_login_failures

Specifies the maximum number of failed login attempts in to the VM manager. The default value of vmm_max_subsequent_login_failures should be set as 0 to avoid connection timeout. This scenario is applicable when using PowerShell framework. When the value is set as 0, the VM manager tool attempts connecting to the VM manager for unlimited times (irrespective of the framework used).

The value when set to 3, the VM Manager tools attempts for 3 times and then it stops attempting. To resolve this, try the following options:

  • change the username and/or password
  • change the hypervisor address
  • restart VM manager tool
  • edit configuration in the file

The status of VM Manager changes as per the value you set. For example, when the value is set as 3, the status changes to 'Invalid credentials - suspended' and when the value is set as 0, the status changes to 'Invalid credentials - attempting'. For more information on statuses, refer to VM manager statuses.

 Number 3 0 100
vmm_polling_time_interval

Specifies the interval between the consecutive retrievals of data from VM managers.

Restriction: In case of subcapacity reporting, it is necessary to capture mobility of VMs. To ensure that it is captured, data from VM managers must be collected every 30 minutes. You can change the frequency of collecting data only if you use BigFix Inventory for purposes other than subcapacity reporting.
 Minutes 30 30 10080 (1 week)
9.2.8 vmm_rmi_protocol

Specifies the protocol that is used for internal communication through the port that is specified in the vmm_rmi_ssl_port parameter when you run the reloadconfig or stop commands.

Possible values are:
  • SSL
  • SSLv3
  • TLSv1
  • TLSv1.1
  • TLSv1.2
  • TLS 1.3
 String TLSv1.2
vmm_rmi_ssl_port

Specifies the port that is used for internal communication when you run the reloadconfig or stop commands.

 Number 25001
9.2.7 vmm_slm_tags_file_size_limit

The maximum size of each .slmtag file that is used to collect VMware license metric utilization.

 Bytes 10240 10240 1048576
9.2.7 vmm_slm_tags_files_per_software

The maximum number of .slmtag files that are stored on the computer for each license key under VMware instance.

 Number 10 1 100
9.2.7 vmm_slm_tags_enabled

Enables collection of license metric utilization for VMware VM managers. If set to true, .slmtag files are created locally and collected by the resource utilization scan.

 Boolean (true/false) False
vmm_thread_pool_size

Specifies the number of threads in thread pool that is used for connections to VM managers.

 Number 10 1 50
9.2.4 vmm_transfer_credentials_to_server

Specifies whether VM manager credentials are transferred to the server. The option is enabled by default. If you disable the option, the credentials are not transferred and thus they are not displayed on the VM Managers panel when you edit the VM manager.

Boolean (true/false) True
9.2.4 vmm_trust_all_vm_managers_certificates

Specifies whether SSL certificates from all defined VM managers are trusted. If the option is disabled, certificates that are trusted must be placed in the truststore on the computer where the VM Manager Tool is installed. For more information, see: Configuring VM Manager tool to accept trusted VM manager certificates.

 Boolean (true/false) True