2018-01-22 19:18:03 +00:00
|
|
|
nodemedia(8) -- Manage server remote media
|
|
|
|
|
=========================================================
|
|
|
|
|
|
|
|
|
|
## SYNOPSIS
|
|
|
|
|
|
2018-02-23 19:26:40 +00:00
|
|
|
`nodemedia <noderange> [attach|detachall|list|upload] [options] <media>`
|
2018-01-22 19:18:03 +00:00
|
|
|
|
|
|
|
|
## DESCRIPTION
|
|
|
|
|
|
|
|
|
|
**nodemedia** manages the remote media functionality of supported BMCs.
|
|
|
|
|
|
|
|
|
|
`list` shows all the current remote media the BMCs of the noderange are
|
2018-01-23 15:23:56 +00:00
|
|
|
providing to the host platform. The string (insecure) is appended to URLs that
|
|
|
|
|
are mounted in an insecure fashion. http is insecure, and https is also
|
|
|
|
|
insecure when no meaningful certificate validation is performed. Currently
|
|
|
|
|
there is no action that can change this, and this is purely informational. A
|
|
|
|
|
future version of software may provide a means to increase security of attached
|
2018-07-17 15:20:27 +00:00
|
|
|
remote media. If no media is mounted, this will provide no output, error
|
|
|
|
|
conditions will result in output to standard error.
|
2018-01-22 19:18:03 +00:00
|
|
|
|
2018-01-22 20:56:59 +00:00
|
|
|
`detachall` removes all the currently provided media to the host. This unlinks
|
2018-01-22 19:18:03 +00:00
|
|
|
remote media from urls and deletes uploaded media from the BMC.
|
|
|
|
|
|
|
|
|
|
`upload` takes the given media image and uploads it to the BMC. This causes
|
|
|
|
|
the remote media to reside internally to the system without having to go
|
|
|
|
|
to the network after the upload. This is more constrained, for example the
|
|
|
|
|
Lenovo xClarity Controller has a limit of 50 megabytes, but it has zero ongoing
|
|
|
|
|
load on the media source.
|
|
|
|
|
|
|
|
|
|
`attach` takes a URL to a remote media as an argument, and has the given
|
|
|
|
|
BMCs map a virtual USB device to that url. Content is loaded on demand, and
|
|
|
|
|
as such that URL is referenced potentially once for every IO operation that
|
|
|
|
|
the host platform attempts.
|
|
|
|
|
|
2018-02-23 19:26:40 +00:00
|
|
|
## OPTIONS
|
|
|
|
|
|
2021-03-19 11:17:30 +00:00
|
|
|
* `-h`, `--help`:
|
|
|
|
|
Show help message and exit
|
2018-02-23 19:26:40 +00:00
|
|
|
|
2018-01-22 19:18:03 +00:00
|
|
|
## EXAMPLES
|
|
|
|
|
* Listing currently mounted media:
|
2018-02-22 21:03:41 +00:00
|
|
|
`# nodemedia s1-s4 list`
|
|
|
|
|
`s1: boot.img`
|
|
|
|
|
`s2: boot.img`
|
|
|
|
|
`s4: boot.img`
|
2018-01-22 19:18:03 +00:00
|
|
|
|
|
|
|
|
* Uploading a small boot image to the BMC:
|
2018-02-22 21:03:41 +00:00
|
|
|
`# nodemedia s1-s4 upload boot.img`
|
|
|
|
|
`s1:complete: 100% s2:complete: 100% s3:complete: 100% s4:complete: 100%`
|
|
|
|
|
`s1: boot.img`
|
|
|
|
|
`s4: boot.img`
|
|
|
|
|
`s2: boot.img`
|
2018-01-22 19:18:03 +00:00
|
|
|
|
|
|
|
|
* Attaching a larger ISO for on-demand access:
|
2018-02-22 21:03:41 +00:00
|
|
|
`# nodemedia s1,s4 attach http://172.30.0.6/install/rhel74.iso`
|
2018-02-22 21:36:09 +00:00
|
|
|
`s4: http://172.30.0.6/install/rhel74.iso (insecure)`
|
|
|
|
|
`s1: http://172.30.0.6/install/rhel74.iso (insecure)`
|
