Old:Installing SVN: Difference between revisions
m
rv: Undo spam
Upazixorys (talk | contribs) No edit summary |
m (rv: Undo spam) |
||
| Line 1: | Line 1: | ||
This guide will show you how to install a Subversion (SVN) server with Uniform Server. This guide assumes that you have a clean installation of Uniform Server running currently and do not have another version of Apache installed on your PC. | |||
== Installing SVN == | == Installing SVN == | ||
| Line 7: | Line 7: | ||
== Apache Module Configuration == | == Apache Module Configuration == | ||
# Edit Apache's configuration files (W:\usr\local\Apache2\conf\httpd.conf) and uncomment (remove the # from) this line if it is commented: | # Edit Apache's configuration files (W:\usr\local\Apache2\conf\httpd.conf) and uncomment (remove the # from) this line if it is commented: <pre>LoadModule dav_module modules/mod_dav.so</pre> | ||
# Next find: | # Next find: <pre>LoadModule dav_fs_module modules/mod_dav_fs.so</pre> and add this below it: <pre><nowiki>LoadModule dav_svn_module modules/mod_dav_svn.so | ||
LoadModule authz_svn_module modules/mod_authz_svn.so | LoadModule authz_svn_module modules/mod_authz_svn.so</nowiki></pre> | ||
== Configuring SVN == | == Configuring SVN == | ||
# Create an empty folder (I used W:\svn), which will used as repository root. | # Create an empty folder (I used W:\svn), which will used as repository root. | ||
# Create another empty folder (for example W:\svn\test) in your repository root. | # Create another empty folder (for example W:\svn\test) in your repository root. | ||
# Open the Command Prompt (or MS-DOS Prompt in Win 9x), cd into your repository root. Execute: | # Open the Command Prompt (or MS-DOS Prompt in Win 9x), cd into your repository root. Execute:<pre>svnadmin create --fs-type bdb test</pre>or<pre>svnadmin create --fs-type fsfs test</pre> ''Note: test is the folder you created (under your repository root) earlier in Step #2; for more info on which fs-type to choose, read [http://svnbook.red-bean.com/en/1.1/ch05.html#svn-ch-5-sect-1.2.A Chapter 5, Repository Data-Stores] in the SVN book for more information '' | ||
== Integrating Apache + SVN == | == Integrating Apache + SVN == | ||
First, you should add this anywhere in your configuration file (preferably between | First, you should add this anywhere in your configuration file (preferably between "<IfModule mod_dav.c>" and "</IfModule>"): | ||
<pre><nowiki><Location /svn> | |||
Dav svn | Dav svn | ||
SVNParentPath /svn | SVNParentPath /svn | ||
AuthType Basic | AuthType Basic | ||
AuthName | AuthName "Subversion Repositories" | ||
AuthUserFile /htpasswd/svn/.htpasswd | AuthUserFile /htpasswd/svn/.htpasswd | ||
<LimitExcept GET PROPFIND OPTIONS REPORT> | |||
Require valid-user | Require valid-user | ||
</LimitExcept> | |||
</Location></nowiki></pre> ''Note #1: If you do not want your repository to have read access for everyone (even those who do not have the password) remove the <LimitExcept>'' | |||
''Note #2: /svn is the path to your repository root, if you used any drive other than what Apache is on (Uniform Server default = W:\) for your repository root, you'll have to put the drive letter in front of the / (for example, C:\SVN becomes C:/SVN)'' | ''Note #2: /svn is the path to your repository root, if you used any drive other than what Apache is on (Uniform Server default = W:\) for your repository root, you'll have to put the drive letter in front of the / (for example, C:\SVN becomes C:/SVN)'' | ||
Next, create the .htpasswd file which will store the username & | Next, create the .htpasswd file which will store the username & password needed to modify your repositories. Open the Command Prompt again, cd into Apache's bin directory (W:\usr\local\Apache2\bin). Execute:<pre>htpasswd -c .htpasswd <username></pre> To add more usernames & passwords, execute:<pre><nowiki>htpasswd .htpasswd <username></nowiki></pre> ''Note: Replace <nowiki><username></nowiki> with the username of your choice.'' | ||
For more advanced configurations (not needed by many) view [http://tortoisesvn.tigris.org/docs/TortoiseSVN_en/ch03.html Setting Up an SVN Server]. | For more advanced configurations (not needed by many) view [http://tortoisesvn.tigris.org/docs/TortoiseSVN_en/ch03.html Setting Up an SVN Server]. | ||
== Last Steps == | == Last Steps == | ||
# If you are using version 3.3, please skip to step 4. | # If you are using version 3.3, please skip to step 4. | ||
# Create a | # Create a "htpasswd" directory in the W:/ drive if you are using version 3.2 or less. | ||
# Create a | # Create a "svn" directory under the "htpasswd" directory. | ||
# Copy the .htpasswd file into the | # Copy the .htpasswd file into the "svn" directory. | ||
# Now, the time you've all been for. Restart Uniform Server. | # Now, the time you've all been for. Restart Uniform Server. | ||
# Point your browser to http://localhost/svn/test (where test is the name of the repository you created earlier) | # Point your browser to http://localhost/svn/test (where test is the name of the repository you created earlier) | ||
== Shortcuts == | == Shortcuts == | ||
# If you do not understand how to make the .htpasswd file, you can just make the file and edit it with the contents | # If you do not understand how to make the .htpasswd file, you can just make the file and edit it with the contents "username:password" in the file. | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
| Line 49: | Line 49: | ||
If you installed to another location substitute paths accordingly. | If you installed to another location substitute paths accordingly. | ||
=== How to install SVN === | === How to install SVN === | ||
{|cellspacing= | {|cellspacing="6" | ||
|-valign= | |-valign="top" | ||
|1) | |1) | ||
|'''Run servers''' and check they function. | |'''Run servers''' and check they function. | ||
|Just a quick check, close servers after testing. | |Just a quick check, close servers after testing. | ||
|-valign= | |-valign="top" | ||
|2) | |2) | ||
|Inside folder C:\UniServer_4_3\UniServer\'''udrive''' create two new folders '''svn_tools''' and '''svn''' | |Inside folder C:\UniServer_4_3\UniServer\'''udrive''' create two new folders '''svn_tools''' and '''svn''' <br /> | ||
C:\UniServer_4_3\UniServer\udrive\'''svn_tools''' | C:\UniServer_4_3\UniServer\udrive\'''svn_tools'''<br /> | ||
C:\UniServer_4_3\UniServer\udrive\'''svn''' | C:\UniServer_4_3\UniServer\udrive\'''svn''' | ||
|You can choose different names and locate these outside of the UniServer folder. | |You can choose different names and locate these outside of the UniServer folder.<br />However we are placing these here for portability.<br /> Folder '''svn''' will contain your SVN repositories. | ||
|-valign= | |-valign="top" | ||
|3) | |3) | ||
|Download File: '''svn-win32-1.6.3.zip''' or newer. | |Download File: '''svn-win32-1.6.3.zip''' or newer.<br /> | ||
Located at the bottom of this page: [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100 '''tigris.org'''] | Located at the bottom of this page: [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100 '''tigris.org''']<br /> | ||
Extract to any folder | Extract to any folder | ||
|Make sure any newer version is compatible with the version of Apache. | |Make sure any newer version is compatible with the version of Apache. | ||
|-valign= | |-valign="top" | ||
|4) | |4) | ||
|Copy the entire content of folder svn-win32-1.6.3\'''svn-win32-1.6.3''' | |Copy the entire content of folder svn-win32-1.6.3\'''svn-win32-1.6.3'''<br /> | ||
To folder C:\UniServer_4_3\UniServer\udrive\'''svn_tools''' | To folder C:\UniServer_4_3\UniServer\udrive\'''svn_tools'''<br /> | ||
Folder svn_tools will now contain folders '''bin''', '''iconv''', '''licenses''', | Folder svn_tools will now contain folders '''bin''', '''iconv''', '''licenses''',<br /> '''share''' and file '''README.txt''' | ||
|Once copied if you wish to save space delete the extracted files | |Once copied if you wish to save space delete the extracted files<br /> and svn-win32-1.6.3.zip they are no longer required. | ||
|-valign= | |-valign="top" | ||
|5) | |5) | ||
|Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\'''bin''' | |Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\'''bin'''<br /> | ||
Move files: '''mod_authz_svn.so''' and '''mod_dav_svn.so''' | Move files: '''mod_authz_svn.so''' and '''mod_dav_svn.so'''<br /> | ||
To folder: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\'''modules''' | To folder: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\'''modules''' | ||
|Move the two modules to Apache's module folder; | |Move the two modules to Apache's module folder; | ||
|-valign= | |-valign="top" | ||
|6) | |6) | ||
|Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\'''bin''' | |Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\'''bin'''<br /> | ||
Copy these files: | Copy these files: | ||
| Line 91: | Line 91: | ||
To: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\'''bin''' | To: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\'''bin''' | ||
|The above two modules have dependencies (dlls), | |The above two modules have dependencies (dlls),<br /> | ||
Apache resolves dependences by first looking in | Apache resolves dependences by first looking in<br /> | ||
its bin folder and then looks along system paths. | its bin folder and then looks along system paths.<br /> | ||
Generally these dlls are located on a system path | Generally these dlls are located on a system path<br /> | ||
however we want a portable installation hence they | however we want a portable installation hence they<br /> | ||
are copied to Apache’s bin (binary) folder. | are copied to Apache’s bin (binary) folder. | ||
|-valign= | |-valign="top" | ||
|7) | |7) | ||
|Edit file: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\conf\'''httpd.conf''' | |Edit file: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\conf\'''httpd.conf'''<br /> | ||
Confirm these modules are enabled as shown: | Confirm these modules are enabled as shown: | ||
<pre> | |||
LoadModule dav_module modules/mod_dav.so | LoadModule dav_module modules/mod_dav.so | ||
LoadModule dav_fs_module modules/mod_dav_fs.so | LoadModule dav_fs_module modules/mod_dav_fs.so | ||
</pre> | |||
|Configure Apache to use the subversion module. | |Configure Apache to use the subversion module.<br /> | ||
First check these modules are enabled. | First check these modules are enabled.<br /> | ||
Note, mod_dav.so is enabled by default. | Note, mod_dav.so is enabled by default.<br /> | ||
|-valign= | |-valign="top" | ||
|8) | |8) | ||
|At the end of load modules section add these two lines: | |At the end of load modules section add these two lines: | ||
<pre> | |||
LoadModule dav_svn_module modules/mod_dav_svn.so | LoadModule dav_svn_module modules/mod_dav_svn.so | ||
LoadModule authz_svn_module modules/mod_authz_svn.so | LoadModule authz_svn_module modules/mod_authz_svn.so | ||
</pre> | |||
|The two lines inform Apache to load the svn modules. | |The two lines inform Apache to load the svn modules.<br />Add them just below:<br />LoadModule vhost_alias_module modules/mod_vhost_alias.so | ||
|-valign= | |-valign="top" | ||
|9) | |9) | ||
|At the end of httpd.conf, add the following block of code. | |At the end of httpd.conf, add the following block of code. | ||
<pre> | |||
<location /svn> | |||
DAV svn | DAV svn | ||
SVNListParentPath on | SVNListParentPath on | ||
SVNParentPath C:/UniServer_4_3/UniServer/udrive/svn | SVNParentPath C:/UniServer_4_3/UniServer/udrive/svn | ||
</location> | |||
</pre> | |||
| | |<br /> | ||
* '''svn''' Top level folder name | * '''svn''' Top level folder name <nowiki>http://localhost</nowiki>/svn/*** any name after svn is assumed a repository request and passed to DAV for resolving | ||
* '''DAV svn''' Instructs Apache to pass the request onto the DAV layer for processing as a subversion (svn) request. | * '''DAV svn''' Instructs Apache to pass the request onto the DAV layer for processing as a subversion (svn) request. | ||
* '''SVNListParentPath on''' Enables listing of all repositories for URL | * '''SVNListParentPath on''' Enables listing of all repositories for URL <nowiki>http://localhost</nowiki>/'''svn''' | ||
* '''SVNParentPath''' Absolute path to the parent folder containing all the repositories. | * '''SVNParentPath''' Absolute path to the parent folder containing all the repositories.<br />'''''Note'':''' If you move the servers this path must be changed. | ||
|} | |} | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
=== Testing SVN server === | === Testing SVN server === | ||
* Restart Servers | * Restart Servers | ||
* Access the SVN repository. Type the following into a browser ''' | * Access the SVN repository. Type the following into a browser '''<nowiki>http://localhost/svn</nowiki>''' | ||
Page displays | Page displays | ||
<pre> | |||
Collection of Repositories | Collection of Repositories | ||
page Powered by Subversion version 1.6.3 (r38063). | page Powered by Subversion version 1.6.3 (r38063). | ||
</pre> | |||
This confirms Apache has been configured correctly. Next step is to create an SVN repository. | This confirms Apache has been configured correctly. Next step is to create an SVN repository. | ||
| Line 158: | Line 158: | ||
Name the batch file whatever you like I have named it '''z_start_svn_command_prompt.bat''' add the following content: | Name the batch file whatever you like I have named it '''z_start_svn_command_prompt.bat''' add the following content: | ||
<pre> | |||
start | start "SVN COMMAND PROMPT" cmd.exe /k "COLOR B0" | ||
</pre> | |||
Double click to run, a new command prompt is opened and the working folder is automatically set. | Double click to run, a new command prompt is opened and the working folder is automatically set. | ||
| Line 168: | Line 168: | ||
Run the batch file above and type the following command: | Run the batch file above and type the following command: | ||
<pre> | |||
svnadmin.exe create ..\..\svn\myproject | svnadmin.exe create ..\..\svn\myproject | ||
</pre> | |||
* '''svnadmin.exe''' Runs the subversion administration program. | * '''svnadmin.exe''' Runs the subversion administration program. | ||
* '''create''' Is the command to be run by svn admin. It creates a repository named '''myproject'''. | * '''create''' Is the command to be run by svn admin. It creates a repository named '''myproject'''. | ||
** '''''Note'':''' You can specify an absolute path or a relative path to the folder '''myproject'''. | ** '''''Note'':''' You can specify an absolute path or a relative path to the folder '''myproject'''.<br />For example:<br />Absolute: '''C:\UniServer_4_3\UniServer\udrive\svn\myproject'''<br />Relative: '''..\..\svn\myproject''' - as shown above | ||
* If the folder '''myproject''' does not exist it is created. Adds subversion database and tracking folders. | * If the folder '''myproject''' does not exist it is created. Adds subversion database and tracking folders. | ||
| Line 180: | Line 180: | ||
Start the servers. To access repositories type either of the following into a browser: | Start the servers. To access repositories type either of the following into a browser: | ||
# ''' | # '''<nowiki>http://localhost/svn/</nowiki>''' -- Displays Collection of Repositories page. | ||
## All repositories in folder '''svn''' are listed as links. | ## All repositories in folder '''svn''' are listed as links. | ||
## Currently we have just one repository hence a single link “myproject” is displayed | ## Currently we have just one repository hence a single link “myproject” is displayed | ||
## Click this link to display “myproject” repository. | ## Click this link to display “myproject” repository. | ||
## If you do not want all repositories listed comment this line as shown: '''#SVNListParentPath on''' | ## If you do not want all repositories listed comment this line as shown: '''#SVNListParentPath on'''<br />Accessing '''<nowiki>http://localhost/svn/</nowiki>''' will now produce ''Forbidden You don't have permission to access /svn/ on this server''. | ||
## You can still access a repository by entering its full URL see below. | ## You can still access a repository by entering its full URL see below.<br /> | ||
#''' | #'''<nowiki>http://localhost/svn/myproject/</nowiki>''' -- You directly access a repository by name as shown for "“myproject”. <br />Viewing this repository with a browser you will find it empty.<br /> However view the same folder using '''Windows Explorer''' displays several SVN suport folders and files. | ||
## '''''Folders'':''' '''conf''', '''dav''', '''db''', '''hooks''' and '''locks''' | ## '''''Folders'':''' '''conf''', '''dav''', '''db''', '''hooks''' and '''locks''' | ||
## '''''Files'':''' '''README.txt''' and '''format''' | ## '''''Files'':''' '''README.txt''' and '''format''' | ||
| Line 210: | Line 210: | ||
# Run batch file '''z_start_svn_command_prompt.bat''' (whatever you named it) | # Run batch file '''z_start_svn_command_prompt.bat''' (whatever you named it) | ||
# Type the following: | # Type the following: | ||
<pre> | |||
svn.exe import C:\a_svn_temp http://localhost/svn/myproject -m | svn.exe import C:\a_svn_temp http://localhost/svn/myproject -m "Initial import" | ||
</pre> | |||
This updates your repository with new folder structure and project. | This updates your repository with new folder structure and project. | ||
View repository, type into browser | View repository, type into browser <nowiki>http://localhost/svn/myproject</nowiki> | ||
* The project page and status are displayed '''myproject - Revision 1:''' | * The project page and status are displayed '''myproject - Revision 1:''' | ||
'''''Note'':''' If you do not include '''-m | '''''Note'':''' If you do not include '''-m "Some text"''' SVN will complain about not being able to find a text editor. | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
| Line 240: | Line 240: | ||
[[Category: Self Install]] | [[Category: Self Install]] | ||
[[Category: Development]] | [[Category: Development]] | ||