Product SiteDocumentation Site

Revisor 2.1

Reference

Revisor Complete Installation, Configuration and Tweaking Reference

Edition 0

Logo

Jeroen van Meeuwen, RHCE

Fedora Project Contributor
Fedora Unity Founding Member, Release Engineer
Operator Groep Delft Sr. System Engineer

Legal Notice

Copyright © 2007 - 2009 Jeroen van Meeuwen This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at http://www.gnu.org/licenses/fdl.txt).
Abstract
This is Revisors upstream documentation.

Preface
1. About the Contributors
2. About Fedora Unity
3. About this Document
4. Document Conventions
4.1. Typographic Conventions
4.2. Pull-quote Conventions
4.3. Notes and Warnings
5. We Need Feedback!
1. Introduction
1.1. History of Revisor
1.2. The Installation Media Challenge
1.3. The Live Media Challenge
2. Features
2.1. Installation Media
2.2. Installation Trees
2.3. Live Media
2.4. Reproducibility
2.5. Consistency
2.6. Flexibility
2.7. Graphical User Interface
2.8. Open Development Community
2.9. Plugin System
2.10. Extraneous Debugging
2.11. Smart Caching
2.12. Using YUM Configuration Files
I. Getting Started
3. Installation
3.1. Packages
3.1.1. Red Hat Enterprise Linux 5 or higher
3.1.2. Fedora 7 or higher
3.2. The Latest and Greatest
4. Configuration
4.1. Configuration Files
4.1.1. /etc/revisor/revisor.conf
4.1.2. /etc/revisor/conf.d/
4.1.3. Updates to Configuration Files
4.1.4. Changing Configuration Files
4.2. Global and Model Configuration
4.3. YUM Repository Configuration
4.3.1. $releasever and $basearch
4.3.2. Using a Local Mirror
4.3.3. Using Local Files
4.3.4. Using a DVD
4.3.5. Adding Third Party Repositories
4.3.6. Creating Your Own Repository
4.3.7. Testing & Troubleshooting the YUM Configuration
4.4. Configuring A Proxy Server
4.5. Command-line Options
5. Quick Start
II. Manual
6. HOWTO
6.1. HOWTO: Add a Third Party Repository
6.2. HOWTO: Create a Re-Spin
6.3. HOWTO: Include folders and files on the Media
6.4. HOWTO: Re-use Installer Images
7. Using Kickstart
7.1. How Kickstart Is Used
7.1.1. Installation Media
7.2. The Kickstart Package Manifest
7.2.1. Using Kickstart with Package NEVRA
III. Reference
8. Compose Process Details
8.1. Overview
8.2. Installation Media
8.3. Live Media
8.4. Respin Mode
8.4.1. Selecting Groups
8.4.2. Select Matching Packages
8.5. Dependency Resolving
8.5.1. Inclusive Dependency Resolving
8.5.2. Exclusive Dependency Resolving
8.6. Copying Arbitrary Files Onto the Media
8.7. Cleaning Up
8.7.1. Exception to the Rule
9. Plugins
9.1. Upstream Plugins
9.1.1. Cobbler Plugin
9.1.2. Composer Plugin
9.1.3. Delta Plugin
9.1.4. GUI (Graphical User Interface) Plugin
9.1.5. HUB Plugin
9.1.6. Isolinux Plugin
9.1.7. Jigdo Plugin
9.1.8. Mock Plugin
9.1.9. Rebrand Plugin
9.1.10. Reuse Installer Images Plugin
9.1.11. Server Plugin
9.1.12. Virtualization Plugin
9.1.13. WUI (Web-based User Interface) Plugin
9.2. Writing Your Own Plugins
10. Tweaking the build process
10.1. Reusing Existing Installer Images
10.2. Building The Installer Images in Mock
10.3. Omitting isomd5sums
10.4. Omitting SHA1SUMS
11. Tips and Tricks
11.1. The spin-kickstarts Package
11.2. Even More Debugging
11.3. Kickstart Validator
11.4. Using Mirrormanager for Mirror Redirection
11.5. Using The localrepo DNS Alias
12. Frequently Asked Questions
13. Testing
13.1. Simple Test Cases
13.1.1. Packages
13.1.2. Configuration Files
13.1.3. Requirements for Compose Results
13.2. Complex Test Cases
13.3. Specific Test Cases
14. Development
14.1. Running Revisor from Source
14.1.1. Installing the Required Packages
14.2. Building Revisor Packages
14.3. Tickets
14.4. Adding a new spin or remix
14.5. Versioning Schema
14.6. Release Procedure
A. Revision History
Index
IV. Appendices
A. Terminology
B. Configuration Reference
B.1. Configuration Options