0.0
The project is in a healthy, maintained state
AMI BMC adapter for Radfish Redfish API client. Provides support for ASRockRack servers and other systems using AMI MegaRAC BMC firmware.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

~> 2.0
~> 13.0
~> 3.0
~> 3.0

Runtime

~> 0.6
~> 0.2
 Project Readme

Radfish-AMI

AMI BMC adapter for the Radfish Redfish API client. Provides support for ASRockRack servers and other systems using AMI MegaRAC BMC firmware.

Installation

Add this line to your application's Gemfile:

gem 'radfish-ami'

And then execute:

bundle install

Or install it yourself as:

gem install radfish-ami

Usage

The adapter is automatically registered when you require the gem:

require 'radfish-ami'

# Connect to an ASRockRack server
client = Radfish.connect(
  host: 'bmc.example.com',
  username: 'admin',
  password: 'your-password',
  vendor: 'ami'  # or 'asrockrack'
)

# Get system information
puts client.system_info

# Power operations
puts client.power_status  # => "On"
client.power_restart(force: true)

# Virtual media
client.insert_virtual_media('http://example.com/boot.iso')
client.set_boot_override('Cd', persistent: false)
client.power_restart

# Thermal data
client.fans.each { |fan| puts "#{fan['Name']}: #{fan['Reading']} RPM" }
client.temperatures.each { |t| puts "#{t['Name']}: #{t['ReadingCelsius']}C" }

# Storage
client.storage_controllers.each do |controller|
  puts "Controller: #{controller.name}"
  client.drives(controller).each { |d| puts "  Drive: #{d['Name']}" }
end

# Disconnect
client.logout

Supported Features

  • Power Management: Power on, off, restart, cycle, status
  • System Information: Make, model, serial, BIOS version, CPU, memory, NICs
  • Thermal Monitoring: Fan speeds, temperatures
  • Power Monitoring: PSU status, power consumption
  • Storage: Controllers, drives, volumes
  • Virtual Media: Insert/eject ISO images
  • Boot Configuration: Set boot order, one-time boot overrides
  • Network Configuration: BMC network settings
  • Account Management: Create, delete, update user accounts
  • SEL Log: Read and clear system event logs
  • Task/Job Management: Monitor long-running operations

Tested Hardware

  • ASRockRack GENOAD8UD-2T/X550 (AMD EPYC)
  • Other ASRockRack servers with AMI MegaRAC BMC

License

MIT License - see LICENSE file.