tenks/ansible/roles/virtualbmc-domain/README.md
Mark Goddard 13de0edd6c Install virtualbmc to system when SELinux is enabled
CentOS 8 nodepool images come with SELinux enabled, and prevent systemd
from accessing files in users' home directories. This prevents vbmcd
from starting.

To resolve this, install virtualbmc to the system when SELinux is
enabled.

Change-Id: I5d30aca2b1e1ae897568f6e11fceda39e0b06e17
2020-02-27 15:47:44 +00:00

29 lines
1.1 KiB
Markdown

Virtual BMC Domain
==================
This role configures a Libvirt domain in Virtual BMC. If `vbmc_state` is
`present`, it will ensure the domain is added and started; if `vbmc_state` is
`absent`, it will ensure the domain is stopped and deleted.
Requirements
------------
- Virtual BMC installed in a virtualenv
- Virtual BMC daemon running
Role Variables
--------------
- `vbmc_domain`: The name of the Libvirt domain to be added to Virtual BMC.
- `vbmc_virtualenv_path`: The path to the virtualenv in which Virtual BMC is
installed. Optional.
- `vbmc_ipmi_address`: The address on which Virtual BMC will listen for IPMI
traffic.
- `vbmc_ipmi_port`: The port on which Virtual BMC will listen for IPMI traffic.
- `vbmc_ipmi_username`: The IPMI username that Virtual BMC will use.
- `vbmc_ipmi_password`: The IPMI password that Virtual BMC will use.
- `vbmc_log_directory`: The directory in which to store Virtual BMC logs. If
not overridden from `None`, output will not be logged to a file.
- `vbmc_state`: Whether the domain should be `present` or `absent` in Virtual
BMC. Defaults to `present`.