Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

4.2. Administering the Manager Virtual Machine

The hosted-engine utility is provided to assist with administering the Manager virtual machine. It can be run on any self-hosted engine nodes in the environment. For all the options, run hosted-engine --help. For additional information on a specific command, run hosted-engine --command --help. See Section 3.1, “Troubleshooting the Manager Virtual Machine” for more information.

The following procedure shows you how to update the self-hosted engine configuration file (/var/lib/ovirt-hosted-engine-ha/broker.conf) on the shared storage domain after the initial deployment. Currently, you can configure email notifications using SMTP for any HA state transitions on the self-hosted engine nodes. The keys that can be updated include: smtp-server, smtp-port, source-email, destination-emails, and state_transition.

Updating the Self-Hosted Engine Configuration on the Shared Storage Domain

  1. On a self-hosted engine node, set the smtp-server key to the desired SMTP server address:

    # hosted-engine --set-shared-config smtp-server --type=broker

    To verify that the self-hosted engine configuration file has been updated, run:

    # hosted-engine --get-shared-config smtp-server --type=broker
    broker :, type : broker
  2. Check that the default SMTP port (port 25) has been configured:

    # hosted-engine --get-shared-config smtp-port --type=broker
    broker : 25, type : broker
  3. Specify an email address you want the SMTP server to use to send out email notifications. Only one address can be specified.

    # hosted-engine --set-shared-config source-email --type=broker
  4. Specify the destination email address to receive email notifications. To specify multiple email addresses, separate each address by a comma.

    # hosted-engine --set-shared-config destination-emails, --type=broker

To verify that SMTP has been properly configured for your self-hosted engine environment, change the HA state on a self-hosted engine node and check if email notifications were sent. For example, you can change the HA state by placing HA agents into maintenance mode. See Section 4.1, “Maintaining the Self-Hosted Engine” for more information.