Base Roll: Users Guide: 
| ||
|---|---|---|
| Prev | Chapter 8. Command Reference | Next |
rocks list appliance [appliance...]
Lists the appliances defined in the cluster database.
arguments
Optional list of appliance names.
examples
List all known appliances.
rocks list appliance attr [appliance]
Lists the set of attributes for appliances.
arguments
Name of appliance
examples
List the attributes for compute appliances
rocks list appliance route
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
Optional list of appliance names.
examples
Lists the XML profile for a compute appliance.
Lists the XML profile for all appliance types.
rocks list attr [appliance]
Lists the set of attributes for appliances.
arguments
Name of appliance
examples
List the attributes for compute appliances
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
List the boot actions available for all known hosts.
rocks list distribution [distribution...]
Lists the distributions defined in the cluster database.
arguments
Optional list of distribution names.
examples
List all known distribution definitions.
rocks list help [subdir=string]
The Help Command print the usage of all the registered Commands.
parameters
Relative of Python commands for listing help. This is used internally only.
examples
List help for all commands
List help for all commands under list/host
rocks list host [host...]
List the membership, CPU count and physical position info for a list of hosts.
arguments
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
examples
List info for compute-0-0.
List info for all known hosts.
rocks list host alias [host...]
Lists the aliases for a host.
arguments
Zero, one or more host names. If no host names are supplied, aliases for all the known hosts is listed.
examples
List the aliases for compute-0-0.
List the aliases for all known hosts.
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
Zero, one or more host names. If no host names are supplied, information for all hosts will be listed.
examples
List the appliance assignment for compute-0-0.
List the appliance assignments for compute-0-0 and compute-0-1.
rocks list host attr [host]
Lists the set of attributes for hosts.
arguments
Host name of machine
examples
List the attributes for compute-0-0.
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
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
examples
List the current boot action for compute-0-0.
List the current boot action for all known hosts.
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
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
parameters
Optional. If specified, generate a graph for the specified CPU type. If not specified, then 'arch' defaults to this host's architecture.
Optional. If specified, the location of the XML node files.
examples
Generates a graph for compute-0-0
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
Which section within the XML installation file to process (e.g., "kickstart", "begin", etc.).
examples
Output a RedHat-compliant kickstart file.
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
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
examples
List network interface info for compute-0-0.
List network interface info for all known hosts.
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
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
examples
List the membership assignment for compute-0-0.
List the membership assignment for all known hosts.
rocks list host partition [host...]
Lists the partitions for hosts. For each host supplied on the command line, this command prints the hostname and partitions for that host.
arguments
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
examples
List partition info for compute-0-0.
List partition info for known hosts.
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
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
examples
Generates a Kickstart/Jumpstart profile for compute-0-0.
Does the same thing as above but reads XML from STDIN.
rocks list host roll [host]
List the assignment of rolls to frontend appliances.
arguments
Host name of machine
examples
List the rolls assigned to frontend-0-0-0.
rocks list host route [host]
List the static routes that are assigned to a host.
arguments
Host name of machine
examples
List the static routes assigned to compute-0-0.
rocks list host xml [host...]
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
Zero, one or more host names. If no host names are supplied, info about all the known hosts is listed.
examples
List the XML configuration file for compute-0-0.
List the XML configuration files for all known hosts.
rocks list license
List the Rocks copyright.
examples
List the Rocks copyright.
rocks list membership [membership...]
Lists the memberships defined in the cluster database.
arguments
Optional. A list of membership names. If no membership names are supplied, all the known memberships are listed.
examples
List all known membership definitions.
rocks list network [network...]
List the defined networks for this system.
arguments
Zero, one or more network names. If no network names are supplied, info about all the known networks is listed.
examples
List network info for the network named 'private'.
List info for all defined networks.
rocks list node xml {node} [addr=string] [arch=string] [attrs=string] [basedir=string] [dist=string] [eval=bool] [gen=string] [graph=string] [host=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.
arguments
The XML node file that the graph traversal will begin. This should be the basename of the XML file (e.g., 'compute' and not 'compute.xml').
parameters
Primary address of host. If not supplied, then the loopback IP address is used.
Traverse the graph with the 'arch' parameter set to the supplied value. If not specified, then 'arch' defaults to this host's architecture.
A list of attributes. This list must be in python dictionary form, e.g., attrs="{ 'os': 'linux', 'arch' : 'x86_64' }"
If specified, the location of the XML node files.
Name of the distribution. If not supplied, then the distribution named 'rocks-dist' is used.
If set to 'no', then don't execute eval sections. If not supplied, then execute all eval sections.
If set, the use the supplied argument as the program for the 2nd pass generator. If not supplied, then use 'kgen'.
Name of the graph to traverse. If not supplied, then the graph named 'default' is traversed.
Primary name of host. If not supplied, then the name of this host is used.
If set to 'no', then disable errors regarding missing nodes. If not supplied, then print messages about missing nodes.
If set, only expand nodes from the named roll. If not supplied, then the all rolls are used.
examples
Generate the XML graph starting at the XML node named 'compute.xml'.
rocks list os attr [os]
Lists the set of attributes for OSes.
arguments
Name of OS (e.g. "linux", "solaris")
examples
List the attributes for the Linux OS
rocks list os route
rocks list roll [roll...]
List the status of available rolls.
arguments
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
List the status of the kernel roll
List the status of all the available rolls
related commands
rocks list roll command [roll...]
List the commands provided by a roll.
arguments
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
Returns the the list of commands installed by the Rocks base Roll.
rocks list route
rocks list var [appliance=string] [component=string] [service=string]
Lists variables in the Rocks key/value database. Variables are defined as a quad of (Appliance, Service, Component, Value). Within a node XML file, values can be retrieved as <var name="Service_Component"/>.
parameters
If supplied, restricts listing to this appliance. Using appliance=global will list only global values.
If supplied, restricts listing to this component.
If supplied, restricts listing to this service.
examples
List all Rocks variables.
List all Rocks variables associated with the 'Kickstart' service.
List the Rocks variable for Info_RocksVersion.