CollabNet Subversion Server Installer for Linux Version 1.6.18 Release Date: April 12, 2012 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) CentOS 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.