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.