Difference between revisions of "Freeside:3:Documentation:InstallingOnDebian8"

From Freeside
Jump to: navigation, search
(Apache & Web GUI)
 
(2 intermediate revisions by the same user not shown)
Line 55: Line 55:
 
= Bootstrap Freeside =
 
= Bootstrap Freeside =
  
== Database ==
+
== Freeside database ==
  
 
* As the freeside UNIX user, run <code>freeside-setup -d your.domain.name</code> to create the database tables and initial data.
 
* As the freeside UNIX user, run <code>freeside-setup -d your.domain.name</code> to create the database tables and initial data.
Line 61: Line 61:
 
$ su freeside
 
$ su freeside
 
$ freeside-setup -d example.com
 
$ freeside-setup -d example.com
 +
</pre>
 +
 +
== RT database ==
 +
 +
* As the freeside UNIX user, run:
 +
<pre>
 +
$ su freeside
 +
$ /opt/rt3/sbin/rt-setup-database --action schema
 +
$ /opt/rt3/sbin/rt-setup-database --action coredata
 +
$ /opt/rt3/sbin/rt-setup-database --action insert --datafile /opt/rt3/etc/initialdata
 
</pre>
 
</pre>
  
Line 73: Line 83:
 
</pre>
 
</pre>
  
=== Employees ===
+
== Employees ==
 
* Create one or more Freeside users (your internal sales/tech folks, not customer accounts):
 
* Create one or more Freeside users (your internal sales/tech folks, not customer accounts):
 
<pre>
 
<pre>
Line 89: Line 99:
 
= Apache & Web GUI =
 
= Apache & Web GUI =
 
* Edit /etc/apache2/envvars and set APACHE_RUN_USER and APACHE_RUN_GROUP to <code>freeside</code>
 
* Edit /etc/apache2/envvars and set APACHE_RUN_USER and APACHE_RUN_GROUP to <code>freeside</code>
* <code>a2enconf freeside-base</code>
+
* <code>a2enconf freeside-base2</code>
 
* <code>a2enconf freeside-rt</code>
 
* <code>a2enconf freeside-rt</code>
 
* <code>a2dismod mpm_event</code>
 
* <code>a2dismod mpm_event</code>

Latest revision as of 16:41, 3 December 2015

Configure package repositories

  • Add the following apt sources to /etc/apt/sources.list (for Debian 8.x "jessie"):
deb http://freeside.biz/~ivan/freeside-jessie/ ./
deb http://freeside.biz/~jeremyd/freeside3-jessie-stable/ ./
  • Run aptitude update.

Install

aptitude install freeside
apt-mark hold freeside*

Database setup

Database User

  • Allow the freeside user full access to the freeside database.

with Postgresql:

[ 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';

Database Access

  • Configure /usr/local/etc/freeside/secrets if necessary. This file contains three lines: DBI datasource, username and password
    • See the DBI manpage and the manpage for your DBD for the exact syntax of your DBI data source.

Database

  • Add the freeside database to your database engine:

with Postgres:

$ su freeside
$ createdb -E UTF8 freeside

or with MySQL:

$ mysqladmin -u freeside -p create freeside 

Bootstrap Freeside

Freeside database

  • 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

RT database

  • As the freeside UNIX user, run:
$ su freeside
$ /opt/rt3/sbin/rt-setup-database --action schema
$ /opt/rt3/sbin/rt-setup-database --action coredata
$ /opt/rt3/sbin/rt-setup-database --action insert --datafile /opt/rt3/etc/initialdata

System users

  • 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
$ freeside-adduser -g 1 fs_api

Employees

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

Restart freeside

  • /etc/init.d/freeside restart

Apache & Web GUI

  • Edit /etc/apache2/envvars and set APACHE_RUN_USER and APACHE_RUN_GROUP to freeside
  • a2enconf freeside-base2
  • a2enconf freeside-rt
  • a2dismod mpm_event
  • a2enmod mpm_prefork
  • chown freeside /var/lock/apache2
  • Restart Apache
  • The web interface will be available at /freeside

Next steps

  • Log into the web interface using the username and password you entered above.
  • Proceed to the initial administration of your installation.