BitNami Subversion Stack 1.7.1-0 ============================= 1. OVERVIEW The BitNami Project was created to help spread the adoption of freely available, high quality, open source web applications. BitNami aims to make it easier than ever to discover, download and install open source software such as document and content management systems, wikis and blogging software. You can learn more about BitNami at http://bitnami.org Subversion has rapidly become the version control standard and it is rapidly replacing open source and commercial solutions around the world. Subversion enables globally distributed software development teams to efficiently version and share source code. The open source Subversion project was started in early 2000 by CollabNet, the primary corporate sponsor of Subversion. You can learn more about Subversion at http://subversion.tigris.org/ The BitNami Subversion is an installer that greatly simplifies the installation of a Subversion server and its runtime dependencies. Subversion is distributed Apache/BSD-style open source license. Please see the appendix for the specific licenses of all open source components included. You can learn more about BitNami Stacks at http://bitnami.org/stacks/ 2. FEATURES - Easy to Install BitNami Stacks are built with one goal in mind: to make it as easy as possible to install open source software. Our installers completely automate the process of installing and configuring all of the software included in each Stack, so you can have everything up and running in just a few clicks. - Independent BitNami Stacks are completely self-contained, and therefore do not interfere with any software already installed on your system. For example, you can upgrade your system's MySQL or Apache without fear of 'breaking' your BitNami Stack. - Integrated By the time you click the 'finish' button on the installer, the whole stack will be integrated, configured and ready to go. - Relocatable BitNami Stacks can be installed in any directory. This allows you to have multiple instances of the same stack, without them interfering with each other. 3. COMPONENTS BitNami Subversion ships with the following: - Subversion 1.7.1 - Apache 2.2.21 4. REQUIREMENTS To install BitNami Subversion you will need: - Intel x86 or compatible processor - Minimum of 512 MB RAM - Minimum of 50 MB hard drive space - TCP/IP protocol support - Compatible operantig systems: - An x86 Linux operating system. - A 32-bit Windows operating system such as Windows 2000, XP, Vista or Windows Server 2003. - An OS X operating system (PowerPC or x86). 5. INSTALLATION The BitNami Subversion is distributed as a binary executable installer. It can be downloaded from: http://www.bitnami.org/stacks/ The downloaded file will be named something similar to: bitnami-subversion-1.7.1-0-windows-installer.exe on Windows or bitnami-subversion-1.7.1-0-linux-installer.bin on Linux or bitnami-subversion-1.7.1-0-osx-x86-installer.bin on OS X x86 or bitnami-subversion-1.7.1-0-osx-powerpc-installer.bin on OS X PowerPC. Double click the file and follow the on-screen instructions. If you receive an error message during installation, please refer to the Troubleshooting section. 5. STARTING AND STOPPING BITNAMI SUBVERSION You can start and stop BitNami Subversion on Windows using the shortcuts created in the Start Menu, under Programs -> BitNami -> BitNami Service on Windows. To start/stop/restart application on Linux or OS X you can use the ctlscript.sh utility: ./ctlscript.sh (start|stop|restart) ./ctlscript.sh (start|stop|restart) apache ./ctlscript.sh (start|stop|restart) subversion start - start the service(s) stop - stop the service(s) restart - restart or start the service(s) 6. DIRECTORY STRUCTURE The installation process will create several subfolders under the main installation directory: img/: Additional image files. licenses/: License files. subversion/: Subversion revision control system. scripts/: Simple scripts for launching Subversion applications. apache/: Apache Web server. 8. TROUBLESHOOTING This version of the BitNami Subversion is a preview version, and as such, may contain a number of bugs and be a little bit rough around the edges. We are working on the next release, which will contain several improvements along with expanded documentation. In addition to the resources provided below, we encourage you to post your questions and suggestions at: http://bitnami.org/forums/ We also encourage you to sign up for our newsletter, which we'll use to announce new releases and new stacks. To do so, just register at: http://www.bitnami.org/catalog/newsletter. 8.1 Installer # Installer Payload Error If you get the following error while trying to run the installer from the command line: "Installer payload initialization failed. This is likely due to an incomplete or corrupt downloaded file" The installer binary is not complete, likely because the file was not downloaded correctly. You will need to download the file and repeat the installation process. 9.2 Apache If you find any problem starting Apache, the first place you should check is the Apache error log file: /home/user/subversion-1.7.1-0/apache2/logs/error.log on Linux or /Applications/subversion-1.7.1-0/apache2/error.log on OS X or C:\Program Files\BitNami Subversion Stack\apache2\logs\error.log on Windows. Most errors are related to not being able to listen to the default port. Make sure there are no other server programs listening at the same port before trying to start Apache. Some programs, such as Skype, may also use port 80. For issues not covered in this Quick Start guide, please refer to the Apache documentation, which is located at http://httpd.apache.org/docs/ 9.3 Subversion This section describes how to start the svnserver and to create a simple repository with Subversion. You can find th Subversion technical documentation at http://subversion.tigris.org/. You can start stop Subversion server with ctlscript.sh or using the shortcuts on Windows. We can configure the repository. The repository's svnserve.conf file is the central mechanism for controlling authentication and authorization policies. You can edit this file in /path/to/repository/conf/svnserve.conf. The variables anon-access and auth-access can be set to the values none, read, or write. Setting the value to none prohibits both reading and writing; read allows read-only access to the repository, and write allows complete read/write access to the repository. For example, you can uncomment these lines: [general] anon-access = read auth-access = write password-db = passwd You can edit passwd file at the same directory to manage subversion users. For example, if you uncomment these lines you create two subversion users; harry and sally. [users] harry = harryssecret sally = sallyssecret It is necessary to restart svnserve to apply the changes. Finally you can import a project directory to subversion. $ svn import /path/to/project/ svn://localhost/repository/ -m "first import" 9. LICENSES Apache Web Server is distributed under the Apache License v2.0, which is located at http://www.apache.org/licenses/LICENSE-2.0 Neon is released under the GNU General Public License, which is located at http://www.gnu.org/copyleft/gpl.html Subversion is released under Subversion License / released under the terms of the Apache License, which is located at http://subversion.tigris.org/license-1.html Libiconv is released under the LGPL license, which is located at http://www.gnu.org/licenses/lgpl.html Zlib is released under the zlib License (a free software license/compatible with GPL), which is located at http://www.gzip.org/zlib/zlib_license.html expat is distributed under the MIT License, which is located at http://www.jclark.com/xml/copying.txt OpenSSL is released under the terms of the Apache License, which is located at http://www.openssl.org/source/license.html