x
/
pyghmi
Code Issues Proposed changes
A Pure python IPMI library
1,334 Commits 1 Branch 106 Tags 8.3 MiB
Python 99.9%
Go to file
Jarrod Johnson ed94d36d18 Handle out of order setting instances 
The data from the xClarity controller may not be sorted,
apply numeric sort on the way out.

Change-Id: Icd22a140bf6b558703b1006a41047ffbd6a1e3d8
 		2024-04-09 09:46:24 -04:00
doc Do not use openstackdocstheme 2021-02-17 11:05:53 +01:00
playbooks/legacy/tempest-devstack-ironic-pxe_ipmitool-pyghmi-src Replace openstack.org git:// URLs with https:// 2019-03-24 20:35:47 +00:00
pyghmi Handle out of order setting instances 2024-04-09 09:46:24 -04:00
zuul.d Add SMM2 VPD to configuration for SMM 2022-06-07 13:03:23 -04:00
.coveragerc Switch to stestr 2018-08-10 14:36:57 +02:00
.gitignore Add more file patterns for git to ignore 2018-08-10 12:42:20 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:49:52 +00:00
.stestr.conf Switch to stestr 2018-08-10 14:36:57 +02:00
CONTRIBUTING.rst Update package documentation 2018-08-17 12:04:36 +02:00
LICENSE Place project under Apache license 2.0 2013-06-24 14:15:39 -04:00
MANIFEST.in Catch more XCC variants 2024-02-12 08:46:11 -05:00
README Install scripts as well as library 2014-05-08 14:06:01 -04:00
README.md Fix minor .spec issues 2018-08-17 11:08:56 +02:00
builddeb Fix building under wheezy 2020-02-20 08:58:24 -05:00
buildrpm Enable package builds without pbr 2019-02-04 15:59:18 -05:00
makesetup Enable package builds without pbr 2019-02-04 15:59:18 -05:00
py27-constraints.txt Reconfigure tox 2021-01-29 15:36:11 +00:00
python-pyghmi.spec Add dateutil requirement for python2 users 2020-06-22 10:13:54 -04:00
python-pyghmi.spec.tmpl Add a spec template for rpm build 2019-09-24 16:33:15 -04:00
requirements.txt Reconfigure tox 2021-01-29 15:36:11 +00:00
setup.cfg Reconfigure tox 2021-01-29 15:36:11 +00:00
setup.py Refactor console scripts into entry points 2018-08-10 13:56:22 +02:00
setup.py.tmpl Add iDrac virtual cd/floppy 2022-01-06 16:03:25 -05:00
test-requirements.txt Add SMM2 VPD to configuration for SMM 2022-06-07 13:03:23 -04:00
tox.ini Improve tests 2021-10-18 14:28:18 +02:00
wheezy.patch Update the Wheezy patch 2019-02-08 15:22:53 -05:00

README.md

pyghmi

Pyghmi is a pure Python (mostly IPMI) server management library.

Building and installing

(These instructions have been tested on CentOS 7)

Clone the repository, generate the RPM and install it:

$ git clone https://github.com/openstack/pyghmi.git
$ cd pyghmi/
$ python setup.py bdist_rpm
$ sudo rpm -ivh dist/pyghmi-*.noarch.rpm

Using

There are a few use examples in the bin folder:

  • fakebmc: simply fakes a BMC that supports a few IPMI commands (useful for testing)
  • pyghmicons: a remote console based on SOL redirection over IPMI
  • pyghmiutil: an IPMI client that supports a few direct uses of pyghmi (also useful for testing and prototyping new features)
  • virshbmc: a BMC emulation wrapper using libvirt

Extending

If you plan on adding support for new features, you'll most likely be interested in adding your methods to pyghmi/ipmi/command.py. See methods such as get_users and set_power for examples of how to use internal mechanisms to implement new features. And please, always document new methods.

Sometimes you may want to implement OEM-specific code. For example, retrieving firmware version information is not a part of standard IPMI, but some servers are known to support it via custom OEM commands. If this is the case, follow these steps:

  • Add your generic retrieval function (stub) to the OEMHandler class in pyghmi/ipmi/oem/generic.py. And please, document its intent, parameters and expected return values.
  • Implement the specific methods that your server supports in subdirectories in the oem folder (consider the lenovo submodule as an example). A OEM folder will contain at least one class inheriting from OEMHandler, and optionally helpers for running and parsing custom OEM commands.
  • Register mapping policies in pyghmi/ipmi/oem/lookup.py so pyghmi knows how to associate a BMC session with the specific OEM code you implemented.

A good way of testing the new feature is using bin/pyghmiutil. Just add an extension for the new feature you just implemented (as a new command) and call it from the command line:

$ IPMIPASSWORD=passw0rd bin/pyghmiutil [BMC IP address] username my_new_feature_command