CollabNet

Readme - Apache Server for Subversion 1.7.9 (Solaris 10 / SPARC)

CollabNet Subversion Server Installer for Solaris
Version 1.7.9
Release Date: April, 2013


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
Platform: Solaris 10 SPARC
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" package after the server, but 
  before the server configuration is performed.


2. First-time installation

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

    sudo pkgadd -d /path/to/server-sparc-local

NOTE: You may receive an error message when installing for the first time:

    pkgadd: ERROR: missing entry in contents file for 

    Installation of  failed (internal error) - package
    partially installed.

If you get this error just run the pkgadd command again and it will succeed.  We are
investigating the cause of this problem and will fix it in a future release.

3. Updating an existing installation

Follow these instructions if you are updating an existing installation of the CollabNet
Subversion server.  

A. Stop the current server:

    sudo /etc/init.d/collabnet_subversion stop

B. Backup the existing configuration:

The proper way to update a Solaris package is to remove the current
version and then install the new version.  When you remove the current version, it also
removes your local configuration, such as your Apache usernames/passwords.  NOTE: This
process does not touch your repositories.  You will want to save the current configuration
before removing the server.  To do so, copy the contents of this folder to a safe
location:

    /etc/opt/CollabNet_Subversion/conf

C. Uninstall the current version.  You will also likely want to uninstall the client
and then install the latest client.

    sudo pkgrm CSVNxtrs (if installed)
    sudo pkgrm CSVNsrvr
    sudo pkgrm CSVNclnt
    sudo pkgadd -d /path/to/latest-client-local-sparc

D. Install the current version of the server.

    sudo pkgadd -d /path/to/latest-server-local-sparc

E. Copy the saved configuration files.  Copy the files you saved in step B back to
their original location.  NOTE: Keep the safe copies in case you make a mistake.

F. At this point, you can proceed to the normal Post-installation instructions in
Step 3 below.  When you run the Configure-CollabNet-Subversion script just answer
No, when it asks if you want to do things like create repositories, users etc.  Unless,
of course, you want to do those things at this time.  When the script completes, it will
start the server and it should be using your previous configuration and usernames.


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.