VM Manager Tool command-line options
Apart from basic commands that allow you to create connections to VM managers and check their status, you can use additional commands to run or remove the VM Manager Tool, encrypt passwords, or collect debug information for troubleshooting purposes.
The following table provides a list of command-line options that you can use when you run the VM Manager Tool. If you run the application without specifying any options, the help screen is displayed by default.
Option | Description | Applicable VM Manager Tool deployment type | Example |
---|---|---|---|
-addcertificate -alias unique_alias -file
vm_manager_certificate |
Adds a certificate to the VM Manager Tool keystore. Use
this option when the VM Manager Tool is set not to trust SSL
certificates from all defined VM managers (the vmman_trust_all_vm_managers_certificates parameter is
set to |
All |
|
![]() -changepassword -file file_path
|
Changes the default password to the VM Manager Tool keystore. For more information, see: Improving security of storing VM manager passwords. |
All |
|
![]() -convertcertificate |
Changes format of the VM Manager Tool keystore from JCEKS
to PKCS#12.
Important: Use this command only if you are upgrading the disconnected
VM Manager Tool from version earlier than 9.2.26.
|
Disconnected Other types of the VM Manager Tool have the VM Manager Tool keystore format changed automatically during the upgrade. |
|
-help |
Displays the help screen. It is the default option when no other option is specified. |
All | |
-install |
Installs the VM Manager Tool as a system service. Important: You must have the administrative or root privileges to use this
option.
|
Disconnected The local VM Manager Tool is installed automatically with the License Metric Tool server. The central and distributed VM Manager Tool is installed by running a fixlet from the BigFix console. |
|
![]() ![]() -install [-user user_name] |
Installs the VM Manager Tool as a system service and configures it to run as a specific user. Important: You must have the administrative or root privileges to use this
option.
To use this option, ensure that the following requirements are met.
File ownership When you use this option, the owner of all files that exist in the VM Manager Tool directory changes to the user that you specified. To avoid changing ownership of other files, create a dedicated directory for the VM Manager Tool files. Starting the VM Manager Tool Do not use the -run command to start the VM Manager Tool when you are logged in as root. Otherwise, the VM Manager Tool service is started as root and some of the files are inaccessible to the user that you specified. To start the VM Manager Tool, run the following command:
|
Disconnected | ./vmman.sh -install -user MyUser |
-passwd passwordString -config
file_path |
Encrypts a password for the VM manager from a configuration file that is specified in the config parameter. |
All |
|
![]() -regenerateencryptionkey |
Overwrites the default key that is used to encrypt passwords to VM managers. Run the command to increase security of storing the passwords. For more information, see: Improving security of storing VM manager passwords. |
All |
|
-reloadconfig |
Reloads all configuration files and updates the parameters in the memory of the VM Manager Tool. Tip: Use this option each time a new VM manager connection is defined to load the newly
created configuration.
|
Central, distributed, and disconnected You can use this option only if the VM Manager Tool runs as a system service. |
|
-remove |
Removes the VM Manager Tool from the service registry. Important: You must have the administrative or root privileges to use this
option.
|
Disconnected The local VM Manager Tool is uninstalled automatically with the License Metric Tool server. The central and distributed VM Manager Tool is uninstalled by running a fixlet from the BigFix console. |
|
-retrievedebugdata |
Collects debug information from all defined VM managers and stores it in the
debugData.zip file that is in the main directory of the VM Manager Tool. The collected information includes:
|
All |
|
-run |
Starts the VM Manager Tool in service mode. In this mode, data is collected for all defined VM managers repeatedly at the interval that is set in the vmm_polling_time_interval parameter. To use this option, you must install the VM Manager Tool as a system service. Important:
![]() |
Central, distributed, and disconnected Do not use this command to run the local VM Manager Tool tool. The local VM Manager Tool is started together with the License Metric Tool server. |
|
-runonce [-config file_path] |
Collects data from all defined VM managers once and exits the VM Manager Tool. To collect data from a particular VM manager, use the
|
All |
|
-status [-config file_path] |
Displays the operation status for all VM managers. If the file path is specified, the operation status for the particular VM manager is displayed. To see the information about all operation statuses, see: VM manager statuses. |
All |
|
-stop |
Stops the VM Manager Tool that was started as a system service. |
Central, distributed, and disconnected Do not use this command to stop the local VM Manager Tool tool. To stop the local VM Manager Tool, stop the License Metric Tool server. |
|
-testconnection [-config
file_path] |
Tests connections to all defined VM managers. If no VM manager connection is defined, the command output is empty. To collect data from a particular VM manager, use the |
All |
|