Show More
@@ -1,84 +1,84 b'' | |||||
1 | .. _svn-http: |
|
1 | .. _svn-http: | |
2 |
|
2 | |||
3 | |svn| With Write Over HTTP |
|
3 | |svn| With Write Over HTTP | |
4 | -------------------------- |
|
4 | -------------------------- | |
5 |
|
5 | |||
6 | To use |svn| with write access, the currently supported method is over HTTP. |
|
6 | To use |svn| with write access, the currently supported method is over HTTP. | |
7 | This requires you to configure your local machine so that it can access your |
|
7 | This requires you to configure your local machine so that it can access your | |
8 | |RCE| instance. |
|
8 | |RCE| instance. | |
9 |
|
9 | |||
10 | Prerequisites |
|
10 | Prerequisites | |
11 | ^^^^^^^^^^^^^ |
|
11 | ^^^^^^^^^^^^^ | |
12 |
|
12 | |||
13 | - Enable lab setting on your |RCE| instance, see :ref:`lab-settings`. |
|
13 | - Enable lab setting on your |RCE| instance, see :ref:`lab-settings`. | |
14 | - You need to install the following tools on your local machine: ``Apache`` and |
|
14 | - You need to install the following tools on your local machine: ``Apache`` and | |
15 | ``mod_dav_svn``. Use the following Ubuntu as an example. |
|
15 | ``mod_dav_svn``. Use the following Ubuntu as an example. | |
16 |
|
16 | |||
17 | .. code-block:: bash |
|
17 | .. code-block:: bash | |
18 |
|
18 | |||
19 | $ sudo apt-get install apache2 libapache2-mod-svn |
|
19 | $ sudo apt-get install apache2 libapache2-mod-svn | |
20 |
|
20 | |||
21 | Once installed you need to enable ``dav_svn``: |
|
21 | Once installed you need to enable ``dav_svn``: | |
22 |
|
22 | |||
23 | .. code-block:: bash |
|
23 | .. code-block:: bash | |
24 |
|
24 | |||
25 | $ sudo a2enmod dav_svn |
|
25 | $ sudo a2enmod dav_svn | |
26 |
|
26 | |||
27 | Configuring Apache Setup |
|
27 | Configuring Apache Setup | |
28 | ^^^^^^^^^^^^^^^^^^^^^^^^ |
|
28 | ^^^^^^^^^^^^^^^^^^^^^^^^ | |
29 |
|
29 | |||
30 | .. tip:: |
|
30 | .. tip:: | |
31 |
|
31 | |||
32 | It is recommended to run Apache on a port other than 80, due to possible |
|
32 | It is recommended to run Apache on a port other than 80, due to possible | |
33 | conflicts with other HTTP servers like nginx. To do this, set the |
|
33 | conflicts with other HTTP servers like nginx. To do this, set the | |
34 | ``Listen`` parameter in the ``/etc/apache2/ports.conf`` file, for example |
|
34 | ``Listen`` parameter in the ``/etc/apache2/ports.conf`` file, for example | |
35 | ``Listen 8090`` |
|
35 | ``Listen 8090`` | |
36 |
|
36 | |||
37 | It is also recommended to run apache as the same user as |RCE|, otherwise |
|
37 | It is also recommended to run apache as the same user as |RCE|, otherwise | |
38 | permission issues could occur. To do this edit the ``/etc/apache2/envvars`` |
|
38 | permission issues could occur. To do this edit the ``/etc/apache2/envvars`` | |
39 |
|
39 | |||
40 | .. code-block:: apache |
|
40 | .. code-block:: apache | |
41 |
|
41 | |||
42 | export APACHE_RUN_USER=ubuntu |
|
42 | export APACHE_RUN_USER=ubuntu | |
43 | export APACHE_RUN_GROUP=ubuntu |
|
43 | export APACHE_RUN_GROUP=ubuntu | |
44 |
|
44 | |||
45 | 1. To configure Apache, create and edit a virtual hosts file, for example |
|
45 | 1. To configure Apache, create and edit a virtual hosts file, for example | |
46 | :file:`/etc/apache2/sites-available/default.conf`, or create another |
|
46 | :file:`/etc/apache2/sites-available/default.conf`, or create another | |
47 | virtual hosts file and add a location section inside the |
|
47 | virtual hosts file and add a location section inside the | |
48 | ``<VirtualHost>`` section. |
|
48 | ``<VirtualHost>`` section. | |
49 |
|
49 | |||
50 | .. code-block:: apache |
|
50 | .. code-block:: apache | |
51 |
|
51 | |||
52 | <Location /> |
|
52 | <Location /> | |
53 | DAV svn |
|
53 | DAV svn | |
54 | # Must be explicit path, relative not supported |
|
54 | # Must be explicit path, relative not supported | |
55 | SVNParentPath /PATH/TO/REPOSITORIES |
|
55 | SVNParentPath /PATH/TO/REPOSITORIES | |
56 | SVNListParentPath On |
|
56 | SVNListParentPath On | |
57 | Allow from all |
|
57 | Allow from all | |
58 | Order allow,deny |
|
58 | Order allow,deny | |
59 | </Location> |
|
59 | </Location> | |
60 |
|
60 | |||
61 | .. note:: |
|
61 | .. note:: | |
62 |
|
62 | |||
63 | Once configured, check that you can see the list of repositories on your |
|
63 | Once configured, check that you can see the list of repositories on your | |
64 | |RCE| instance. |
|
64 | |RCE| instance. | |
65 |
|
65 | |||
66 | 2. Go to the :menuselection:`Admin --> Settings --> Labs` page, and |
|
66 | 2. Go to the :menuselection:`Admin --> Settings --> Labs` page, and | |
67 | enable :guilabel:`Proxy Subversion HTTP requests`, and specify the |
|
67 | enable :guilabel:`Proxy Subversion HTTP requests`, and specify the | |
68 | :guilabel:`Subversion HTTP Server URL`. |
|
68 | :guilabel:`Subversion HTTP Server URL`. | |
69 |
|
69 | |||
70 | Using |svn| |
|
70 | Using |svn| | |
71 | ^^^^^^^^^^^ |
|
71 | ^^^^^^^^^^^ | |
72 |
|
72 | |||
73 | Once |svn| has been enabled on your instance, you can use it using the |
|
73 | Once |svn| has been enabled on your instance, you can use it using the | |
74 | following examples. For more |svn| information, see the `Subversion Red Book`_ |
|
74 | following examples. For more |svn| information, see the `Subversion Red Book`_ | |
75 |
|
75 | |||
76 | .. code-block:: bash |
|
76 | .. code-block:: bash | |
77 |
|
77 | |||
78 | # To clone a repository |
|
78 | # To clone a repository | |
79 |
svn c |
|
79 | svn checkout http://my-svn-server.example.com/my-svn-repo | |
80 |
|
80 | |||
81 | # svn commit |
|
81 | # svn commit | |
82 | svn commit |
|
82 | svn commit | |
83 |
|
83 | |||
84 | .. _Subversion Red Book: http://svnbook.red-bean.com/en/1.7/svn-book.html#svn.ref.svn |
|
84 | .. _Subversion Red Book: http://svnbook.red-bean.com/en/1.7/svn-book.html#svn.ref.svn |
General Comments 0
You need to be logged in to leave comments.
Login now