import rt 2.0.14
[freeside.git] / httemplate / docs / upgrade6.html
1 <head>
2   <title>Upgrading to 1.3.0</title>
3 </head>
4 <body>
5 <h1>Upgrading to 1.3.0 from 1.2.3</h1>
6 <ul>
7   <li>If migrating from 1.0.0, see these <a href="upgrade.html">instructions</a> first.
8   <li>If migrating from less than 1.1.4, see these <a href="upgrade2.html">instructions</a> first.
9   <li>If migrating from less than 1.2.0, see these <a href="upgrade3.html">instructions</a> first.
10   <li>If migrating from less than 1.2.2, see these <a href="upgrade4.html">instructions</a> first.
11   <li>If migrating from less than 1.2.3, see these <a href="upgrade5.html">instructions</a> first.
12   <li>Back up your data and current Freeside installation.
13   <li>As 1.3.0 requires transactions, <b>MySQL's default <a href="http://www.mysql.com/doc/M/y/MyISAM.html">MyISAM</a> and <a href="http://www.mysql.com/doc/I/S/ISAM.html">ISAM</a> table types are no longer supported</b>.  Converting to <a href="http://www.postgresql.org/">PostgreSQL</a> is recommended.  If you really want to use MySQL, convert your tables to one of the <a href="http://www.mysql.com/doc/T/a/Table_types.html">transaction-safe table types</a> such as <a href="http://www.mysql.com/doc/B/D/BDB.html">BDB</a>.
14   <li>Copy the <i>invoice_template</i> file from the <i>conf/</i> directory in the distribution to your <a href="config.html">configuration directory</a>.
15   <li>Install the <a href="http://search.cpan.org/search?dist=Text-Template">Text-Template</a>, <a href="http://search.cpan.org/search?dist=DBIx-DBSchema">DBIx-DBSchema</a>, <a href="http://search.cpan.org/search?dist=Net-SSH">Net-SSH</a>, <a href="http://search.cpan.org/search?dist=String-ShellQuote">String-ShellQuote</a> and <a href="http://search.cpan.org/search?dist=Net-SCP">Net-SCP</a> Perl modules.
16   <li>Apply the following changes to your database:
17 <pre>
18 CREATE TABLE domain_record (
19   recnum int NOT NULL,
20   svcnum int NOT NULL,
21   reczone varchar(80) NOT NULL,
22   recaf char(2) NOT NULL,
23   rectype char(5) NOT NULL,
24   recdata varchar(80) NOT NULL,
25   PRIMARY KEY (recnum)
26 );
27 CREATE TABLE svc_www (
28   svcnum int NOT NULL,
29   recnum int NOT NULL,
30   usersvc int NOT NULL,
31   PRIMARY KEY (svcnum)
32 );
33 ALTER TABLE part_svc ADD svc_www__recnum varchar(80) NULL;
34 ALTER TABLE part_svc ADD svc_www__recnum_flag char(1) NULL;
35 ALTER TABLE part_svc ADD svc_www__usersvc varchar(80) NULL;
36 ALTER TABLE part_svc ADD svc_www__uesrsvc_flag char(1) NULL;
37 ALTER TABLE svc_acct CHANGE _password _password varchar(50) NULL;
38 ALTER TABLE svc_acct ADD seconds integer NULL;
39 ALTER TABLE part_svc ADD svc_acct__seconds integer NULL;
40 ALTER TABLE part_svc ADD svc_acct__seconds_flag char(1) NULL;
41 ALTER TABLE prepay_credit ADD seconds integer NULL;
42
43 </pre>
44   <li>If your database supports dropping columns:
45 <pre>
46 ALTER TABLE cust_bill DROP owed;
47 ALTER TABLE cust_credit DROP credited;
48 </pre>
49      Or, if your database does not support dropping columns, you can do this:
50 <pre>
51 ALTER TABLE cust_bill CHANGE owed depriciated decimal(10,2);
52 ALTER TABLE cust_credit CHANGE credited depriciated2 decimal(10,2);
53 </pre>
54
55   <li>Copy or symlink htdocs to the new copy.
56   <li>Remove the symlink or directory <i>(your_site_perl_directory)</i>/FS.
57   <li>Change to the FS directory in the new tarball, and build and install the
58       Perl modules:
59     <pre>
60 $ cd FS/
61 $ perl Makefile.PL
62 $ make
63 $ su
64 # make install</pre>
65   <li>Run bin/dbdef-create.
66 </body>