Base Users Guide: 
| ||
|---|---|---|
| Prev | Chapter 9. Command Reference | Next |
rocks set appliance attr {appliance} {attr} {value} [attr=string] [value=string]
Sets an attribute to an appliance and sets the associated values
arguments
Name of appliance
Name of the attribute
Value of the attribute
parameters
same as attr argument
same as value argument
examples
Sets the sge attribution to False for compute appliances
same as above
rocks set attr {attr} {value} [attr=string] [value=string]
Sets a global attribute for all nodes
arguments
Name of the attribute
Value of the attribute
parameters
same as attr argument
same as value argument
examples
Sets the sge attribution to False
related commands
rocks set host attr {host} {attr} {value} [attr=string] [value=string]
Sets an attribute to a host and sets the associated values
arguments
Host name of machine
Name of the attribute
Value of the attribute
parameters
same as attr argument
same as value argument
examples
Sets the number of cpus of compute-0-0 to 2
same as above
related commands
rocks set host boot {host...} [action=string]
Set a bootaction for a host. A hosts action can be set to 'install' or to 'os' (also, 'run' is a synonym for 'os').
arguments
One or more host names.
parameters
The label name for the bootaction. This must be one of: 'os', 'install', or 'run'. If no action is supplied, then only the configuration file for the list of hosts will be rewritten.
examples
On the next boot, compute-0-0 will boot the profile based on its "run action". To see the node's "run action", execute: "rocks list host compute-0-0" and examine the value in the "RUNACTION" column.
rocks set host bootflags {host...} [flags=string]
Set the boot flags for a host. The boot flags will applied to the configuration file that a host uses to boot the running kernel. For example, if a node uses GRUB as its boot loader, the boot flags will part of the 'append' line.
arguments
Zero, one or more host names. If no host names are supplied, then the global bootflag will be set.
parameters
The boot flags to set for the host.
examples
Apply the kernel boot flags "mem=1024M" to compute-0-0.
rocks set host cdrom {host} [cdrom=string] [key=string]
Set the cdrom ISO file for a virtual node through Airboss If you want to change the cdrom ISO and you are root on the physical vm frontend use rocks set host vm cdrom (it does not use airboss)
arguments
Host name of machine. This host name should be the name of the machine that you want to set the cdrom
parameters
The cdrom file path on the VM container that runs the virtual host.
A private key that will be used to authenticate the request. This should be a file name that contains the private key.
rocks set host comment {host...} {comment} [comment=string]
Set the comment field for a list of hosts.
arguments
One or more host names.
The string to assign to the comment field for each host.
parameters
Can be used in place of the comment argument.
examples
Sets the comment field to "Fast Node" for compute-0-0.
Sets the comment field to "Slow Node" for compute-0-0 and compute-0-1.
Same as above.
rocks set host cpus {host...} {cpus} [cpus=string]
Set the number of CPUs for a list of hosts.
arguments
One or more host names.
The number of CPUs to assign to each host.
parameters
Can be used in place of the cpus argument.
examples
Sets the CPU value to 2 for compute-0-0.
Sets the CPU value to 4 for compute-0-0 and compute-0-1.
Same as above.
rocks set host installaction {host...} {action} [action=string]
Set the install action for a list of hosts.
arguments
One or more host names.
The install action to assign to each host. To get a list of all actions, execute: "rocks list bootaction".
parameters
Can be used in place of the action argument.
examples
Sets the install action to "install" for compute-0-0.
Sets the install action to "install i386" for compute-0-0 and compute-0-1.
Same as above.
rocks set host interface channel {host...} {iface} {channel} [channel=string] [iface=string]
Sets the channel for a named interface.
arguments
One or more hosts.
Interface that should be updated. This may be a logical interface or the MAC address of the interface.
The channel for an interface. Use channel=NULL to clear.
parameters
Can be used in place of the channel argument.
Can be used in place of the iface argument.
examples
Sets the channel for eth1 to be "bond0" (i.e., it associates eth1 with the bonded interface named "bond0").
Clear the channel entry.
rocks set host interface iface {host...} {mac} {iface} [iface=string] [mac=string]
Sets the logical interface of a mac address for particular hosts.
arguments
One or more named hosts.
MAC address of the interface whose logical interface will be reassigned
Logical interface.
parameters
Can be used in place of the iface argument.
Can be used in place of the mac argument.
examples
Sets the logical interface of MAC address 00:0e:0c:a7:5d:ff to be eth1
Same as above.
related commands
rocks set host interface ip {host} {iface} {ip} [iface=string] [ip=string]
Sets the IP address for the named interface for one host.
arguments
Host name.
Interface that should be updated. This may be a logical interface or the mac address of the interface.
The IP address of the interface. Usually of the form nnn.nnn.nnn.nnn where n is a decimal digit. This format is not enforced. Use IP=NULL to clear.
parameters
Can be used in place of the iface argument.
Can be used in place of the ip argument.
examples
Sets the IP Address for the eth1 device on host compute-0-0.
Same as above.
rocks set host interface mac {host} {iface} {mac} [iface=string] [mac=string]
Sets the mac address for named interface on host.
arguments
Host name.
Interface that should be updated. This may be a logical interface or the mac address of the interface.
The mac address of the interface. Usually of the form dd:dd:dd:dd:dd:dd where d is a hex digit. This format is not enforced. Use mac=NULL to clear the mac address.
parameters
Can be used in place of the iface argument.
Can be used in place of the mac argument.
examples
Sets the MAC Address for the eth1 device on host compute-0-0.
Same as above.
clears the mac address from the database
related commands
rocks set host interface module {host...} {iface} {module} [iface=string] [module=string]
Sets the device module for a named interface. On Linux this will get translated to an entry in /etc/modprobe.conf.
arguments
One or more hosts.
Interface that should be updated. This may be a logical interface or the MAC address of the interface.
The software device module of interface. Use module=NULL to clear.
parameters
Can be used in place of the iface argument.
Can be used in place of the module argument.
examples
Sets the device module for eth1 to be e1000 on host compute-0-0.
Same as above.
Clear the module entry.
related commands
rocks set host interface name {host} {iface} {name} [iface=string] [name=string]
Sets the logical name of a network interface on a particular host.
arguments
Host name.
Interface that should be updated. This may be a logical interface or the MAC address of the interface.
Name of this interface (e.g. newname). This is only the name associated with a certain interface. FQDNs are disallowed. To set the domain or zone for an interface, use the "rocks add network" command, and then associate the interface with the network
parameters
Can be used in place of the iface argument.
Can be used in place of the name argument.
examples
Sets the name for the eth1 device on host compute-0-0 to cluster-0-0.zonename. The zone is decided by the subnet that the interface is attached to.
Same as above.
related commands
rocks set host interface options {host...} {iface} [iface=string] [options=string]
Sets the options for a device module for a named interface. On Linux, this will get translated to an entry in /etc/modprobe.conf.
arguments
One or more hosts.
Interface that should be updated. This may be a logical interface or the MAC address of the interface.
parameters
Can be used in place of the iface argument.
The options for an interface. Use options=NULL to clear. In Rocks 5.4 (linux): options='dhcp' or options='noreport' have special meaning. Bonded interfaces use options field to set up bonding options.
examples
Sets the option "Speed=10" for eth1 on e1000 on host compute-0-0.
Clear the options entry.
Linux only: Configure eth0 interface for DHCP instead of static.
Linux only: Tell rocks report host interface to ignore this interface when writing configuration files
rocks set host interface subnet {host...} {iface} {subnet} [iface=string] [subnet=string]
Sets the subnet for named interface on one of more hosts.
arguments
One or more named hosts.
Interface that should be updated. This may be a logical interface or the MAC address of the interface.
The subnet address of the interface. This is a named subnet and must be listable by the command 'rocks list network'.
parameters
Can be used in place of the iface argument.
Can be used in place of the subnet argument.
examples
Sets eth1 to be on the public subnet.
Same as above.
related commands
rocks set host interface vlan {host...} {iface} {vlan} [iface=string] [vlan=string]
Sets the VLAN ID for an interface on one of more hosts.
arguments
One or more named hosts.
Interface that should be updated. This may be a logical interface or the mac address of the interface.
The VLAN ID that should be updated. This must be an integer and the pair 'subnet/vlan' must be defined in the VLANs table.
parameters
Can be used in place of the iface argument.
Can be used in place of the vlan argument.
examples
Sets compute-0-0-0's private interface to VLAN ID 3.
Same as above.
related commands
rocks set host membership {host...} {membership} [membership=string]
Set the membership for hosts.
arguments
One or more host names.
The membership to assign to each host.
parameters
Can be used in place of the membership argument.
examples
Sets the membership to 'NAS Appliance' for nas-0-0.
Same as above.
Sets the membership to 'Compute' for all known hosts.
rocks set host name {host} {name} [name=string]
Rename a host.
arguments
The current name of the host.
The new name for the host.
parameters
Can be used in place of the 'name' argument.
examples
Changes the name of compute-0-0 to new-compute-0-0.
Same as above.
rocks set host power {host...} [action=string] [key=string]
Turn the power for a host on or off.
arguments
One or more host names.
parameters
The power setting. This must be one of 'on', 'off' or 'install'. The 'install' action will turn the power on and force the host to install.
A private key that will be used to authenticate the request. This should be a file name that contains the private key. If not specified it will default to $HOME/.ssh/id_rsa.pub or $HOME/.ssh/id_dsa.pub
examples
Turn on the power for compute-0-0.
rocks set host rack {host...} {rack} [rack=string]
Set the rack number for a list of hosts.
arguments
One or more host names.
The rack number to assign to each host.
parameters
Can be used in place of rack argument.
examples
Set the rack number to 2 for compute-2-0.
Set the rack number to 0 for compute-0-0 and compute-0-1.
Same as above.
rocks set host rank {host...} {rank} [rank=string]
Set the rank number for a list of hosts.
arguments
One or more host names.
The rank number to assign to each host.
parameters
Can be used in place of rank argument.
examples
Set the rank number to 2 for compute-0-2.
Set the rank number to 0 for compute-0-0 and compute-1-0.
Same as above.
rocks set host roll {host} {name} {version} {arch} [arch=string] [name=string] [os=string] [version=string]
Associates a roll with a frontend appliance.
arguments
Host name of a frontend machine.
Name of the roll (e.g., 'base').
Version of the roll (e.g., '5.2').
Architecture of the roll (e.g., 'x86_64').
parameters
Same as 'arch' argument.
Same as 'name' argument.
The OS version. The default is 'linux'.
Same as 'version' argument.
examples
Associates the roll with name/version/arch of 'base/5.2/x86_64' to frontend-0-0-0.
related commands
rocks set host runaction {host...} {action} [action=string]
Set the run action for a list of hosts.
arguments
One or more host names.
The run action to assign to each host. To get a list of all actions, execute: "rocks list bootaction".
parameters
Can be used in place of the action argument.
examples
Sets the run action to "os" for compute-0-0.
Sets the run action to "memtest" for compute-0-0 and compute-0-1.
Same as above.
rocks set host sec_attr {host} [attr=string] [crypted=boolean] [enc=string] [value=string]
Set a host-specific secure attribute to the database. The user also has the option of not supplying the value on the command line. The command will prompt the user to enter the secure attribute value, and will not echo this value on screen. If the user chooses to enter the value for the secure attribute by prompt, then the value entered must be in an unencrypted form.
arguments
Host name of machine
parameters
Name of the attribute
Is "value" already crypted or not
Encryption scheme to use to crypt the value. Currently supported values are "sha", "crypt", "portable".
Value of the attribute. If value is a file, read the value from that file
examples
Sets a secure attribute called db_pw to the crypted value of "DatabasePassword" using the sha1 encoding schema.
Same as above
rocks set network mtu {network...} {mtu} [mtu=string]
Sets the MTU for one or more named networks.
arguments
One or more named networks that should have the defined MTU.
MTU that named networks should have.
parameters
Can be used in place of 'mtu' argument.
examples
Sets the "optiputer" MTU address to 9000.
Same as above.
related commands
rocks set network netmask {network...} {netmask} [netmask=string]
Sets the network mask for one or more named networks .
arguments
One or more named networks that should have the defined netmask.
Netmask that named networks should have.
parameters
Can be used in place of netmask argument.
examples
Sets the netmask for the "optiputer" network to a class-c address space.
Same as above.
Sets the netmask for the "optiputer" and "cavewave" networks to a class-b address space.
related commands
rocks set network servedns {network} {servedns} [servedns=bool]
Sets/Unsets the capability for serving DNS for a given subnet
arguments
Name of the Network
True/False
parameters
True/False
rocks set network subnet {network...} {subnet} [subnet=string]
Sets the subnet for one or more named networks.
arguments
One or more named networks that should have the defined subnet.
Subnet that named networks should have.
parameters
Can be used in place of subnet argument.
examples
Sets the "optiputer" subnet address to 132.239.51.0.
Same as above.
Sets both the "optiputer" and "cavewave" subnet addresses to the same value of 67.58.32.0.
related commands
rocks set network zone {network} {zone} [zone=string]
Set the zone/domain name associated with a subnet
arguments
Network Name
Zone / Domain that the network belongs to. Example: optiputer.net
parameters
Zone / Domain that the network belongs to. Example: optiputer.net
rocks set os attr {os} {attr} {value} [attr=string] [value=string]
Sets an attribute to an os and sets the associated values
arguments
Name of os
Name of the attribute
Value of the attribute
parameters
same as attr argument
same as value argument
examples
Sets the sge attribution to False for linux nodes
rocks set sec_attr {attr} [crypted=boolean] [enc=string] [value=string]
Set a secure attribute to the database. The user also has the option of not supplying the value on the command line. The command will prompt the user to enter the secure attribute value, and will not echo this value on screen. If the user chooses to enter the value for the secure attribute by prompt, then the value entered must be in an unencrypted form.
arguments
Name of the attribute
parameters
Is "value" already crypted or not
Encryption scheme to use to crypt the value. Currently supported values are "sha", "crypt", "portable".
Value of the attribute. If value is a file, read the value from the file
examples
Sets a secure attribute called db_pw to the crypted value of "DatabasePassword" using the sha1 encoding schema.
Same as above