/doc/book-toc.txt

 1Potential book outline....
 2
 3What is Perlbal?
 4
 5  -- reverse proxy / load balancer
 6
 7  -- web server
 8
 9  -- pluggable
10
11  -- event based
12     * connection cheap
13     * scalable w/ epoll, kqueue
14
15  -- introspective
16
17Perlbal tricks  (teaser overviews to get excited, forward refs to more details in later sections)
18
19  -- internal (client-transparent) redirects, to pass req between backend HTTP servers,
20     or pass to static webserver mode in perlbal itself.
21
22  -- smart load balancing
23
24  -- runtime config changes
25
26  -- buffered uploads
27
28  -- verified backends (why it helps so much with loaded apaches)
29
30
31Configuring
32
33  * About config
34
35    -- config file format.
36    -- config file is just a bunch of line-based commands,
37       also work in mgmt port.
38       * explain implicit command context
39    -- change all config at runtime
40
41  * global commands (max fds, etc)
42
43  * Services, service roles
44
45    -- general service options
46    -- service role types
47
48  * Configuring a static webserver service
49
50    -- example configs and drawings/explanations
51
52    -- service options
53
54  * Configuring reverse proxy service
55
56    -- example configs and drawings/explanations
57
58    -- service options
59
60  * Selector services
61
62    -- example configs and drawings/explanations
63
64    -- map onto other services based on criteria.
65
66    -- vhosts.
67
68  * Hybrid modes:
69
70    -- selectors & x-reproxy-url & x-reproxy-file & x-reproxy-service
71
72    -- crazy examples:
73
74        * typepad/mogilefs crazy setup/selector
75
76
77Monitoring Perlbal
78
79  * all the introspection admin commands
80
81Hacking on Perlbal
82
83  * class hierarchy.  roles of each object.
84
85  * explain hook system, document all hooks
86
87  * walk through minimal vhost plugin code, as example of how
88    to write a service selector.
89
90  * tips for debugging memory leaks:
91
92     -- easy to introduce circular loops w/ safaris 
93     -- $^P = 0x200;
94     -- Devel::Gladiator,
95     -- Devel::Cycle
96
97
98