Revision as of 15:59, 13 September 2007

Upgrade instructions

Install HTML::Widgets::SelectLayers 0.07 (or later)
Install Authen::Passphrase
Install Net::Domain::TLD
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.
Run bin/freeside-migrate-events to migrate your (deprecated) invoice events to the new billing events. Keep an eye out for anything which does not migrate.
make configure-rt
make install-docs (or make deploy if you've got everything setup for that in the Makefile)
mv /opt/rt3/etc/RT_SiteConfig.pm /opt/rt3/etc/RT_SiteConfig.pm.OLD; make install-rt
Perl module errors? Try make clean then make install-perl-modules then make install-docs or make deploy again
New packages/modules for RT 3.6.4: libxml-rss-perl libcalendar-simple-perl libgd-graph-perl libuniversal-require-perl libgd-text-perl

RT "dashboard" has diappeared; needs something upgraded/inserted into the db?
(FIXED, except for agentnum handling? see nested item) action options don't get migrated automatically. this is bad. invoices will go out with wrong templates.
- agentnum needs special handling?

@@ Line 6: / Line 6: @@
 * 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.
-* Run <code>bin/freeside-migrate-events</code>
+* Run <code>bin/freeside-migrate-events</code> to migrate your (deprecated) invoice events to the new billing events.  Keep an eye out for anything which does not migrate.
 * <code>make configure-rt</code>
 * <code>make install-docs</code> (or <code>make deploy</code> if you've got everything setup for that in the Makefile)