Upgrading to 1.5.8

From: ivan Date: Wed, 8 Feb 2006 03:50:42 +0000 (+0000) Subject: slightly html-ize the 1.5.8 upgrade instructions X-Git-Tag: BEFORE_RT_3_4_5^2~206 X-Git-Url: http://git.freeside.biz/gitweb/?a=commitdiff_plain;h=4c9e6e4863e2045d984933ab0e229b5dd500e1f7;p=freeside.git slightly html-ize the 1.5.8 upgrade instructions --- diff --git a/httemplate/docs/index.html b/httemplate/docs/index.html index 7254d76f3..bec62e34a 100644 --- a/httemplate/docs/index.html +++ b/httemplate/docs/index.html @@ -8,11 +8,9 @@
Configuration and setup

-this is incomplete
-
-NOTE: Version numbering has been simplified.  1.5.7 is the version after
-1.5.0pre6.  It is still a development version - releases with odd numbered 
-middle parts (NN in x.NN.x) are development versions, like Perl or Linux.
-
-If migrating from 1.5.7, see README.1.5.8 instead
-
-If migrating from 1.5.0pre6, see README.1.5.7 instead
-
-install DBD::Pg 1.32, 1.41 or later (not 1.40) (or, if you're using a Perl version before 5.6, you could try installing DBD::Pg 1.22 with this patch and commenting out the "use DBD::Pg 1.32" at the top of DBIx/DBSchema/DBD/Pg.pm)
-install DBIx::DBSchema 0.27 (or later)
-  (if you are running Pg version 7.2.x or earlier, install at least
-   DBIx::DBSchema 0.29)
-install Net::SSH 0.08
-install HTML::Widgets::SelectLayers 0.05
-install Business::CreditCard 0.28
-
-- If using Apache::ASP, add PerlSetVar RequestBinaryRead Off and PerlSetVar IncludesDir /your/freeside/document/root/ to your Apache configuration and make sure you are using Apache::ASP minimum version 2.55.
-- In httpd.conf, change <Files ~ \.cgi> to  <Files ~ (\.cgi|\.html)>
-- In httpd.conf, change AddHandler perl-script .cgi or SetHandler perl-script to AddHandler perl-script .cgi .html
-
-install NetAddr::IP, Chart::Base, Locale::SubCountry, Text::CSV_XS, 
+
+  Upgrading to 1.5.8
+
+
+Upgrading to 1.5.8 from 1.4.1 or 1.4.2
+
+Note: Version numbering has been simplified.  1.5.7 and 1.5.8 are the
+versions following 1.5.0pre6.  They are still development versions - releases
+with odd numbered middle parts (NN in x.NN.x) are development versions, like
+Perl or Linux.
+
+
+

+
+
+  If migrating from 1.5.0pre6, see README.1.5.7 instead
+  
If migrating from 1.5.7, see README.1.5.8 instead
+  
 install DBD::Pg 1.32, 1.41 or later (not 1.40) (or, if you're using a Perl version before 5.6, you could try installing DBD::Pg 1.22 with this patch and commenting out the "use DBD::Pg 1.32" at the top of DBIx/DBSchema/DBD/Pg.pm)
+  
 install DBIx::DBSchema 0.27 (or later) (if you are running Pg version 7.2.x or earlier, install at least DBIx::DBSchema 0.29)
+  
 install Net::SSH 0.08 or later
+  
 install HTML::Widgets::SelectLayers 0.05 or later
+  
 install Business::CreditCard 0.28 or later
+
+  
If using Apache::ASP, add PerlSetVar RequestBinaryRead Off and PerlSetVar IncludesDir /your/freeside/document/root/ to your Apache configuration and make sure you are using Apache::ASP minimum version 2.55.
+    
+      In httpd.conf, change <Files ~ \.cgi> to  <Files ~ (\.cgi|\.html)>
+      
In httpd.conf, change AddHandler perl-script .cgi or SetHandler perl-script to AddHandler perl-script .cgi .html
+    
+  
install NetAddr::IP, Chart::Base, Locale::SubCountry, Text::CSV_XS, 
 Spreadsheet::WriteExcel, IO-stringy (IO::Scalar), Frontier::RPC
 (Frontier::RPC2), MIME::Entity (MIME-tools), IPC::Run3, Net::Whois::Raw,
 JSON and Term::ReadKey
 
 
+  
Apply the following changes to your database:
+ INSERT INTO msgcat ( msgnum, msgcode, locale, msg ) VALUES ( 20, 'svc_external-id', 'en_US', 'External ID' );
 INSERT INTO msgcat ( msgnum, msgcode, locale, msg ) VALUES ( 21, 'svc_external-title', 'en_US', 'Title' );
 
 DROP INDEX cust_bill_pkg1;
+
 
-On recent Pg versions:
-
+  
On recent Pg versions:
+ ALTER TABLE cust_main ALTER COLUMN payinfo varchar(512) NULL;
 ALTER TABLE h_cust_main ALTER COLUMN payinfo varchar(512) NULL;
+
+On older Pg versions that don't support altering columns directly, you will need to dump the database, edit the schema definitions in the dump file, and reload.
 
-Or on older Pg versions that don't support altering columns directly:
-(dump database, edit & reload)
-
-On recent Pg versions:
-
+  
On recent Pg versions:
+ ALTER TABLE svc_forward ALTER COLUMN srcsvc DROP NOT NULL;
 ALTER TABLE h_svc_forward ALTER COLUMN srcsvc DROP NOT NULL;
 ALTER TABLE svc_forward ALTER COLUMN dstsvc DROP NOT NULL;
 ALTER TABLE h_svc_forward ALTER COLUMN dstsvc DROP NOT NULL;
 ALTER TABLE cust_main ALTER COLUMN zip DROP NOT NULL;
 ALTER TABLE h_cust_main ALTER COLUMN zip DROP NOT NULL;
-
+
 Or on Pg versions that don't support DROP NOT NULL (tested on 7.1 and 7.2 so far):
+ UPDATE pg_attribute SET attnotnull = FALSE WHERE ( attname = 'srcsvc' OR attname = 'dstsvc' ) AND ( attrelid = ( SELECT oid FROM pg_class WHERE relname = 'svc_forward' ) OR attrelid = ( SELECT oid FROM pg_class WHERE relname = 'h_svc_forward' ) );
 UPDATE pg_attribute SET attnotnull = FALSE WHERE ( attname = 'zip' ) AND ( attrelid = ( SELECT oid FROM pg_class WHERE relname = 'cust_main' ) OR attrelid = ( SELECT oid FROM pg_class WHERE relname = 'h_cust_main' ) );
+
 
-If you created your database with a version before 1.4.2, dump database, edit:
-- cust_main and h_cust_main: increase otaker from 8 to 32
-- cust_main and h_cust_main: change ss from char(11) to varchar(11) ( "character(11)" to "character varying(11)" )
-- cust_credit and h_cust_credit: increase otaker from 8 to 32
-- cust_pkg and h_cust_pkg: increase otaker from 8 to 32
-- cust_refund and h_cust_refund: increase otaker from 8 to 32
-- domain_record and h_domain_record: increase reczone from 80 to 255
-- domain_record and h_domain_record: change rectype from char to varchar ( "character(5)" to "character varying(5)" )
-- domain_record and h_domain_record: increase recdata from 80 to 255
-then reload
-
-mandatory again:
-
-make install-perl-modules to install the new libraries and CLI utilities
-run "freeside-upgrade username" to create the remaining new tables and columns
-
-optionally:
-
+  
 If you created your database with a version before 1.4.2, dump database, edit the following, then reload:
+    
+      cust_main and h_cust_main: increase otaker from 8 to 32
+      
cust_main and h_cust_main: change ss from char(11) to varchar(11) ( "character(11)" to "character varying(11)" )
+      
cust_credit and h_cust_credit: increase otaker from 8 to 32
+      
cust_pkg and h_cust_pkg: increase otaker from 8 to 32
+      
cust_refund and h_cust_refund: increase otaker from 8 to 32
+      
domain_record and h_domain_record: increase reczone from 80 to 255
+      
domain_record and h_domain_record: change rectype from char to varchar ( "character(5)" to "character varying(5)" )
+      
domain_record and h_domain_record: increase recdata from 80 to 255
+    
+
+
make install-perl-modules to install the new libraries and CLI utilities
+
run "freeside-upgrade username" to create the remaining new tables and columns
+
+
optionally:
+ CREATE INDEX cust_main4 ON cust_main ( daytime );
 CREATE INDEX cust_main5 ON cust_main ( night );
 CREATE INDEX cust_main6 ON cust_main ( fax );
@@ -89,5 +99,9 @@ CREATE INDEX cust_pay4 ON cust_pay (_date);
 CREATE INDEX part_referral1 ON part_referral ( disabled );
 CREATE INDEX part_pkg2 ON part_pkg ( promo_code );
 CREATE INDEX h_part_pkg2 ON h_part_pkg ( promo_code );
-
 
+
+
+
+
+