Base Roll: Users Guide Version 5.2 Edition Base Roll: Users Guide: Version 5.2 Edition Published Jun 2009 Copyright © 2009 University of California This document is subject to the Rocks License (see Rocks Copyright). Table of Contents Preface......................................................................................................................................................................... vii 1. Overview ....................................................................................................................................................................1 2. Installing a Rocks Cluster ........................................................................................................................................3 2.1. Getting Started................................................................................................................................................3 2.2. Install and Configure Your Frontend..............................................................................................................4 2.3. Install Your Compute Nodes ........................................................................................................................17 2.4. Upgrade or Reconfigure Your Existing Frontend.........................................................................................21 2.5. Installing a Frontend over the Network........................................................................................................23 2.6. Enabling Public Web Access to Your Frontend ...........................................................................................25 3. Defining and Modifying Networks and Network Interfaces ...............................................................................27 3.1. Networks, Subnets, VLANs and Interfaces..................................................................................................27 3.2. Named Networks/Subnets ............................................................................................................................27 3.3. Host Interfaces..............................................................................................................................................27 3.4. Virtual LANs (VLANs) and Logical VLAN Bridges ..................................................................................28 3.5. Network Bridging for Virtual Machines ......................................................................................................31 3.6. Networking Configuration Examples...........................................................................................................33 4. Customizing your Rocks Installation ....................................................................................................................35 4.1. Adding Packages to Compute Nodes ...........................................................................................................35 4.2. Customizing Configuration of Compute Nodes...........................................................................................36 4.3. Adding Applications to Compute Nodes .....................................................................................................36 4.4. Configuring Additional Ethernet Interfaces .................................................................................................37 4.5. Compute Node Disk Partitioning .................................................................................................................38 4.6. Creating a Custom Kernel RPM...................................................................................................................46 4.7. Enabling RSH on Compute Nodes...............................................................................................................48 4.8. Adding a New Appliance Type to the Cluster..............................................................................................48 4.9. Adding a Device Driver................................................................................................................................50 4.10. Extending DNS ..........................................................................................................................................52 5. Community Resources............................................................................................................................................54 5.1. Access to Rocks Source Code......................................................................................................................54 5.2. All Past Rocks Releases ...............................................................................................................................54 5.3. Email Discussion List...................................................................................................................................54 5.4. Office Hours .................................................................................................................................................54 5.5. Rocks License ..............................................................................................................................................55 6. Administration Examples.......................................................................................................................................57 6.1. Introduction to the Rocks Command Line ...................................................................................................57 6.2. Boot Order and PXE First ............................................................................................................................57 6.3. Support for PXE First...................................................................................................................................58 6.4. Forcing a Re-install at Next PXE Boot ........................................................................................................58 6.5. Inspecting and Changing PXE Behaviour....................................................................................................58 6.6. Working with and Modifying Network Configuration.................................................................................60 6.7. Reinstall All Compute Nodes with SGE......................................................................................................61 iii 7. Advanced Tasks.......................................................................................................................................................62 7.1. Flashing BIOS on Compute Nodes Using PXE...........................................................................................62 7.2. Frontend Central Server ...............................................................................................................................62 7.3. Cross Kickstarting........................................................................................................................................63 7.4. Adding Kernel Boot Parameters...................................................................................................................64 8. Command Reference ..............................................................................................................................................67 8.1. add ................................................................................................................................................................67 8.2. create ............................................................................................................................................................77 8.3. disable...........................................................................................................................................................81 8.4. dump.............................................................................................................................................................82 8.5. enable ...........................................................................................................................................................86 8.6. help...............................................................................................................................................................88 8.7. iterate............................................................................................................................................................88 8.8. list.................................................................................................................................................................89 8.9. remove ........................................................................................................................................................104 8.10. report ........................................................................................................................................................116 8.11. run.............................................................................................................................................................122 8.12. set .............................................................................................................................................................123 8.13. sync...........................................................................................................................................................144