Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/m-lab/bmctool
BMCTool is a command line tool to manage BMC credentials on the M-Lab infrastructure.
https://github.com/m-lab/bmctool
Last synced: about 1 month ago
JSON representation
BMCTool is a command line tool to manage BMC credentials on the M-Lab infrastructure.
- Host: GitHub
- URL: https://github.com/m-lab/bmctool
- Owner: m-lab
- License: apache-2.0
- Created: 2019-05-07T14:42:39.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-06-09T13:49:22.000Z (7 months ago)
- Last Synced: 2024-10-29T16:02:05.895Z (about 2 months ago)
- Language: Go
- Size: 6.76 MB
- Stars: 0
- Watchers: 11
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://godoc.org/github.com/m-lab/bmctool) [](https://travis-ci.org/m-lab/bmctool) [](https://coveralls.io/github/m-lab/bmctool?branch=master) [](https://goreportcard.com/report/github.com/m-lab/bmctool)
# BMCTool
BMCTool is a command line tool to manage Baseband Management Controller credentials on the M-Lab infrastructure.
In particular, it allows to:
* Fetch credentials for the BMC module on a given node from Google Cloud Datastore
* Add a new node
* Update the credentials for an existing node
* Delete credentials for an existing node
* Reboot a node via its BMC, using the credentials in GCD to log in
* Automatically set up SSH forwarding to access the BMC's web interface and virtual console
If an entity is created or updated, output is provided in JSON format.
## Usage
### Common flags
```--project ```
Overrides the auto-detected project ID (based on the hostname format) with the specified ``.
If the project is not specified, it is inferred based on the hostname format. The regular expressions used to determine the project are the following, in decreasing priority order:
1. Sandbox: `[a-zA-Z]{3}[0-9]t` (e.g. `mlab1.lga0t`)
2. Staging: `^mlab4` (e.g. `mlab4.lga05`)
3. Production: anything that does not match the previous ones
### Fetch credentials
```bmctool get ```
Retrieves the credentials for ``.
### Add a new node
```bmctool add
```
Set the shell variables `BMCUSER` and `BMCPASS` to the appropriate values before running this command.
Creates the node `` with the provided `BMCUSER`, `BMCPASS` and `
`. If the specified node already exists or the required env variables are not set, the command will fail.
### Update an existing node
```bmctool set ```
Updates details for node ``. If `` does not exist, the command will fail.
A list of fields that can be updated can be retrieved with `bmctool set --help`.
For example, to set the address to 127.0.0.1
```bmctool set mlab1.lga0t --addr 127.0.0.1```
### Delete an existing node
```bmctool delete ```
Deletes the Credentials entity for ``. This works in the same way as Datastore's `Delete` operation, thus if `` does not exist, this command will not fail.
### Reboot a node
```bmctool reboot ```
Logs into the BMC for `` and reboots the node. Credentials are fetched from GCD.
### Forward ports via SSH
```bmctool forward ```
Runs the system-wide SSH command to connect to an authorized host and forward ports to the BMC.
Access to M-Lab's BMCs is restricted to a set of IP addresses, thus the only way to log into them is to connect from those.
This is normally used to access the BMC's web interface and its Virtual Console, thus the default behavior is to map ports 4443 -> 443 (to not require root privileges) and 5900 -> 5900. For a list of the available options: `bmctool forward --help`.