Difference between revisions of "Freeside:2.1:Documentation"

From Freeside
Jump to: navigation, search
(Prerequisites)
(Backend Installation)
 
(30 intermediate revisions by 6 users not shown)
Line 1: Line 1:
= Upgrading =
+
= Note =
  
== Prerequisites ==
+
Some documentation links point to the 1.9 documentation until things are fully moved over.  The information should still be applicable.
  
* aptitude install gcc libmodule-versions-report-perl libtext-wikiformat-perl libhttp-server-simple-mason-perl libxml-rss-perl libnet-server-perl libhtml-rewriteattributes-perl libdata-ical-perl libperlio-eol-perl libgnupg-interface-perl libfile-sharedir-perl libcgi-pm-perl libmime-types-perl libdate-ical-perl libdatetime-set-perl libhook-lexwrap-perl libcalendar-simple-perl libsoap-lite-perl libpoe-perl libipc-run-safehandles-perl
+
= Installation and upgrades =
* Or via CPAN
 
  
== Freeside ==
+
== Backend Installation ==
  
* <code>make install-perl-modules</code>
+
* [[Freeside:2.1:Documentation:Installation|New Installation]]
* As the freeside UNIX user, run <code>freeside-upgrade username</code>, passing the username of an internal Freeside user.
+
* [[Freeside:2.1:Documentation:RT Installation|Integrated RT Installation]]
* If freeside-upgrade hangs, try stopping Apache, all Freeside processes, and anything else connected to your database, especially on older PostgreSQL versions.
+
* OS-specific installation guides (source)
* <code>make install-docs</code>
+
** [[Freeside:2.1:Documentation:InstallingOnDebian5|Debian 5.0 "lenny"]]
<!-- * You may want to check your ACLs under Configuration->Employees->View/Edit employee groups and grant some of the new rights to one or more groups. -->
+
** [[Freeside:2.1:Documentation:InstallingOnDebian6|Debian 6.0 "squeeze"]]
 +
** [[Freeside:2.1:Documentation:Installation:Ubuntu|Ubuntu 10.4 LTS]]
 +
**[[Freeside:2.1:Documentation:Installation:FreeBSD|FreeBSD 8.1]] - Feedback please!
 +
* OS-specific installation guides (packages)
 +
** (no 2.1 packages yet) <strike>[[Freeside:1.9:Documentation:InstallingUsingAPT|Debian packages]]</strike>
 +
** (no 2.1 packages yet) <strike>[[Freeside:1.9:Documentation:InstallingUsingRPM|CentOS/RHEL RPM packages]]</strike>
  
== RT ==
+
== Signup and Self-service installation ==
  
* <code>mv /opt/rt3/etc/RT_SiteConfig.pm /opt/rt3/etc/RT_SiteConfig.pm.3.6</code><br>or add:<br><code>Set($WebDefaultStylesheet, 'freeside2.1');</code>
+
* [[Freeside:2.1:Documentation:Self-Service Installation|Signup/Self-service Installation]]
* make configure-rt; make deploy
 
* cd rt; su freeside -c '/opt/rt3/sbin/rt-setup-database --dba freeside --prompt-for-dba-password --action upgrade'
 
* Clear mason cache dir: rm -fr /usr/local/etc/freeside/masondata/obj
 
  
== Restart ==
+
== Distributor guides ==
  
* Restart Apache and the Freeside daemons:
+
* [[Freeside:Documentation:CreatingRPMRepo|Creating your own repository with Freeside RPMs]]
  <pre>make deploy</pre>
 
  
== Edit configuration ==
+
* [[Freeside:Documentation:MirroringRPMRepo|Creating and using a mirror of the Freeside Internet Services RPM repositories]]
  
* You may want to check your ACLs under Configuration->Employees->View/Edit employee groups and grant some of the new rights to one or more groups.
+
* [[Freeside:Documentation:RPMBuildSystem|Documentation on the RPM build system]]
* Add an "Invoice eligible for automatic collection" condition to all "Run card", "Run check" and "Add card or check to a pending batch" events.
 
* Create a new invoice send event, with the default conditions plus:
 
** customer payment type CARD or CHEK
 
** "Invoice ineligible for automatic collection"
 
  
= Changelog =
+
== Upgrading ==
 +
 
 +
* [[Freeside:2.1:Documentation:Upgrading|Upgrading from 1.9.X to 2.1.x]]
 +
* [[Freeside:2.1.1:Documentation:Upgrading|Upgrading from 2.1.0 to 2.1.1]]
 +
* [[Freeside:2.1.2:Documentation:Upgrading|Upgrading from 2.1.1 to 2.1.2]]
 +
* [[Freeside:2.1.3:Documentation:Upgrading|Upgrading from 2.1.2 to 2.1.3]]
 +
 
 +
= User's Guide =
 +
 
 +
* [[Freeside:2.1:Documentation:User|User's Guide]] (help wanted)
 +
* [http://www.sisd.com/~ivan/freeside-slides Training presentation slides]
 +
 
 +
= Administrator's Guide =
  
* [[Freeside:2.1:Changelog|2.1 Changelog]]
+
* [[Freeside:2.1:Documentation:Administration|Administrator's Guide]]
 +
* [[Freeside:Documentation:DisasterRecovery|Disaster Recovery]]
 +
* [[:Category:Freeside:1.9:Documentation:Template|Templates]] used and their fill in variables.
  
= Known Issues =
+
= Developer's Guide =
  
* Bad RT links under Configuraiton -> Ticketing -> Ticketing Global?  Make sure the URL section in <code>/opt/rt3/etc/RT_SiteConfig.pm</code> is new-style:
+
* [[Freeside:2.1:Documentation:Developer|Developer's Guide]]
<pre>
 
$RT::URI::freeside::URL = 'https://your/freeside/URL/';
 
  
$RT::URI::freeside::URL =~ m(^(https?://[^/]+)(/.*)$)i;
+
= Accounting Guide =
Set($WebBaseURL, $1);
 
Set($WebPath, "$2/rt");
 
</pre>
 
  
* Ancient Firefox v2.x may have performance problems rendering RT?  (who cares?)
+
*[[Freeside:Documentation:Accounting|Accounting Guide]]
  
 
= Misc =
 
= Misc =
  
* Is it necessary to create an fs_bootstrap user??
+
* [[Freeside:Documentation:FAQ|Frequently Asked Questions]]
 +
* [[3rd_party_software|Third-party software]]
 +
* [[Freeside:2.1:Documentation:Administration:VoIP:Timed_Rates|New feature: Timed Rates]]
 +
* [[Freeside:2.1:Documentation:Administration:RT_Workflow|RT workflow features]]
 +
* [[Freeside:2.1:Documentation:Administration:Tips_and_Tricks|Tips and Tricks]]
 +
 
 +
* [[Freeside:1.9:Documentation|Version 1.9 documentation]] (previous maintenance version)
 +
* [[Freeside:2.3:Documentation|Version 2.3 documentation]] (upcoming development version)
 +
 
 +
= Changelog =
 +
 
 +
* [[Freeside:2.1:Changelog|2.1 Changelog]]
 +
* [[Freeside:2.1.1:Changelog|2.1.1 Changelog]]
 +
* [[Freeside:2.1.2:Changelog|2.1.2 Changelog]]
 +
* [[Freeside:2.1.3:Changelog|2.1.3 Changelog]]

Latest revision as of 08:11, 6 May 2011

Note

Some documentation links point to the 1.9 documentation until things are fully moved over. The information should still be applicable.

Installation and upgrades

Backend Installation

Signup and Self-service installation

Distributor guides

Upgrading

User's Guide

Administrator's Guide

Developer's Guide

Accounting Guide

Misc

Changelog