From Freeside
Revision as of 12:18, 12 December 2008 by Rsiddall (talk | contribs) (Installation: Expanded SSL setup instructions)

Jump to: navigation, search



The YaST installation of Freeside is experimental! The instructions below may be incomplete or incorrect and are subject to change. You should only attempt to use the YaST installation if you are prepared to work around omissions and inaccuracies, and can recover data in the event of a loss.


YaST is the installer on the SuSE Linux distributions: Novell's SuSE Enterprise Linux Server (SLES) and OpenSuSE. The Freeside repository is a repomd, i.e. RPM-based, repository.

Installing the YaST version of Freeside may not be a good idea if you plan to do development on Freeside as the RPMs may not include all the files supplied in the tarball.


The YaST version of Freeside does not include Request Tracker at this time. The self-service interface conflicts with the main server installation and has been temporarily removed from the repository. The MySQL backend has not yet been tested. Only the 1.7 branch has been tested. The version and release of the YaST package is shown in the "Billing Main" page in Freeside.


  • Install SLES on your target machine.
  • SSH in as root.
  • Run "yast2", select "Software : Installation Source" and make sure the SLES repo is present. If not click Add and add the URL of the repo.
  • Also add an update source if you're using a separate repo for updates.
  • While still in YaST, select "Network Services : HTTP Server" and walk through the configuration wizard. It will show SSL disabled.
    • Enable "Perl Scripting," which is mod_perl.
    • Set "HTTP Service" to "Enabled"
    • In the 5th screen, select "HTTP Server Expert Configuration". Then you can select Server Modules, move down to "ssl" and select the toggle button to enable SSL.

SLES does not ship with a working SSL configuration for Apache2. You'll need to configure a virtual host and configure SSL on that virtual host. First, scp the server certificate and key to /etc/apache2/ssl.{crt,key}, and copy any certificate authority bundles needed.

cd /etc/apache2/vhosts.d
cp -p vhost-ssl.template freeside-ssl.conf
vi freeside-ssl.conf # Uncomment and correct ServerName, ServerAdmin, and any SSL file locations
  • Exit YaST and enter:
yast2 --install zypper

as zypper has a better CLI interface than YaST.

  • Use zypper to update the whole system?
zypper update

You might have to repeat this several times as updating zypper itself may result in more updates becoming available.

  • Use zypper to install postgresql-server if the database server is going to be running on the same machine as Freeside:
zypper install postgresql-server
  • Set PostgreSQL to run on startup:
chkconfig --add postgresql

and start it now

service postgresql start
  • Use zypper to add the Freeside repo:
zypper service-add

for the stable version, or:

zypper service-add

for a recent CVS build. (This option is really only useful if you have access to the Freeside RPM build system.)

  • Update MailTools to 2.x:
zypper install perl-MailTools

and answer 'y'.

If this step fails (zypper refuses to install anything), start yast2 and turn off synchronization of the Install Source to ZenWorks. Turn it back on again once you've completed the Freeside installation.

  • Install Freeside:
zypper install freeside-postgresql

If zypper complains that it can't find a provider of "freeside" or "freeside-mason", it means that your repo is missing Perl module RPMs that the freeside or freeside-mason RPMs require. You can keep telling zypper to ignore that requirement, which will cause zypper to enumerate the missing modules.

  • Install Business::OnlinePayment gateways. (I haven't tried this yet.)
zypper install perl-Business-OnlinePayment-AuthorizeNet
  • Work down the final steps to bring up a Freeside installation:
su postgres -c 'createuser -P freeside'
su freeside -c 'createdb -E sql_ascii freeside'
su freeside -c 'freeside-setup -d'
su freeside -c 'for i in fs_queue fs_daily fs_selfservice ivan; do freeside-adduser -g 1 $i; done'
su freeside -c '/usr/sbin/htpasswd2 /etc/freeside/htpasswd ivan'
  • To fix a current bug in the freeside-mason RPM generation, go into /etc/apache2/conf.d/freeside-base2.conf and replace %%%FREESIDE_CONF%%% with /etc/freeside.

Also in /etc/apache2/uid.conf, change Group from freeside to www.

Also, in /etc/freeside/, remove the 3.29 following "use CGI" as this is only required for Request Tracker.

  • To get pslatex to work temporarily:
service apache2 restart
  • Try bringing up Freeside in the web browser. Do some cursory testing, including generating and viewing typeset invoices (to test LaTex).

Finalizing the installation

  • Go to and log in.