CollabNet Subversion Extras Installer for Linux

CollabNet Subversion Extras Installer for Linux



Version 1.4.6-3

Release Date: January 4, 2008

Readme Updated: May 6, 2008





Contents



1. Platform and configuration

2. Support for CollabNet Subversion

3. Updating an existing installation

4. Post-installation instructions

5. ViewVC Configuration

6. About Subversion and CollabNet





1. Platform and configuration



Product: CollabNet Subversion extras

Platform: Red Hat Enterprise Linux releases 4 and 5 (all versions, 32 bit)

Includes: Subversion python bindings and ViewVC



Pre-requisites:

- The CollabNet Subversion Client and Server need to be installed before the 

  CollabNet Subversion extras.

- The user needs super-user privileges to install and uninstall CollabNet Subversion.





2. Support for CollabNet Subversion



Find out about CollabNet Technical Support at 

http://www.collab.net/support/svn_support.html

   

Information about CollabNet Training, Consulting and Migration

services is at http://www.collab.net/services/consulting/

   

Join openCollabNet for community support: http://open.collab.net.





3. Updating an existing installation



Before updating an existing CollabNet Subversion extras installation to the latest 

version be sure to follow these steps:



A. Stop the existing server if it is running:

    

    sudo /etc/rc.d/init.d/collabnet_subversion stop



B. Backup local configuration files.  The update process will 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 and server RPM first.  Follow 

the instructions in the readme for the client and server respectively.  Then, 

install the extras RPM using this command:



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



D. Run the Configure-CollabNet-Subversion script.  Just follow the Post-installation

instructions in step 3 below.  When running the Configure script, you can just say 

No when it asks if you want to create new repositories, users, etc.  Unless, of 

course, you want to do those steps again.  At the end, the script will restart 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.  You need to add 

the directory /opt/CollabNet_Subversion/bin to your $PATH environment 

variable. You can make this change in a way that will affect all users of 

your system and persists across reboots. To do this, 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 

the creation of Subversion repositories and the setup of basic Subversion 

authentication and authorization. Once you've added CollabNet Subversion to 

your system's $PATH environment variable, run the following script as super user: 



    $ sudo Configure-CollabNet-Subversion

    

C. CollabNet Subversion provides man pages and localizations for several

languages.  To take advantage of these features you need to 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. ViewVC configuration



ViewVC support currently requires that you are using the Apache server 

option. When you run the Configure-CollabNet-Subversion script if you choose

the option to configure an Apache server, and the extras RPM has been installed,

then you will be asked if you want to configure ViewVC.  You just have to answer 

Yes and the script will add ViewVC to the Apache configuration.





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