https://github.com/wojtekwanczyk/easy_manage
Easy remote server management
https://github.com/wojtekwanczyk/easy_manage
in-band ipmi out-of-band python python-3 python3 redfish ssh
Last synced: 3 months ago
JSON representation
Easy remote server management
- Host: GitHub
- URL: https://github.com/wojtekwanczyk/easy_manage
- Owner: wojtekwanczyk
- License: gpl-3.0
- Created: 2019-04-08T18:25:32.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-01-04T21:53:03.000Z (over 5 years ago)
- Last Synced: 2025-03-10T19:54:08.878Z (4 months ago)
- Topics: in-band, ipmi, out-of-band, python, python-3, python3, redfish, ssh
- Language: Python
- Homepage:
- Size: 411 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# easy-manage :fish:
This python package has been created to facilitate remote server management.
It is focused on out-of-band management through IPMI and Redefish standards, however,
it is possible to perform in-band management with it.
The reason of creation of such package is need to unify server management regardless of
standard or protocol we use below. Easy-manage delivers unified management interface.
Easy-manage is able to connet either Network Interface Card assigned to BMC or whole system.
You can give multiple IP addresses to ControllerFactory and it will try to connect to all of them.
Example config:
```
from easy_manage.tools import Protocol
from easy_manage import Credentials
bmc_credentials = Credentials('username', 'password')
system_credentials = Credentials('username2', 'password2')
config = {
Protocol.REDFISH: {
'address': bmc_ip_address,
'credentials': bmc_credentials
},
Protocol.IPMI: {
'address': bmc_ip_address,
'credentials': bmc_credentials
},
Protocol.BASH: {
'address': system_ip_address,
'credentials': system_credentials
},
}
```
Above configuration will enable user to connect to device with all three accessible protocols.
To create abstract controller over theses interfaces, we need to use ControllerFactory
```
controller = ControllerFactory.get_controller(config)
```
Now it is ready to use.
```
# See all available system methods
print(ControllerFactory.get_methods(controller.system))
# See all available chassis methods
print(ControllerFactory.get_methods(controller.chassis))
# Test simple abstract methods
print(controller.chassis.get_power_state())
print(controller.system.get_led_state())
controller.system.power_on()
```
Connector depending on its configuration is able to aggregate up to three components:
- System
- Chassis
- Shell
You can get bulk data from every component using pre-defined methods `redings()`, `static_data()` and `raw_data()` on controller components.
```
from pprint import pprint
pprint(controller.shell.readings())
pprint(controller.system.static_data())
pprint(controller.chassis.raw_data())
```
What is important, you can invoke methods through any connected component interface by referencing it explicitly. Above calls could be transformed to:
```
from pprint import pprint
pprint(controller.components['shell']['bash'].readings())
pprint(controller.components['system']['redfish'].static_data())
pprint(controller.components['chassis']['redfish'].raw_data())
# PowerShell is not supported yet
#pprint(controller.components['shell']['power_shell'].readings())
pprint(controller.components['system']['ipmi'].static_data())
pprint(controller.components['system']['ipmi'].static_data())
```
See more examples in demo/demo.py
Package has been designed to provide command line tool but it has not been binded with implemented functionalities yet.
Please note that this package came into existence as a part of bachelor's thesis and has not
been commercially used and thus may be buggy.