VM Manager Tool configuration parameters

Edit online

To configure settings of the VM Manager Tool, edit the vmmmainconf.properties file.

Important: The following parameters are used to configure the distributed or disconnected VM Manager Tool. To configure the local or central VM Manager Tool, change the parameters through the License Metric Tool user interface. Only the vmm_rmi_ssl_port and vmm_rmi_protocol parameters should be changed in the configuration file for local and central VM Manager Tool. For more information, see: Advanced configuration of basic VM management.
The vmmmainconf.properties file is by default stored in the following directory.
  • For local VM Manager Tool
    • Linux opt/ibm/LMT/VMMAN/config
    • Windows C:\Program Files\ibm\LMT\VMMAN\config
  • For central and distributed VM Manager Tool
    • Linux /var/opt/BESClient/LMT/VMMAN/config
    • Windows C:\Program Files (x86)\BigFix Enterprise\BES Client\LMT\VMMAN\config
  • For disconnected VM Manager Tool
    • Linux VM Manager Tool install dir/config
    • Windows VM Manager Tool install dir\config
Table 1. VM Manager Tool configuration parameters
Parameter Unit Default Minimum Maximum
check_vm_managers_uniqueness

Checks the uniqueness of the VM manager's URL.

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

You can enable this parameter to solve problems with duplicated UUIDs. If duplicates are found, 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.

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

When the same results are generated, the parameter determines how much time must pass for a new package to be created. By default, a new package is created when the same results are generated for 12 hours in a row.

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

Allows the VM Manager to connect using the insecure HTTP protocol. If not allowed, even if vmm_http_connection_allowed is set to true, the VM Manager Tool will not attempt to fall back to HTTP.

 Boolean (true/false) False    
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 attempts of logging in to the VM manager.

 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 License Metric Tool 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
 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 1024 65535
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