Base Roll: Users Guide

(PDF version)

Table of Contents
Preface
1. Overview
2. Installing a Rocks Cluster
2.1. Getting Started
2.2. Install and Configure Your Frontend
2.3. Install Your Compute Nodes
2.4. Upgrade or Reconfigure Your Existing Frontend
2.5. Installing a Frontend over the Network
2.6. Enabling Public Web Access to Your Frontend
3. Defining and Modifying Networks and Network Interfaces
3.1. Networks, Subnets, VLANs and Interfaces
3.2. Named Networks/Subnets
3.3. Host Interfaces
3.4. Virtual LANs (VLANs) and Logical VLAN Bridges
3.5. Network Bridging for Virtual Machines
3.6. Networking Configuration Examples
4. Customizing your Rocks Installation
4.1. Adding Packages to Compute Nodes
4.2. Customizing Configuration of Compute Nodes
4.3. Adding Applications to Compute Nodes
4.4. Configuring Additional Ethernet Interfaces
4.5. Compute Node Disk Partitioning
4.6. Creating a Custom Kernel RPM
4.7. Enabling RSH on Compute Nodes
4.8. Adding a New Appliance Type to the Cluster
4.9. Adding a Device Driver
4.10. Extending DNS
5. Community Resources
5.1. Access to Rocks Source Code
5.2. All Past Rocks Releases
5.3. Email Discussion List
5.4. Office Hours
5.5. Rocks License
6. Administration Examples
6.1. Introduction to the Rocks Command Line
6.2. Boot Order and PXE First
6.3. Support for PXE First
6.4. Forcing a Re-install at Next PXE Boot
6.5. Inspecting and Changing PXE Behaviour
6.6. Working with and Modifying Network Configuration
6.7. Reinstall All Compute Nodes with SGE
7. Advanced Tasks
7.1. Flashing BIOS on Compute Nodes Using PXE
7.2. Frontend Central Server
7.3. Cross Kickstarting
7.4. Adding Kernel Boot Parameters
8. Command Reference
8.1. add
8.2. create
8.3. disable
8.4. dump
8.5. enable
8.6. help
8.7. iterate
8.8. list
8.9. remove
8.10. report
8.11. run
8.12. set
8.13. sync
A. Frequently Asked Questions
A.1. Installation
A.2. Configuration
A.3. System Administration
B. Release Notes
B.1. Release 5.1 - changes from 5.0
B.2. Release 4.3 - changes from 4.2.1
B.3. Release 3.2.0 - changes from 3.1.0
B.4. Release 3.2.0 - changes from 3.1.0
B.5. Release 3.1.0 - changes from 3.0.0
B.6. Release 3.0.0 - changes from 2.3.2
B.7. Release 2.3.2 - changes from 2.3.1
B.8. Release 2.3.1 - changes from 2.3
B.9. Release 2.2.1 - changes from 2.2
B.10. Release 2.2 - changes from 2.1.2
B.11. Release 2.1.2 - changes from 2.1.1
B.12. Release 2.1.1 - changes from 2.1
B.13. Release 2.1 - changes from 2.0.1
B.14. Release 2.0.1 - changes from 2.0
C. Kickstart Nodes Reference
C.1. Rocks Base Nodes
D. Rocks™ Copyright and Trademark
D.1. Copyright Statement
D.2. Trademark Licensing
E. Common Licenses
E.1. Artistic License
E.2. Apache v2.0
E.3. GNU General Public License v1
E.4. GNU General Public License v2
E.5. GNU Lesser General Public License v2.1
E.6. GNU Library General Public License v2
E.7. Python Software Foundation License v2
F. Package Licenses
F.1. anaconda
F.2. ant
F.3. coreutils
F.4. cvs
F.5. eGenix mx
F.6. FireFox
F.7. gawk
F.8. gd
F.9. graphviz
F.10. kudzu
F.11. libxml2
F.12. libxml2doc
F.13. mysql
F.14. ncurses
F.15. numarray
F.16. Numeric
F.17. perl
F.18. perl tk
F.19. pexpect
F.20. phpMyAdmin
F.21. POW
F.22. pygtk
F.23. python
F.24. rcs
F.25. readline
F.26. tidy
F.27. wget
List of Tables
1-1. Summary
1-2. Roll Compatibility
2-1. Frontend -- Default Root Disk Partition
4-1. Compute Node -- Default Root Disk Partition
4-2. A Compute Node with 3 SCSI Drives
List of Figures
D-1. Rocks™ logo