Help:Rocks

From MMAE

Jump to: navigation, search

ROCKS is a wrapper distribution designed specifically for clusters. It wraps its own installation script and a lot of glue software and some prepackaged stuff suitable for clusters around any variation of RedHat. (Specifically, RedHat Enterprise, and CentOS, but others may work as well.)


Vendor homepage
http://www.rocksclusters.org
http://www.platform.com/
Software documentation
http://www.rocksclusters.org/rocks-documentation/4.2.1/
http://www.rocksclusters.org/rocks-documentation/reference-guide/4.2/
Software availability
Other related software
ganglia, ssh, MPI, others.
View online documentation (restricted access)
http://deli.i2lab.ucf.edu/rocks-documentation/4.1.1/
http://deli.i2lab.ucf.edu/rocks-documentation/reference-guide/4.1.1/
http://deli.i2lab.ucf.edu/homepage/platform/User_Guide.html
http://arcadius.mmae.ucf.edu/rocks-documentation/4.2.1/
http://arcadius.mmae.ucf.edu/rocks-documentation/reference-guide/4.2.1/

In the following command reference, each entry is followed by one or more of:

ug  
user guide link
man  
a man page exists
info  : an info page exists

Contents

[edit] user commands

ssh, ssh-agent, ssh-add (ug man)
ssh allows text and graphics access to other nodes. ssh-agent and ssh-add allow access between nodes without a password
cluster-fork (ug)
launch a command on some or all (live) cluster nodes
cluster-ps 
list processes on all nodes that match
cluster-kill 
kill a process that matches a regex on all nodes in the cluster
tentakel (man)
run commands in parallel on groups of hosts
tentakel -g compute hostname
freenodes 
locally written command to list all free nodes (complain if this is missing on your cluster)

[edit] system commands

insert-ethers (ug man)
add new ethers to the dhcp database, use when adding or replacing nodes
rocks-user-sync (ug)
force synchronization of authentication databases and fix new accounts
shoot-node  
causes a node to reload
add-extra-nic 
add a second network card to a node's database config
rocks-console 
vpn into the console of a (reinstalling?) node
dbreport (ref)
dump configuration database contents
rocks-dist (man ug*) 
manages contents of the local rocks distribution, including installing updates, local changes, making media images, updating kickstart info, etc.
shoot-node (man) 
forces a node to reinstall, and uses xterm to interactively monitor reinstallation progress

rocks-roll add-distribution add-new-appliance big-red-button busy-nodes cfgen cluster-probe cluster-ps insert-access insert-pcis kdoc kgen kpp kroll local-ca-sign probe-ethers read-411-shared-key read-ssh-private-key rocks-partition rocks-sql-checkpoint screengen setup-ca ssl-genca ssl-genserver ssl-genuser state

[edit] general tips

/sbin/chkconfig --level 35 rocks-grub off ; service rocks-grub stop
don't auto-reinstall on reboot
/home/install/rocks-dist/lan/$ARCH/RedHat/RPMS
merged directory of rpms from all rolls
/home/install/site-profiles/4.2.1/nodes
xml files describing site customizations

[edit] installed software

Software installed on a rocks system will be located in one of three places:

  1. Software installed by the system uses the Redhat Package Management system (RPM) and can be listed with the rpm command (ex: rpm -qa | grep lam )
  2. Optional software locally installed on each node (via a rocks roll) or only available on the head node may be installed into /opt or /usr/local ; sometime software installed on all nodes may be placed here if it was installed from a rocks roll.
  3. Software installed only on the head node but distributed to compute nodes will be installed in /share/apps (NOTE: this option may have lower performance)

Some of this software is described here in the wiki in various categories, but examination of these directories may provide a more complete list.

Personal tools