A virtual BMC for controlling virtual machines using IPMI commands.
Go to file
Jay Faulkner f97e1946d3 Document VirtualBMC is not for production use
VirtualBMC is not a tool designed for production use; ensure this is
explicitly documented in the readme.

Story #2010382
Task #46661

Change-Id: I581b96b93d9b24f650ac0c6280d074708ec69ef4
2022-10-26 08:27:30 -07:00
doc remove unicode from code 2022-08-24 20:29:21 +08:00
releasenotes preserve secure information on xml changes 2022-10-25 18:50:18 +00:00
virtualbmc preserve secure information on xml changes 2022-10-25 18:50:18 +00:00
zuul.d Remove support for Python 3.6 and 3.7 2022-06-17 14:41:34 +02:00
.coveragerc Switch to using stestr 2018-06-20 09:23:50 -04:00
.gitignore Merge "Switch to using stestr" 2018-07-18 20:21:39 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:45:25 +00:00
.stestr.conf Switch to using stestr 2018-06-20 09:23:50 -04:00
CONTRIBUTING.rst Update bug tracker url for storyboard 2018-03-26 13:58:20 -07:00
HACKING.rst Update the documentation link for doc migration 2017-07-25 14:06:06 +08:00
LICENSE Initial Commit with code 2016-02-11 15:55:51 +00:00
README.rst Document VirtualBMC is not for production use 2022-10-26 08:27:30 -07:00
bindep.txt Fix doc build failure 2020-05-25 10:44:18 +02:00
requirements.txt Fix lower-constraints for ubuntu focal 2020-09-11 15:21:32 -05:00
setup.cfg Remove support for Python 3.6 and 3.7 2022-06-17 14:41:34 +02:00
setup.py Cleanup py27 support 2020-04-05 20:21:05 +02:00
test-requirements.txt Add doc/requirements 2021-01-04 18:19:04 +01:00
tox.ini Use zed jobs 2022-05-05 17:07:54 +02:00

README.rst

VirtualBMC

Team and repository tags

image

Overview

A virtual BMC for controlling virtual machines using IPMI commands.

This software is intended for CI and development use only. Please do not run VirtualBMC in a production environment for any reason.

Installation

pip install virtualbmc

Supported IPMI commands

# Power the virtual machine on, off, graceful off, NMI and reset
ipmitool -I lanplus -U admin -P password -H 127.0.0.1 power on|off|soft|diag|reset

# Check the power status
ipmitool -I lanplus -U admin -P password -H 127.0.0.1 power status

# Set the boot device to network, hd or cdrom
ipmitool -I lanplus -U admin -P password -H 127.0.0.1 chassis bootdev pxe|disk|cdrom

# Get the current boot device
ipmitool -I lanplus -U admin -P password -H 127.0.0.1 chassis bootparam get 5

Project resources

Project status, bugs, and requests for feature enhancements (RFEs) are tracked in StoryBoard: https://storyboard.openstack.org/#!/project/openstack/virtualbmc

For information on how to contribute to VirtualBMC, see https://docs.openstack.org/virtualbmc/latest/contributor