Difference between revisions of "Freeside:1.7:Documentation:Installation"

From Freeside
Jump to: navigation, search
(all spammers must die)
 
Line 1: Line 1:
[http://vfcpug.org/meta/quad/images/text-265.htm porm] [http://rvpark4u.com/weblog/skins/rsd/files/page188.html wholesale cheap electronics] [http://caypkiwanis.org/main/wp-content/uploads/2007/09/article-818.htm paris hilton and nick carter sex tape video] [http://thewholesaler.co.uk/newsletter/data/images/article1695.html lindsay lohan hot video] [http://tatlin.com/gallery/wp-content/uploads/2008/index.htm http] [http://casv.ca/secondary/class/install/2519.html mac vcd x serial] [http://arccc-cccaa.org/images/thumbs/topic-1633.htm part time job london uk] [http://appleturnover.tv/about/images/news-148-20090626.html movie school summer] [http://caypkiwanis.org/main/wp-content/uploads/2007/09/sitemap.htm site] [http://ackcsc.org/club.bak/media/flash/dewolos.htm email campaign] [http://appleturnover.tv/about/images/news-203-20090704.html tel drug of pennsylvania] [http://tatlin.com/gallery/wp-content/uploads/2008/topic-2614.htm axle bolts] [http://mdabc.net/test/files/index.htm link] [http://cavalierpedigrees.com/XOOPS/images/text399.htm movie character personality test] [http://kazak.ca/buzz/data/media/eldeldeda1722.htm control system analysis] [http://marja-leena-rathje.info/ssp_director/config/conf/article403.html movie scripts sling blade] [http://aquisechatea.com/galeria/albums/userpics/10002/page1751.html nissan frontier 2000 gas mileage] [http://woningpagina.com/pics/flash/comment-909.html s video wireless sender] [http://arccc-cccaa.org/images/thumbs/topic-1723.htm pires penalty kick video] [http://paarc.ca/images/thumbs/article2364.html lori heuring] [http://thewholesaler.co.uk/newsletter/data/images/article1634.html movie trailer voice guy] [http://brixhost.net/my/attachments/media/news-329-2009-06-30.html pharynx] [http://casv.ca/secondary/class/install/1411.html titanium diaphragm] [http://marja-leena-rathje.info/ssp_director/config/conf/article522.html mudvayne l.d 50] [http://appleturnover.tv/about/images/news-2506-20090627.html ati radeon x300 video card] [http://capstonerealty.ph/gallery/Farm_Lots/mini/resource-323.html porcine respiratory and reproductive syndrome] [http://tatlin.com/gallery/wp-content/uploads/2008/topic-2428.htm xerocomus badius] [http://marja-leena-rathje.info/ssp_director/config/conf/article1348.html anderson lee pamela pic tommy video] [http://beachcki.org/officers/wpThumbnails/pics/topic38.htm india mobile ringtone] [http://ackcsc.org/club.bak/media/flash/acrobugb.htm scottsdale real estate site] [http://kazak.ca/buzz/data/media/c4tacelh746.htm actonel assistance programs] [http://rvpark4u.com/weblog/skins/rsd/files/page1468.html network digital video recorders] [http://sahardesign.com/files/styles/article575.html melissa etheridge videos] [http://rvpark4u.com/weblog/skins/rsd/files/page1106.html prelude eliot] [http://rvpark4u.com/weblog/skins/rsd/files/page2342.html bin laden games] [http://atomized.ca/2006/12/news-544-20090630.html lafffy taffy video] [http://tatlin.com/gallery/wp-content/uploads/2008/topic-128.htm american jobs in england] [http://aarh.net/generator/assets/gallery3/topic-1731.html roosevelt field theatre] [http://brixhost.net/my/attachments/media/news-1913-2009-07-06.html job match testing] [http://cavaliersonline.com/photos/icons/text280.htm legend music riding video] [http://rubyarts.org/images/icons/news-1704.html james brown celebrity hot tub] [http://tatlin.com/gallery/wp-content/uploads/2008/topic-72.htm adderall 3steps] [http://rubyarts.org/images/icons/news-861.html jfk the movie] [http://aquisechatea.com/galeria/albums/userpics/10002/page1353.html ice age movie merchandise] [http://rubyarts.org/images/icons/news-1744.html 1001 jokes.com] [http://mdabc.net/test/files/new617.htm speed razor crack] [http://castlekeepcavaliers.com/generator/assets/files/page487.html consumer reports magazine] [http://brixhost.net/my/attachments/media/index.html map] [http://casv.ca/secondary/class/install/937.html hallie berry nude] [http://cavalierpedigrees.com/XOOPS/images/text103.htm knighthood] 
 
 
== Introduction ==
 
== Introduction ==
  

Latest revision as of 13:52, 20 July 2009

Introduction

Install Freeside on a firewalled, private server, not a public (web, RADIUS, etc.) server.

Please note that these are the 1.7 installation instructions. Do not attempt to use them to install 1.5/1.6, or edit them to correct differences with those releases.

Prerequisites

Packages

  • Perl, minimum version 5.8.4
  • Apache, SSL highly recommended)
  • mod_perl
    • mod_perl v2 is now supported.
    • If compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option
  • A transactional database engine supported by Perl's DBI.
    • PostgreSQL is recommended (v7.2 or later, v7.4 or later recommended).
    • MySQL (v4.1 or later, v5 recommended) is supported starting with Freeside 1.7.3. DBIx::DBSchema 0.35 or later is required.

Note: the above only applies to the database used by the Freeside software itself. Freeside can integrate with RADIUS and other servers running a different database than the backend.

  • teTeX and Ghostscript (included with most distributions) (Optional, enables typeset invoices)

Perl modules

Popular modules you might want to check your distribution for

Modules of Indeterminate Popularity

Less common modules

Optional modules

Installation

  • Add the user and group `freeside' to your system.
  • Allow the freeside user full access to the freeside database.

with PostgreSQL

$ su postgres (pgsql on some distributions)
$ createuser -P freeside
Enter password for user "freeside": 
Enter it again: 
Shall the new user be allowed to create databases? (y/n) y
Shall the new user be allowed to create more new users? (y/n) n
CREATE USER

or with Postgresql 8.3

[ as postgres/pgsql user ]
$ 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

or with MySQL:

$ mysqladmin -u root password 'set_a_root_database_password'
$ mysql -u root -p
mysql> GRANT SELECT,INSERT,UPDATE,DELETE,INDEX,ALTER,CREATE,DROP on freeside.* TO freeside@localhost IDENTIFIED BY 'set_a_freeside_database_password';
  • Edit the top-level Makefile:
    • Set DATASOURCE to your DBI data source, for example, DBI:Pg:dbname=freeside for PostgresSQL or DBI:mysql:freeside for 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.
  • Add the freeside database to your database engine:

with Postgres:

$ su freeside
$ createdb -E sql_ascii freeside

or with Postgres 8.3:

$ su freeside
$ createdb -E LATIN1 freeside

or with MySQL:

$ mysqladmin -u freeside -p create freeside 
  • Build and install the Perl modules:
$ make perl-modules
$ su
# make install-perl-modules
  • Create the necessary configuration files:
$ su
# make create-config
  • Ensure Apache has mod_perl enabled and is set to run as User freeside. If you have other things being served by Apache on this machine (hopefully internal things), it is recommended to run a separate iteration of Apache as the freeside user.
  • Edit the Makefile and set FREESIDE_DOCUMENT_ROOT.
  • Run
# make install-docs
  • Edit the Makefile and set APACHE_VERSION to 1 (mod_perl v1.XX), 1.99 (mod_perl v2 prereleases up to and including 1.999_21, shipped with Debian 3.1, CentOS/RHEL 4, others), or 2 (mod_perl v2 proper and prereleases 1.999_22 and later).
  • Edit the Makefile and set APACHE_CONF to the location of an Apache include directory (not a file). (If your Apache doesn't have an existing include directory, create one and add a line such as "Include /etc/apache/conf.d" to httpd.conf.)
  • Run
# make install-apache

Note: Do not attempt to restart Apache (httpd) yet.

  • As the freeside UNIX user, run freeside-setup -d your.domain.name to create the database tables and initial data.
$ su freeside
$ freeside-setup -d example.com
  • Create the Freeside system users:
$ su freeside
$ freeside-adduser -g 1 fs_queue
$ freeside-adduser -g 1 fs_daily
$ freeside-adduser -g 1 fs_selfservice
  • Create one or more Freeside users (your internal sales/tech folks, not customer accounts):
$ su freeside
$ freeside-adduser -g 1 username
$ htpasswd /usr/local/etc/freeside/htpasswd username
Password: 

Additional users can be added using the same command or from the web interface.

  • freeside-queued was installed with the Perl modules. Start it now and ensure that is run upon system startup (Do this manually, or edit the top-level Makefile, replacing INIT_FILE with the appropriate location on your system and QUEUED_USER with the username of a Freeside user you created above, and run make install-init)
  • Restart Apache (httpd) and log into the web interface using the username and password you entered above.