← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/http_smart_server.txt

  • Committer: John Arbash Meinel
  • Date: 2007-07-05 19:39:28 UTC
  • mto: This revision was merged to the branch mainline in revision 2614.
  • Revision ID: john@arbash-meinel.com-20070705193928-xtm8nh4ucc8qosdn
Add direct tests of how we handle incomplete/'broken' lines

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/http_smart_server.txt
 
1
===========================
1
2
Serving Bazaar with FastCGI
2
3
===========================
3
4
 
7
8
This document describes one way to set up a Bazaar HTTP smart server,
8
9
using Apache 2.0 and FastCGI or mod_python.
9
10
 
10
 
For more information on the smart server, and other ways to configure it
11
 
see the main `smart server documentation`_.
12
 
 
13
 
.. _smart server documentation: #running-a-smart-server
14
 
 
15
11
Example
16
 
-------
 
12
=======
17
13
 
18
14
You have a webserver already publishing `/srv/example.com/www/code` as
19
15
`http://example.com/code/...` with plain HTTP.  It contains bzr branches and
49
45
 
50
46
    Alias /code /srv/example.com/www/code
51
47
    <Directory /srv/example.com/www/code>
52
 
        Options Indexes FollowSymLinks
 
48
        Options Indexes, FollowSymLinks
53
49
        RewriteEngine On
54
50
        RewriteBase /code
55
51
        RewriteRule ^(.*/|)\.bzr/smart$ /srv/example.com/scripts/bzr-smart.fcgi
105
101
This instructs Apache to hand requests for any URL ending with `/.bzr/smart`
106
102
inside `/code` to a Bazaar smart server via mod_python.
107
103
 
108
 
NOTE: If you don't have bzrlib in your PATH, you will be need to change the
109
 
following line::
110
 
 
111
 
            PythonPath "sys.path+['/srv/example.com/scripts']"
112
 
 
113
 
To::
114
 
 
115
 
            PythonPath "['/path/to/bzr']+sys.path+['/srv/example.com/scripts']"
116
 
 
117
 
 
118
104
Refer to the mod_python_ documentation for further information.
119
105
 
120
106
.. _mod_python: http://www.modpython.org/
171
157
        
172
158
The `modpywsgi` module can be found at http://trac.pocoo.org/wiki/ModPyWsgi.  It
173
159
is part of pocoo_.
174
 
You sould make sure you place modpywsgi.py in the same directory as
175
 
bzr-smart.py (ie. /srv/example.com/scripts/).
176
160
 
177
161
.. _pocoo: http://trac.pocoo.org/wiki/
178
162
 
189
173
 
190
174
 
191
175
Advanced configuration
192
 
----------------------
 
176
======================
193
177
 
194
178
Because the Bazaar HTTP smart server is a WSGI application, it can be used with
195
179
any 3rd-party WSGI middleware or server that conforms the WSGI standard.  The
216
200
 
217
201
 
218
202
Pushing over ``bzr+http://``
219
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
203
----------------------------
220
204
 
221
205
It is possible to allow pushing data over the http smart server. The
222
206
easiest way to do this, is to just supply ``readonly=False`` to the