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

From Freeside
Jump to: navigation, search
(→‎Installation)
(→‎Warnings!)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
=Introduction=
 
=Introduction=
  
−
==Warnings!==
+
==Warnings==
  
−
The .deb 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 .deb installation if you are prepared to work around omissions and inaccuracies, and can recover data in the event of a loss.
+
The .deb installation of Freeside is experimental.
  
 
Make sure to remove any FS:: libraries installed in your Perl @INC (probaby under /usr/local/share/) before attempting to install a packaged Freeside.  Also stop and remove any existing Freeside daemon processes and init scripts.
 
Make sure to remove any FS:: libraries installed in your Perl @INC (probaby under /usr/local/share/) before attempting to install a packaged Freeside.  Also stop and remove any existing Freeside daemon processes and init scripts.
Line 9: Line 9:
 
==Information==
 
==Information==
  
−
The currently available Freeside packages are architecture-independent and are available for Debian 4.0 "etch" (stable) and Debian "sid" (unstable).
+
The currently available Freeside packages are architecture-independent and are available for Debian 5.0 "lenny" (stable) and Debian "sid" (unstable). The packages for Debian 4.0 "etch" (oldstable) are no longer being actively maintained.
−
 
 
−
On Debian 4.0 "etch" (stable), additional perl modules not packaged in Debian proper are required.  These packages are available from our repository for the i386 and amd64 architectures only.
 
  
 
Installing the .deb version of Freeside may not be a good idea if you plan to do development on Freeside as the .debs may not include all the files supplied in the tarball.
 
Installing the .deb version of Freeside may not be a good idea if you plan to do development on Freeside as the .debs may not include all the files supplied in the tarball.
Line 21: Line 19:
 
=Installation=
 
=Installation=
  
−
* Add the following apt sources to <code>/etc/apt/sources.list</code> (for Debian 4.0 "etch" (stable)):
+
* For Debian 5.0 "etch" (stable), add the following apt sources to <code>/etc/apt/sources.list</code>:
  
 
<pre>
 
<pre>
−
deb http://freeside.biz/~ivan/freeside-etch/ ./
+
deb http://freeside.biz/~ivan/freeside-lenny/ ./
−
deb http://freeside.biz/~ivan/freeside-1.7-etch/ ./
+
deb http://freeside.biz/~ivan/freeside-1.7-lenny/ ./
 
</pre>
 
</pre>
  
−
* OR, add the following apt source to <code>/etc/apt/sources.list</code> (for Debian "sid" (unstable)):
+
* OR, for Debian "sid" (unstable), add the following apt source to <code>/etc/apt/sources.list</code>:
  
 
<pre>
 
<pre>
Line 36: Line 34:
 
* Run <code>aptitude update</code>.
 
* Run <code>aptitude update</code>.
  
−
* If you don't already have PostgreSQL or MySQL installed, run <code>aptitude install postgresql-8.1</code> or <code>aptitude install mysql</code>.
+
* If you don't already have PostgreSQL or MySQL installed, run <code>aptitude install postgresql-8.3</code> or <code>aptitude install mysql-server</code>.
  
−
* Run <code>aptitude --visual-preview install freeside</code>.  Inspect the actions to be taken and then hit "g" to proceed.  (If you're installing on a headless machine without a command-line web browser installed yet, you may wish to do <code>aptitude --visual-preview install freeside links</code> to prevent iceape-browser from being pulled in)
+
* Run <code>aptitude --visual-preview install freeside</code>.  Inspect the actions to be taken and then hit "g" to proceed.  (If you're installing on an X-less machine, you may wish to do <code>aptitude --visual-preview install freeside links</code> to prevent extra dependencies from being pulled in).
  
 
* At this time, you can pick the database type (pgsql or mysql), database user and database name.  Leave the other options (remote databases, alternate connection options) at their defaults.
 
* At this time, you can pick the database type (pgsql or mysql), database user and database name.  Leave the other options (remote databases, alternate connection options) at their defaults.
 +
 +
= Finalizing the installation =
 +
 +
* Edit /etc/apache2/envvars or /etc/apache2/apache2.conf and set User and Group to freeside
 +
 +
* <code>/etc/init.d/apache2 restart</code>
 +
 +
* Create one or more Freeside users (your internal sales/tech folks, not customer accounts):
 +
<pre>
 +
$ su
 +
# su freeside
 +
$ freeside-adduser -g 1 username
 +
$ htpasswd /etc/freeside/htpasswd username
 +
(enter password)
 +
</pre>
 +
 +
* Go to <code><nowiki>http://your.host.name/freeside</nowiki></code> and log in.
 +
 +
* Proceed to the initial [[Freeside:1.7:Documentation:Administration | administration]] of your installation.

Latest revision as of 18:43, 12 August 2009

Introduction

Warnings

The .deb installation of Freeside is experimental.

Make sure to remove any FS:: libraries installed in your Perl @INC (probaby under /usr/local/share/) before attempting to install a packaged Freeside. Also stop and remove any existing Freeside daemon processes and init scripts.

Information

The currently available Freeside packages are architecture-independent and are available for Debian 5.0 "lenny" (stable) and Debian "sid" (unstable). The packages for Debian 4.0 "etch" (oldstable) are no longer being actively maintained.

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

Status

The Debian version of Freeside does include Request Tracker at this time. There is no package of the self-service interface yet. A single package provides both PostgreSQL and MySQL support. Though the prompts ask you for many database options, only a local database via the default connection method works. The version and release of the Debian package is shown in the "Billing Main" page in Freeside.

Installation

  • For Debian 5.0 "etch" (stable), add the following apt sources to /etc/apt/sources.list:
deb http://freeside.biz/~ivan/freeside-lenny/ ./
deb http://freeside.biz/~ivan/freeside-1.7-lenny/ ./
  • OR, for Debian "sid" (unstable), add the following apt source to /etc/apt/sources.list:
deb http://freeside.biz/~ivan/freeside-1.7-sid/ ./
  • Run aptitude update.
  • If you don't already have PostgreSQL or MySQL installed, run aptitude install postgresql-8.3 or aptitude install mysql-server.
  • Run aptitude --visual-preview install freeside. Inspect the actions to be taken and then hit "g" to proceed. (If you're installing on an X-less machine, you may wish to do aptitude --visual-preview install freeside links to prevent extra dependencies from being pulled in).
  • At this time, you can pick the database type (pgsql or mysql), database user and database name. Leave the other options (remote databases, alternate connection options) at their defaults.

Finalizing the installation

  • Edit /etc/apache2/envvars or /etc/apache2/apache2.conf and set User and Group to freeside
  • /etc/init.d/apache2 restart
  • Create one or more Freeside users (your internal sales/tech folks, not customer accounts):
$ su
# su freeside
$ freeside-adduser -g 1 username
$ htpasswd /etc/freeside/htpasswd username
(enter password)
  • Go to http://your.host.name/freeside and log in.
Retrieved from "http://freeside.biz/mediawiki/index.php?title=Freeside:1.7:Documentation:InstallingUsingAPT&oldid=5263"