Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

22.2. The Engine Configuration Tool

22.2.1. The Engine Configuration Tool
Copy link

The engine configuration tool is a command-line utility for configuring global settings for your Red Hat Virtualization environment. The tool interacts with a list of key-value mappings that are stored in the engine database, and allows you to retrieve and set the value of individual keys, and retrieve a list of all available configuration keys and values. Furthermore, different values can be stored for each configuration level in your Red Hat Virtualization environment.

Note

Neither the Red Hat Virtualization Manager nor Red Hat JBoss Enterprise Application Platform need to be running to retrieve or set the value of a configuration key. Because the configuration key value-key mappings are stored in the engine database, they can be updated while the postgresql service is running. Changes are then applied when the ovirt-engine service is restarted.

22.2.2. Syntax for the engine-config Command
Copy link

You can run the engine configuration tool from the machine on which the Red Hat Virtualization Manager is installed. For detailed information on usage, print the help output for the command: 

# engine-config --help
Copy to Clipboard Toggle word wrap

Common tasks:

  • List available configuration keys 

    # engine-config --list
    Copy to Clipboard Toggle word wrap

  • List available configuration values 

    # engine-config --all
    Copy to Clipboard Toggle word wrap

  • Retrieve value of configuration key 

    # engine-config --get KEY_NAME
    Copy to Clipboard Toggle word wrap

    Replace KEY_NAME with the name of the preferred key to retrieve the value for the given version of the key. Use the --cver parameter to specify the configuration version of the value to be retrieved. If no version is provided, values for all existing versions are returned.

  • Set value of configuration key 

    # engine-config --set KEY_NAME=KEY_VALUE --cver=VERSION
    Copy to Clipboard Toggle word wrap

    Replace KEY_NAME with the name of the specific key to set, and replace KEY_VALUE with the value to be set. You must specify the VERSION in environments with more than one configuration version.

  • Restart the ovirt-engine service to load changes

    The ovirt-engine service needs to be restarted for your changes to take effect. 

    # systemctl restart ovirt-engine.service
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat