BitNami Trac Stack 1.1.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.com Trac is an enhanced wiki and issue tracking system for software development projects. Trac uses a minimalistic approach to web-based software project management. Our mission is to help developers write great software while staying out of the way. Trac should impose as little as possible on a team's established development process and policies. It provides an interface to Subversion, an integrated Wiki and convenient reporting facilities. Trac allows wiki markup in issue descriptions and commit messages, creating links and seamless references between bugs, tasks, changesets, files and wiki pages. A timeline shows all project events in order, making the acquisition of an overview of the project and tracking progress very easy. You can learn more about Trac at http://trac.edgewall.org The BitNami Trac Stack is an installer that greatly simplifies the installation of Trac and runtime dependencies. It includes ready-to-run versions of Apache, SQLite, Python and Subversion. Trac Stack is distributed for free under the Apache 2.0 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.com/stacks/ BitNami virtual machine images contain a minimal Linux operating system and a fully configured BitNami application stack. Running virtual machine images requires a hypervisor such as VMWare or VirtualBox, so it is recommended for system administrators and advanced users. You can learn more about BitNami Virtual Appliances at http://wiki.bitnami.com BitNami Cloud Hosting simplifies the process of deploying open source applications in the cloud. Which one click, you can launch applications in the Amazon Cloud (with support for other clouds coming in the future.) You can learn more about BitNami Cloud Hosting at http://bitnami.com/cloud 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 Trac Stack ships with the following: - Trac 1.1.1 - Apache 2.4.4 - SQLite 3.7.10 - Python 2.7.4 - Subversion 1.7.5 - Git 1.8.2 - TracAccountManager Plugin 4. REQUIREMENTS To install BitNami Trac Stack you will need: - Intel x86 or compatible processor - Minimum of 512 MB RAM - Minimum of 150 MB hard drive space - TCP/IP protocol support - Compatible operating systems: - An x86 or x64 Linux operating system. - A Windows operating system such as Windows 2000, XP, Vista, 7, 2008 or Windows Server 2003. - An OS X operating system. 5. INSTALLATION The BitNami Trac Stack is distributed as a binary executable installer. It can be downloaded from: http://bitnami.com/stacks/ The downloaded file will be named something similar to: bitnami-trac-1.1.1-0-linux-installer.run on Linux or bitnami-trac-1.1.1-0-linux-x64-installer.run on Linux 64 bit or bitnami-trac-1.1.1-0-windows-installer.exe on Windows or bitnami-trac-1.1.1-0-osx-x86-installer.dmg on OS X x86 On Linux, you will need to give it executable permissions: chmod 755 bitnami-trac-1.1.1-0-linux.run To begin the installation process, double-click on that file, and you will be greeted by the 'Welcome' screen. The next screen is the Installation Folder, where you can select where BitNami stack will be installed. If the destination directory does not exist, it will be created as part of the installation. The next screen will prompt you for data necessary to create the initial admin user: Username and password: You will use this information to log-in into the administrative interface. The password you provide here will also be used to protect other parts of the installation. Please see the section named "Usernames and Passwords" later in this document. The next screen will vary, depending on whether the ports needed by the bundled Apache and Subversion are already taken or not. The default listening port for Apache is 8080 on Linux and 80 on Wndows and for Subversion is 3690. If those ports are already in use by other applications, you will be prompted for alternate ports to use. The last screen will prompt you for data to create an initial project and to use a Subversion repository. This repository will be created if a non existing folder is entered in the field. Bear in mind that if you enter an existing folder, it must contain a valid svn repository. Once the information has been entered, the installation will proceed to copy the files to the target installation directory and configure the different components. One this process has been completed, you will see the 'Installation Finished' page. You can choose to launch BitNami Trac Stack at this point. If you do so, your default web browser will open and display the Welcome page for the BitNami Trac Stack. If you received an error message during installation, please refer to the Troubleshooting section. The rest of this guide assumes that you installed BitNami Trac Stack in /home/user/trac-1.1.1-0 on Linux or C:\Program Files\BitNami Trac Stack on Windows or /Applications/trac-1.1.1-0 on OS X and that you use port 8080 for Apache on Linux and port 80 on Windows and 3690 for Subversion. 6. STARTING AND STOPPING BITNAMI TRAC STACK The BitNami Application Manager is a simple graphical interface included in the stacks that can start and stop the BitNami servers. It is are located in the same installation directory. To start the utility, double click the file named ‘manager-linux’, 'manager-windows' or 'manager-osx' from your file browser. Alternatively, you can also start and stop the services manually, as explained below. To start/stop/restart application from the command line on Linux and OSX you can use the included ctlscript.sh utility, as shown below: ./ctlscript.sh (start|stop|restart) ./ctlscript.sh (start|stop|restart) subversion ./ctlscript.sh (start|stop|restart) apache start - start the service(s) stop - stop the service(s) restart - restart or start the service(s) You can start and stop BitNami Trac Stack on Windows using the shortcuts created in the Start Menu, under Programs -> BitNami -> BitNami Service That will start Apache service. Once started, you can open your browser and access the following URL on Linux or OS X: http://127.0.0.1:8080/trac/ And you can access the following URL on Windows: http://127.0.0.1/trac/ If you selected an alternate port during installation, for example 18080, the URL will look like: http://127.0.0.1:18080/trac/ If you are accessing the machine remotely, you will need to replace 127.0.0.1 with the appropriate IP address or hostname. 7. DIRECTORY STRUCTURE The installation process will create several subfolders under the main installation directory: manager-platform: Graphical Tool for managing servers apache2/: Apache Web server. python/: Python. subversion/: Subversion application folder sqlite/ SQlite application folder apps/trac/: Trac application folder conf/: Trac Apache configuration files scripts/: mod_wsgi configuration file 8. DEFAULT USERNAMES AND PASSWORDS The Trac administrative user and password are the ones you set at installation time. 9. TROUBLESHOOTING You can find more information about this product at: http://wiki.bitnami.com We also encourage you to post your questions and suggestions at: http://answers.bitnami.com 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://bitnami.com/newsletter. 9.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. # Installer execution error on Linux If you get the following error while trying to run the installer: "Cannot open bitnami-trac-1.1.1-0-linux.run: No application suitable for automatic installation is available for handling this kind of file." In some operatings systems you can change permissions with right click properties -> permissions -> execution enable. Or from the command line: $ chmod 755 bitnami-trac-1.1.1-0-linux.run 9.2 Apache If you find any problem starting Apache, the first place you should check is the Apache error log file: /home/user/trac/apache2/logs/error.log on Linux or C:\Program Files\BitNami Trac Stack\apache2\logs\error.log on Windows or /Applications/trac-1.1.1-0/apache2/logs/error.log. 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. You can find more info at http://wiki.bitnami.com/Components/Apache 9.3 Trac For any problem related to Trac, please visit http://trac.edgewall.org/wiki/TracSupport 10. LICENSES Apache Web Server is distributed under the Apache License v2.0, which is located at http://www.apache.org/licenses/LICENSE-2.0 Python is distributed under the Python 2.5 License, which is located at http://www.python.org/download/releases/2.5.1/license/ This product includes software developed by CollabNet (http://www.Collab.Net/). Subversion is distributed under the license located at http://subversion.tigris.org/license-1.html SQLite has been dedicated to public domain by the authors. You can find more about this at http://www.sqlite.org/copyright.html Trac is distributed under the modified BSD License, which is located at http://trac.edgewall.org/wiki/TracLicense curl is distributed under the Curl License, which is located at http://curl.haxx.se/docs/copyright.html expat is distributed under the MIT License, which is located at http://www.jclark.com/xml/copying.txt gd is distributed under the gd License, which is located at http://www.boutell.com/gd/manual2.0.33.html IMAP is distributed under the University of Washington Free-Fork License, located at http://www.washington.edu/imap/legal.html jpegsrc is distributed under The Independent JPEG Group's JPEG software license, which is located at http://dev.w3.org/cvsweb/Amaya/libjpeg/README?rev=1.2 libiconv is distributed under the Lesser General Public License (LGPL), located at http://www.gnu.org/copyleft/lesser.html zlib and libpng are distributed under zlib License, located at http://www.zlib.net/zlib_license.html ClearSilver is distributed under the Neotonic ClearSilver Software License, located at http://www.clearsilver.net/license.hdf libxml2 is distributed under the MIT license, located at http://www.opensource.org/licenses/mit-license.php mod_python is distributed under the Apache license, located at http://www.apache.org/licenses/LICENSE-2.0 Pysqlite is distributed under the license located at http://www.initd.org/tracker/pysqlite/wiki/About neon is distributed under the Lesser General Public License (LGPL), located at http://www.gnu.org/copyleft/lgpl.html Silvercity is distributed under the BSD License, located at http://www.opensource.org/licenses/bsd-license.php SWIG is distributed under the license located at http://www.swig.org/copyright.html