= Go Redfish Utility (gru) :toc: :toclevels: 3

image:https://github.com/Cray-HPE/gru/actions/workflows/test.yml/badge.svg[link="https://github.com/Cray-HPE/gru/actions/workflows/test.yml",title="Test status"] image:https://github.com/Cray-HPE/gru/actions/workflows/lint.yml/badge.svg[link="https://github.com/Cray-HPE/gru/actions/workflows/lint.yml",title="Lint status"]

An asynchronous RedFish utility for interrogating and managing blade management controllers.

== Usage

[source,bash]

gru help

.Setting Credentials

• Environment Variables

• [source,bash]

  export USERNAME=admin export PASSWORD=password gru show system myserver-bmc.local

• Configuration File

• [source,yaml]

  ---

  username: admin password: password

• Configuration file with a general username/password and exceptions (for server10 use a different username and password)

• [source,yaml]

  ---

  username: admin password: password hosts: server10: username: root password: password

.Querying Servers

• Pass any number of hosts, delimited by spaces.

• [source,bash]

  gru show system myserver-bmc.local myotherserver-bmc.local

• Piping a list a space delimited list of hosts.

• [source,bash]

  grep -oP pattern /etc/hosts | tr -s '\n' ' ' | gru show system

== Development

[source,bash]

make gru ./gru