Freeside - User contributions [en]

Freeside:1.7:Documentation:Installation

2006-08-21T18:38:37Z

Lawrence: /* Installation */

== Introduction ==

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

== Prerequisites ==

=== Packages ===

* [http://www.perl.org/ Perl], minimum version 5.8.0 (5.8.3 for RT?)
* [http://httpd.apache.org/ Apache], version 1.3 ([http://www.modssl.org/ mod_ssl] highly recommended)
* [http://perl.apache.org/ mod_perl], version 1.29 (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
* A '''transactional''' database engine [http://search.cpan.org/search?mode=module&query=DBD%3A%3A supported] by Perl's [http://dbi.perl.org/ DBI].
** [http://www.postgresql.org PostgreSQL] is recommended (v7.2 or later, 7.4 or later recommended).
** [http://www.mysql.com MySQL] is '''not currently supported'''. ''Developers intersted in maintaining MySQL support are welcome to ask on the -devel mailing list; most things work, but MySQL support needs a maintainer to update it for recent (and future) changes.

''Note: the above only applies to the database used by the Freeside software itself. Freeside can integrate with RADIUS and other servers running MySQL or any other DBI-supported database.''

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

=== Perl modules ===

==== Popular modules you might want to check your distribution for ====

* [http://search.cpan.org/dist/libnet/ libnet] (CPAN: "install Net::Cmd")
* [http://search.cpan.org/dist/libwww-perl libwww-perl] (CPAN: "install Bundle::LWP")
** [http://search.cpan.org/dist/URI URI]
** [http://search.cpan.org/dist/HTML-Tagset HTML::Tagset]
** [http://search.cpan.org/dist/HTML-Parser HTML::Parser]
* [http://search.cpan.org/dist/HTML-Mason HTML::Mason]
* [http://search.cpan.org/dist/Text-Template Text::Template]
* [http://search.cpan.org/dist/DBI DBI]
** [http://search.cpan.org/search?mode=module&query=DBD%3A%3A DBD] for your database engine ([http://search.cpan.org/dist/DBD-Pg DBD::Pg] for PostgreSQL)
* [http://search.cpan.org/dist/MailTools MailTools] (CPAN: "install Mail::Internet")
* [http://search.cpan.org/dist/MIME-tools MIME::Tools]
* [http://search.cpan.org/dist/TimeDate TimeDate] (CPAN: "install Date::Format")
* [http://search.cpan.org/dist/Locale-Codes Locale-Codes] (CPAN: "install Locale::Country")

==== Modules of Indeterminate Popularity ====

* [http://search.cpan.org/dist/Chart Chart] (CPAN: "install Chart::Base")
* [http://search.cpan.org/dist/Cache-Cache Cache::Cache]
* [http://search.cpan.org/dist/NetAddr-IP NetAddr::IP]
* [http://search.cpan.org/dist/String-Approx String::Approx]
* [http://search.cpan.org/dist/Locale-SubCountry Locale::SubCountry]
* [http://search.cpan.org/dist/Frontier-RPC Frontier::RPC2]
* [http://search.cpan.org/dist/Term-ReadKey Term::ReadKey]

==== Less common modules probably not included in anything but Debian? ====

* [http://search.cpan.org/dist/Business-CreditCard Business::CreditCard]
* [http://search.cpan.org/dist/Net-Whois-Raw Net::Whois::Raw]
* [http://search.cpan.org/dist/DBIx-DBSchema DBIx::DBSchema]
* [http://search.cpan.org/dist/Tie-IxHash Tie::IxHash]
* [http://search.cpan.org/dist/Crypt::PasswdMD5 Crypt::PasswdMD5]
* [http://search.cpan.org/dist/Time-Duration Time::Duration]
* [http://search.cpan.org/dist/File-CounterFile File::CounterFile]
* [http://search.cpan.org/dist/IPC-Run3 IPC::Run3]
* [http://search.cpan.org/dist/Net-SSH Net::SSH]
* [http://search.cpan.org/dist/String-ShellQuote String::ShellQuote]
* [http://search.cpan.org/dist/JSON JSON]
* [http://search.cpan.org/dist/HTML-Widgets-SelectLayers HTML::Widgets::SelectLayers]

==== Optional modules ====

* [http://search.cpan.org/dist/Fax-Hylafax-Client Fax::Hylafax::Client] ''(Required if faxing invoices)''
* [http://search.cpan.org/dist/Apache-DBI Apache::DBI] ''(recommended for better web interface performance)''

== Installation ==

* Add the user and group `freeside' to your system.
* Allow the freeside user full access to the freeside database.
** with PostgreSQL<pre><nowiki>
$ 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
</nowiki></pre>
** or with MySQL:<pre><nowiki>
$ 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';
</nowiki></pre>

*Edit the top-level Makefile:
** Set DATASOURCE to your DBI data source, for example, <code>DBI:Pg:dbname=freeside</code> for PostgresSQL or <code>DBI:mysql:freeside</code> 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: <pre><nowiki>
$ su freeside
$ createdb -E sql_ascii freeside
</nowiki></pre>
** or with MySQL: <pre><nowiki>
$ mysqladmin -u freeside -p create freeside
</nowiki></pre>

* Build and install the Perl modules: <pre><nowiki>
$ make perl-modules
$ su
# make install-perl-modules
</nowiki></pre>

* Create the necessary configuration files: <pre><nowiki>
$ su
# make create-config
</nowiki></pre>

* Run a '''separate''' iteration of Apache[-SSL] with mod_perl enabled '''as the freeside user'''.

* Edit the Makefile and set <code>FREESIDE_DOCUMENT_ROOT</code>.

* Run <code>make install-docs</code>

* Configure Apache: <pre><nowiki>
PerlModule HTML::Mason
# your freeside docuemnt root
<Directory /var/www/freeside>
<Files ~ (\.cgi|\.html)>
AddHandler perl-script .cgi .html
PerlHandler HTML::Mason
</Files>
<Perl>
require "/usr/local/etc/freeside/handler.pl";
</Perl>
</Directory>
</nowiki></pre>

* Restrict access to this web interface - see the [http://httpd.apache.org/docs/misc/FAQ.html#user-authentication Apache documentation on user authentication]. For example, to configure user authentication with [http://httpd.apache.org/docs/mod/mod_auth.html mod_auth] (flat files), add something like the following to your Apache httpd.conf file, adjusting for your actual paths: <pre><nowiki>
#your freeside document root
<Directory /var/www/freeside>
AuthName Freeside
AuthType Basic
AuthUserFile /usr/local/etc/freeside/htpasswd
require valid-user
</Directory>
</nowiki></pre>

* As the freeside UNIX user, run freeside-setup -d domain.name to create the database tables and initial data.<pre><nowiki>
$ su freeside
$ freeside-setup -d example.com
</nowiki></pre>

* Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication, not UNIX user accounts. For example, using mod_auth (flat files):
** First user: <pre><nowiki>
$ su freeside
# freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
</nowiki></pre>
** Additional users: <pre><nowiki>
$ su freeside
# freeside-adduser -h /usr/local/etc/freeside/htpasswd username
</nowiki></pre>
''(using other auth types, add each user to your Apache authentication and then run: freeside-adduser username) ''

* Create the Freeside system users: <pre><nowiki>
$ su freeside
# freeside-adduser fs_queue
# freeside-adduser fs_daily
# freeside-adduser fs_selfservice
</nowiki></pre>

* 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 <code>INIT_FILE</code> with the appropriate location on your system and <code>QUEUED_USER</code> with the username of a Freeside user you created above, and run <code>make install-init</code>)

* Now proceed to the initial administration of your installation.

Freeside:1.7:Documentation:Installation

2006-08-21T18:37:45Z

Lawrence: /* Installation */

== Introduction ==

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

== Prerequisites ==

=== Packages ===

* [http://www.perl.org/ Perl], minimum version 5.8.0 (5.8.3 for RT?)
* [http://httpd.apache.org/ Apache], version 1.3 ([http://www.modssl.org/ mod_ssl] highly recommended)
* [http://perl.apache.org/ mod_perl], version 1.29 (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
* A '''transactional''' database engine [http://search.cpan.org/search?mode=module&query=DBD%3A%3A supported] by Perl's [http://dbi.perl.org/ DBI].
** [http://www.postgresql.org PostgreSQL] is recommended (v7.2 or later, 7.4 or later recommended).
** [http://www.mysql.com MySQL] is '''not currently supported'''. ''Developers intersted in maintaining MySQL support are welcome to ask on the -devel mailing list; most things work, but MySQL support needs a maintainer to update it for recent (and future) changes.

''Note: the above only applies to the database used by the Freeside software itself. Freeside can integrate with RADIUS and other servers running MySQL or any other DBI-supported database.''

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

=== Perl modules ===

==== Popular modules you might want to check your distribution for ====

* [http://search.cpan.org/dist/libnet/ libnet] (CPAN: "install Net::Cmd")
* [http://search.cpan.org/dist/libwww-perl libwww-perl] (CPAN: "install Bundle::LWP")
** [http://search.cpan.org/dist/URI URI]
** [http://search.cpan.org/dist/HTML-Tagset HTML::Tagset]
** [http://search.cpan.org/dist/HTML-Parser HTML::Parser]
* [http://search.cpan.org/dist/HTML-Mason HTML::Mason]
* [http://search.cpan.org/dist/Text-Template Text::Template]
* [http://search.cpan.org/dist/DBI DBI]
** [http://search.cpan.org/search?mode=module&query=DBD%3A%3A DBD] for your database engine ([http://search.cpan.org/dist/DBD-Pg DBD::Pg] for PostgreSQL)
* [http://search.cpan.org/dist/MailTools MailTools] (CPAN: "install Mail::Internet")
* [http://search.cpan.org/dist/MIME-tools MIME::Tools]
* [http://search.cpan.org/dist/TimeDate TimeDate] (CPAN: "install Date::Format")
* [http://search.cpan.org/dist/Locale-Codes Locale-Codes] (CPAN: "install Locale::Country")

==== Modules of Indeterminate Popularity ====

* [http://search.cpan.org/dist/Chart Chart] (CPAN: "install Chart::Base")
* [http://search.cpan.org/dist/Cache-Cache Cache::Cache]
* [http://search.cpan.org/dist/NetAddr-IP NetAddr::IP]
* [http://search.cpan.org/dist/String-Approx String::Approx]
* [http://search.cpan.org/dist/Locale-SubCountry Locale::SubCountry]
* [http://search.cpan.org/dist/Frontier-RPC Frontier::RPC2]
* [http://search.cpan.org/dist/Term-ReadKey Term::ReadKey]

==== Less common modules probably not included in anything but Debian? ====

* [http://search.cpan.org/dist/Business-CreditCard Business::CreditCard]
* [http://search.cpan.org/dist/Net-Whois-Raw Net::Whois::Raw]
* [http://search.cpan.org/dist/DBIx-DBSchema DBIx::DBSchema]
* [http://search.cpan.org/dist/Tie-IxHash Tie::IxHash]
* [http://search.cpan.org/dist/Crypt::PasswdMD5 Crypt::PasswdMD5]
* [http://search.cpan.org/dist/Time-Duration Time::Duration]
* [http://search.cpan.org/dist/File-CounterFile File::CounterFile]
* [http://search.cpan.org/dist/IPC-Run3 IPC::Run3]
* [http://search.cpan.org/dist/Net-SSH Net::SSH]
* [http://search.cpan.org/dist/String-ShellQuote String::ShellQuote]
* [http://search.cpan.org/dist/JSON JSON]
* [http://search.cpan.org/dist/HTML-Widgets-SelectLayers HTML::Widgets::SelectLayers]

==== Optional modules ====

* [http://search.cpan.org/dist/Fax-Hylafax-Client Fax::Hylafax::Client] ''(Required if faxing invoices)''
* [http://search.cpan.org/dist/Apache-DBI Apache::DBI] ''(recommended for better web interface performance)''

== Installation ==

* Add the user and group `freeside' to your system.
* Allow the freeside user full access to the freeside database.
** with PostgreSQL<pre><nowiki>
$ 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
</nowiki></pre>
** or with MySQL:<pre><nowiki>
$ 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';
</nowiki></pre>

*Edit the top-level Makefile:
** Set DATASOURCE to your DBI data source, for example, <code>DBI:Pg:dbname=freeside</code> for PostgresSQL or <code>DBI:mysql:freeside</code> 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: <pre><nowiki>
$ su freeside
$ createdb -E sql_ascii freeside
</nowiki></pre>
** or with MySQL: <pre><nowiki>
$ mysqladmin -u freeside -p create freeside
</nowiki></pre>

* Build and install the Perl modules: <pre><nowiki>
$ make perl-modules
$ su
# make install-perl-modules
</nowiki></pre>

* Create the necessary configuration files: <pre><nowiki>
$ su
# make create-config
</nowiki></pre>

* Run a '''separate''' iteration of Apache[-SSL] with mod_perl enabled '''as the freeside user'''.

* Edit the Makefile and set <code>FREESIDE_DOCUMENT_ROOT</code>.

* Run <code>make install-docs</code>

* Configure Apache: <pre><nowiki>
PerlModule HTML::Mason
# your freeside docuemnt root
<Directory /var/www/freeside>
<Files ~ (\.cgi|\.html)>
AddHandler perl-script .cgi .html
PerlHandler HTML::Mason
</Files>
<Perl>
require "/usr/local/etc/freeside/handler.pl";
</Perl>
</Directory>
</nowiki></pre>

* Restrict access to this web interface - see the [http://httpd.apache.org/docs/misc/FAQ.html#user-authentication Apache documentation on user authentication]. For example, to configure user authentication with [http://httpd.apache.org/docs/mod/mod_auth.html mod_auth] (flat files), add something like the following to your Apache httpd.conf file, adjusting for your actual paths: <pre><nowiki>
#your freeside document root
<Directory /var/www/freeside>
AuthName Freeside
AuthType Basic
AuthUserFile /usr/local/etc/freeside/htpasswd
require valid-user
</Directory>
</nowiki></pre>

* As the freeside UNIX user, run freeside-setup -d domain.name to create the database tables and initial data.<pre><nowiki>
$ su freeside
$ freeside-setup -d example.com
</nowiki></pre>

* Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication, not UNIX user accounts. For example, using mod_auth (flat files):
** First user: <pre><nowiki>
$ su
# freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
</nowiki></pre>
** Additional users: <pre><nowiki>
$ su freeside
# freeside-adduser -h /usr/local/etc/freeside/htpasswd username
</nowiki></pre>
''(using other auth types, add each user to your Apache authentication and then run: freeside-adduser username) ''

* Create the Freeside system users: <pre><nowiki>
$ su freeside
# freeside-adduser fs_queue
# freeside-adduser fs_daily
# freeside-adduser fs_selfservice
</nowiki></pre>

* 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 <code>INIT_FILE</code> with the appropriate location on your system and <code>QUEUED_USER</code> with the username of a Freeside user you created above, and run <code>make install-init</code>)

* Now proceed to the initial administration of your installation.

Freeside:1.7:Documentation:Installation

2006-08-21T18:32:24Z

Lawrence: /* Installation */

== Introduction ==

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

== Prerequisites ==

=== Packages ===

* [http://www.perl.org/ Perl], minimum version 5.8.0 (5.8.3 for RT?)
* [http://httpd.apache.org/ Apache], version 1.3 ([http://www.modssl.org/ mod_ssl] highly recommended)
* [http://perl.apache.org/ mod_perl], version 1.29 (if compiling your own mod_perl, make sure you set the EVERYTHING=1 compile-time option)
* A '''transactional''' database engine [http://search.cpan.org/search?mode=module&query=DBD%3A%3A supported] by Perl's [http://dbi.perl.org/ DBI].
** [http://www.postgresql.org PostgreSQL] is recommended (v7.2 or later, 7.4 or later recommended).
** [http://www.mysql.com MySQL] is '''not currently supported'''. ''Developers intersted in maintaining MySQL support are welcome to ask on the -devel mailing list; most things work, but MySQL support needs a maintainer to update it for recent (and future) changes.

''Note: the above only applies to the database used by the Freeside software itself. Freeside can integrate with RADIUS and other servers running MySQL or any other DBI-supported database.''

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

=== Perl modules ===

==== Popular modules you might want to check your distribution for ====

* [http://search.cpan.org/dist/libnet/ libnet] (CPAN: "install Net::Cmd")
* [http://search.cpan.org/dist/libwww-perl libwww-perl] (CPAN: "install Bundle::LWP")
** [http://search.cpan.org/dist/URI URI]
** [http://search.cpan.org/dist/HTML-Tagset HTML::Tagset]
** [http://search.cpan.org/dist/HTML-Parser HTML::Parser]
* [http://search.cpan.org/dist/HTML-Mason HTML::Mason]
* [http://search.cpan.org/dist/Text-Template Text::Template]
* [http://search.cpan.org/dist/DBI DBI]
** [http://search.cpan.org/search?mode=module&query=DBD%3A%3A DBD] for your database engine ([http://search.cpan.org/dist/DBD-Pg DBD::Pg] for PostgreSQL)
* [http://search.cpan.org/dist/MailTools MailTools] (CPAN: "install Mail::Internet")
* [http://search.cpan.org/dist/MIME-tools MIME::Tools]
* [http://search.cpan.org/dist/TimeDate TimeDate] (CPAN: "install Date::Format")
* [http://search.cpan.org/dist/Locale-Codes Locale-Codes] (CPAN: "install Locale::Country")

==== Modules of Indeterminate Popularity ====

* [http://search.cpan.org/dist/Chart Chart] (CPAN: "install Chart::Base")
* [http://search.cpan.org/dist/Cache-Cache Cache::Cache]
* [http://search.cpan.org/dist/NetAddr-IP NetAddr::IP]
* [http://search.cpan.org/dist/String-Approx String::Approx]
* [http://search.cpan.org/dist/Locale-SubCountry Locale::SubCountry]
* [http://search.cpan.org/dist/Frontier-RPC Frontier::RPC2]
* [http://search.cpan.org/dist/Term-ReadKey Term::ReadKey]

==== Less common modules probably not included in anything but Debian? ====

* [http://search.cpan.org/dist/Business-CreditCard Business::CreditCard]
* [http://search.cpan.org/dist/Net-Whois-Raw Net::Whois::Raw]
* [http://search.cpan.org/dist/DBIx-DBSchema DBIx::DBSchema]
* [http://search.cpan.org/dist/Tie-IxHash Tie::IxHash]
* [http://search.cpan.org/dist/Crypt::PasswdMD5 Crypt::PasswdMD5]
* [http://search.cpan.org/dist/Time-Duration Time::Duration]
* [http://search.cpan.org/dist/File-CounterFile File::CounterFile]
* [http://search.cpan.org/dist/IPC-Run3 IPC::Run3]
* [http://search.cpan.org/dist/Net-SSH Net::SSH]
* [http://search.cpan.org/dist/String-ShellQuote String::ShellQuote]
* [http://search.cpan.org/dist/JSON JSON]
* [http://search.cpan.org/dist/HTML-Widgets-SelectLayers HTML::Widgets::SelectLayers]

==== Optional modules ====

* [http://search.cpan.org/dist/Fax-Hylafax-Client Fax::Hylafax::Client] ''(Required if faxing invoices)''
* [http://search.cpan.org/dist/Apache-DBI Apache::DBI] ''(recommended for better web interface performance)''

== Installation ==

* Add the user and group `freeside' to your system.
* Allow the freeside user full access to the freeside database.
** with PostgreSQL<pre><nowiki>
$ 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
</nowiki></pre>
** or with MySQL:<pre><nowiki>
$ 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';
</nowiki></pre>

*Edit the top-level Makefile:
** Set DATASOURCE to your DBI data source, for example, <code>DBI:Pg:dbname=freeside</code> for PostgresSQL or <code>DBI:mysql:freeside</code> 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: <pre><nowiki>
$ su freeside
$ createdb -E sql_ascii freeside
</nowiki></pre>
** or with MySQL: <pre><nowiki>
$ mysqladmin -u freeside -p create freeside
</nowiki></pre>

* Build and install the Perl modules: <pre><nowiki>
$ make perl-modules
$ su
# make install-perl-modules
</nowiki></pre>

* Create the necessary configuration files: <pre><nowiki>
$ su
# make create-config
</nowiki></pre>

* Run a '''separate''' iteration of Apache[-SSL] with mod_perl enabled '''as the freeside user'''.

* Edit the Makefile and set <code>FREESIDE_DOCUMENT_ROOT</code>.

* Run <code>make install-docs</code>

* Configure Apache: <pre><nowiki>
PerlModule HTML::Mason
# your freeside docuemnt root
<Directory /var/www/freeside>
<Files ~ (\.cgi|\.html)>
AddHandler perl-script .cgi .html
PerlHandler HTML::Mason
</Files>
<Perl>
require "/usr/local/etc/freeside/handler.pl";
</Perl>
</Directory>
</nowiki></pre>

* Restrict access to this web interface - see the [http://httpd.apache.org/docs/misc/FAQ.html#user-authentication Apache documentation on user authentication]. For example, to configure user authentication with [http://httpd.apache.org/docs/mod/mod_auth.html mod_auth] (flat files), add something like the following to your Apache httpd.conf file, adjusting for your actual paths: <pre><nowiki>
#your freeside document root
<Directory /var/www/freeside>
AuthName Freeside
AuthType Basic
AuthUserFile /usr/local/etc/freeside/htpasswd
require valid-user
</Directory>
</nowiki></pre>

* As the freeside UNIX user, run freeside-setup -d domain.name to create the database tables and initial data.<pre><nowiki>
$ su freeside
$ freeside-setup -d example.com
</nowiki></pre>

* Create one or more Freeside users (your internal sales/tech folks, not customer accounts). These users are setup using using Apache authentication, not UNIX user accounts. For example, using mod_auth (flat files):
** First user: <pre><nowiki>
$ su
# freeside-adduser -c -h /usr/local/etc/freeside/htpasswd username
</nowiki></pre>
** Additional users: <pre><nowiki>
$ su
# freeside-adduser -h /usr/local/etc/freeside/htpasswd username
</nowiki></pre>
''(using other auth types, add each user to your Apache authentication and then run: freeside-adduser username) ''

* Create the Freeside system users: <pre><nowiki>
$ su
# freeside-adduser fs_queue
# freeside-adduser fs_daily
# freeside-adduser fs_selfservice
</nowiki></pre>

* 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 <code>INIT_FILE</code> with the appropriate location on your system and <code>QUEUED_USER</code> with the username of a Freeside user you created above, and run <code>make install-init</code>)

* Now proceed to the initial administration of your installation.