Now we’re getting ready for some of the fun stuff. This time around, we’re going to install Apache (aka “httpd”) and Subversion (aka “svn”) and prepare to create a basic repository over https authentication.
Installing the Binaries
- Login to your CentOS VM as the root user.
- Open the Terminal (it can be found in Applications –> Accessories –> Terminal)
- Type the following in the terminal (without quotes): “yum install mod_dav_svn subversion”. This tells CentOS to use its package manager to pull down the subversion module for Apache and the subversion binaries itself. NOTE: A nice feature here is that CentOS knows that mod_dav_svn requires Apache, and so it’s going to install Apache for us as well. Very kind!
Creating Directories for SubversionWe need to give the subversion repositories a place to live, and we want to provide a common directory for subversion authentication.
In the terminal, type the following:
- mkdir /var/www/svn
- mkdir /var/www/svn/repositories
- mkdir /var/www/svn/auth
Create Local User AccountsThese accounts are separate from operating system accounts – they’ll apply only to Apache via the configuration files we’ll be setting up soon.
NOTE: These user accounts will apply across multiple repositories if we’d like them to; think of them as “subversion-wide” user accounts.
We’ll create two test users by running the following via the terminal:
- htpasswd -csb /var/www/svn/auth/svn.htpasswd svnuser1 passw0rd1
- htpasswd -sb /var/www/svn/auth/svn.htpasswd svnuser2 passw0rd2
This creates the credentials for both users in the svn.htpasswd file. –c is the command to create a new file, –s forces SHA encryption of the password, and –b lets us pass the password via the command line (otherwise, it would have prompted us one at a time).
Creating our First RepositoryWe’ll create a repository called TestProjectRepo under our repositories directory that we’ve created by running the following on the terminal:
- svnadmin create /var/www/svn/repositories/TestProjectRepo
Granting Apache Ownership of the Repository FolderApache installs its own user account when setting itself up. The user, of course, is “apache”, and a group called “apache” now exists as well.
Run the following command in the terminal to grant apache the access it needs:
- chown -R apache:apache /var/www/svn/repositories/TestProjectRepo
Editing the Apache Configuration to View our RepositoryFirst, we’ll need to create configuration file. To do this by creating and opening a blank file, type the following into your terminal:
- gedit /etc/httpd/conf.d/svn.conf
Enter the following into the text file:
1: <Location /svn>
2: DAV svn
3: SVNListParentPath on
4: SVNParentPath /var/www/svn/repositories/
6: AuthType Basic
7: AuthName “TestProject Repository Site”
8: AuthUserFile /var/www/svn/auth/svn.htpasswd
9: Require valid-user
Save the file. This text does the following:
- Line 1: Tells apache that off of the main URL, the virtual directory will be “/svn”. (so if apache is hosting a web site at www.myreposite.com, our app will be located at www.myreposite.com/svn)
- Line 2: Tells apache we’ll be using the mod_dav_svn module
- Line 4: the location of our repositories on the actual server
- Line 6: Configures basic authentication (which is the type of auth that our basic file setup is using)
- Line 7: Defines the Text that will show up when the user is prompted for a username and password
- Line 8: This is the reference to the file we created that holds the basic passwords
- Line 9: This states that for this directory, Apache will deny anyone who doesn’t login as a user that is listed in our auth file.
We need to restart the server for these changes to take effect. To do this, enter the following into the terminal:
- /etc/init.d/httpd restart
Seeing it in Action
Since the default configuration for apache is to host web site’s on port 80, you should be able to point a web browser on another machine to your subversion server’s web site via its IP address and get the result.
I didn’t know what the IP address was for my subversion server, so I typed “ifconfig” into the terminal to get. I saw that my “inet addr” for my connection “eth0” is 10.0.0.15, and I know that the site is hosted on port 80 by default (which I don’t have to enter into my web browser because it knows this), and I know that the virtual directory is /svn, so I type the following into my web browser:
…and lo & behold, I’m greeted with a password prompt! I enter one of our pre-defined usernames and passwords, I’m greeted with the following in my web browser:
Great – I can see my repository!
Now, bear in mind, this is an empty repository, so clicking on it won’t give you the satisfaction of seeing any project files. But don’t worry, we’ll be taking care of that next.
Starting Apache Upon System Startup
For use multiple times, it will likely make sense to have Apache start up with the system.
On the Centos VM command line, run the collowing:
- chkconfig httpd on
That's it; the server will start at boot.
I'd love to hear any comments on this series. Find it useful? Think there's a better way to implement the technique or something I should have mentioned? Please drop a line in the comments to help me improve the series!
ReferencesSome of the great resources that I pulled this information from:
|<— Part 3: OS Setup|