Base Users Guide 5.4.3 Edition Base Users Guide: 5.4.3 Edition Published Aug 11 2011 Copyright © 2011 University of California This document is subject to the Rocks® License (see Rocks Copyright). Table of Contents Preface........................................................................................................................................................................ viii 1. Overview ....................................................................................................................................................................1 2. Attributes ...................................................................................................................................................................2 3. Installing a Rocks Cluster ........................................................................................................................................5 3.1. Getting Started................................................................................................................................................5 3.2. Install and Configure Your Frontend..............................................................................................................6 3.3. Install Your Compute Nodes ........................................................................................................................19 3.4. Upgrade or Reconfigure Your Existing Frontend.........................................................................................23 3.5. Installing a Frontend over the Network........................................................................................................25 3.6. Enabling Public Web Access to Your Frontend ...........................................................................................26 4. Defining and Modifying Networks and Network Interfaces ...............................................................................29 4.1. Networks, Subnets, VLANs and Interfaces..................................................................................................29 4.2. Named Networks/Subnets ............................................................................................................................29 4.3. Host Interfaces..............................................................................................................................................29 4.4. Virtual LANs (VLANs) and Logical VLAN Bridges ..................................................................................30 4.5. Network Bridging for Virtual Machines ......................................................................................................33 4.6. Networking Configuration Examples...........................................................................................................35 5. Customizing your Rocks Installation ....................................................................................................................37 5.1. Adding Packages to Compute Nodes ...........................................................................................................37 5.2. Customizing Configuration of Compute Nodes...........................................................................................38 5.3. Adding Applications to Compute Nodes .....................................................................................................38 5.4. Configuring Additional Ethernet Interfaces .................................................................................................39 5.5. Compute Node Disk Partitioning .................................................................................................................40 5.6. Creating a Custom Kernel RPM...................................................................................................................49 5.7. Enabling RSH on Compute Nodes...............................................................................................................51 5.8. Adding a New Appliance Type to the Cluster..............................................................................................51 5.9. Adding a Device Driver................................................................................................................................53 5.10. Extending DNS ..........................................................................................................................................55 5.11. Changing the Root password......................................................................................................................56 6. Community Resources............................................................................................................................................58 6.1. Access to Rocks Source Code......................................................................................................................58 6.2. All Past Rocks Releases ...............................................................................................................................58 6.3. Email Discussion List...................................................................................................................................58 6.4. Office Hours .................................................................................................................................................58 7. Administration Examples.......................................................................................................................................60 7.1. Introduction to the Rocks Command Line ...................................................................................................60 7.2. Boot Order and PXE First ............................................................................................................................60 7.3. Support for PXE First...................................................................................................................................61 7.4. Forcing a Re-install at Next PXE Boot ........................................................................................................61 7.5. Inspecting and Changing PXE Behaviour....................................................................................................61 7.6. Working with and Modifying Network Configuration.................................................................................63 7.7. Reinstall All Compute Nodes with SGE......................................................................................................64 iii 8. Advanced Tasks.......................................................................................................................................................65 8.1. Managing the Firewall on the Cluster Nodes...............................................................................................65 8.2. Flashing BIOS on Compute Nodes Using PXE...........................................................................................69 8.3. Adding a Login Appliance to Your Cluster..................................................................................................70 8.4. Channel Bonding Interfaces .........................................................................................................................71 8.5. Frontend Central Server ...............................................................................................................................72 8.6. Cross Kickstarting........................................................................................................................................73 8.7. Adding Kernel Boot Parameters...................................................................................................................75 9. Command Reference ..............................................................................................................................................78 9.1. add ................................................................................................................................................................78 9.2. config............................................................................................................................................................96 9.3. create ............................................................................................................................................................97 9.4. disable.........................................................................................................................................................101 9.5. dump...........................................................................................................................................................102 9.6. enable .........................................................................................................................................................107 9.7. help.............................................................................................................................................................108 9.8. iterate..........................................................................................................................................................109 9.9. list...............................................................................................................................................................109