Mongrel2 Manual Installing, Deploying, Managing, Hacking

Mongrel2 Manual
Installing, Deploying, Managing, Hacking

Zed A. Shaw
Guillermo O. “Tordek” Freschi

July 2010

Contents
Preface
Typography
1 Introduction
1.1 Language Agnostic
1.2 Asynchronous
1.3 Message Protocol
1.4 Application Oriented
1.5 Automated Management
1.6 Using This Manual
2 Installing
2.1 Install Dependencies
2.2 Building Mongrel2
2.3 Building And Installing
2.4 Testing The Installation
2.5 Upgrading from trunk
2.6 Up Next
3 Managing
3.1 Model-View-Controller
3.2 Trying m2sh
3.3 A Simple Configuration File
3.4 How A Config Is Structured
3.5 A More Complex Example
3.6 Routing And Host Patterns
3.7 Deployment Logs And Commits
3.8 Control Port
3.9 Multiple Servers
3.10 Tweakable Expert Settings
3.11 SSL Configuration
3.12 Configuring Filters (BETA)
4 Deploying
4.1 Mongrel2 Deployment Requirements
4.2 The Plan
4.3 Step 1: The Deployment Area
4.4 Step 2: The mongrel2.org Configuration
4.5 Step 3: Setup procer
4.6 Step 4: Static Content
4.7 Step 5: Testing And Troubleshooting
4.8 Further Improvements
4.9 Deployment Tips
5 Hacking
5.1 Front-end Goodies
5.2 Introduction to ZeroMQ
5.3 Handler ZeroMQ Format
5.4 Basic Handler Demo
5.5 Async File Upload Demo
5.6 MP3 Streaming Demo
5.7 Chat Demo
5.8 Writing A Filter (BETA)
5.9 Other Language APIs
5.10 Writing Your Own m2sh
5.11 Config From Anything: Experimental
6 Contributing