← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/admin-guide/other-setups.txt

  • Committer: Martin Packman
  • Date: 2011-11-17 13:45:49 UTC
  • mto: This revision was merged to the branch mainline in revision 6271.
  • Revision ID: martin.packman@canonical.com-20111117134549-080e1fhtrzoicexg
https://launchpad.net/bugs/891582
Only assert FileExists path in test_transform directory clash tests to avoid stringification fallout

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/admin-guide/other-setups.txt
 
1
Other Setups
 
2
============
 
3
 
 
4
Dumb servers
 
5
------------
 
6
 
 
7
Bazaar can also serve branches over protocols that know nothing about Bazaar's
 
8
specific needs.  These are called "dumb servers" to distinguish them from
 
9
Bazaar's native protocol.  Currently HTTP, HTTPS, FTP, SFTP and HTTP+WebDAV can
 
10
be used to read branches remotely.  FTP, SFTP and HTTP+WebDAV can be used for
 
11
writing as well.  To use any of these protocols, it is just necessary to
 
12
provide access to the server's filesystem under ``/srv/bzr``.
 
13
 
 
14
For example, for Apache to provide read-only access to the branches
 
15
in ``/srv/bzr`` the configuration may look like this::
 
16
 
 
17
  Alias /code /srv/bzr
 
18
  <Directory /srv/bzr>
 
19
      Options Indexes
 
20
      # ...
 
21
  </Directory>
 
22
 
 
23
and users could use the URL ``http://server.example.com/code/projectx/trunk``
 
24
to refer to the trunk branch.
 
25
 
 
26
Note that SFTP access is often available whenever there is SSH access and it
 
27
may be a good choice when Bazaar cannot be installed on the server to allow
 
28
``bzr+ssh://`` access.  Dumb servers are slower by their very nature than the
 
29
native protocol, but they can be a good choice in situations where the
 
30
software and protocols that can be used on the server or the network is
 
31
limited.
 
32
 
 
33
Smart server over HTTP(S)
 
34
-------------------------
 
35
 
 
36
Bazaar can use its native protocol with HTTP or HTTPS requests.  Since HTTP is
 
37
a network protocol that is available on many networks, this can be a good
 
38
option where SSH access is not possible.  Another benefit of this setup is that
 
39
all of the authentication and access control methods available to the HTTP
 
40
server (basic, LDAP, ActiveDirectory, etc.) are then available to control
 
41
access to Bazaar branches.  More information about setting up this type of
 
42
access using Apache and FastCGI or mod_python or WSGI is in the `smart server
 
43
section of the User's Guide <../user-guide/http_smart_server.html>`_.
 
44
 
 
45
Direct Smart Server Access
 
46
--------------------------
 
47
 
 
48
The built-in server that is used by ``bzr+ssh://`` access can also be used as a
 
49
persistent server on a dedicated port.  Bazaar's official port is 4155,
 
50
although the port used can be configured.  Further information on running the
 
51
Bazaar smart server from inetd, or directly from the shell is in the `User's
 
52
Guide <../user-guide/server.html#inetd>`_.  The dedicated Bazaar server does
 
53
not currently perform any authentication, so this server by default provides
 
54
read-only access.  It can be run with the ``--allow-writes`` option, but the
 
55
smart server does not do any additional access control so this may allow
 
56
undesired people to make changes to branches.  (Which of course can be
 
57
reverted.)  If the user that runs the server has write access to the branches
 
58
on the filesystem, then anyone with access to port 4155 on the server can make
 
59
changes to the branches stored there. 
 
60