update.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
   2 <html><head>
   3         <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-2">
   4
   5         <title>FrontAccounting Update</title><meta name="GENERATOR" content="OpenOffice.org 2.4  (Linux)">
   6         <meta name="CREATED" content="0;0">
   7         <meta name="CHANGED" content="20100902;19041400"></head>
   8 <body dir="ltr" lang="en-US">
   9 <p style="margin-bottom: 0cm;"><strong><font color="#cc6600"><font style="font-size: 20pt;" size="5"><i>Front</i></font></font></strong><strong><font style="font-size: 20pt;" size="5">Accounting
  10 Update</font></strong></p>
  11 <h2>Important Notes for release 2.3.5.</h2>Change in the behaviour of <span style="font-weight: bold; font-style: italic;">Recurrent Invoices</span>.<br><ul><li>Now
  12 the Last Sent day is stamped with the former Last Sent (or Begin date
  13 the first time) + months + days. Before the Last Sent day was stamped
  14 with tthe creation date (today). The Invoice date is still todays date.
  15 </li><li>If you for some reason want to make a pause in the recurrent
  16 invoices, you can now edit the Last Sent day in the Management section
  17 of Sales tab.</li><li>Before the days value, together with a month
  18 value, decided which day in the month the invoice was due.. &nbsp;This
  19 does not&nbsp;work now. You can&nbsp;change the day in the month you
  20 want the recurrency to happen by setting the Last Sent day with the new
  21 day in the Management section.&nbsp;</li><li>If you create a new Recurrent Invoice the Beginning date can be set to the day in the month you want the recurrencies to be due.</li></ul>
  22 <h2>Important Notes</h2>
  23 <p>Upgrade process can be done only by administrator of the first
  24 company created during FrontAccounting installation. This person is
  25 considered as a site admin who have granted access to potentially
  26 dangerous setup options, like Setup/Software Upgrade.</p>
  27 <p>In the following description sections related to older FA versions are
  28 prefixed with <span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[color tags]</span><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">
  29 . Y</span>ou can skip tagged fragment safely if currently FA
  30 application is newer than the version in tag.</p>
  31 <p>Upgrade process consists of up to four stages, some of them are
  32 optional:</p>
  33 <ol>
  34         <li><p>Application source files update
  35         </p>
  36         </li><li><p>Database upgrade &#8211; this step is needed only during
  37         upgrade which involves change in major application version number
  38         (e.g. from 2.2.x to 2.3.x), and sometimes during upgrade from beta
  39         release to stable version. Otherwise this step can be skipped.</p>
  40         </li><li><p>Final cleanup &#8211; is needed when some old source files,
  41         obsoleted by new release should be removed.</p>
  42         </li><li><p>New features configuration &#8211; this is optional step
  43         needed for most major releases and some minor ones.
  44         </p>
  45 </li></ol>
  46 <p style="margin-bottom: 0cm;">Before starting upgrade ensure nobody
  47 is using the application and make database backup for all companies.
  48 To be on safe side backup also old source files, especially those
  49 locally customized (if any).</p>
  50 <p>Log into admin account of first company.<strong> </strong><strong><span style="">If
  51 you use a theme other than the standard 3 (aqua, cool or default),
  52 switch to one of these before going further.</span></strong></p>
  53 <h2><strong><b>1. Application files update</b></strong></h2>
  54 <p style="margin-top: 0.42cm; page-break-after: avoid;"><font face="Liberation Sans, sans-serif"><font size="4"><strong><span style="">a. Source
  55 files update</span></strong></font></font></p>
  56 <p><strong><span style="">Extract distribution
  57 zip/tar.gz file in empty directory, and copy all the files to your
  58 FrontAccounting directory overwriting old files. If it is major
  59 release upgrade you can skip next step and go directly to cleanup.</span></strong></p>
  60 <p style="margin-top: 0.42cm; page-break-after: avoid;"><strong><font face="Liberation Sans, sans-serif"><font size="4"><span style="">b. Configuration
  61 files update</span></font></font></strong></p>
  62 <p><strong><span style="">Compare new
  63 </span></strong><strong><i><b>config.default.php</b></i></strong><strong>
  64 </strong><strong><span style="">file with the old
  65 </span></strong><strong><i><b>config.php </b></i></strong><strong><span style="font-style: normal;"><span style="">and
  66 add all n</span></span></strong><strong><span style="">ew
  67 settings (if any). </span></strong>
  68 </p>
  69 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  70 2.2beta]</span></span></strong></p>
  71 <p><strong> <span style="">$show_users_online = 0;</span></strong></p>
  72 <p><strong> <span style="">$def_print_destination
  73 = 0;</span></strong></p>
  74 <p><strong><span style="">$dflt_date_fmt=0;</span></strong></p>
  75 <p><strong><span style="">$dflt_date_sep=0;</span></strong></p>
  76 <p><strong><span style="">$table_style,table_style2
  77 changed</span></strong></p>
  78 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  79 2.3beta]</span></span></strong></p>
  80 <p><strong> <span style="">$alternative_tax_include_on_doc=0;</span></strong></p>
  81 <p><strong><span style="">$suppress_tax_rates = 0;</span></strong></p>
  82 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  83 2.3RC1]</span></span></strong><strong> </strong>
  84 </p>
  85 <p><strong><span style="">Application version
  86 information and a couple of other private FA variables are stored in
  87 </span></strong><strong><i><b>version.php</b></i></strong><strong>
  88 </strong><strong><span style="">file. The
  89 application version displayed in footer is defined in $version
  90 variable unless this is set in config.php file. If you want current
  91 release version to be displayed on every FA update just remove or
  92 comment out $version variable in </span></strong><strong><span style="font-style: normal;"><span style="">config.php</span></span></strong><strong><span style="">.</span></strong></p>
  93 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  94 2.3RC2]</span></span></strong></p>
  95 <p><strong> <span style="">$save_report_selections &nbsp;= 0; &nbsp;// A value &gt; 0 means days to save the report selections.</span></strong></p><p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  96 2.3]</span></span></strong></p><p><strong> <span style="">$save_po_item_codes &nbsp;= 0; &nbsp;//&nbsp; show item codes on purchase order&nbsp;</span></strong></p><p><strong><span style="">$def_print_destination = 0; // &nbsp;default print destination. 0 = PDF/Printer, 1 = Excel</span></strong></p><p><strong><span style="">$alternative_tax_include_on_docs = 0; // &nbsp;1 = print Subtotal tax excluded, tax and Total tax included</span></strong></p><p><strong><span style="">$suppress_tax_rates = 0; // &nbsp;suppress tax rates on documents. 0 = no, 1 = yes.</span></strong></p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;"></span></span></strong>
  97
  98 <strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;"></span></span></strong><h2><strong><b>2. Database upgrade</b></strong></h2>
  99 <p><strong><span style="">This step can be skipped
 100 for small version updates i.e. when you have already installed
 101 FrontAccounting version 2.3.1 or later. Before database upgrade is
 102 done on all company databases backup file is created automatically to
 103 enable database restore after failure.</span></strong></p>
 104 <p><strong><span style="">After major version
 105 upgrade overwriting files in first step makes the system unaccessible
 106 for all users but site admin, who have to run upgrade procedures to
 107 update all company databases to the new version provided with the
 108 release. After logging to administrator account of first installed
 109 company go directly to Setup/Software Upgrade screen, mark all
 110 subsequent 'Install' checkboxes and press 'Upgrade System'.</span></strong></p>
 111 <p style="">If something goes wrong during
 112 upgrade, you can eventually try forced upgrade option. Forced upgrade
 113 ignores some smaller errors which can arise during upgrade due to
 114 some exotic database configuration. This is depreciated option, so
 115 first read error messages if any, try to fix signalized problems,
 116 restore databases from backup and retry normal installation. To run
 117 upgrade in forced mode check box 'Force Upgrade', and press 'Upgrade
 118 System' again.</p>
 119 <h2>3. Final cleanup</h2>
 120 <p>Remove or rename install folder in main FrontAccounting directory.
 121 </p>
 122 <p>After upgrade is installed you can remove files obsoleted by new
 123 FrontAccounting version. Also old, unused settings <span style="font-style: normal;"><span style="">can
 124 be removed from  </span></span><i><b>config.php</b></i><span style="font-style: normal;"><span style="">
 125 file.</span></span></p>
 126 <p style="margin-top: 0.42cm; page-break-after: avoid;"><font face="Liberation Sans, sans-serif"><font size="4">a.
 127 Source files cleanup</font></font></p>
 128 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
 129 2.2beta]</span></span></strong></p>
 130 <p><strong><span style=""><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">/includes/reserved.inc
 131 &#8211; removed.</span></span></strong></p>
 132 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
 133 2.1]</span></span></strong><strong> </strong>
 134 </p>
 135 <p><strong><span style="">/admin/db/v_banktrans.inc
 136 - removed</span></strong></p>
 137 <p style="margin-top: 0.42cm; page-break-after: avoid;"><font face="Liberation Sans, sans-serif"><font size="4"><span style="font-style: normal;"><span style="">b.
 138 Config.php cleanup </span></span></font></font>
 139 </p>
 140 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
 141 2.2RC1]</span></span></strong><strong> </strong>
 142 </p>
 143 <p><strong><span style="">$security_headings,
 144 $security_groups arrays &#8211; moved to database (see Access Setup)
 145 </span></strong>
 146 </p>
 147 <p><strong><span style="">$def_app &#8211; moved
 148 to user configuration in database.</span></strong></p>
 149 <p><strong><span style="font-style: normal;"><span style="">$version
 150 &#8211; moved to </span></span></strong><strong><i><b>version.php</b></i></strong><strong><span style="font-style: normal;"><span style="">
 151 file. Remove</span></span></strong></p>
 152 <h2>4. New features configuration</h2>
 153 <p>During upgrade process new features are initialized to default
 154 status, and sometimes old settings are also changed to conform with
 155 new security policy. This automatic process is designed to be as
 156 neutral for end users as possible, however sometimes site or company
 157 admin intervention can be necessary to set thing after changes to
 158 their best state. Below you will find description of new settings
 159 available after upgrade.</p>
 160 <p><br><br>
 161 </p>
 162 <p>----------------------</p>
 163 <ul></ul>
 164 </body></html>