Freeside - User contributions [en]

Freeside:2.1:Documentation:Installation:Ubuntu

2011-01-12T01:58:24Z

NZFoxnet: /* 5. Prepare the system */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
- Cpan may complain about YAML you can optionally install this if you choose.
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang Net::SSH
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
chmod 777 -r /freesidesource
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<br>
'''''Note''' - If your freeside database user's password contains a $ symbol, it is currently not handled properly by the "make create-rt" step of the integrated RT ticketing system install''
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
/etc/init.d/postgresql-8.4 restart
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

EDIT - I have reports that the below still fails - just for now install the RT system to get everything going.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2011-01-12T01:58:04Z

NZFoxnet: /* 5. Prepare the system */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
- Cpan may complain about YAML you can optionally install this if you choose.
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang Net::SSH
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
chmod 777 -r /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<br>
'''''Note''' - If your freeside database user's password contains a $ symbol, it is currently not handled properly by the "make create-rt" step of the integrated RT ticketing system install''
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
/etc/init.d/postgresql-8.4 restart
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

EDIT - I have reports that the below still fails - just for now install the RT system to get everything going.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2011-01-12T01:10:08Z

NZFoxnet: /* 4. Install core packages */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
- Cpan may complain about YAML you can optionally install this if you choose.
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang Net::SSH
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<br>
'''''Note''' - If your freeside database user's password contains a $ symbol, it is currently not handled properly by the "make create-rt" step of the integrated RT ticketing system install''
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
/etc/init.d/postgresql-8.4 restart
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

EDIT - I have reports that the below still fails - just for now install the RT system to get everything going.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2011-01-05T01:51:04Z

NZFoxnet: /* RT */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang Net::SSH
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
/etc/init.d/postgresql-8.4 restart
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

EDIT - I have reports that the below still fails - just for now install the RT system to get everything going.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T23:42:46Z

NZFoxnet: /* 5. Prepare the system */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang Net::SSH
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
/etc/init.d/postgresql-8.4 restart
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T23:42:08Z

NZFoxnet: /* 5. Prepare the system */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang Net::SSH
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
/etc/init.d/postgresql restart
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T23:39:05Z

NZFoxnet: /* 4. Install core packages */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang Net::SSH
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T23:36:24Z

NZFoxnet: /* 4. Install core packages */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl liblocale-subcountry-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T23:24:03Z

NZFoxnet: /* 6. Install freeside */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freesidesource/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T23:22:52Z

NZFoxnet: /* 6. Install freeside */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
su freeside
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T23:16:01Z

NZFoxnet: /* 5. Prepare the system */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
exit
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T21:17:32Z

NZFoxnet: /* 2. Configure the network */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T21:16:54Z

NZFoxnet: /* 2. Configure the network */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

Restart networking
<pre>
/etc/init.d/networking restart
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation

2010-12-11T07:49:08Z

NZFoxnet: /* Backend Installation */

= Note =

Some documentation links point to the 1.9 documentation until things are fully moved over. The information should still be applicable.

= Installation and upgrades =

== Backend Installation ==

* [[Freeside:1.9:Documentation:Installation|New Installation]]
* [[Freeside:1.9:Documentation:RT Installation|Integrated RT Installation]]
* OS-specific installation guides (source)
** [[Freeside:1.9:Documentation:InstallingOnDebian5|Debian 5.0 "lenny"]]
** [[Freeside:2.1:Documentation:Installation:Ubuntu|Ubuntu 10.4 LTS]]
* OS-specific installation guides (packages)
** [[Freeside:1.9:Documentation:InstallingUsingAPT|Debian packages]]
** [[Freeside:1.9:Documentation:InstallingUsingRPM|CentOS/RHEL RPM packages]]

== Signup and Self-service installation ==

* [[Freeside:1.9:Documentation:Self-Service Installation|Signup/Self-service Installation]]

== Distributor guides ==

* [[Freeside:Documentation:CreatingRPMRepo|Creating your own repository with Freeside RPMs]]

* [[Freeside:Documentation:MirroringRPMRepo|Creating and using a mirror of the Freeside Internet Services RPM repositories]]

* [[Freeside:Documentation:RPMBuildSystem|Documentation on the RPM build system]]

== Upgrading ==

* [[Freeside:2.1:Documentation:Upgrading|Upgrading from 1.9.X to 2.1.x]]
* [[Freeside:2.1.1:Documentation:Upgrading|Upgrading from 2.1.0 to 2.1.1]]
* [[Freeside:2.1.2:Documentation:Upgrading|Upgrading from 2.1.1 to 2.1.2]]

= User's Guide =

* [[Freeside:2.1:Documentation:User|User's Guide]] (help wanted)
* [http://www.sisd.com/~ivan/freeside-slides Training presentation slides]

= Administrator's Guide =

* [[Freeside:1.9:Documentation:Administration|Administrator's Guide]]
* [[Freeside:Documentation:DisasterRecovery|Disaster Recovery]]
* [[:Category:Freeside:1.9:Documentation:Template|Templates]] used and their fill in variables.

= Developer's Guide =

* [[Freeside:1.9:Documentation:Developer|Developer's Guide]]

= Accounting Guide =

*[[Freeside:Documentation:Accounting|Accounting Guide]]

= Misc =

* [[Freeside:Documentation:FAQ|Frequently Asked Questions]]
* [[3rd_party_software|Third-party software]]
* [[Freeside:2.1:Documentation:Administration:VoIP:Timed_Rates|New feature: Timed Rates]]
* [[Freeside:2.1:Documentation:Administration:RT_Workflow|RT workflow features]]

* [[Freeside:1.9:Documentation|Version 1.9 documentation]]

= Changelog =

* [[Freeside:2.1:Changelog|2.1 Changelog]]
* [[Freeside:2.1.1:Changelog|2.1.1 Changelog]]
* [[Freeside:2.1.2:Changelog|2.1.2 Changelog]]

Freeside:2.1:Documentation:RT Installation:Ubuntu

2010-12-11T07:35:18Z

NZFoxnet: /* 1. Install Perl Modules */

==Introduction==

Install RT on Ubuntu / Debian system - Tested with Ubuntu 10.4 Lts

==1. Install Perl Modules==

<pre>
cpan Apache::Session HTML::TreeBuilder HTML::FormatText Test::Inline Class::ReturnValue DBIx::SearchBuilder Log::Dispatch Locale::Maketext::Lexicon
cpan Locale::Maketext::Fuzzy Text::Wrapper Time::ParseDate Term::ReadKey Text::Autoformat Text::Quoted Regexp::Common HTML::Scrubber Tree::Simple
cpan Crypt::SSLeay GD::Graph UNIVERSAL::require XML::RSS Calendar::Simple GD::Graph GD::Text CSS::Squish
cpan File::ShareDir HTML::RewriteAttributes MIME::Types PerlIO::eol GnuPG::Interface Data::ICal Text::WikiFormat Net::Server
cpan HTTP::Server::Simple HTTP::Server::Simple::Mason Module::Versions::Report DateTime::Set IPC::Run::SafeHandles
</pre>

== Installation ==

* Create a new Unix group called 'rt'
<pre>
addgroup rt
</pre>
* Edit the top-level Makefile (within the freeside source directory - NOT rt directory), set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
<pre>
cd /freesidesource/freeside-X.X/
nano Makefile
</pre>

* <pre><nowiki>$ make configure-rt</nowiki></pre>
* If your database is not on the local machine you will need to edit /opt/rt3/etc/RT_SiteConfig.pm and set the DatabaseHost value
* <pre><nowiki># make create-rt</nowiki></pre>
** ''Authentication errors?''
*** ''Edit <code>pg_hba.conf</code>, change "<code>ident sameuser</code>" auth to "<code>trust</code>" for the line starting with "<code>local all all</code>"''
*** ''Restart Pg''
*** ''Revert the change back and restart Pg after this installation step''
* <pre><nowiki>make install-rt</nowiki></pre>
* Add the following to your httpd.conf:
<pre>
#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/NoAuth>
<Limit GET POST>
allow from all
Satisfy any
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/REST/1.0/NoAuth>
<Limit GET POST>
allow from all
Satisfy any
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<DirectoryMatch "^%/var/www/freeside/rt/.*NoAuth/images">
SetHandler None
</DirectoryMatch>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Ticket/Attachment>
SetHandler perl-script
PerlHandler HTML::Mason
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Search>
SetHandler perl-script
PerlHandler HTML::Mason
</Directory>
</pre>

* Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.

* Set the '''ticket_system''' configuration value to <code>RT_Internal</code>. (You may also wish to set '''ticket_system-default_queueid''' once you have RT configured.)

=== Bootstrap RT's permissions ===
*Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
*From "Billing Main", go to Configuration > Employees > View/Edit employees and add a temporary "root" user. Note: the user name must be "root" (without the quotes).
* Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, or by using <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> syntax if your browser supports it.
* Click on "Ticketing Main" on the Freeside main menu. Go to Configuration > Ticketing > Ticketing Global, and then "User Rights". Grant the "SuperUser" right to your normal RT/Freeside login.
* Go back to the freeside employee list and disable the temporary "root" user.

== Futher Reading ==
* Follow the [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T07:26:37Z

NZFoxnet: /* 5. Prepare the system */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T07:22:45Z

NZFoxnet:

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:2.1:Documentation:RT_Installation:Ubuntu|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:RT Installation:Ubuntu

2010-12-11T07:22:08Z

NZFoxnet: /* 1. Install Perl Modules */

==Introduction==

Install RT on Ubuntu / Debian system - Tested with Ubuntu 10.4 Lts

==1. Install Perl Modules==

<pre>
cpan Apache::Session HTML::TreeBuilder HTML::FormatText Test::Inline Class::ReturnValue DBIx::SearchBuilder Log::Dispatch Locale::Maketext::Lexicon
cpan Locale::Maketext::Fuzzy Text::Wrapper Time::ParseDate Term::ReadKey Text::Autoformat Text::Quoted Regexp::Common HTML::Scrubber Tree::Simple
cpan Crypt::SSLeay GD::Graph UNIVERSAL::require XML::RSS Calendar::Simple GD::Graph GD::Text CSS::Squish
cpan File::ShareDir HTML::RewriteAttributes MIME::Types PerlIO::eol GnuPG::Interface Data::ICal Text::WikiFormat Net::Server
cpan HTTP::Server::Simple HTTP::Server::Simple::Mason Module::Versions::Report DateTime::Set
</pre>

== Installation ==

* Create a new Unix group called 'rt'
<pre>
addgroup rt
</pre>
* Edit the top-level Makefile (within the freeside source directory - NOT rt directory), set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
<pre>
cd /freesidesource/freeside-X.X/
nano Makefile
</pre>

* <pre><nowiki>$ make configure-rt</nowiki></pre>
* If your database is not on the local machine you will need to edit /opt/rt3/etc/RT_SiteConfig.pm and set the DatabaseHost value
* <pre><nowiki># make create-rt</nowiki></pre>
** ''Authentication errors?''
*** ''Edit <code>pg_hba.conf</code>, change "<code>ident sameuser</code>" auth to "<code>trust</code>" for the line starting with "<code>local all all</code>"''
*** ''Restart Pg''
*** ''Revert the change back and restart Pg after this installation step''
* <pre><nowiki>make install-rt</nowiki></pre>
* Add the following to your httpd.conf:
<pre>
#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/NoAuth>
<Limit GET POST>
allow from all
Satisfy any
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/REST/1.0/NoAuth>
<Limit GET POST>
allow from all
Satisfy any
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<DirectoryMatch "^%/var/www/freeside/rt/.*NoAuth/images">
SetHandler None
</DirectoryMatch>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Ticket/Attachment>
SetHandler perl-script
PerlHandler HTML::Mason
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Search>
SetHandler perl-script
PerlHandler HTML::Mason
</Directory>
</pre>

* Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.

* Set the '''ticket_system''' configuration value to <code>RT_Internal</code>. (You may also wish to set '''ticket_system-default_queueid''' once you have RT configured.)

=== Bootstrap RT's permissions ===
*Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
*From "Billing Main", go to Configuration > Employees > View/Edit employees and add a temporary "root" user. Note: the user name must be "root" (without the quotes).
* Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, or by using <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> syntax if your browser supports it.
* Click on "Ticketing Main" on the Freeside main menu. Go to Configuration > Ticketing > Ticketing Global, and then "User Rights". Grant the "SuperUser" right to your normal RT/Freeside login.
* Go back to the freeside employee list and disable the temporary "root" user.

== Futher Reading ==
* Follow the [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.

Freeside:2.1:Documentation:RT Installation:Ubuntu

2010-12-11T07:17:50Z

NZFoxnet:

==Introduction==

Install RT on Ubuntu / Debian system - Tested with Ubuntu 10.4 Lts

==1. Install Perl Modules==

<pre>
cpan Apache::Session HTML::TreeBuilder HTML::FormatText Test::Inline Class::ReturnValue DBIx::SearchBuilder Log::Dispatch Locale::Maketext::Lexicon
cpan Locale::Maketext::Fuzzy Text::Wrapper Time::ParseDate Term::ReadKey Text::Autoformat Text::Quoted Regexp::Common HTML::Scrubber Tree::Simple
cpan Crypt::SSLeay GD::Graph UNIVERSAL::require XML::RSS Calendar::Simple GD::Graph GD::Text CSS::Squish
cpan File::ShareDir HTML::RewriteAttributes MIME::Types PerlIO::eol GnuPG::Interface Data::ICal Text::WikiFormat Net::Server
cpan HTTP::Server::Simple HTTP::Server::Simple::Mason Module::Versions::Report
</pre>

== Installation ==

* Create a new Unix group called 'rt'
<pre>
addgroup rt
</pre>
* Edit the top-level Makefile (within the freeside source directory - NOT rt directory), set RT_ENABLED to 1 and set the RT_DOMAIN, RT_TIMEZONE, and FREESIDE_URL variables.
<pre>
cd /freesidesource/freeside-X.X/
nano Makefile
</pre>

* <pre><nowiki>$ make configure-rt</nowiki></pre>
* If your database is not on the local machine you will need to edit /opt/rt3/etc/RT_SiteConfig.pm and set the DatabaseHost value
* <pre><nowiki># make create-rt</nowiki></pre>
** ''Authentication errors?''
*** ''Edit <code>pg_hba.conf</code>, change "<code>ident sameuser</code>" auth to "<code>trust</code>" for the line starting with "<code>local all all</code>"''
*** ''Restart Pg''
*** ''Revert the change back and restart Pg after this installation step''
* <pre><nowiki>make install-rt</nowiki></pre>
* Add the following to your httpd.conf:
<pre>
#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/NoAuth>
<Limit GET POST>
allow from all
Satisfy any
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/REST/1.0/NoAuth>
<Limit GET POST>
allow from all
Satisfy any
SetHandler perl-script
PerlHandler HTML::Mason
</Limit>
</Directory>

#replace /var/www/freeside with your freeside document root
<DirectoryMatch "^%/var/www/freeside/rt/.*NoAuth/images">
SetHandler None
</DirectoryMatch>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Ticket/Attachment>
SetHandler perl-script
PerlHandler HTML::Mason
</Directory>

#replace /var/www/freeside with your freeside document root
<Directory /var/www/freeside/rt/Search>
SetHandler perl-script
PerlHandler HTML::Mason
</Directory>
</pre>

* Restart Apache (httpd) and log into the Freeside web interface using the username and password you created during the first part of the installation.

* Set the '''ticket_system''' configuration value to <code>RT_Internal</code>. (You may also wish to set '''ticket_system-default_queueid''' once you have RT configured.)

=== Bootstrap RT's permissions ===
*Click on "Ticketing Main" on the Freeside main menu to auto-create an RT login for your username
*From "Billing Main", go to Configuration > Employees > View/Edit employees and add a temporary "root" user. Note: the user name must be "root" (without the quotes).
* Log into your Freeside installation as the "root" user you just created, by closing all of your browser windows, or by using <code><nowiki>https://root@yourmachone/freeside/</nowiki></code> syntax if your browser supports it.
* Click on "Ticketing Main" on the Freeside main menu. Go to Configuration > Ticketing > Ticketing Global, and then "User Rights". Grant the "SuperUser" right to your normal RT/Freeside login.
* Go back to the freeside employee list and disable the temporary "root" user.

== Futher Reading ==
* Follow the [http://wiki.bestpractical.com/ regular RT documentation] to configure RT, setup the mailgate, etc.

Freeside:2.1:Documentation:RT Installation:Ubuntu

2010-12-11T07:10:50Z

NZFoxnet: New page: ==Introduction== Install RT on Ubuntu / Debian system - Tested with Ubuntu 10.4 Lts ==1. Install Perl Modules== <pre> cpan Apache::Session HTML::TreeBuilder HTML::FormatText Test::Inlin...

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T06:37:20Z

NZFoxnet: /* 6. Install freeside */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

=== RT ===
* Either [[Freeside:1.9:Documentation:RT_Installation|install the integrated RT ticketing system]], or delete the <code>ticket_system</code> entry from your conf table.

<pre>
su freeside
psql freeside
delete from conf where name = 'ticket_system';
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T06:35:48Z

NZFoxnet: /* 4. Install core packages */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema HTML::ElementTable
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T06:31:35Z

NZFoxnet: /* 4. Install core packages */

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl libhtml-tableextract-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T06:13:40Z

NZFoxnet:

== Summary ==
Tested with Ubuntu 10.4 LTS
Step by step instructions

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T06:09:48Z

NZFoxnet:

== Summary ==
Tested with Ubuntu 10.4 LTS

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation:Ubuntu

2010-12-11T06:08:31Z

NZFoxnet: New page: == 1. Install the base system == - Only select the OpenSSH Package == 2. Configure the network == Change the server to static IP <pre> nano /etc/network/interfaces </pre> Replace the be...

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Add first freeside user / administrator
<pre>
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password:
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation

2010-12-11T06:07:21Z

NZFoxnet: Moved

Placeholder

Freeside:2.1:Documentation:Installation

2010-12-11T06:01:31Z

NZFoxnet:

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E Unicode freeside
</pre>

Set the encoding
*Uncomment client_encoding and set it to Latin1
<pre>
nano /etc/postgresql/8.4/main/postgresql.conf
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

Reboot

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module

Freeside:2.1:Documentation:Installation

2010-12-11T05:45:48Z

NZFoxnet: /* 5. Prepare the system */

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su postgres
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E LATIN1 freeside
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module
* If you are non us the database encoding might not be compatible - set the client encoding to LATIN1 and create the Database as Unicode

Freeside:2.1:Documentation:Installation

2010-12-11T03:48:20Z

NZFoxnet:

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential texlive-base
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl libnet-ssleay-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI Email::Sender::Transport::SMTP::TLS DBIx::DBSchema
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su freeside
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E LATIN1 freeside
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
*Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Install the Web Interface
<pre>
make install-docs
</pre>

Install Apache Config
<pre>
make install-apache
</pre>

Drop back to freeside permissions
<pre>
su freeside
</pre>

Initialize Data
<pre>
freeside-setup -d example.com
</pre>

Stay as freeside user and add additional users
<pre>
freeside-adduser -g 1 fs_queue
freeside-adduser -g 1 fs_daily
freeside-adduser -g 1 fs_selfservice
</pre>

== Trouble Shooting ==
* If freeside-setup fails its often due to a missing perl module - google the .pm filename and find and install the module
* If you are non us the database encoding might not be compatible - set the client encoding to LATIN1 and create the Database as Unicode

Freeside:2.1:Documentation:Installation

2010-12-11T02:21:36Z

NZFoxnet:

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libdbix-dbschema-perl libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su freeside
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E LATIN1 freeside
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/httpd.conf
</pre>
Add
<pre>
User freeside
Group Freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Freeside:2.1:Documentation:Installation

2010-12-11T02:16:04Z

NZFoxnet:

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Apache2 etc
<pre>
apt-get install apache2 libapache2-mod-perl2 postgresql-8.4 build-essential
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libdbix-dbschema-perl libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su freeside
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E LATIN1 freeside
</pre>

Configure Apache
*Set user to freeside
<pre>
nano /etc/apache2/apache2.conf
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
cd /freeside/freeside-2.1.1
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Freeside:2.1:Documentation:Installation

2010-12-11T01:03:23Z

NZFoxnet:

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libdbix-dbschema-perl libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su freeside
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E LATIN1 freeside
</pre>

==6. Install freeside==

Build and Install the Perl modules - stay as freeside user
<pre>
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Freeside:2.1:Documentation:Installation

2010-12-11T01:02:16Z

NZFoxnet:

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libdbix-dbschema-perl libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissions to freeside in postgresql
<pre>
#su freeside
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Add the database
<pre>
#su freeside
$createdb -E LATIN1 freeside
</pre>

Build and Install the Perl modules - stay as freeside user
<pre>

==6. Install freeside==
Make perl files

<pre>
make perl-modules
su
make install-perl-modules
</pre>

Create config files
<pre>
make create-config
</pre>

Invoice Typesetting
<pre>
make install-texmf
</pre>

Freeside:2.1:Documentation:Installation

2010-12-11T00:50:38Z

NZFoxnet:

Freeside:2.1:Documentation:Installation

2010-12-11T00:46:39Z

NZFoxnet:

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==

Change the server to static IP
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

Set the hostname correctly
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Common Perl Packages - Packages are much faster to install
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
apt-get install libcache-cache-perl libdatetime-perl libdatetime-format-strptime-perl libdatetime-format-natural-perl libemail-sender-perl
apt-get install libhtml-mason-perl libmailtools-perl libmail-mboxparser-perl libnetaddr-ip-perl libnet-ping-external-perl
apt-get install libnumber-format-perl libnumber-format-perl libspreadsheet-writeexcel-perl libstring-approx-perl libtext-csv-xs-perl
apt-get install libtext-template-perl libnet-ping-external-perl libterm-readkey-perl
</pre>
Additional Perl Packages
<pre>
apt-get install libdbix-dbschema-perl libfile-counterfile-perl libfile-policy-perl libipc-run-perl libipc-run3-perl libjson-perl
apt-get install liblingua-en-nameparse-perl liblingua-en-inflect-perl libnet-domain-tld-perl libnet-ssh2-perl
apt-get install libnet-whois-raw-perl libtime-duration-perl
</pre>
Modules not available as packages - Allow cpan to prepend any dependencies
<pre>
cpan Authen::Passphrase Business::CreditCard Business::US::USPS::WebTools Color::Scheme Crypt::PasswdMD5 Frontier::RPC2 HTML::Defang
cpan HTML::Widgets::SelectLayers String::ShellQuote Tie::IxHash Apache::DBI
</pre>

==5. Prepare the system==

Download latest freeside tar and extract
<pre>
mkdir /freesidesource
cd /freesidesource
wget http://www.freeside.biz/freeside/freeside-2.1.1.tar.gz
tar -zxvf freeside-2.1.1.tar.gz
</pre>

Add the freeside user
<pre>
adduser freeside
</pre>

Grant permissionsto postgresql
<pre>
#su freeside
$createuser -P freeside
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
$exit
</pre>

Edit the Makefile
- Configure the DATASOURCE to your DBI data source
-Set the DB_TYPE (Pg or mysql)
-See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source.
-Set DB_PASSWORD to the freeside database user's password.
<pre>
cd /freesidesource/freeside-2.1.1
nano Makefile
</pre>

Freeside:2.1:Documentation:Installation

2010-12-11T00:26:16Z

NZFoxnet:

Freeside:2.1:Documentation:Installation

2010-12-11T00:17:25Z

NZFoxnet: /* 4. Install core packages */

Freeside:2.1:Documentation:Installation

2010-12-11T00:13:53Z

NZFoxnet:

Freeside:2.1:Documentation:Installation

2010-12-11T00:11:03Z

NZFoxnet:

Freeside:2.1:Documentation:Installation

2010-12-10T23:37:21Z

NZFoxnet: Step by step install on Ubuntu 10.04 based linux distro with Postgresql

== 1. Install the base system ==
- Only select the OpenSSH Package

== 2. Configure the network ==
===Change the server to static IP===
<pre>
nano /etc/network/interfaces
</pre>
Replace the below settings with you own ip addresses etc
<pre>
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
network 192.168.0.0
broadcast 192.168.0.255
gateway 192.168.0.1
</pre>

===Set the hostname correctly===
<pre>
nano /etc/hosts
</pre>

<pre>
127.0.0.1 localhost.localdomain localhost
192.168.0.100 server1.example.com server1

# The following lines are desirable for IPv6 capable hosts
::1 localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
</pre>

<pre>
echo server1.example.com > /etc/hostname
/etc/init.d/hostname restart
</pre>

==3. Update the system==

<pre>
apt-get update
apt-get upgrade
</pre>

==4. Install core packages==
Keep the system time correct
<pre>
apt-get install ntp ntpdate
</pre>

Main Packages
<pre>
apt-get install libapache2-mod-perl2 Apache2 postgresql-8.4
</pre>

Perl Packages
<pre>
apt-get install libwww-perl liburi-perl libhtml-tagset-perl libhtml-parser-perl libdbd-pg-perl libtimedate-perl libdate-manip-perl libchart-perl
</pre>