CLI tool is based on OpenStackClient with prefix
openstack baremetal introspection
.
All commands accept the following arguments:
--inspector-url
the Ironic Inspector API endpoint. If missing,
the endpoint will be fetched from the service catalog.--inspector-api-version
requested API version, see API Versioning
for details.$ openstack baremetal introspection start [--wait] [--check-errors] NODE_ID [NODE_ID ...]
NODE_ID
- Ironic node UUID or name;Note that the CLI call accepts several UUID’s and will stop on the first error.
Note
This CLI call doesn’t rely on Ironic, and the introspected node will be
left in MANAGEABLE
state. This means that the Ironic node is not
protected from other operations being performed by Ironic, which could
cause inconsistency in the node’s state, and lead to operational errors.
With --wait
flag it waits until introspection ends for all given nodes,
then displays the results as a table.
The --check-errors
flag verifies if any error occurred during the
introspection of the selected nodes while waiting for the results. If any error
has occurred in the introspection result of selected nodes no output is
displayed, otherwise it shows the result as a table.
Note
--check-errors
can only be used with --wait
$ openstack baremetal introspection status NODE_ID
NODE_ID
- Ironic node UUID or name.Returns following information about a node introspection status:
error
: an error string or None
finished
: True/False
finished_at
: an ISO8601 timestamp or None
if not finishedstarted_at
: an ISO8601 timestampuuid
: node UUIDThis command supports pagination.
$ openstack baremetal introspection list [--marker] [--limit]
--marker
the last item on the previous page, a UUID--limit
the amount of items to list, an integer, 50 by defaultShows a table with the following columns:
Error
: an error string or None
Finished at
: an ISO8601 timestamp or None
if not finishedStarted at
: and ISO8601 timestampUUID
: node UUIDNote
The server orders the introspection status items according to the
Started at
column, newer items first.
$ openstack baremetal introspection data save [--file file_name] NODE_ID
NODE_ID
- Ironic node UUID or name;file_name
- file name to save data to. If file name is not provided,
the data is dumped to stdout.Note
This feature requires Swift support to be enabled in Ironic Inspector
by setting [processing]store_data
configuration option to swift
.
$ openstack baremetal introspection abort NODE_ID
NODE_ID
- Ironic node UUID or name.$ openstack baremetal introspection reprocess NODE_ID
NODE_ID
- Ironic node UUID or name.Note
This feature requires Swift store to be enabled for Ironic Inspector
by setting [processing]store_data
configuration option to swift
.
$ openstack baremetal introspection rule import <JSON FILE>
rule_json
dictionary with a rule representation, see
ironic_inspector_client.RulesAPI.from_json()
for details.$ openstack baremetal introspection rule list
Returns list of short rule representations, containing only description, UUID and links.
$ openstack baremetal introspection rule purge
Starting with baremetal introspection API 1.5 (provided by Ironic Inspector 3.3.0) it’s possible to use node names instead of UUIDs in all Python and CLI calls.
$ openstack baremetal introspection interface list NODE_IDENT
[--fields=<field>] [--vlan=<vlan>]
NODE_IDENT
- Ironic node UUID or namefields
- name of one or more interface columns to display.vlan
- list only interfaces configured for this vlan idReturns a list of interface data, including attached switch information, for each interface on the node.
$ openstack baremetal introspection interface show NODE_IDENT INTERFACE
[--fields=<field>]
NODE_IDENT
- Ironic node UUID or nameINTERFACE
- interface name on this nodefields
- name of one or more interface rows to display.Show interface data, including attached switch information, for a particular node and interface.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.