Codepot Files

CODEPOT 

 Codepot is a simple web-based source code manager. It incorporates the
 subversion revision control system and wiki-based documentation, and supports
 authentication via LDAP or DBMS. If you opt for the simplest, you can manage
 multiple subversion repositories independent of each other. Going beyond it,
 you can track issues, write documents, and upload release files.

RPM FILES

 Get the right RPM files by refering to the table below.


 CENTOS5/PHP51/X86_64     codepot-0.2.0-php.1.el5.x86_64.rpm     
                          codepot-peclsvn-0.2.0-php.1.el5.x86_64.rpm            
 -----------------------------------------------------------------------
 CENTOS5/PHP53/X86_64     codepot-0.2.0-php53.1.el5.x86_64.rpm
                          codepot-peclsvn-0.2.0-php53.1.el5.x86_64.rpm
 -----------------------------------------------------------------------
 CENTOS5/PHP53/I686       codepot-0.2.0-php53.1.el5.i686.rpm
                          codepot-peclsvn-0.2.0-php53.1.el5.i686.rpm  
 -----------------------------------------------------------------------
 CENTOS6/PHP53/X86_64     codepot-0.2.0-php.1.el6.x86_64.rpm
                          codepot-peclsvn-0.2.0-php.1.el6.x86_64.rpm 

 0.2.0 is the version number. The release number is composed of 4 segments: 
   - depending php package name
   - actual release number
   - target CentOS distro
   - target architecture

 CentOS 6 comes with PHP 5.3 and its package name is php. So the package
 for CentOS 6 x86_64 running PHP5.3 has the release number of php.1.el6.x86_64.

INSTALLATION ON CENTOS

 A RPM package is provided for RedHat/CentOS Linux. The RPM package specifies
 dependency which must be met prior to or at the same time as the installation
 of the rpm package. 

   $ rpm -ivh codepot-0.2.0-Y.Y.Y.Y.rpm

 You can use the yum utility to be hassle-free instead. However, some required
 packages are not available in the base CentOS repository but in the RPMforge
 repository. You may be required to add the RPMforge repository to the system.
 View http://wiki.centos.org/AdditionalResources/Repositories/RPMForge for 
 RPMforge set-up.

   $ yum localinstall --nogpgcheck codepot-0.2.0-Y.Y.Y.Y.rpm

 Once you have all required package installed, you can proceed to configure
 the system. The following steps shown assume the default installation of
 CentOS 5.

 0.2.0 is the version number and Y.Y.Y.Y is the release number. 

 1. Add the following line to /etc/httpd/conf.d/perl.conf. It must be placed 
 after 'LoadModule perl_module modules/mod_perl.so'.

   PerlSwitches -Mlib=/etc/codepot/perl

 2. Customize the Subversion WebDAV access in /etc/httpd/conf.d/codepot.conf
 which the RPM package copies from /etc/codepot/codepot.http upon fresh
 installation. The default file installed specify the location '/svn'. It
 must match the path part of the subversion base URL(svn_base_url) specified
 in /etc/codepot/codepot.ini. You can skip this step if you don't need any
 customizations.

 3. Create a database named 'codepot' into the running MySQL server. The
 schema is defined in /etc/codepot/codepot.mysql. You can execute the following
 in the MySQL command prompt.

   mysql> create database codepot;
   mysql> use codepot;
   mysql> source /etc/codepot/codepot.mysql;

 4. Customize various configuration items in /etc/codepot/codepot.ini.
 Set all items beginning with database_  to match the database settings.
 Customize the values to match your system database.
 
   database_hostname = "localhost"
   database_username = "root"
   database_password = ""
   database_name = "codepot"
   database_driver = "mysql"
   database_prefix = ""

 5. Add a local user using the 'codepot-user' command. This command is used
 to add a user to the database and a user entry added is effective if codepot
 is configured to use 'DbLoginModel'. You can change it by chaning the value
 of 'login_mode' in /etc/codepot/codepot.ini.

   $ /usr/sbin/codepot-user add username password username@your.domain

 6. Enable the user added.
   
   $ /usr/sbin/codepot-user enable username

 7. Optionally, you can set this user to be a system administrator
 in /etc/codepot/codepot.ini.

   sysadmin_userids = "username"

 8. If you don't have the right subversion extension for PHP installed, you can
 install the codepot-peclsvn package. Codepot requires the 'svn.so' extension 
 built of at least r333800 from http://svn.php.net/repository/pecl/svn/trunk.

   $ rpm -ivh codepot-peclsvn-0.2.0-Y.Y.Y.Y.rpm

 9. Check if you have SELinux on and its current mode with the sestatus command.

   $ /usr/sbin/sestatus
   SELinux status:                 enabled
   SELinuxfs mount:                /selinux
   Current mode:                   enforcing
   Mode from config file:          enforcing
   Policy version:                 21
   Policy from config file:        targeted

 If you have SELinux on in the enforcing mode, check if the data directories
 used by Codepot has the right context set. The 'httpd_sys_content_t' context
 type should be set. The Codepot RPM package sets the context type upon fresh 
 installation only.

   $ ls -Zd /var/lib/codepot
   drwxr-xr-x  root root user_u:object_r:httpd_sys_content_t /var/lib/codepot

   $ ls -Z /var/lib/codepot
   drwxr-xr-x  apache apache system_u:object_r:httpd_sys_content_t attachments
   drwxr-xr-x  apache apache system_u:object_r:httpd_sys_content_t files
   drwxr-xr-x  apache apache system_u:object_r:httpd_sys_content_t svnrepo
   drwxr-xr-x  apache apache system_u:object_r:httpd_sys_content_t usericons

   $ ls -lZd /var/cache/codepot
   drwxr-xr-x  apache apache system_u:object_r:httpd_sys_content_t /var/cache/codepot

 10. If you have SELinux on in the enforcing mode, ensure to allow httpd to
 execute an external command.

   $ /usr/sbin/getsebool httpd_ssi_exec
   httpd_ssi_exec --> off

 If httpd_ssi_exec is off, switch it to on.

   $ /usr/sbin/setsebool -P httpd_ssi_exec=1
   $ /usr/sbin/getsebool httpd_ssi_exec
   httpd_ssi_exec --> on

 The only external command Codepot executes is '/etc/codepot/cloc.pl' which
 is configured under 'cloc_command_path' in /etc/codepot/codepot.ini. Some
 CLOC graphs won't work properly when the execution of this command fails.

 If you don't want to bother with SELinux, disable it.

   $ /usr/sbin/setenforce 0

 Change your system configuration files to make it disabled permanently.

 11. Restart httpd.

   $ service httpd restart

 12. Access http://your-server/codepot/

INSTALLATION ON OTHER SYSTEM

 While installing Codepot on other systems are possible, there is no packages
 avaialble at this moment. You may use the source archive to install in 
 other systems.

SOURCE CODE

 Get codepot-0.2.0.tar.gz. It contains the Codepot source code revision 285.

 Codepot uses the standard autoconf & automake build system. You can execute
 'configure' followed by 'make' and 'make install' in principle. However, there
 are some key options you should be aware of. See this sample run below.
 
   $ ./configure --prefix=/usr \
                 --libdir=/usr/lib64 \
                 --sysconfdir=/etc \
                 --with-wwwdir=/var/www/html/codepot \
                 --with-cfgdir=/etc/codepot \
                 --with-depotdir=/var/lib/codepot \
                 --with-logdir=/var/log/codepot \
                 --with-cachedir=/var/cache/codepot \
                 --with-phpextdir=/usr/lib64/php/modules \
                 --with-phpextinidir=/etc/php.d
   $ make
   $ make install 

 You should take note of the following key directory options:

 - wwwdir:       The directory where most of the codepot program files are 
                 installed.
 - cfgdir:       The directory where the codepot configuration file(codepot.ini)
                 and other supporting files are stored.
 - depotdir:     Subversion repostiories and various files uploaded are stored
                 under this directory.
 - cachedir:     Cache directory.
 - phpextdir:    PHP extension directory. The peclsvn extension(svn.so) goes
                 here.
 - phpextinidir: The configuration file(svn.ini) to enable the extension goes
                 here.
 
 You should customize the value of these directories according to your system
 configuration.

LICENSE

 This software is licensed under the GNU General Public License.

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

 This software contains the following third-party components.

   ------------------------------------------------------------------------
   Name                                         License
   ------------------------------------------------------------------------
   CodeIgniter 1.7.2                            See src/system/license.txt
   Google code prettify                         Apache License 2.0
   JavaScript Creole 1.0 Wiki Markup Parser     See src/js/creole.js
   jQuery JavaScript Library v1.4.2             See http://jquery.org/license
   jQuery UI 1.8                                MIT or GPL
   PHPGraphLib                                  MIT
   CLOC 1.62                                    GPL
   Flot                                         https://github.com/flot/flot/blob/master/LICENSE.txt
   ------------------------------------------------------------------------