Old:Installing SVN: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
(Numbered lists will be messed up if list item is longer than a paragraph)
mNo edit summary
Line 42: Line 42:
== 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 "username:password" in the file.
# 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]]'''''
== NEW Installing SVN on 4.3-Mona ==
The following assumes you installed US to C:\UniServer_4_3\UniServer.
If you installed to another location substitute paths accordingly.
=== How to install SVN ===
{|cellspacing="6"
|-valign="top"
|1)
|'''Run servers''' and check they function.
|Just a quick check, close servers after testing.
|-valign="top"
|2)
|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'''<br />
C:\UniServer_4_3\UniServer\udrive\'''svn'''
|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="top"
|3)
|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''']<br />
Extract to any folder
|Make sure any newer version is compatible with the version of Apache.
|-valign="top"
|4)
|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'''<br />
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<br /> and svn-win32-1.6.3.zip they are no longer required.
|-valign="top"
|5)
|Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\'''bin'''<br />
Move files: '''mod_authz_svn.so''' and '''mod_dav_svn.so'''<br />
To folder: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\'''modules'''
|Move the two modules to Apache's module folder;
|-valign="top"
|6)
|Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\'''bin'''<br />
Copy these files:
*  intl3_svn.dll
*  libdb44.dll
*  libsvn_delta-1.dll
*  libsvn_fs-1.dll
*  libsvn_repos-1.dll
*  libsvn_subr-1.dll
To: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\'''bin'''
|The above two modules have dependencies (dlls),<br />
Apache resolves dependences by first looking in<br />
its bin folder and then looks along system paths.<br />
Generally these dlls are located on a system path<br />
however we want a portable installation hence they<br />
are copied to Apache’s bin (binary) folder.
|-valign="top"
|7)
|Edit file: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\conf\'''httpd.conf'''<br />
Confirm these modules are enabled as shown:
<pre>
LoadModule dav_module modules/mod_dav.so
LoadModule dav_fs_module modules/mod_dav_fs.so
</pre>
|Configure Apache to use the subversion module.<br />
First check these modules are enabled.<br />
Note, mod_dav.so is enabled by default.<br />
|-valign="top"
|8)
|At the end of load modules section add these two lines:
<pre>
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so
</pre>
|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="top"
|9)
|At the end of httpd.conf, add the following block of code.
<pre>
<location /svn>
  DAV svn
  SVNListParentPath on
  SVNParentPath C:/UniServer_4_3/UniServer/udrive/svn
</location>
</pre>
|<br />
* '''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.
* '''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.<br />'''''Note'':''' If you move the servers this path must be changed.
|}
'''''[[#top | Top]]'''''
=== Testing SVN server ===
* Restart Servers
* Access the SVN repository. Type the following into a browser '''<nowiki>http://localhost/svn</nowiki>'''
Page displays
<pre>
Collection of Repositories
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.
'''''[[#top | Top]]'''''
=== Creating a repository - Command line ===
To create a repository use the command line tool '''svnadmin.exe'''
This section shows how to create a repository using this tool and how to add a working project. 
'''''[[#top | Top]]'''''
==== Batch file ====
The admin tools requires opening a command prompt and navigating to the svn_tools executables folder .
This I find very tedious hence create the following batch file in folder C:\UniServer_4_3\UniServer\udrive\svn_tools\'''bin'''
Name the batch file whatever you like I have named it '''z_start_svn_command_prompt.bat''' add the following content:
<pre>
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.
'''''[[#top | Top]]'''''
==== Create a repository ====
You need to create at least one blank repository choose a name that matches your project for this example I will use “'''myproject'''”
Run the batch file above and type the following command:
<pre>
svnadmin.exe create ..\..\svn\myproject
</pre>
* '''svnadmin.exe''' Runs the subversion administration program.
* '''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'''.<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.
'''''[[#top | Top]]'''''
==== Repository Access ====
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.
## Currently we have just one repository hence a single link “myproject” is displayed
## Click this link to display “myproject” repository.
## 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.<br />&nbsp;
#'''<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'''
## '''''Files'':''' '''README.txt''' and '''format'''
## Never edit or delete the above folders or files. They tag and track all changes in a repository.
'''''Note'':'''
SVN comes complete with several other command line tools including a '''command line client'''.
'''''[[#top | Top]]'''''
=== Command line client ===
Starting with an empty repository you probably want to quickly set it up and publish your current project as it stands. 
The following shows a quick way to do this it also includes SVN’s recommended folder structure.
# Create a temporary folder for example '''C:\a_svn_temp'''
# Inside this create three new folders (SVN recommended) named:
## '''trunk'''
## '''tags'''
## '''branches'''
# Copy your current stable project into folder '''trunk''' -- Note: For testing I copied folder C:\UniServer_4_3\UniServer\udrive\'''plugins''' 
# '''Start''' servers
# Run batch file '''z_start_svn_command_prompt.bat''' (whatever you named it)
# Type the following:
<pre>
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.
View repository, type into browser <nowiki>http://localhost/svn/myproject</nowiki>
* The project page and status are displayed '''myproject - Revision 1:'''
'''''Note'':''' If you do not include '''-m "Some text"''' SVN will complain about not being able to find a text editor.
'''''[[#top | Top]]'''''
== Related Links ==
* [[SVN: Introduction|Portable Subversion (SVN)]] - Running on 5.0-Nano


== External Links ==
== External Links ==
Line 50: Line 234:




[[Category: Uniform Server 4.0-Mona]]
[[Category: Installation]]
[[Category: Installation]]
[[Category: User Made]]
[[Category: User Made]]
[[Category: Self Install]]
[[Category: Self Install]]
[[Category: Development]]
[[Category: Development]]

Revision as of 09:11, 15 August 2009

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

  1. Download the latest Win32 SVN binaries from here. This guide uses the .exe Installer provided there.
  2. After installing / unpacking it, copy the contents of its httpd folder (usually C:\Program Files\Subversion\httpd) into Apache's module directory (Uniform Server's default is W:\usr\local\Apache2\modules)
  3. Copy libdb42.dll from the bin folder into the same module directory.

Apache Module Configuration

  1. Edit Apache's configuration files (W:\usr\local\Apache2\conf\httpd.conf) and uncomment (remove the # from) this line if it is commented:
    LoadModule dav_module modules/mod_dav.so
  2. Next find:
    LoadModule dav_fs_module modules/mod_dav_fs.so
    and add this below it:
    LoadModule dav_svn_module modules/mod_dav_svn.so

LoadModule authz_svn_module modules/mod_authz_svn.so

Configuring SVN

  1. Create an empty folder (I used W:\svn), which will used as repository root.
  2. Create another empty folder (for example W:\svn\test) in your repository root.
  3. Open the Command Prompt (or MS-DOS Prompt in Win 9x), cd into your repository root. Execute:
    svnadmin create --fs-type bdb test
    or
    svnadmin create --fs-type fsfs test
    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 Chapter 5, Repository Data-Stores in the SVN book for more information

Integrating Apache + SVN

First, you should add this anywhere in your configuration file (preferably between "<IfModule mod_dav.c>" and "</IfModule>"):

<Location /svn>
    Dav svn
    SVNParentPath /svn
    AuthType Basic
    AuthName "Subversion Repositories"
    AuthUserFile /htpasswd/svn/.htpasswd
    <LimitExcept GET PROPFIND OPTIONS REPORT>
        Require valid-user
    </LimitExcept>
</Location>

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)

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:

htpasswd -c .htpasswd <username>

To add more usernames & passwords, execute:

htpasswd .htpasswd <username>

Note: Replace <username> with the username of your choice.

For more advanced configurations (not needed by many) view Setting Up an SVN Server.

Last Steps

  1. If you are using version 3.3, please skip to step 4.
  2. Create a "htpasswd" directory in the W:/ drive if you are using version 3.2 or less.
  3. Create a "svn" directory under the "htpasswd" directory.
  4. Copy the .htpasswd file into the "svn" directory.
  5. Now, the time you've all been for. Restart Uniform Server.
  6. Point your browser to http://localhost/svn/test (where test is the name of the repository you created earlier)

Shortcuts

  1. 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

NEW Installing SVN on 4.3-Mona

The following assumes you installed US to C:\UniServer_4_3\UniServer.

If you installed to another location substitute paths accordingly.

How to install SVN

1) Run servers and check they function. Just a quick check, close servers after testing.
2) Inside folder C:\UniServer_4_3\UniServer\udrive create two new folders svn_tools and svn

C:\UniServer_4_3\UniServer\udrive\svn_tools
C:\UniServer_4_3\UniServer\udrive\svn

You can choose different names and locate these outside of the UniServer folder.
However we are placing these here for portability.
Folder svn will contain your SVN repositories.
3) Download File: svn-win32-1.6.3.zip or newer.

Located at the bottom of this page: tigris.org
Extract to any folder

Make sure any newer version is compatible with the version of Apache.
4) Copy the entire content of folder svn-win32-1.6.3\svn-win32-1.6.3

To folder C:\UniServer_4_3\UniServer\udrive\svn_tools
Folder svn_tools will now contain folders bin, iconv, licenses,
share and file README.txt

Once copied if you wish to save space delete the extracted files
and svn-win32-1.6.3.zip they are no longer required.
5) Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\bin

Move files: mod_authz_svn.so and mod_dav_svn.so
To folder: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\modules

Move the two modules to Apache's module folder;
6) Navigate to C:\UniServer_4_3\UniServer\udrive\svn_tools\bin

Copy these files:

  • intl3_svn.dll
  • libdb44.dll
  • libsvn_delta-1.dll
  • libsvn_fs-1.dll
  • libsvn_repos-1.dll
  • libsvn_subr-1.dll

To: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\bin

The above two modules have dependencies (dlls),

Apache resolves dependences by first looking in
its bin folder and then looks along system paths.


Generally these dlls are located on a system path
however we want a portable installation hence they
are copied to Apache’s bin (binary) folder.

7) Edit file: C:\UniServer_4_3\UniServer\udrive\usr\local\apache2\conf\httpd.conf

Confirm these modules are enabled as shown:

LoadModule dav_module modules/mod_dav.so
LoadModule dav_fs_module modules/mod_dav_fs.so
Configure Apache to use the subversion module.

First check these modules are enabled.
Note, mod_dav.so is enabled by default.

8) At the end of load modules section add these two lines:
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so
The two lines inform Apache to load the svn modules.
Add them just below:
LoadModule vhost_alias_module modules/mod_vhost_alias.so
9) At the end of httpd.conf, add the following block of code.
<location /svn>
  DAV svn
  SVNListParentPath on
  SVNParentPath C:/UniServer_4_3/UniServer/udrive/svn
</location>

  • svn Top level folder name http://localhost/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.
  • SVNListParentPath on Enables listing of all repositories for URL http://localhost/svn
  • SVNParentPath Absolute path to the parent folder containing all the repositories.
    Note: If you move the servers this path must be changed.

Top

Testing SVN server

  • Restart Servers
  • Access the SVN repository. Type the following into a browser http://localhost/svn

Page displays

Collection of Repositories
page Powered by Subversion version 1.6.3 (r38063).

This confirms Apache has been configured correctly. Next step is to create an SVN repository.

Top

Creating a repository - Command line

To create a repository use the command line tool svnadmin.exe

This section shows how to create a repository using this tool and how to add a working project.

Top

Batch file

The admin tools requires opening a command prompt and navigating to the svn_tools executables folder .

This I find very tedious hence create the following batch file in folder C:\UniServer_4_3\UniServer\udrive\svn_tools\bin

Name the batch file whatever you like I have named it z_start_svn_command_prompt.bat add the following content:

start "SVN COMMAND PROMPT" cmd.exe /k "COLOR B0" 

Double click to run, a new command prompt is opened and the working folder is automatically set.

Top

Create a repository

You need to create at least one blank repository choose a name that matches your project for this example I will use “myproject

Run the batch file above and type the following command:

svnadmin.exe create ..\..\svn\myproject
  • svnadmin.exe Runs the subversion administration program.
  • 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.
      For example:
      Absolute: C:\UniServer_4_3\UniServer\udrive\svn\myproject
      Relative: ..\..\svn\myproject - as shown above
  • If the folder myproject does not exist it is created. Adds subversion database and tracking folders.

Top

Repository Access

Start the servers. To access repositories type either of the following into a browser:

  1. http://localhost/svn/ -- Displays Collection of Repositories page.
    1. All repositories in folder svn are listed as links.
    2. Currently we have just one repository hence a single link “myproject” is displayed
    3. Click this link to display “myproject” repository.
    4. If you do not want all repositories listed comment this line as shown: #SVNListParentPath on
      Accessing http://localhost/svn/ will now produce Forbidden You don't have permission to access /svn/ on this server.
    5. You can still access a repository by entering its full URL see below.
       
  2. http://localhost/svn/myproject/ -- You directly access a repository by name as shown for "“myproject”.
    Viewing this repository with a browser you will find it empty.
    However view the same folder using Windows Explorer displays several SVN suport folders and files.
    1. Folders: conf, dav, db, hooks and locks
    2. Files: README.txt and format
    3. Never edit or delete the above folders or files. They tag and track all changes in a repository.

Note:

SVN comes complete with several other command line tools including a command line client.

Top

Command line client

Starting with an empty repository you probably want to quickly set it up and publish your current project as it stands.

The following shows a quick way to do this it also includes SVN’s recommended folder structure.

  1. Create a temporary folder for example C:\a_svn_temp
  2. Inside this create three new folders (SVN recommended) named:
    1. trunk
    2. tags
    3. branches
  3. Copy your current stable project into folder trunk -- Note: For testing I copied folder C:\UniServer_4_3\UniServer\udrive\plugins
  4. Start servers
  5. Run batch file z_start_svn_command_prompt.bat (whatever you named it)
  6. Type the following:
svn.exe import C:\a_svn_temp http://localhost/svn/myproject -m "Initial import"

This updates your repository with new folder structure and project.

View repository, type into browser http://localhost/svn/myproject

  • The project page and status are displayed myproject - Revision 1:


Note: If you do not include -m "Some text" SVN will complain about not being able to find a text editor.

Top

Related Links

External Links