Difference between revisions of "Freeside:4:Documentation:Upgrading"

From Freeside
Jump to: navigation, search
Line 5: Line 5:
 
Note that unlike most major version upgrades, a minimum version of 3.3 is needed before upgrading to 4.x.  If running an earlier version, upgrade to 3.3 or later before upgrading to 4.x.
 
Note that unlike most major version upgrades, a minimum version of 3.3 is needed before upgrading to 4.x.  If running an earlier version, upgrade to 3.3 or later before upgrading to 4.x.
  
 +
= Upgrade instructions =
 +
 +
== Preqrequisites ==
 +
 +
=== Debian ===
 +
 +
aptitude install libhtml-formattext-withlinks-perl libemail-address-list-perl libsymbol-global-name-perl libdate-extract-perl libcgi-emulate-psgi-perl libplack-perl librole-basic-perl libhtml-formattext-withlinks-andtables-perl libcrypt-x509-perl libdata-guid-perl libencode-perl starlet
 +
 +
=== Other distributions ===
 +
 +
Install the appropriate Perl modules as indicated above.
 +
 +
== Initial cleanup ==
 +
 +
* rm -r /opt/rt3/lib
 +
== Freeside ==
 +
 +
* <code>cd freeside-4.0</code>
 +
 +
* <code>make clean; make configure-rt; make install-perl-modules</code>
 +
* As the freeside UNIX user, run <code>freeside-upgrade username</code>, passing the username of an internal Freeside user.
 +
* If freeside-upgrade hangs, try stopping Apache, all Freeside processes, and anything else connected to your database, especially on older PostgreSQL versions.
 +
 +
== RT ==
 +
 +
* As the freeside UNIX user, run <code>/opt/rt3/sbin/rt-setup-database --dba freeside --prompt-for-dba-password --action upgrade</code>
 +
 +
= Post-upgrade configuration =
 
Doing real-time electronic check transactions?  After the upgrade, double check your billing events to make sure the upgrade didn't add a duplicate "Run card or check with a Business::OnlinePayment realtime gateway"
 
Doing real-time electronic check transactions?  After the upgrade, double check your billing events to make sure the upgrade didn't add a duplicate "Run card or check with a Business::OnlinePayment realtime gateway"

Revision as of 23:37, 9 July 2015

Notes

Start of 3.x to 4.x upgrade instructions.

Note that unlike most major version upgrades, a minimum version of 3.3 is needed before upgrading to 4.x. If running an earlier version, upgrade to 3.3 or later before upgrading to 4.x.

Upgrade instructions

Preqrequisites

Debian

aptitude install libhtml-formattext-withlinks-perl libemail-address-list-perl libsymbol-global-name-perl libdate-extract-perl libcgi-emulate-psgi-perl libplack-perl librole-basic-perl libhtml-formattext-withlinks-andtables-perl libcrypt-x509-perl libdata-guid-perl libencode-perl starlet

Other distributions

Install the appropriate Perl modules as indicated above.

Initial cleanup

  • rm -r /opt/rt3/lib

Freeside

  • cd freeside-4.0
  • make clean; make configure-rt; make install-perl-modules
  • As the freeside UNIX user, run freeside-upgrade username, passing the username of an internal Freeside user.
  • If freeside-upgrade hangs, try stopping Apache, all Freeside processes, and anything else connected to your database, especially on older PostgreSQL versions.

RT

  • As the freeside UNIX user, run /opt/rt3/sbin/rt-setup-database --dba freeside --prompt-for-dba-password --action upgrade

Post-upgrade configuration

Doing real-time electronic check transactions? After the upgrade, double check your billing events to make sure the upgrade didn't add a duplicate "Run card or check with a Business::OnlinePayment realtime gateway"