Freeside:1.7:Documentation:InstallingUsingYaST

Introduction

Warnings!

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.

Information

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.

Status

The YaST version of Freeside does 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.

Installation

• 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 "Advanced Setup". 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.

• 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 reboot after that.

• 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 so on...

• Use zypper to add the Freeside repo:

zypper service-add http://wavetail.420.am/~rsiddall/repo/sles/10/freeside-1.7/stable/x86_64

(which is where it will be).

• Update MailTools to 2.x:

zypper install perl-MailTools

and answer 'y'

• 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 example.com'
su freeside -c 'for i in fs_queue fs_daily fs_selfservice ikohler; do freeside-adduser -g 1 $i; done'
su freeside -c '/usr/sbin/htpasswd2 /etc/freeside/htpasswd ikohler'

• 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.

• To get pslatex to work temporarily:

unset TEXINPUTS
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 https://your.host.name/freeside and log in.

• Proceed to the initial administration of your installation.