More cooked
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Deployment / FastCGI.pod
1 =head1 NAME
2
3 Catalyst::Manual::Deployment::FastCGI - Deploying Catalyst with FastCGI
4
5 =head1 FastCGI Deployment
6
7 FastCGI is a high-performance extension to CGI. It is suitable
8 for production environments.
9
10 =head2 Pros
11
12 =head3 Speed
13
14 FastCGI performs equally as well as mod_perl.  Don't let the 'CGI' fool you;
15 your app runs as multiple persistent processes ready to receive connections
16 from the web server.
17
18 =head3 App Server
19
20 When using external FastCGI servers, your application runs as a standalone
21 application server.  It may be restarted independently from the web server.
22 This allows for a more robust environment and faster reload times when
23 pushing new app changes.  The frontend server can even be configured to
24 display a friendly "down for maintenance" page while the application is
25 restarting.
26
27 =head3 Load-balancing
28
29 You can launch your application on multiple backend servers and allow the
30 frontend web server to load-balance between all of them.  And of course, if
31 one goes down, your app continues to run fine.
32
33 =head3 Multiple versions of the same app
34
35 Each FastCGI application is a separate process, so you can run different
36 versions of the same app on a single server.
37
38 =head3 Can run with threaded Apache
39
40 Since your app is not running inside of Apache, the faster mpm_worker module
41 can be used without worrying about the thread safety of your application.
42
43 =head2 Cons
44
45 You may have to disable mod_deflate.  If you experience page hangs with
46 mod_fastcgi then remove deflate.load and deflate.conf from mods-enabled/
47
48 =head3 More complex environment
49
50 With FastCGI, there are more things to monitor and more processes running
51 than when using mod_perl.
52
53 XXX - FIXME, note not just apache!
54
55 =head3 More Info
56
57 L<Catalyst::Engine::FastCGI> - XXX FIXME.
58
59 =head1 AUTHORS
60
61 Catalyst Contributors, see Catalyst.pm
62
63 =head1 COPYRIGHT
64
65 This library is free software. You can redistribute it and/or modify it under
66 the same terms as Perl itself.
67
68 =cut
69