Base Roll: Users Guide: 
| ||
|---|---|---|
| Prev | Chapter 8. Command Reference | Next |
rocks add appliance {appliance} [compute=bool] [graph=string] [membership=string] [node=string] [os=string] [public=bool] [short-name=string]
Add an appliance specification to the database.
arguments
The appliance name (e.g., 'compute', 'frontend', 'nas').
parameters
True means jobs can be scheduled on these types of appliances. The default is 'yes'.
The directory name of the graph XML files. The default is 'default'.
The full membership name of the appliance. This name will be displayed in the appliances menu by insert-ethers (e.g., 'NAS Appliance'). If not supplied, the membership name is set to the appliance name.
The name of the root XML node (e.g., 'compute', 'nas', 'viz-tile'). If not supplied, the node name is set to the appliance name.
The OS that the appliance type can support. Some appliances can support both linux and solaris, where as others can support only one of the two. Acceptable values are 'linux' or 'sunos'. Defaults to 'linux'
True means this appliance will be displayed by 'insert-ethers' in the Appliance menu. The default is 'yes'.
The basename for the short host name (e.g., 'c', 'f', 'n').
examples
rocks add distribution {distribution}
Add a distribution specification to the database.
arguments
Name of the new distribution.
examples
Adds the distribution named "rocks-dist" into the database.
rocks add host {host} [cpus=int] [membership=string] [os=string] [rack=int] [rank=int]
Add an new host to the cluster.
arguments
A single host name. If the hostname is of the standard form of basename-rack-rank the default values for the membership, rack, and rank parameters are taken from the hostname.
parameters
Number of CPUs (cores) in the given host. If not provided the default of 1 CPU is inserted into the database.
Appliance membership name. If not provided and the host name is of the standard form the membership is taken from the basename of the host.
The operating system name. The default is: linux.
The number of the rack where the machine is located. The convention in Rocks is to start numbering at 0. If not provided and the host name is of the standard form the rack number is taken from the host name.
The position of the machine in the rack. The convention in Rocks is to number from the bottom of the rack to the top starting at 0. If not provided and the host name is of the standard form the rank number is taken from the host name.
examples
Adds the host "compute-0-0" to the database with 1 CPU, a membership name of "compute", a rack number of 0, and rank of 1.
Adds the host "frontend" to the database with 1 CPU, a membership name of "Frontend", a rack number of 0, and rank of 1.
related commands
rocks add host interface {host} {iface} [gateway=string] [iface=string] [ip=string] [mac=string] [module=string] [name=string] [subnet=string] [vlan=string]
Adds an interface to a host and sets the associated values
arguments
Host name of machine
The interface name on the host (e.g., 'eth0', 'eth1')
parameters
The gateway to assign to the interface (e.g., '192.168.1.1')
Can be used in place of the iface argument.
The IP address to assign to the interface (e.g., '192.168.1.254')
The MAC address of the interface (e.g., '00:11:22:33:44:55')
The device driver name (or module) of the interface (e.g., 'e1000')
The name to assign to the interface
The name of the subnet to assign to the interface (e.g., 'private')
The VLAN ID to assign the interface
examples
same as above
rocks add host pxeaction [host...] [action=string] [args=string] [command=string]
Add a pxeaction specification for a host.
arguments
List of hosts to add pxeaction definitions. If no hosts are listed, then the global definition for 'action=name' is added.
parameters
Label name for the pxeaction. You can see the pxeaction label names by executing: 'rocks list host pxeaction [host(s)]'.
The second line for a pxelinux definition (e.g., append ks initrd=initrd.img ramdisk_size=150000 lang= devfs=nomount pxe kssendmac selinux=0)
The first line for a pxelinux definition (e.g., 'kernel vmlinuz' or 'localboot 0').
examples
Add the global 'os' pxeaction
Add the 'memtest' pxeaction for compute-0-0
rocks add network {name} {subnet} {netmask} [netmask=string] [subnet=string]
Add a network to the database. By default both the "public" and "private" networks are already defined by Rocks.
arguments
Name of the new network.
The IP network address for the new network.
The IP network mask for the new network.
parameters
Can be used in place of the netmask argument.
Can be used in place of the subnet argument.
examples
Adds the optiputer network address of 192.168.1.0/255.255.255.0.
Same as above.
rocks add roll [roll...] [clean=bool]
Add Roll ISO images to this machine's roll directory. This command copies all files in the ISOs to a directory under /export/rocks/install/rolls.
arguments
A list of Roll ISO images to add to /export/rocks/install/rolls. If no list is supplied, then if a roll is mounted on /mnt/cdrom, it will be copied into /export/rocks/install/rolls.
parameters
If set, then remove all files from any existing rolls of the same name, version, and architecture before copying the contents of the Rolls onto the local disk. This parameter should not be set when adding multi-CD Rolls such as the OS Roll, but should be set when adding single Roll CDs such as the Grid Roll.
examples
Adds the Kernel Roll to local Roll directory. Before the Roll is added the old Kernel Roll packages are removed from the Roll directory.
Added the Kernel, PVFS, and Ganglia Rolls to the local Roll directory.
related commands
rocks add var {service} {component} {value} [appliance=string] [component=string] [service=string] [value=string]
Add variables to the Rocks key/value database. Variables are defined as quad of (Appliance, Service, Component, Value). Within a node XML file, values can be retrieved as <var name="Service_Component"/>.
arguments
Defines the service name. e.g., service=Kickstart.
Defines the component name. e.g. component=PublicDNS.
Defines the value for the variable.
parameters
If supplied, restricts to the named appliance. See 'rocks list appliance' for a listing of appliances.
Can be used in place of component argument.
Can be used in place of service argument.
Can be used in place of value argument.
examples
Add the variable name <var name="Condor_Master"/> to 'localhost'.
Same as above.
Add the variable name <var name="Condor_Master"/> to 'localhost' and associate it with only compute appliances.