Difference between revisions of "Freeside:1.9:Documentation:InstallingOnDebian5"

From Freeside
Jump to: navigation, search
(Database Locale)
(Verify the correct locale is set: Oops)
 
(29 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Prerequisites ==
+
= Notes =
=== Operating System ===
+
 
 +
Note: All of the commands on this page must be run as root.
 +
 
 +
== Operating System ==
 
* Basic Debian 5.0 "lenny" install - You will not need the desktop applications group.
 
* Basic Debian 5.0 "lenny" install - You will not need the desktop applications group.
  
 +
== Set the System Locale ==
 +
The locale needs to be set correctly for the database.  It is easiest to set it at the beginning of the installation.
 +
 +
*  Set the locale correctly -
 +
** For the US, generate both en_US and en_US.UTF-8, but (IMPORTANT) pick en_US as the default...
 +
  dpkg-reconfigure locales
 +
 +
= Prerequisites =
  
=== Aptitude & Required Libraries ===
+
== Aptitude & Required Libraries ==
 +
=== Add the freeside repository ===
 
* Add the following apt source to <code>/etc/apt/sources.list</code> (for Debian 5.0 "lenny"):
 
* Add the following apt source to <code>/etc/apt/sources.list</code> (for Debian 5.0 "lenny"):
  
Line 11: Line 23:
 
</pre>
 
</pre>
  
* Run <code>aptitude update</code>. If it errors out complaining about missing files, run it a second time, it will complete normally.
+
* Run <code>aptitude update</code>.
 +
 
 +
=== Install the Appropriate Packages ===
  
 
* Run this command to install all prerequisites:
 
* Run this command to install all prerequisites:
Line 29: Line 43:
 
  libconvert-binhex-perl \
 
  libconvert-binhex-perl \
 
  libcrypt-openssl-rsa-perl libcrypt-passwdmd5-perl libcss-squish-perl \
 
  libcrypt-openssl-rsa-perl libcrypt-passwdmd5-perl libcss-squish-perl \
  libdatetime-perl libdatetime-format-strptime-perl \
+
  libdatetime-perl libdatetime-format-natural-perl \
  libdate-manip-perl libdbd-mysql-perl libdbd-pg-perl \
+
  libdatetime-format-strptime-perl libdate-manip-perl libdbd-mysql-perl \
libdbi-perl libdbix-dbschema-perl libdbix-searchbuilder-perl \
+
libdbd-pg-perl libdbi-perl libdbix-dbschema-perl libdbix-searchbuilder-perl \
 
  libdevel-stacktrace-perl libdevel-symdump-perl \
 
  libdevel-stacktrace-perl libdevel-symdump-perl \
  libdigest-sha1-perl libmail-sender-perl \
+
  libdigest-sha1-perl libemail-sender-perl \
 
  libemail-sender-transport-smtp-tls-perl liberror-perl \
 
  libemail-sender-transport-smtp-tls-perl liberror-perl \
 
  libexception-class-perl \
 
  libexception-class-perl \
Line 40: Line 54:
 
  libfrontier-rpc-perl libgd-gd2-noxpm-perl libgd2-noxpm \
 
  libfrontier-rpc-perl libgd-gd2-noxpm-perl libgd2-noxpm \
 
  libgd-graph-perl libgd-text-perl libhtml-format-perl libhtml-mason-perl \
 
  libgd-graph-perl libgd-text-perl libhtml-format-perl libhtml-mason-perl \
  libhtml-parser-perl \
+
  libhtml-parser-perl libhtml-defang-perl \
 
  libhtml-scrubber-perl libhtml-tagset-perl libhtml-tree-perl \
 
  libhtml-scrubber-perl libhtml-tagset-perl libhtml-tree-perl \
 
  libhtml-widgets-selectlayers-perl libio-stringy-perl \
 
  libhtml-widgets-selectlayers-perl libio-stringy-perl \
Line 49: Line 63:
 
  liblocale-maketext-lexicon-perl liblocale-subcountry-perl \
 
  liblocale-maketext-lexicon-perl liblocale-subcountry-perl \
 
  liblog-dispatch-perl libmailtools-perl libmime-perl \
 
  liblog-dispatch-perl libmailtools-perl libmime-perl \
  libnet-daemon-perl libnet-domain-tld-perl libnet-perl libnet-scp-perl \
+
  libnet-daemon-perl libnet-domain-tld-perl libnet-scp-perl \
 
  libnet-ssh-perl libnet-whois-raw-perl libnetaddr-ip-perl \
 
  libnet-ssh-perl libnet-whois-raw-perl libnetaddr-ip-perl \
  libnumber-format-perl \
+
  libnumber-format-perl libnet-ping-external-perl\
 
  libparams-validate-perl libparse-recdescent-perl \
 
  libparams-validate-perl libparse-recdescent-perl \
 
  libplrpc-perl libregexp-common-perl \
 
  libplrpc-perl libregexp-common-perl \
Line 71: Line 85:
 
</pre>
 
</pre>
  
=== Database Locale ===
+
= Verify the correct locale is set =
*  dpkg-reconfigure locales, generate both en_US and en_US.UTF-8, but (IMPORTANT) pick en_US as the default
+
 
* if /etc/postgresql/8.3/main/postgresql.conf is already installed and has has lc_* = 'en_US.UTF-8', cluster will need to be dropped and re-initialized
+
* Check your /etc/postgresql/8.3/main/postgresql.conf for the lc_ lines.  If they are set to "= 'en_US.UTF-8'"...
 +
* The postgresql cluster will need to be dropped and re-initialized
 
  pg_dropcluster 8.3 main --stop
 
  pg_dropcluster 8.3 main --stop
 
  pg_createcluster --locale en_US 8.3 main
 
  pg_createcluster --locale en_US 8.3 main
 +
* Don't forget to restart postgresql
 +
/etc/init.d/postgresql-8.3 start
  
== Installation ==
+
= Installation =
  
 
Follow the [[Freeside:1.9:Documentation:Installation#Installation|regular installation instructions]].
 
Follow the [[Freeside:1.9:Documentation:Installation#Installation|regular installation instructions]].

Latest revision as of 10:32, 11 August 2010

Notes

Note: All of the commands on this page must be run as root.

Operating System

  • Basic Debian 5.0 "lenny" install - You will not need the desktop applications group.

Set the System Locale

The locale needs to be set correctly for the database. It is easiest to set it at the beginning of the installation.

  • Set the locale correctly -
    • For the US, generate both en_US and en_US.UTF-8, but (IMPORTANT) pick en_US as the default...
  dpkg-reconfigure locales

Prerequisites

Aptitude & Required Libraries

Add the freeside repository

  • Add the following apt source to /etc/apt/sources.list (for Debian 5.0 "lenny"):
deb http://freeside.biz/~ivan/freeside-lenny/ ./
  • Run aptitude update.

Install the Appropriate Packages

  • Run this command to install all prerequisites:
aptitude install \
 apache2 apache2-mpm-prefork apache2-utils cron \
 ghostscript gsfonts \
 libapache-dbi-perl libapache2-mod-perl2 \
 libapache2-request-perl \
 libapache-session-perl libauthen-passphrase-perl \
 libbusiness-creditcard-perl libbusiness-us-usps-webtools-perl \
 libcache-cache-perl libcache-simple-timedexpiry-perl libcalendar-simple-perl \
 libchart-perl libclass-container-perl \
 libclass-data-inheritable-perl libclass-returnvalue-perl \
 libcolor-scheme-perl libcompress-zlib-perl \
 libconvert-binhex-perl \
 libcrypt-openssl-rsa-perl libcrypt-passwdmd5-perl libcss-squish-perl \
 libdatetime-perl libdatetime-format-natural-perl \
 libdatetime-format-strptime-perl libdate-manip-perl libdbd-mysql-perl \
 libdbd-pg-perl libdbi-perl libdbix-dbschema-perl libdbix-searchbuilder-perl \
 libdevel-stacktrace-perl libdevel-symdump-perl \
 libdigest-sha1-perl libemail-sender-perl \
 libemail-sender-transport-smtp-tls-perl liberror-perl \
 libexception-class-perl \
 libfile-counterfile-perl libfile-rsync-perl \
 libfont-afm-perl libfreezethaw-perl \
 libfrontier-rpc-perl libgd-gd2-noxpm-perl libgd2-noxpm \
 libgd-graph-perl libgd-text-perl libhtml-format-perl libhtml-mason-perl \
 libhtml-parser-perl libhtml-defang-perl \
 libhtml-scrubber-perl libhtml-tagset-perl libhtml-tree-perl \
 libhtml-widgets-selectlayers-perl libio-stringy-perl \
 libipc-run-perl libipc-run3-perl libipc-sharelite-perl \
 libjson-perl \
 liblingua-en-inflect-perl liblingua-en-nameparse-perl \
 liblocale-gettext-perl liblocale-maketext-fuzzy-perl \
 liblocale-maketext-lexicon-perl liblocale-subcountry-perl \
 liblog-dispatch-perl libmailtools-perl libmime-perl \
 libnet-daemon-perl libnet-domain-tld-perl libnet-scp-perl \
 libnet-ssh-perl libnet-whois-raw-perl libnetaddr-ip-perl \
 libnumber-format-perl libnet-ping-external-perl\
 libparams-validate-perl libparse-recdescent-perl \
 libplrpc-perl libregexp-common-perl \
 libspreadsheet-writeexcel-perl libstring-approx-perl \
 libstring-shellquote-perl libterm-readkey-perl \
 libtest-inline-perl libtext-autoformat-perl \
 libtext-charwidth-perl libtext-csv-perl libtext-iconv-perl \
 libtext-quoted-perl libtext-reform-perl \
 libtext-template-perl libtext-wrapi18n-perl \
 libtext-wrapper-perl libtie-ixhash-perl \
 libtime-duration-perl libtime-modules-perl libtimedate-perl \
 libtree-simple-perl libuniversal-require-perl liburi-perl \
 libwant-perl libwww-perl libxml-parser-perl libxml-rss-perl \
 lmodern make perl perl-modules \
 postgresql postgresql-client \
 psfontmgr \
 rsync openssh-client \
 texlive texlive-latex-extra whois

Verify the correct locale is set

  • Check your /etc/postgresql/8.3/main/postgresql.conf for the lc_ lines. If they are set to "= 'en_US.UTF-8'"...
  • The postgresql cluster will need to be dropped and re-initialized
pg_dropcluster 8.3 main --stop
pg_createcluster --locale en_US 8.3 main
  • Don't forget to restart postgresql
/etc/init.d/postgresql-8.3 start

Installation

Follow the regular installation instructions.