Difference between revisions of "Freeside:1.7:Documentation:InstallingUsingAPT"
From Freeside
m (→Installation) |
(→Warnings!) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
=Introduction= | =Introduction= | ||
| − | ==Warnings | + | ==Warnings== |
| − | The .deb installation of Freeside is experimental | + | 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 | + | 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. | 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= | ||
| − | * For Debian | + | * 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- | + | deb http://freeside.biz/~ivan/freeside-lenny/ ./ |
| − | deb http://freeside.biz/~ivan/freeside-1.7- | + | deb http://freeside.biz/~ivan/freeside-1.7-lenny/ ./ |
</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. | + | * 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 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). | * 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). | ||
Latest revision as of 18:43, 12 August 2009
Contents
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.3oraptitude 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 doaptitude --visual-preview install freeside linksto 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/freesideand log in.
- Proceed to the initial administration of your installation.
