9.9. list

9.9.1. list appliance

rocks list appliance [appliance...]

Lists the appliances defined in the cluster database.

arguments

[appliance]

Optional list of appliance names.

examples

$ rocks list appliance

List all known appliances.

9.9.2. list appliance attr

rocks list appliance attr [appliance]

Lists the set of attributes for appliances.

arguments

[appliance]

Name of appliance

examples

$ rocks list appliance attr compute

List the attributes for compute appliances

9.9.3. list appliance route

rocks list appliance route [appliance]

Lists routes associated with a set of appliances

arguments

[appliance]

Name of appliance (can be also a sql regexp)

examples

$ rocks list appliance route compute

List the routes for compute appliance

9.9.4. list appliance xml

rocks list appliance xml [appliance...]

Lists the XML profile for a given appliance type. This is useful for high level debugging but will be missing any host specific variables. It cannot be used to pass into 'rocks list host profile' to create a complete Kickstart/Jumpstart profile.

arguments

[appliance]

Optional list of appliance names.

examples

$ rocks list appliance xml compute

Lists the XML profile for a compute appliance.

$ rocks list appliance xml

Lists the XML profile for all appliance types.

9.9.5. list attr

rocks list attr

Lists the set of global attributes.

examples

$ rocks list attr

List the global attributes.

9.9.6. list bootaction

rocks list bootaction

Lists the set of boot actions for hosts. Each boot action is a label that points to a command string. The command string is placed into a host-specific pxelinux configuration file. Example labels are 'install' and 'os' which point to command strings used to install and boot hosts respectively.

examples

$ rocks list bootaction

List the boot actions available for all known hosts.

9.9.7. list distribution

rocks list distribution [distribution...]

Lists the distributions defined in the cluster database.

arguments

[distribution]

Optional list of distribution names.

examples

$ rocks list distribution

List all known distribution definitions.

9.9.8. list firewall

rocks list firewall [category=index] [maxwidth=integer]

List the firewall rules for a particular category

arguments

[category=index]

[global,os,appliance,host]=index. list rules index (member) of category. e.g. os=linux, appliance=login, or host=compute-0-0. global, global=, and global=global all refer to the global category.

parameters

[maxwidth=integer]

Maximum width of comment and flags field. Default is 24.

9.9.9. list help

rocks list help [subdir=string]

The Help Command print the usage of all the registered Commands.

parameters

[subdir=string]

Relative of Python commands for listing help. This is used internally only.

examples

$ rocks list help

List help for all commands

$ rocks list help subdir=list/host

List help for all commands under list/host

9.9.10. list host

rocks list host [host...]

List the membership, CPU count and physical position info for a list of hosts.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

examples

$ rocks list host compute-0-0

List info for compute-0-0.

$ rocks list host

List info for all known hosts.

9.9.11. list host alias

rocks list host alias [host...]

Lists the aliases for a host.

arguments

[host]

Zero, one or more host names. If no host names are supplied, aliases for all the known hosts is listed.

examples

$ rocks list host alias compute-0-0

List the aliases for compute-0-0.

$ rocks list host membership

List the aliases for all known hosts.

9.9.12. list host appliance

rocks list host appliance [host...]

Lists the appliance assignments for hosts. For each host supplied on the command line, this command prints the hostname and appliance assignment for that host.

arguments

[host]

Zero, one or more host names. If no host names are supplied, information for all hosts will be listed.

examples

$ rocks list host appliance compute-0-0

List the appliance assignment for compute-0-0.

$ rocks list host appliance compute-0-0 compute-0-1

List the appliance assignments for compute-0-0 and compute-0-1.

9.9.13. list host attr

rocks list host attr [host]

Lists the set of attributes for hosts.

arguments

[host]

Host name of machine

examples

$ rocks list host attr compute-0-0

List the attributes for compute-0-0.

9.9.14. list host boot

rocks list host boot [host...]

Lists the current bot action for hosts. For each host supplied on the command line, this command prints the hostname and boot action for that host. The boot action describes what the host will do the next time it is booted.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

examples

$ rocks list host boot compute-0-0

List the current boot action for compute-0-0.

$ rocks list host boot

List the current boot action for all known hosts.

9.9.15. list host firewall

rocks list host firewall [host...] [maxwidth=integer]

List the current firewall rules for the named hosts.

arguments

[host]

Zero, one or more host names. If no host names are supplied, the firewall rules for all the known hosts are listed.

parameters

[maxwidth=integer]

Maximum width of comment and flags field. Default is 24.

9.9.16. list host graph

rocks list host graph [host...] [arch=string] [basedir=string]

For each host, output a graphviz script to produce a diagram of the XML configuration graph. If no hosts are specified, a graph for every known host is listed.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

parameters

[arch=string]

Optional. If specified, generate a graph for the specified CPU type. If not specified, then 'arch' defaults to this host's architecture.

[basedir=string]

Optional. If specified, the location of the XML node files.

examples

$ rocks list host graph compute-0-0

Generates a graph for compute-0-0

9.9.17. list host installfile

rocks list host installfile [section=string]

Process an XML-based installation file and output an OS-specific installation file (e.g., a kickstart or jumpstart file).

parameters

[section=string]

Which section within the XML installation file to process (e.g., "kickstart", "begin", etc.).

examples

# rocks list host installfile section="kickstart"

Output a RedHat-compliant kickstart file.

9.9.18. list host interface

rocks list host interface [host...]

Lists the interface definitions for hosts. For each host supplied on the command line, this command prints the hostname and interface definitions for that host.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

examples

$ rocks list host interface compute-0-0

List network interface info for compute-0-0.

$ rocks list host interface

List network interface info for all known hosts.

9.9.19. list host key

rocks list host key [host...]

List the public keys for hosts.

arguments

[host]

Zero, one or more host names. If no host names are supplied, information for all hosts will be listed.

9.9.20. list host macs

rocks list host macs {host} [key=string] [status=bool]

Get a list of MAC addresses for all the hosts that are associated with a virtual cluster.

arguments

host

Host name of machine. This host name should be the name of the virtual frontend for the virtual cluster that you want the MAC addresses for.

parameters

[key=string]

A private key that will be used to authenticate the request. This should be a file name that contains the private key.

[status=bool]

If true, then for each VM-based cluster node, output the VM's status (e.g., 'active', 'paused', etc.).

9.9.21. list host membership

rocks list host membership [host...]

Lists the membership assignments for hosts. For each host supplied on the command line, this command prints the hostname and membership assignment for that host.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

examples

$ rocks list host membership compute-0-0

List the membership assignment for compute-0-0.

$ rocks list host membership

List the membership assignment for all known hosts.

9.9.22. list host partition

rocks list host partition [host...] [bigmnt=bool]

Lists the partitions for hosts. For each host supplied on the command line, this command prints the hostname and partitions for that host.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

parameters

[bigmnt=bool]

If true, then it will output only the biggest partition mount point (e.g. /state/partition1)

examples

$ rocks list host partition compute-0-0

List partition info for compute-0-0.

$ rocks list host partition

List partition info for known hosts.

9.9.23. list host profile

rocks list host profile [host...]

Outputs a XML wrapped Kickstart/Jumpstart profile for the given hosts. If not, profiles are listed for all hosts in the cluster. If input is fed from STDIN via a pipe, the argument list is ignored and XML is read from STDIN. This command is used for debugging the Rocks configuration graph.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

examples

# rocks list host profile compute-0-0

Generates a Kickstart/Jumpstart profile for compute-0-0.

# rocks list host xml compute-0-0 | rocks list host profile

Does the same thing as above but reads XML from STDIN.

9.9.24. list host roll

rocks list host roll [host]

List the assignment of rolls to frontend appliances.

arguments

[host]

Host name of machine

examples

$ rocks list host roll frontend-0-0-0

List the rolls assigned to frontend-0-0-0.

9.9.25. list host route

rocks list host route [host]

List the static routes that are assigned to a host.

arguments

[host]

Host name of machine

examples

$ rocks list host route compute-0-0

List the static routes assigned to compute-0-0.

9.9.26. list host sec_attr

rocks list host sec_attr {host}

Lists the secure attributes for a given host

arguments

host

Hostname(s)

9.9.27. list host xml

rocks list host xml [host...] [roll=string]

Lists the monolithic XML configuration file for hosts. For each host supplied on the command line, this command prints the hostname and XML file configuration for that host. This is the same XML configuration file that is sent back to a host when a host begins it's installation procedure.

arguments

[host]

Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.

parameters

[roll=string]

If set, only expand nodes from the named roll. If not supplied, then the all rolls are used.

examples

$ rocks list host xml compute-0-0

List the XML configuration file for compute-0-0.

$ rocks list host xml

List the XML configuration files for all known hosts.

9.9.28. list license

rocks list license

List the Rocks copyright.

examples

$ rocks list license

List the Rocks copyright.

9.9.29. list membership

rocks list membership [membership...]

Lists the memberships defined in the cluster database.

arguments

[membership]

Optional. A list of membership names. If no membership names are supplied, all the known memberships are listed.

examples

$ rocks list membership

List all known membership definitions.

9.9.30. list network

rocks list network [network...]

List the defined networks for this system.

arguments

[network]

Zero, one or more network names. If no network names are supplied, info about all the known networks is listed.

examples

$ rocks list network private

List network info for the network named 'private'.

$ rocks list network

List info for all defined networks.

9.9.31. list node xml

rocks list node xml [attrs=string] [basedir=string] [eval=bool] [gen=string] [missing-check=bool] [roll=string]

Lists the XML configuration information for a host. The graph traversal for the XML output is rooted at the XML node file specified by the 'node' argument. This command executes the first pre-processor pass on the configuration graph, performs all variable substitutions, and runs all eval sections.

parameters

[attrs=string]

A list of attributes. This list must be in python dictionary form, e.g., attrs="{ 'os': 'linux', 'arch' : 'x86_64' }"

[basedir=string]

If specified, the location of the XML node files.

[eval=bool]

If set to 'no', then don't execute eval sections. If not supplied, then execute all eval sections.

[gen=string]

If set, the use the supplied argument as the program for the 2nd pass generator. If not supplied, then use 'kgen'.

[missing-check=bool]

If set to 'no', then disable errors regarding missing nodes. If not supplied, then print messages about missing nodes.

[roll=string]

If set, only expand nodes from the named roll. If not supplied, then the all rolls are used.

examples

$ rocks list node xml compute

Generate the XML graph starting at the XML node named 'compute.xml'.

9.9.32. list os attr

rocks list os attr [os]

Lists the set of attributes for OSes.

arguments

[os]

Name of OS (e.g. "linux", "sunos")

examples

$ rocks list os attr linux

List the attributes for the Linux OS

9.9.33. list os route

rocks list os route [os]

Lists routes associated with a set of OSes

arguments

[os]

Name of the os (can be also a sql regexp)

examples

$ rocks list routes os linux

List the routes for linux os

9.9.34. list roll

rocks list roll [roll...]

List the status of available rolls.

arguments

[roll]

List of rolls. This should be the roll base name (e.g., base, hpc, kernel). If no rolls are listed, then status for all the rolls are listed.

examples

$ rocks list roll kernel

List the status of the kernel roll

$ rocks list roll

List the status of all the available rolls

9.9.35. list roll command

rocks list roll command [roll...]

List the commands provided by a roll.

arguments

[roll]

List of rolls. This should be the roll base names (e.g., base, hpc, kernel). If no rolls are listed, then commands for all the rolls are listed.

examples

$ rocks list roll command base

Returns the the list of commands installed by the Rocks base Roll.

9.9.36. list route

rocks list route

Lists global routes defined for this cluster

examples

$ rocks list routes

List all the global routes

9.9.37. list sec_attr

rocks list sec_attr

Lists the global routes defined for this cluster

examples

$ rocks list sec_attr

List all the global secutiry attributes