manta(1)

NAME
manta

SYNOPSIS
manta [--site] [-h|--help] [-V|--version] [subcommands]

DESCRIPTION

OPTIONS

--site <SITE_NAME>
    Override the active site for this invocation

-h, --help
    Print help

-V, --version
    Print version

SUBCOMMANDS

  manta config
Show or change CLI-side settings (active site, default node group, log level)

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta config show
Show current configuration values

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta config set
Set a configuration value

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta config set hsm
Set the active node group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

GROUP_NAME
    Node group name

  manta config set parent-hsm
Set the parent node group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

GROUP_NAME
    Node group name

  manta config set site
Set the active site

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

SITE_NAME
    Site name

  manta config set log
Set the log verbosity level

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

LOG_LEVEL
    Log verbosity level

  manta config unset
Clear a configuration value

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta config unset hsm
Clear the active node group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta config unset parent-hsm
Clear the parent node group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta config unset auth
Clear the cached authentication token

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get
Inspect groups, nodes, hardware, images, configurations, sessions, templates, and boot/kernel parameters

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get groups
List node groups visible to your token (or look up one by name)

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

[GROUP_NAME]
    Group name (lists all groups if omitted)

  manta get hardware
Inspect hardware components

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get hardware nodes
Show hardware inventory for a set of nodes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

NODES
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

  manta get hardware group
Show hardware inventory for a group

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

GROUP_NAME
    Group name

  manta get sessions
List configuration sessions

[-n, --name] <SESSION_NAME>
    Return only the session with this name

[-a, --min-age] <VALUE>
    Return only sessions older than this age (eg: '1d', '6h')

[-A, --max-age] <VALUE>
    Return only sessions younger than this age (eg: '1d', '6h')

[-t, --type] <VALUE>
    Return only sessions of this type

[-s, --status] <VALUE>
    Return only sessions with this status

[-m, --most-recent]
    Return only the most recent session (equivalent to --limit 1)

[-l, --limit] <VALUE>
    Return only the <VALUE> most recent sessions

[-o, --output] <FORMAT>
    Output format

[-x, --xnames] <NODES>
    Xnames, NIDs, or hostlist expression. Returns sessions targeting these nodes or their groups

[-H, --group] <GROUP_NAME>
    Node group name. Returns sessions targeting this group or its members

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get configurations
List CFS configurations (filter by name, glob, group, or recency)

[-n, --name] <NAME>
    Show only the configuration with this exact name

[-p, --pattern] <PATTERN>
    Glob pattern to filter by name (eg: 'my-cfg*')

[-m, --most-recent]
    Return only the most recent (equivalent to --limit 1)

[-l, --limit] <VALUE>
    Return only the <VALUE> most recent configurations

[-o, --output] <FORMAT>
    Output format

[-H, --group] <GROUP_NAME>
    Show only configurations whose layers target this group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get templates
List BOS session templates (filter by name, group, or recency)

[-n, --name] <NAME>
    Show only the template with this exact name

[-m, --most-recent]
    Return only the most recent (equivalent to --limit 1)

[-l, --limit] <VALUE>
    Return only the <VALUE> most recent templates

[-H, --group] <GROUP_NAME>
    Show only templates whose boot sets target this group

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get group-nodes
Show node details and status for a group

[-n, --nids-only-one-line]
    Print NIDs on a single line

[-x, --xnames-only-one-line]
    Print xnames on a single line

[-s, --status] <VALUE>
    Filter nodes by status

[-T, --summary-status]
    Show a group status summary: OK — all nodes booted and configured OFF — at least one node is OFF ON — no nodes OFF, at least one is ON STANDBY — at least one node's heartbeat is lost UNCONFIGURED — all nodes READY but at least one is still being configured FAILED — at least one node's configuration failed

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

GROUP_NAME
    Group name

  manta get nodes
Show node details and status

[-n, --nids-only-one-line]
    Print NIDs on a single line

[-s, --status] <VALUE>
    Filter nodes by status

[-T, --summary-status]
    Show a node status summary: OK — all nodes booted and configured OFF — at least one node is OFF ON — no nodes OFF, at least one is ON STANDBY — at least one node's heartbeat is lost UNCONFIGURED — all nodes READY but at least one is still being configured FAILED — at least one node's configuration failed

[-S, --include-siblings]
    Also show sibling nodes that share a power supply with the requested nodes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

NODES
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

  manta get images
List IMS images (filter by id, name glob, or recency; sorted most-recent first)

[-i, --id] <IMAGE_ID>
    Show only the image with this exact ID

[-p, --pattern] <PATTERN>
    Glob matched against image name (e.g. 'compute-*'); applied server-side. Invalid glob returns 400.

[-m, --most-recent]
    Return only the most recent (equivalent to --limit 1)

[-l, --limit] <VALUE>
    Return only the <VALUE> most recent images

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get boot-parameters
Show the BSS boot parameters (kernel, initrd, params) for nodes or a group

[-H, --group] <GROUP_NAME>
    Show boot parameters for every node in this group

[-n, --nodes] <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get kernel-parameters
Show kernel parameters for nodes or a group

[-n, --nodes] <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[-H, --group] <GROUP_NAME>
    Show kernel parameters for all nodes in this group

[-f, --filter] <VALUE>
    Comma-separated list of parameter names to show. eg: 'console,bad_page,crashkernel,hugepagelist,root'

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta get redfish-endpoints
List the BMCs / controllers the hardware state manager has registered as Redfish endpoints

[-i, --id] <VALUE>
    Filter by xname (can be specified multiple times)

[-f, --fqdn] <VALUE>
    Filter by FQDN

[-u, --uuid] <VALUE>
    Filter by UUID

[-m, --macaddr] <VALUE>
    Filter by MAC address

[-I, --ipaddress] <VALUE>
    Filter by IP address (empty string matches endpoints without an IP)

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta add
Register new nodes, groups, boot/kernel parameters, hardware components, or Redfish endpoints

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta add node
Register a new node in the hardware state manager.

Use this for nodes that don't exist yet. To attach existing nodes to a group, use `manta add nodes` (plural).

-i, --id <XNAME>
    Xname to register

-g, --group <NAME>
    Group to put the new node into

[-H, --hardware] <FILE>
    File containing hardware information

[-a, --arch] <VALUE>
    Node architecture

[-d, --disabled]
    Register the node as disabled

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta add nodes
Add existing nodes to a group's membership.

Differs from `manta add node` (singular), which registers a brand-new node in the inventory; this command operates on nodes that already exist and just changes which group(s) they belong to.

-g, --group <NAME>
    Group to add the nodes to

-n, --nodes <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta add group
Create a node group

-l, --label <NAME>
    Group name

[-d, --description] <VALUE>
    Group description

[-n, --nodes] <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[--dry-run]
    Validate input and print the payload(s) that would be sent to the backend without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta add hardware
[experimental] Add hardware components to a group

[-P, --pattern] <PATTERN>
    Hardware component pattern

[-t, --target-group] <NAME>
    Group to add components to

[-p, --parent-group] <NAME>
    Group that donates the components

[-d, --dry-run]
    Simulate the operation without making changes

[-c, --create-group]
    Create the target group if it does not exist

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta add boot-parameters
Create a BSS boot-parameters entry (kernel, initrd, params, cloud-init) for one or more nodes

-H, --hosts <XNAMES>
    Xnames of the nodes

[-n, --nids] <VALUE>
    Comma-separated NIDs of the nodes

[-m, --macs] <VALUE>
    Comma-separated MAC addresses of the nodes

[-p, --params] <VALUE>
    Kernel parameters

[-k, --kernel] <VALUE>
    S3 path to the kernel file

[-i, --initrd] <VALUE>
    S3 path to the initrd file

[-c, --cloud-init] <VALUE>
    Cloud-init script

[-d, --dry-run]
    Simulate the operation without making changes

[-y, --assume-yes]
    Skip confirmation prompts

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta add kernel-parameters
Append kernel parameters to nodes (leaves existing parameters untouched unless --overwrite is set)

[-n, --nodes] <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[-H, --group] <GROUP_NAME>
    Append kernel parameters to every node in this group

[-o, --output] <FORMAT>
    Output format

[-O, --overwrite]
    Overwrite the value if the parameter already exists

[-y, --assume-yes]
    Skip confirmation prompts

[--do-not-reboot]
    Do not reboot nodes after applying changes

[-d, --dry-run]
    Simulate the operation without making changes

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

PARAMS
    Space-separated kernel parameters to append. eg: bos_update_frequency=4h console=ttyS0,115200 crashkernel=512M

  manta add redfish-endpoints
Register a new Redfish endpoint

-i, --id <XNAME>
    Xname of the BMC or controller

[-n, --name] <VALUE>
    Arbitrary user-provided name for the endpoint

[-H, --hostname] <VALUE>
    Hostname (FQDN host portion); normally identical to the xname

[-d, --domain] <VALUE>
    Domain (FQDN domain portion)

[-f, --fqdn] <VALUE>
    Fully-qualified domain name on the management network (derived from hostname + domain)

[-e, --enabled]
    Enable the endpoint upon creation

[-u, --user] <VALUE>
    Username for endpoint authentication

[-p, --password] <VALUE>
    Password for endpoint authentication

[-U, --use-ssdp]
    Use SSDP for discovery if the endpoint supports it

[-m, --mac-required]
    Require a MAC address for geolocation

[-M, --macaddr] <VALUE>
    MAC address of the Redfish endpoint on the management network

[-I, --ipaddress] <VALUE>
    IP address of the Redfish endpoint on the management network (IPv4 or IPv6)

[-r, --rediscover-on-update]
    Trigger rediscovery when endpoint information is updated

[-t, --template-id] <VALUE>
    Discovery template ID

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta apply
Roll out configurations, images, session templates, boot/kernel parameters, and hardware rescaling

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta apply hardware
[experimental] Rescale a group's hardware allocation

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta apply hardware group
[experimental] Upscale or downscale a group by specifying a hardware component pattern.

If the group does not exist it will be created; otherwise its node assignment is updated.

Pattern format: <component>:<quantity>[:<component>:<quantity>...] eg: 'a100:12:epyc:5' — assign nodes with 12 A100 GPUs and 5 EPYC CPUs total

-P, --pattern <PATTERN>
    Hardware pattern: <component>:<qty>[:<component>:<qty>...]. eg: 'a100:12:epyc:5'

-t, --target-group <TARGET_GROUP_NAME>
    Group to rescale

-p, --parent-group <PARENT_GROUP_NAME>
    Group that donates or receives the redistributed nodes

[-d, --dry-run]
    Simulate the operation without making changes

[-c, --create-target-group]
    Create the target group if it does not exist

[-D, --delete-empty-parent-group]
    Delete the parent group if empty after this operation

[-u, --unpin-nodes]
    Allow any available nodes to be selected

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta apply sat-file
Process a SAT file containing up to three sections:

- `configurations`: configurations to create - `images`: images to build from those configurations - `session_templates`: session templates to create

Use --image-only to process only configurations and images. Use --sessiontemplate-only to process only configurations and session templates.

-t, --sat-template-file <FILE>
    SAT file path (may be a jinja2 template)

[-f, --values-file] <FILE>
    Values file to expand jinja2 variables in the SAT file

[-V, --values] <VALUE>
    Inline values to expand jinja2 variables (overrides --values-file)

[--reboot]
    Reboot nodes after applying session templates

[-v, --ansible-verbosity] <VALUE>
    Ansible verbosity level (1 = -v, 2 = -vv, …, max 4)

[-P, --ansible-passthrough] <VALUE>
    Additional Ansible flags (limited to --extra-vars, --forks, --skip-tags, --start-at-task, --tags)

[-o, --overwrite-configuration]
    Overwrite an existing configuration with the same name

[-w, --watch-logs]
    Stream session logs to stdout

[-T, --timestamps]
    Show log timestamps

[-i, --image-only]
    Process only the `configurations` and `images` sections

[-s, --sessiontemplate-only]
    Process only the `configurations` and `session_templates` sections

[-p, --pre-hook] <SCRIPT>
    Command to run before processing. eg: --pre-hook "echo hello"

[-a, --post-hook] <SCRIPT>
    Command to run after successful processing. eg: --post-hook "echo hello"

[-y, --assume-yes]
    Skip confirmation prompts

[-d, --dry-run]
    Simulate the operation without making changes

[--output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta apply boot
Update boot parameters and runtime configuration

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta apply boot nodes
Update the boot parameters (image, runtime configuration, and kernel parameters) for a set of nodes.

The boot image can be specified by image ID or by the configuration name used to build it (the most recent matching image is used).

eg:
  manta apply boot nodes \
    --boot-image-configuration <config-name> \
    --runtime-configuration <config-name> <nodes>

[-i, --boot-image] <IMAGE_ID>
    Image ID to boot the nodes

[-b, --boot-image-configuration] <NAME>
    Configuration name used to build the boot image (uses the most recent matching image)

[-r, --runtime-configuration] <NAME>
    Configuration to apply to nodes after booting

[-k, --kernel-parameters] <VALUE>
    Kernel parameters to assign to the nodes

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

NODES
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

  manta apply boot group
Update the boot parameters (image, runtime configuration, and kernel parameters) for all nodes in a group.

The boot image can be specified by image ID or by the configuration name used to build it (the most recent matching image is used).

eg:
  manta apply boot group \
    --boot-image-configuration <config-name> \
    --runtime-configuration <config-name> <group-name>

[-i, --boot-image] <IMAGE_ID>
    Image ID to boot the nodes

[-b, --boot-image-configuration] <NAME>
    Configuration name used to build the boot image (uses the most recent matching image)

[-r, --runtime-configuration] <NAME>
    Configuration to apply to nodes after booting

[-k, --kernel-parameters] <VALUE>
    Kernel parameters to assign to all group members

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

GROUP_NAME
    Group name

  manta apply boot-parameters
Update boot parameters for nodes

-H, --hosts <XNAMES>
    Xnames of the nodes to update

[-p, --params] <VALUE>
    Kernel parameters

[-k, --kernel] <VALUE>
    S3 path to the kernel file

[-i, --initrd] <VALUE>
    S3 path to the initrd file

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta apply redfish-endpoints
Update an existing Redfish endpoint

-i, --id <XNAME>
    Xname of the endpoint to update

[-n, --name] <VALUE>
    Arbitrary user-provided name for the endpoint

[-H, --hostname] <VALUE>
    Hostname (FQDN host portion)

[-d, --domain] <VALUE>
    Domain (FQDN domain portion)

[-f, --fqdn] <VALUE>
    Fully-qualified domain name on the management network

[-e, --enabled]
    Enable the endpoint

[-u, --user] <VALUE>
    Username for endpoint authentication

[-p, --password] <VALUE>
    Password for endpoint authentication

[-U, --use-ssdp]
    Use SSDP for discovery if the endpoint supports it

[-m, --mac-required]
    Require a MAC address for geolocation

[-M, --macaddr] <VALUE>
    MAC address of the Redfish endpoint on the management network

[-I, --ipaddress] <VALUE>
    IP address of the Redfish endpoint on the management network (IPv4 or IPv6)

[-r, --rediscover-on-update]
    Trigger rediscovery when endpoint information is updated

[-t, --template-id] <VALUE>
    Discovery template ID

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta apply kernel-parameters
Replace the full kernel-parameters string on nodes (drops any existing parameters not listed)

[-n, --nodes] <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[-H, --group] <GROUP_NAME>
    Replace kernel parameters on every node in this group

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

PARAMS
    Space-separated kernel parameters to apply. eg: bos_update_frequency=4h console=ttyS0,115200 crashkernel=512M

  manta apply ephemeral-environment
Launch an ephemeral SSH environment from an image.

Returns an SSH hostname once the environment is ready (usually within a few seconds).

-i, --image-id <IMAGE_ID>
    Image ID to use

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta apply template
Boot nodes using an existing session template

[-n, --name] <VALUE>
    Name of the boot session to create

[-o, --operation] <VALUE>
    Boot operation to perform

-t, --template <VALUE>
    Session template name

-l, --limit <VALUE>
    Limit to specific nodes, groups, or roles (OR by default; prefix with '&' for AND or '!' for NOT)

[-i, --include-disabled]
    Include nodes marked as disabled in the hardware state manager

[-d, --dry-run]
    Simulate the operation without making changes

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta delete
Remove nodes, groups, images, configurations, sessions, boot/kernel parameters, or Redfish endpoints

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta delete group
Delete a node group.

The group must be empty before deletion. Move its members to another group with 'migrate nodes' first.

[-f, --force]
    Force deletion

[-d, --dry-run]
    Validate input and print the request that would be sent to the backend without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

GROUP_NAME
    Name of the group to delete

  manta delete node
Remove a node from the hardware state manager (the node disappears from the inventory). To only remove it from a group's membership without deleting it, use `manta delete nodes` (plural).

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

XNAME
    Xname of the node to remove

  manta delete nodes
Remove nodes from a group's membership.

Differs from `manta delete node` (singular), which removes a node from the system inventory entirely; this command leaves the nodes in place and only changes which group(s) they belong to.

-g, --group <NAME>
    Group to remove the nodes from

-n, --nodes <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta delete kernel-parameters
Remove kernel parameters from nodes (parameter values are ignored — match is by name)

[-n, --nodes] <NODES>
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

[-H, --group] <GROUP_NAME>
    Remove the listed kernel parameters from every node in this group

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

PARAMS
    Comma-separated kernel parameter names to remove. eg: console,bad_page,crashkernel,hugepagelist,quiet

  manta delete boot-parameters
Delete boot parameters for nodes

[-H, --hosts] <XNAMES>
    Xnames of the nodes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta delete configurations
Delete configurations and all associated data (sessions, session templates, boot sessions, and images).

Use --since and/or --until to filter by the configuration's last-updated date (format: %Y-%m-%d).

eg:
  --since 2023-01-01 --until 2023-10-01
    Deletes all configurations last updated between 2023-01-01 and 2023-10-01.

[-n, --configuration-name] <VALUE>
    Glob pattern to filter by name. eg: my-config*, my-config-v[1,2]

[-s, --since] <DATE>
    Delete configurations last updated after this date (format: %Y-%m-%d)

[-u, --until] <DATE>
    Delete configurations last updated before this date (format: %Y-%m-%d)

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta delete session
Delete a configuration session.

For image-building sessions, the associated image is also removed. For dynamic (runtime) sessions, the error count is set to its maximum value.

[-y, --assume-yes]
    Skip confirmation prompts

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

SESSION_NAME
    Name of the session to delete

  manta delete images
[experimental] Delete IMS images by ID (refuses to delete images currently booting a node)

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

IMAGE_IDS
    Comma-separated image IDs to delete. eg: e2ce82f0-e7ba-4f36-9f5c-750346599600,59e0180a-3fdd-4936-bba7-14ba914ffd34

  manta delete hardware
[experimental] Remove hardware components from a group

[-P, --pattern] <PATTERN>
    Hardware component pattern

[-t, --target-group] <TARGET_GROUP_NAME>
    Group to remove components from

[-p, --parent-group] <PARENT_GROUP_NAME>
    Group that receives the freed components

[-d, --dry-run]
    Simulate the operation without making changes

[-D, --delete-group]
    Delete the group if empty after this operation

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta delete redfish-endpoints
Delete a Redfish endpoint

-i, --id <XNAME>
    Xname of the Redfish endpoint to delete

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta migrate
Move nodes between groups

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta migrate nodes
Move nodes between clusters

[-f, --from] <NAME>
    Source cluster to move nodes from

-t, --to <NAME>
    Destination cluster to move nodes to

[-d, --dry-run]
    Simulate the operation without making changes

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

XNAMES
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1'

  manta backup
Back up a virtual cluster (images, boot settings, group membership) to disk

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta backup vcluster
Back up a virtual cluster's configuration: images, boot settings, and group membership.

The backup is derived from the specified session template.

[-b, --bos] <SESSIONTEMPLATE>
    Session template to derive the backup from

[-d, --destination] <FOLDER>
    Destination directory for the backup files

[-p, --pre-hook] <SCRIPT>
    Command to run before the backup. eg: --pre-hook "echo hello"

[-a, --post-hook] <SCRIPT>
    Command to run after a successful backup. eg: --post-hook "echo hello"

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta restore
Restore a virtual cluster from a backup bundle

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta restore vcluster
Restore a virtual cluster from a backup bundle

[-b, --bos-file] <FILE>
    Session template backup file

[-c, --cfs-file] <FILE>
    Configuration backup file

[-j, --hsm-file] <FILE>
    Group description backup file

[-m, --ims-file] <FILE>
    Image metadata backup file

[-i, --image-dir] <PATH>
    Directory containing the image files

[-p, --pre-hook] <SCRIPT>
    Command to run before the restore. eg: --pre-hook "echo hello"

[-a, --post-hook] <SCRIPT>
    Command to run after a successful restore. eg: --post-hook "echo hello"

[-o, --overwrite]
    Overwrite existing data

[--output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta run
Create and run a configuration session from a local Ansible repo

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta run session
Create and run a configuration session from a local git repo.

The repo must already exist in the system's VCS. The session runs the specified Ansible playbook against the target nodes or group.

-n, --name <VALUE>
    Session name

[-p, --playbook-name] <VALUE>
    Ansible playbook filename

-r, --repo-path <REPO_PATH>
    Path to the local git repo containing the Ansible playbook

[-w, --watch-logs]
    Stream session logs to stdout

[-t, --timestamps]
    Show log timestamps

[-v, --ansible-verbosity] <VALUE>
    Ansible verbosity level (1 = -v, 2 = -vv, …, max 4)

[-P, --ansible-passthrough] <VALUE>
    Additional Ansible flags (limited to --extra-vars, --forks, --skip-tags, --start-at-task, --tags)

-l, --ansible-limit <VALUE>
    Limit the session to specific nodes (must be a subset of --group if both are provided)

[-H, --group] <GROUP_NAME>
    Run the session against every node in this group

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta power
Power nodes on, off, or reset (reboot); waits for the transition unless --no-wait is set

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta power on
Power on nodes or a group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta power on group
Power on all nodes in a group

[-R, --reason] <TEXT>
    Reason for the power operation

[-y, --assume-yes]
    Skip confirmation prompts

[--no-wait]
    Return as soon as the transition is queued; don't poll for completion

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

GROUP_NAME
    Group name

  manta power on nodes
Power on a set of nodes

[-y, --assume-yes]
    Skip confirmation prompts

[--no-wait]
    Return as soon as the transition is queued; don't poll for completion

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

NODES
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

  manta power off
Power off nodes or a group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta power off group
Power off all nodes in a group

[-g, --graceful]
    Perform a graceful shutdown

[-R, --reason] <TEXT>
    Reason for the power operation

[-y, --assume-yes]
    Skip confirmation prompts

[--no-wait]
    Return as soon as the transition is queued; don't poll for completion

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

GROUP_NAME
    Group name

  manta power off nodes
Power off a set of nodes

[-g, --graceful]
    Perform a graceful shutdown

[-y, --assume-yes]
    Skip confirmation prompts

[--no-wait]
    Return as soon as the transition is queued; don't poll for completion

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

NODES
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

  manta power reset
Reset (reboot) nodes or a group

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta power reset group
Reset all nodes in a group

[-g, --graceful]
    Perform a graceful reboot

[-y, --assume-yes]
    Skip confirmation prompts

[--no-wait]
    Return as soon as the transition is queued; don't poll for completion

[-o, --output] <FORMAT>
    Output format

[-r, --reason] <TEXT>
    Reason for the power operation

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

GROUP_NAME
    Group name

  manta power reset nodes
Reset a set of nodes

[-g, --graceful]
    Perform a graceful reboot

[-y, --assume-yes]
    Skip confirmation prompts

[--no-wait]
    Return as soon as the transition is queued; don't poll for completion

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

NODES
    Xnames, NIDs, or a hostlist expression. eg: 'x1003c1s7b0n0,x1003c1s7b0n1', 'nid001313,nid001314', 'x1003c1s7b0n[0-1],x1003c1s7b1n0', 'nid00131[0-9]'

  manta log
Stream configuration session logs to stdout (accepts session, node, group, or NID)

[-t, --timestamps]
    Show log timestamps

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

[TARGET]
    Session name, node group, xname, or NID. eg: x1003c1s7b0n0, nid001313, zinal, batcher-64d35a81-d0e1-496d-9eda-0010e502f2a3

  manta console
Attach to a node's serial console, or to a configuration session's Ansible container

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

  manta console node
Connect to a node's serial console.

Accepts an xname or NID. eg: 'x1003c1s7b0n0' or 'nid001313'

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

XNAME
    Node xname or NID

  manta console target-ansible
Connect to the Ansible target container of a configuration session

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help

SESSION_NAME
    Configuration session name

  manta gen-autocomplete
Generate the shell completion script and install it into the shell's standard XDG user completion directory:

  bash → $XDG_DATA_HOME/bash-completion/completions/manta
  zsh → $XDG_DATA_HOME/zsh/site-functions/_manta
  fish → $XDG_CONFIG_HOME/fish/completions/manta.fish

Pass `--path <DIR>` to install elsewhere (e.g. a system-wide location or a directory already on your `$fpath`), or `--print` to emit the script to stdout without touching the filesystem.

[-s, --shell] <SHELL>
    Shell type (guessed from $SHELL if omitted)

[-p, --path] <PATH>
    Override the default install directory

[--print]
    Emit the script to stdout instead of installing it

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta gen-man
Generate the consolidated `manta.1` man page from the running binary's clap tree and write it into the target directory. The page has a top-level reference plus one SUBCOMMANDS subsection per (sub)subcommand, so `/<verb>` inside `man manta` jumps to the relevant flag table.

Defaults to `$XDG_DATA_HOME/man/man1` (i.e. `~/.local/share/man/man1`) when `--path` is omitted. The directory is created if it doesn't exist.

After install, configure your shell so `man` finds the new location — on Linux this directory is searched by default; on macOS you may need `export MANPATH="$HOME/.local/share/man:$MANPATH"`.

[-p, --path] <PATH>
    Directory to write `manta.1` into (defaults to $XDG_DATA_HOME/man/man1)

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')

  manta upgrade
Fetch the highest `manta-cli-v*` tag from https://github.com/eth-cscs/manta/releases, compare against the current version, and (if newer) download the right platform tarball and atomically replace the running binary.

Use `brew upgrade manta-cli` instead if you installed via Homebrew — this command will warn but not block in that case.

[-c, --check]
    Check for a newer version and print it, but don't apply

[-d, --dry-run]
    Show what would happen without downloading or replacing

[-y, --assume-yes]
    Skip the confirmation prompt before replacing the binary

[-o, --output] <FORMAT>
    Output format

[--site] <SITE_NAME>
    Override the active site for this invocation

[-h, --help]
    Print help (see a summary with '-h')