2 <title>Upgrading to 1.4.0</title>
5 <h1>Upgrading to 1.4.0 from 1.3.1</h1>
7 <li>If migrating from less than 1.3.1, see these <a href="upgrade7.html">instructions</a> first.
8 <li>Back up your data and current Freeside installation.
9 <li>Install <a href="http://www.apache-asp.org/">Apache::ASP</a> or <a href="http://www.masonhq.com/">HTML::Mason</a>.
13 <th>Apache::ASP</th><th>Mason</th>
17 <li>Run <tt>make aspdocs</tt>
18 <li>Copy <tt>aspdocs/</tt> to your web server's document space.
19 <li>Create a <a href="http://www.apache-asp.org/config.html#Global">Global</a> directory, such as <tt>/usr/local/etc/freeside/asp-global/</tt>
20 <li>Copy <tt>htetc/global.asa</tt> to the Global directory.
21 <li>Configure Apache for the Global directory and to execute .cgi files using Apache::ASP. For example:
23 <Directory /usr/local/apache/htdocs/freeside-asp>
24 <Files ~ (\.cgi)>
25 AddHandler perl-script .cgi
26 PerlHandler Apache::ASP
29 $MLDBM::RemoveTaint = 1;
31 PerlSetVar Global /usr/local/etc/freeside/asp-global/
36 <li>Run <tt>make masondocs</tt>
37 <li>Copy <tt>masondocs/</tt> to your web server's document space.
38 <li>Copy <tt>htetc/handler.pl</tt> to your web server's configuration directory.
39 <li>Edit <tt>handler.pl</tt> and set an appropriate <tt>data_dir</tt>, such as <tt>/usr/local/etc/freeside/mason-data</tt>
40 <li>Configure Apache to use the <tt>handler.pl</tt> file and to execute .cgi files using HTML::Mason. For example:
42 <Directory /usr/local/apache/htdocs/freeside-mason>
43 <Files ~ (\.cgi)>
44 AddHandler perl-script .cgi
45 PerlHandler HTML::Mason
48 require "/usr/local/apache/conf/handler.pl";
56 <li>Change to the FS directory in the new tarball, and build and install the
63 # make install UNINST=1</pre>
64 <li>If you wish to enable service/shipping addresses, apply the following
65 changes to your database:
67 ALTER TABLE cust_main ADD COLUMN ship_last varchar(80) NULL;
68 ALTER TABLE cust_main ADD COLUMN ship_first varchar(80) NULL;
69 ALTER TABLE cust_main ADD COLUMN ship_company varchar(80) NULL;
70 ALTER TABLE cust_main ADD COLUMN ship_address1 varchar(80) NULL;
71 ALTER TABLE cust_main ADD COLUMN ship_address2 varchar(80) NULL;
72 ALTER TABLE cust_main ADD COLUMN ship_city varchar(80) NULL;
73 ALTER TABLE cust_main ADD COLUMN ship_county varchar(80) NULL;
74 ALTER TABLE cust_main ADD COLUMN ship_state varchar(80) NULL;
75 ALTER TABLE cust_main ADD COLUMN ship_zip varchar(10) NULL;
76 ALTER TABLE cust_main ADD COLUMN ship_country char(2) NULL;
77 ALTER TABLE cust_main ADD COLUMN ship_daytime varchar(20) NULL;
78 ALTER TABLE cust_main ADD COLUMN ship_night varchar(20) NULL;
79 ALTER TABLE cust_main ADD COLUMN ship_fax varchar(12) NULL;
81 <li>Run bin/dbdef-create.