CollabNet Subversion Server Installer for Linux
Version 1.5.0-11
Release Date: June 19th, 2008

Contents

1. Platform and configuration
2. First-time installation
3. Updating an existing installation
4. Post-installation instructions
5. Back-end support
6. Support for CollabNet Subversion
7. About Subversion and CollabNet


1. Platform and configuration

Product: CollabNet Subversion server
Platforms: Red Hat Enterprise Linux releases 4 and 5 (all versions, 32 bit) 
Supported Subversion backend: FSFS
Supported Apache Modules: mod_dav_svn, mod_authz_svn, SSL, LDAP

Prerequisites:
- Install the CollabNet Subversion Client before the CollabNet Subversion 
  Server.
- The user needs superuser (root) privileges to install and uninstall CollabNet
  Subversion.
- If you want ViewVC support, install the "extras" RPM after the server RPM, but 
  before the server configuration is performed.


2. First-time installation

Install the client RPM first. The client RPM includes all of the
Subversion libraries. (Refer to the readme for the client RPM before
continuing.) Once the client is installed, install the server RPM using
this command:

    sudo rpm -ivh /path/to/server.rpm


3. Updating an existing installation

Before updating an existing CollabNet Subversion server installation to the
latest version, follow these steps:

A. Stop the existing server if it is running:
    
    sudo /etc/rc.d/init.d/collabnet_subversion stop

B. Back up local configuration files. The update process does not touch your
   repositories at all, but it is possible for you to lose your local
   configuration files, such as your Apache configuration or your list of
   usernames/passwords. To be safe, copy the contents of this folder to a
   safe location:

    /etc/opt/CollabNet_Subversion/conf

C. Install the updates. You must update the client RPM first. Follow the
   instructions in the readme for the client. Then install the server RPM
   using this command:

    sudo rpm -Uvh /path/to/server.rpm

D. Run the Configure-CollabNet-Subversion script. Just follow the
   Post-installation instructions in the next section. When you run the 
   Configure script, select No when you are asked if you want to create 
   new repositories, users, and so on (unless you want to redo those steps). 
   At the end, the script restarts the server and, if you followed these 
   instructions, your previous configuration should still be in tact.

   If you have problems, you can copy the files you saved in step B back to
   their original location.


4. Post-installation instructions

A. CollabNet Subversion installs into /opt/CollabNet_Subversion, which is
   probably not on the executable search path for your system. Add the 
   directory /opt/CollabNet_Subversion/bin to your $PATH environment
   variable. To make this change so it affects all users of your system 
   and persists across reboots, add the following line to /etc/profile:

    PATH=/opt/CollabNet_Subversion/bin:$PATH

B. CollabNet Subversion provides an interactive script which allows you to
   choose which Subversion server process you want to run (either Apache or
   the custom svnserve daemon) and configure it. The script also walks you
   through creating Subversion repositories and setting up of basic
   Subversion authentication and authorization. Once you add CollabNet
   Subversion to your system's $PATH environment variable, run the following
   script as superuser: 

    $ sudo Configure-CollabNet-Subversion
    
C. CollabNet Subversion provides man pages and localizations for several
   languages. To take advantage of these features, update your MANPATH and/or 
   LOCPATH environment variables to include the CollabNet Subversion directories.  
   For example:

   export MANPATH=/opt/CollabNet_Subversion/share/man:$MANPATH
   export LOCPATH=/opt/CollabNet_Subversion/share/locale:$LOCPATH


5. Back-end support

If you try to access an existing BDB (Berkeley DB) based repository through 
CollabNet Subversion, then you might receive an alert "Failed to load module 
for FS type 'bdb'." This is because CollabNet Subversion does not support 
BDB. CollabNet recommends FSFS over BDB for ease of maintenance and supportability.


6. Support for CollabNet Subversion

Find out about CollabNet Technical Support at 
http://www.collab.net/services/subversion/
   
Information about CollabNet Training, Consulting, and Migration
services is at http://www.collab.net/services/subversion/training.html
   
Join openCollabNet for community support: http://open.collab.net.



7. About Subversion and CollabNet

CollabNet launched the Subversion project in 2000 in response to the demand 
for an open standard for Web-based software configuration management that 
could support distributed development. CollabNet continues to be strongly 
involved with the Subversion project and offers CollabNet Subversion Support, 
Training, and Consulting services. 
   
CollabNet also provides the most widely used collaborative development 
environment in the world. More than 1,400,000 developers and IT projects 
managers collaborate online through CollabNet. The company is transforming 
the way software is developed by enabling organizations to leverage global 
development talents to deliver better products and innovate faster. 
   
Visit CollabNet at http://www.collab.net for more information.