Freeside:2.1:Documentation:Installation:FreeBSD

Summary

FreeBSD 8.1 install of Freeside 2.1.1 + RT using ports (ports tree date 1/3/2011) where possible.

Please note this quick guide is written for someone already familiar with installing and maintaining a FreeBSD system. This is NOT a bare metal install guide. This guide leaves many apache modules that you may not need activated - feel free to pare things down once you have a working install.

1. Install a ton of ports

I use portmaster for most ports tasks. It's in ports-mgmt/portmaster.

Here's the list, as output by "portmaster --list-origins". If you save this list to a file, something like "portmaster `cat /tmp/fs-port-list` should install all of these:

devel/libtool
lang/python26
archivers/unzip
devel/automake
devel/gmake
misc/help2man
www/p5-Apache-DBI-mp2
www/p5-Apache-Session
security/p5-Authen-Passphrase
finance/p5-Business-CreditCard
textproc/p5-CSS-Squish
devel/p5-Calendar-Simple
graphics/p5-Color-Scheme
databases/p5-DBD-Pg
databases/p5-DBIx-SearchBuilder
deskutils/p5-Data-ICal
devel/p5-DateTime-Format-Natural
devel/p5-DateTime-Format-Strptime
devel/p5-DateTime-Set
security/p5-Digest-HMAC
mail/p5-Email-Sender
misc/p5-File-CounterFile
devel/p5-File-ShareDir
net/p5-Frontier-RPC
graphics/p5-GD-Graph
textproc/p5-HTML-Format
textproc/p5-HTML-RewriteAttributes
www/p5-HTML-Scrubber
www/p5-HTML-Widgets-SelectLayers
www/p5-HTTP-Server-Simple-Mason
devel/p5-Hash-AsObject
security/p5-IO-Socket-SSL
devel/p5-IPC-Run
devel/p5-IPC-Run-SafeHandles
converters/p5-JSON
textproc/p5-Lingua-EN-Inflect
textproc/p5-Lingua-EN-NameParse
misc/p5-Locale-Codes
devel/p5-Locale-Maketext-Fuzzy
devel/p5-Locale-Maketext-Lexicon
misc/p5-Locale-SubCountry
devel/p5-Log-Dispatch
mail/p5-MIME-Tools
mail/p5-MIME-Types
devel/p5-Module-Versions-Report
dns/p5-Net-Domain-TLD
net/p5-Net-Ping
net/p5-Net-Ping-External
mail/p5-Net-SMTP-SSL
net/p5-Net-SSH
net/p5-Net-Server
net/p5-Net-Whois-Raw
net-mgmt/p5-NetAddr-IP
textproc/p5-Number-Format
devel/p5-POE
textproc/p5-Regexp-Common
textproc/p5-Spreadsheet-WriteExcel
devel/p5-String-Approx
textproc/p5-String-ShellQuote
devel/p5-Term-ReadKey
devel/p5-Test-Deep
devel/p5-Test-Exception
devel/p5-Test-Inline
devel/p5-Test-LongString
devel/p5-Test-Manifest
devel/p5-Test-Script
devel/p5-Test-Warn
textproc/p5-Text-CSV_XS
textproc/p5-Text-Quoted
textproc/p5-Text-Template
textproc/p5-Text-WikiFormat
textproc/p5-Text-Wrapper
devel/p5-Tie-IxHash
devel/p5-Time-Duration
devel/p5-Time-modules
devel/p5-Tree-Simple
devel/p5-UNIVERSAL-require
textproc/p5-XML-RSS
databases/postgresql90-server

Portmaster will query you for all options for these ports at the beginning of the build process. I did not deviate from the defaults much, but for completeness, here's all the options files:

# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for apache-2.2.17_1
_OPTIONS_READ=apache-2.2.17_1
WITHOUT_THREADS=true
WITHOUT_MYSQL=true
WITHOUT_PGSQL=true
WITHOUT_SQLITE=true
WITHOUT_IPV6=true
WITHOUT_BDB=true
WITH_AUTH_BASIC=true
WITH_AUTH_DIGEST=true
WITH_AUTHN_FILE=true
WITHOUT_AUTHN_DBD=true
WITH_AUTHN_DBM=true
WITH_AUTHN_ANON=true
WITH_AUTHN_DEFAULT=true
WITH_AUTHN_ALIAS=true
WITH_AUTHZ_HOST=true
WITH_AUTHZ_GROUPFILE=true
WITH_AUTHZ_USER=true
WITH_AUTHZ_DBM=true
WITH_AUTHZ_OWNER=true
WITH_AUTHZ_DEFAULT=true
WITH_CACHE=true
WITH_DISK_CACHE=true
WITH_FILE_CACHE=true
WITHOUT_MEM_CACHE=true
WITH_DAV=true
WITH_DAV_FS=true
WITHOUT_BUCKETEER=true
WITHOUT_CASE_FILTER=true
WITHOUT_CASE_FILTER_IN=true
WITHOUT_EXT_FILTER=true
WITHOUT_LOG_FORENSIC=true
WITHOUT_OPTIONAL_HOOK_EXPORT=true
WITHOUT_OPTIONAL_HOOK_IMPORT=true
WITHOUT_OPTIONAL_FN_IMPORT=true
WITHOUT_OPTIONAL_FN_EXPORT=true
WITHOUT_LDAP=true
WITHOUT_AUTHNZ_LDAP=true
WITH_ACTIONS=true
WITH_ALIAS=true
WITH_ASIS=true
WITH_AUTOINDEX=true
WITH_CERN_META=true
WITH_CGI=true
WITH_CHARSET_LITE=true
WITHOUT_DBD=true
WITH_DEFLATE=true
WITH_DIR=true
WITH_DUMPIO=true
WITH_ENV=true
WITH_EXPIRES=true
WITH_HEADERS=true
WITH_IMAGEMAP=true
WITH_INCLUDE=true
WITH_INFO=true
WITH_LOG_CONFIG=true
WITH_LOGIO=true
WITH_MIME=true
WITH_MIME_MAGIC=true
WITH_NEGOTIATION=true
WITH_REWRITE=true
WITH_SETENVIF=true
WITH_SPELING=true
WITH_STATUS=true
WITH_UNIQUE_ID=true
WITH_USERDIR=true
WITH_USERTRACK=true
WITH_VHOST_ALIAS=true
WITH_FILTER=true
WITH_VERSION=true
WITHOUT_PROXY=true
WITHOUT_PROXY_CONNECT=true
WITH_PATCH_PROXY_CONNECT=true
WITHOUT_PROXY_FTP=true
WITHOUT_PROXY_HTTP=true
WITHOUT_PROXY_AJP=true
WITHOUT_PROXY_BALANCER=true
WITHOUT_PROXY_SCGI=true
WITH_SSL=true
WITHOUT_SUEXEC=true
WITHOUT_SUEXEC_RSRCLIMIT=true
WITH_REQTIMEOUT=true
WITHOUT_CGID=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for apr-ipv6-devrandom-gdbm-db42-1.4.2.1.3.10
_OPTIONS_READ=apr-ipv6-devrandom-gdbm-db42-1.4.2.1.3.10
WITH_THREADS=true
WITHOUT_IPV6=true
WITH_BDB=true
WITH_GDBM=true
WITHOUT_LDAP=true
WITHOUT_MYSQL=true
WITHOUT_NDBM=true
WITHOUT_PGSQL=true
WITHOUT_SQLITE=true
WITH_DEVRANDOM=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for gd-2.0.35_7,1
_OPTIONS_READ=gd-2.0.35_7,1
WITHOUT_X11=true
WITHOUT_XPM=true
WITHOUT_FONTCONFIG=true
WITHOUT_ICONV=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for m4-1.4.15,1
_OPTIONS_READ=m4-1.4.15,1
WITHOUT_LIBSIGSEGV=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for p5-Class-C3-0.23
_OPTIONS_READ=p5-Class-C3-0.23
WITHOUT_XS=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for p5-HTML-Mason-1.45
_OPTIONS_READ=p5-HTML-Mason-1.45
WITHOUT_MOD_PERL=true
WITHOUT_APACHE2=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for p5-IO-Socket-SSL-1.37
_OPTIONS_READ=p5-IO-Socket-SSL-1.37
WITHOUT_IDN=true
WITHOUT_IPV6=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for p5-Log-Dispatch-2.28
_OPTIONS_READ=p5-Log-Dispatch-2.28
WITHOUT_APACHELOG=true
WITHOUT_EMAIL_MIMELITE=true
WITHOUT_EMAIL_MAILSEND=true
WITH_EMAIL_MAILSENDMAIL=true
WITHOUT_MAIL_SENDER=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for p5-Test-NoWarnings-1.02
_OPTIONS_READ=p5-Test-NoWarnings-1.02
WITHOUT_DEVEL_STACKTRACE=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for p5-libwww-5.837
_OPTIONS_READ=p5-libwww-5.837
WITH_SSL=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for perl-5.10.1_3
_OPTIONS_READ=perl-5.10.1_3
WITHOUT_DEBUGGING=true
WITHOUT_GDBM=true
WITHOUT_PERL_MALLOC=true
WITH_PERL_64BITINT=true
WITHOUT_THREADS=true
WITHOUT_MULTIPLICITY=true
WITHOUT_SUIDPERL=true
WITHOUT_SITECUSTOMIZE=true
WITHOUT_USE_PERL=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for png-1.4.5
_OPTIONS_READ=png-1.4.5
WITHOUT_APNG=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for portmaster-3.6
_OPTIONS_READ=portmaster-3.6
WITH_BASH=true
WITHOUT_ZSH=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for postgresql-server-9.0.2
_OPTIONS_READ=postgresql-server-9.0.2
WITH_NLS=true
WITHOUT_DTRACE=true
WITHOUT_PAM=true
WITHOUT_LDAP=true
WITHOUT_MIT_KRB5=true
WITHOUT_HEIMDAL_KRB5=true
WITHOUT_OPTIMIZED_CFLAGS=true
WITH_XML=true
WITH_TZDATA=true
WITHOUT_DEBUG=true
WITHOUT_GSSAPI=true
WITHOUT_ICU=true
WITH_INTDATE=true
# This file is auto-generated by 'make config'.
# No user-servicable parts inside!
# Options for python26-2.6.6
_OPTIONS_READ=python26-2.6.6
WITH_THREADS=true
WITHOUT_HUGE_STACK_SIZE=true
WITHOUT_SEM=true
WITHOUT_PTH=true
WITH_UCS4=true
WITH_PYMALLOC=true
WITHOUT_IPV6=true
WITHOUT_FPECTL=true

2. Install perl modules outside of ports

I downloaded the following from the CPAN site:

Business-US-USPS-WebTools-1.11.tar.gz
Chart-2.4.2.tar.gz
Email-Sender-Transport-SMTP-TLS-0.09.tar.gz
HTML-Defang-1.04.tar.gz
Net-SMTP-TLS-ButMaintained-0.13.tar.gz

Unpack each, then cd to the directory and run "perl Makefile.pl". Look for any errors - if any dependancies are unsatisfied, that should be noted at the end of the output. Once all dependencies are satisfied, run "make" and "make install".