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

From Freeside
Jump to: navigation, search
Line 27: Line 27:
 
* As the freeside UNIX user, run <code>freeside-upgrade username</code>, passing the username of an internal Freeside user.
 
* 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.
 
* If freeside-upgrade hangs, try stopping Apache, all Freeside processes, and anything else connected to your database, especially on older PostgreSQL versions.
 +
* <code>make install-docs</code>
  
 
== RT ==
 
== RT ==
  
* As the freeside UNIX user, run <code>/opt/rt3/sbin/rt-setup-database --dba freeside --prompt-for-dba-password --action upgrade</code>
+
* <code>make install-rt</code>
 +
* cd freeside-4.0/rt
 +
* As the root UNIX user, run <code>/opt/rt3/sbin/rt-setup-database --dba freeside --prompt-for-dba-password --action upgrade</code>
  
 
= Post-upgrade configuration =
 
= 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 22:55, 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.
  • make install-docs

RT

  • make install-rt
  • cd freeside-4.0/rt
  • As the root 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"