######################################################
#
# FreeBSD 6.1 Release
#
# Based on the Savane-2.0 debian dist
#
# You can find the source files with the patches mentioned applied at
# http://www.digilanti.org/FreeBSD-6.1-R_Savane-2.0.tar.bz2
#
######################################################
 location changes
 everything is under /usr/local paths have been adjusted

/usr/local/bin
/usr/local/lib
/usr/local/etc
/usr/local/share

######################################################
 file changes
 fix inconcistent use of chown user.group(linux) user:group (bsd) opt format

bin/sv_gpgcheckfiles:		system("chown", "root:root", "-R", $cachedir);
bin/sv_update_conf:		`chown root:$http_user $conffile_phpcopy $conffile` if $http_user;
# note "root.adm" typo ? may break if admin group doesn't exist
lib/perl5/Savane/Cvs.pm:	system("chown", "root:admin", "$dir_cvs/CVSROOT", "-R");
lib/perl5/Savane/Download.pm:	system('/bin/chown', "gatekpr:$name", $dir_public);
lib/perl5/Savane/Download.pm:	system ('/bin/chown', 'upload:gatekpr', $dir_upload);
lib/perl5/Savane/Download.pm:	system ('/bin/chown', 'gatekpr:gatekpr', $dir_ftpin);
lib/perl5/Savane/Download.pm:	system ('/bin/chown', 'gatekpr:gatekpr', $dir_ftpout);

######################################################
fix hostname FreeBSD cmd returns fqdn with no options (default)
                                          remove '-f'
bin/sv_update_conf:$sys_default_domain = `hostname`; chomp($sys_default_domain);

######################################################
 fix paths, everything is relative to /usr/local/

savane/configure:  MM_PATH (add this) /usr/local/mailman/cgi-bin/listinfo
bin/sv_update_conf my $confdir = "/usr/local/etc/savane";
share/savane-frontend/testconfig.php:$configfile = '/usr/local/etc/savane/';

# note
bash is /usr/local/bin/bash

######################################################
 Savane 2.0 requires these additional pkgs to be
 installed and functional apache php exim mailman cvs
 if you want ssl you have to compile a version of
 apache with ssl, php4 is unstable with apache-ssl this
 is why you won't find pre-pkg-ed apache+ssl+php ?

 Recomend these too but not needed
 phpMyAdmin-2.7.0.2  A set of PHP-scripts to manage MySQL over the web
 wget-1.10.2         Retrieve files from the Net via HTTP and FTP

 I add these lines to ~/.login to help get these pkgs installed

 setenv PACKAGEROOT ftp://ftp3.freebsd.org/pub/FreeBSD/ports/i386/packages-6.1-release/All/
 setenv PACKAGESITE ftp://ftp4.freebsd.org/pub/FreeBSD/ports/i386/packages-6.1-release/All/

 then # pkg_add -r <pkgname> (as root) many are installed as dependancies
 so you won't have to type them all in

apache-1.3.34_4     The extremely popular Apache http server. Very fast, very c
bash-3.1.10_1       The GNU Project's Bourne Again SHell
coreutils-5.2.1     The Free Software Foundation's core utilities
curl-7.15.3         Non-interactive tool to get files from FTP, GOPHER, HTTP(S)
cvsutils-2003.02.03 CVS utilities which facilitate working with local working d
dpkg-1.9.21_2       Package maintenance system for Debian
exim-4.60           High performance MTA for Unix systems on the Internet
expat-2.0.0_1       XML 1.0 parser written in C
fontconfig-2.3.2_3,1 An XML-based font configuration API for X Windows
freetype2-2.1.10_3  A free and portable TrueType font rendering engine
gettext-0.14.5_2    GNU gettext package
gettext-lint-0.3.1  Check the validity and consistency of PO and POT files
jpeg-6b_4           IJG's jpeg compression utilities
libdrm-2.0_1        Userspace interface to kernel Direct Rendering Module servi
libiconv-1.9.2_2    A character set conversion library
libltdl-1.5.22      System independent dlopen wrapper
libmcrypt-2.5.7_2   Multi-cipher cryptographic library (used in PHP)
libxml2-2.6.23_1    XML parser library for GNOME
lynx-2.8.5_2        A non-graphical, text-based World-Wide Web client
mailman-2.1.7       A mailing list manager (MLM) with a user-friendly web front
mm-1.4.0            Shared memory allocation library for pre-forked process mod
mysql-client-4.1.18_1 Multithreaded SQL database (client)
mysql-scripts-4.1.18_1 Multithreaded SQL database (scripts)
mysql-server-4.1.18_2 Multithreaded SQL database (server)
p5-Archive-Tar-1.28 Perl module for creation and manipulation of tar files
p5-Compress-Zlib-1.41 Perl5 interface to zlib compression library
p5-DBD-mysql41-3.0002 MySQL 4.1 driver for the Perl5 Database Interface (DBI)
p5-DBI-1.50         The perl5 Database Interface.  Required for DBD::* modules
p5-ExtUtils-CBuilder-0.15 Compile and link C code for Perl modules
p5-ExtUtils-ParseXS-2.15 Converts Perl XS code into C code
p5-File-Find-Rule-0.28_1 Alternative interface to File::Find
p5-IO-String-1.08   Simplified Perl5 module to handle I/O on in-core strings
p5-IO-Zlib-1.04_1   IO:: style interface to Compress::Zlib
p5-MIME-Base64-3.07 Perl5 module for Base64 and Quoted-Printable encodings
p5-Mail-Tools-1.74  Perl5 modules for dealing with Internet e-mail messages
p5-Module-Build-0.26.11_1 Build and install Perl modules
p5-Number-Compare-0.01 Numeric comparisons
p5-PathTools-3.16   A Perl module for portably manipulating file specifications
p5-Regexp-Assemble-0.23 Assemble multiple Regular Expressions into one RE
p5-Regexp-Common-2.120 Regexp::Common - Provide commonly requested regular express
p5-Scalar-List-Utils-1.18,1 Perl subroutines that would be nice to have in the perl cor
p5-Spiffy-0.30      Spiffy Perl Interface Framework For You
p5-Storable-2.15    Persistency for perl data structures
p5-Term-ReadKey-2.30 A perl5 module for simple terminal control
p5-Test-Base-0.50   Test::Base - A Data Driven Testing Framework
p5-Test-Harness-2.56 Run perl standard test scripts with statistics
p5-Test-Simple-0.62 Basic utilities for writing tests in perl
p5-Text-Glob-0.06   Match globbing patterns against text
p5-YAML-0.58        YAML implementation in Perl
pecl-pdflib-2.0.4   A PECL extension to create PDF on the fly
perl-5.8.8          Practical Extraction and Report Language
php4-4.4.2_1        PHP Scripting Language (Apache Module and CLI)
php4-bz2-4.4.2_1    The bz2 shared extension for php
php4-ctype-4.4.2_1  The ctype shared extension for php
php4-curl-4.4.2_1   The curl shared extension for php
php4-gd-4.4.2_1     The gd shared extension for php
php4-gettext-4.4.2_1 The gettext shared extension for php
php4-mbstring-4.4.2_1 The mbstring shared extension for php
php4-mcrypt-4.4.2_1 The mcrypt shared extension for php
php4-mysql-4.4.2_1  The mysql shared extension for php
php4-openssl-4.4.2_1 The openssl shared extension for php
php4-pcre-4.4.2_1   The pcre shared extension for php
php4-readline-4.4.2_1 The readline shared extension for php
php4-session-4.4.2_1 The session shared extension for php
php4-zlib-4.4.2_1   The zlib shared extension for php
pkgconfig-0.20      A utility to retrieve information about installed libraries
png-1.2.8_3         Library for manipulating PNG images
python-2.4.2        An interpreted object-oriented programming language
t1lib-5.1.0_1,1     A Type 1 Rasterizer Library for UNIX/X11
viewcvs-0.9.4       Python version of Zeller's cvsweb
xorg-libraries-6.9.0 X11 libraries and headers from X.Org

######################################################
 Install

 After the above mentioned pkgs are installed

1. Setup /etc/rc.conf make sure it has these lines, tune to taste

apache_enable="YES"
mysql_enable="YES"
mysql_limits="NO"
mysql_dbdir="/path/to/where/you/want/mysql/to/store/db"
mysql_args=""
sendmail_enable="NONE"
exim_enable="YES"

2. Setup mysql as in savane docs

 http://download.gna.org/savane-doc/savane-install-guide-HTML/x523.html

 Test mysql, phpMyadmin is ideal for making sure mysql is ok
 talking php via apache and adjusting the main user for savane.
 After the mysql database has been initialised with data, use pMA to
 make sure the savane mysqluser has the proper privileges on the right
 database, set as per your needs

3. Setup apache (/usr/local/etc/httpd.conf)
   can be virual hosts or aliased directories

    Alias /savane/ "/usr/local/share/savane-frontend/"

   <Directory "/usr/local/share/savane-frontend">
        Options Indexes MultiViews FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from your.test.ip.only
    </Directory>

   Test apache+php, fire up your browser

5. Ok ? if everything works

cd /usr/local
tar -xjf <pathtoarchive>/FreeBSD-6.1-R_Savane-2.0.tar.bz2

 Configure savane using mysqluser/mysqlpasswd and paths used above.

 Test installation by browsing my.site.ip/savane/testconfig.php

 Make any adjustments needed in /usr/local/etc/php.ini and 
 /usr/local/etc/apache/httpd.conf

 Configure savane installation as recomended 

 /usr/local/bin/savane-configure

 https://gna.org/userguide/
 http://download.gna.org/savane-doc/savane-install-guide-HTML/