update.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
   2 <html><head>
   3
   4 <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1"><title>FrontAccounting Update</title>
   5 <meta name="GENERATOR" content="OpenOffice.org 2.4 (Linux)">
   6 <meta name="CREATED" content="0;0">
   7 <meta name="CHANGED" content="20100902;19041400"></head><body style="direction: ltr;" lang="en-US">
   8 <h4><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
   9 Update</font></strong></h4>
  10 <h2>Important Notes for release 2.4.RC1.</h2>
  11 <h3>This is a preliminary FrontAccounting ERP 2.4 RC1 release. </h3>
  12 This version provides a couple of new important features (in addition to all the <br>
  13 features merged from latest 2.3.25 release), but main development effort was <br>
  14 focused on internal architecture changes and cleanups to make future FA development <br>
  15 easier. Please keep in mind the application in current Release Candidate 1 stage is only rougly<br>
  16 tested, so installation on production servers is not recommended yet. Until final <br>
  17 2.4.0 version both software API and database scheme are subject to smaller changes.<br>
  18 <br>
  19 At the time of release most of optional extension modules available from central<br>
  20 extensions repo has been also ported to 2.4 and should be mostly usable. Most Themes are<br>
  21 updated and many new Themes are available.<br>
  22 <br>
  23 Due to deep changes made under the hood, we highly encourage all current FA 2.3 users<br>
  24 to make test upgrades on a copy of your working installation connected to separate database<br>
  25 filled with your real company data. This will allow us find and fix any possible<br>
  26 upgrade issues before final 2.4 release. Please report any bugs/problems found via our <br>
  27 Mantis Bugtracker at http://mantis.frontaccounting.com.<br>
  28 <h3>Download instructions</h3>
  29 In Sourceforge FrontAccounting (http://sourceforge.net/projects/frontaccounting), select <br>
  30 Files -&gt; FrontAccounting 2.4 -&gt;2.4.RC1.<br>
  31 <br>
  32 For Windows users select the zip file. For all other users select the tar.gz file.<br>
  33 <h3>Notice for certain Windows wamp servers.</h3>
  34 Due to experienced long upgrade time for release 2.3 databases to release 2.4 on certain wamp <br>
  35 servers, we just ask you to be patience. It might take a while, but should&nbsp; end successfully. <br>
  36 <h4>New global flags in config.php (config-default.php):</h4>
  37 /* Optional popup search enabled if this is true. $max_rows_in_search = 10 <br>
  38
  39 &nbsp;&nbsp;&nbsp; is used for maximum rows in search */<br>
  40
  41 <span style="font-weight: bold;">$use_popup_search = true;</span><br>
  42
  43 <span style="font-weight: bold;">$max_rows_in_search = 10;</span><br>
  44
  45 <h2>Important Notes for release 2.3.22.</h2>
  46
  47
  48
  49
  50 <h4>New global flags in config.php (config-default.php):</h4>
  51 /* Show average costed values instead of fixed standard cost */ In Enventory Valuation Report.<br>
  52 <span style="font-weight: bold;">$use_costed_values = 0;</span><br>
  53 <br>
  54 /* Print Item Images on Sales Quotations. Set to 1 if so. */<br>
  55 <span style="font-weight: bold;">$print_item_images_on_quote = 0;</span><br>
  56 <h2>Important Notes for release 2.3.21.</h2>
  57
  58 <h4>Crucial security patches:</h4>
  59
  60 This version consists of crucial security patches and this applies especially to all publicly available servers, <br>
  61 &nbsp;f.i. installations which are run in not fully trusted environment like public demos, shared accounts or SAAS.<br>
  62 <h4>New global flags in config.php (config-default.php):</h4>
  63 /* Whether to allow sending new password by e-mail */<br>
  64 <span style="font-weight: bold;">$allow_password_reset = false</span><h2>Important Notes for release 2.3.20.</h2>
  65
  66 <h4>Crucial security patches:</h4>
  67 This version consists of crucial security patches and all guest FA
  68 installations (I mean whenever FA is run in not fully trusted
  69 environment) should be updtaed.<br>
  70 <h2>Important Notes for release 2.3.17.</h2>
  71
  72 <h4>New global flags in config.php (config-default.php):</h4>
  73 /*<br>
  74 &nbsp;&nbsp;&nbsp; Choose Exchange Rate Provider<br>
  75 &nbsp;&nbsp;&nbsp; Default is ECB for backwards compatibility<br>
  76 */<br>
  77 <span style="font-weight: bold;">$xr_providers = array("ECB", "YAHOO", "GOOGLE", "BLOOMBERG");<br>
  78 $dflt_xr_provider = 0;<br>
  79 <br>
  80 </span>/*<br>
  81 &nbsp;&nbsp;&nbsp; Set to true when remote service is authoritative
  82 source of exchange rates, and can be stored automatically without<br>
  83 &nbsp;&nbsp;&nbsp; manual edition. Otherwise exrate is stored on first new currency transaction of the day.<br>
  84 */<br>
  85 <span style="font-weight: bold;">$xr_provider_authoritative = false;<br>
  86 </span><h2>Important Notes for release 2.3.16.</h2>
  87 <h4>New global flags in config.php (config-default.php):</h4><span style="font-weight: bold;">/*<br>&nbsp;&nbsp; </span>&nbsp;Optional sorting new sales documents lines according to item code<span style="font-weight: bold;"><br>*/<br>$sort_sales_items = false;<br><br>/*<br>&nbsp;&nbsp; &nbsp;</span>Trial Balance opening balance presentation option.<br>&nbsp;&nbsp; &nbsp;When set to true past years part of opening balance is cleared.<span style="font-weight: bold;"><br>*/<br>$clear_trial_balance_opening = false;</span><h2>Important Notes for release 2.3.14.</h2>
  88 <h4>New global flags in config.php (config-default.php):</h4>
  89 /* default print orientation. 0 = Portrait, 1 = Landscape */<br>
  90 &nbsp;&nbsp;&nbsp; <span style="font-weight: bold;">$def_print_orientation
  91 = 0;</span><br>
  92 <h2>Important Notes for release 2.3.13.</h2>
  93 <h4>New global flags in config.php (config-default.php):</h4>
  94 /* No check on edit conflicts. Maybe needed to be set to 1 in certains
  95 Windows Servers */<br>
  96 &nbsp;&nbsp;&nbsp; <span style="font-weight: bold;">$no_check_edit_conflicts
  97 = 0;</span><br>
  98 <h2>Important Notes for release 2.3.12.</h2>
  99 <h4>New global flags in config.php (config-default.php):</h4>
 100 /* <br>
 101 &nbsp;&nbsp;&nbsp; Display a dropdown select box for
 102 choosing Company to login if false.<br>
 103 &nbsp;&nbsp;&nbsp; Show a blank editbox only if true where
 104 the Company NickName<br>
 105 &nbsp;&nbsp;&nbsp; will have to be manually entered. This
 106 is when privacy is needed.<br>
 107 */<br>
 108 &nbsp; &nbsp; <span style="font-weight: bold;">$text_company_selection</span>&nbsp;
 109 = false;<br>
 110 <br>
 111 /*&nbsp; Should FA hide menu items (Applications, Modules, and
 112 Actions) from the user if they don't have access to them? <br>
 113 &nbsp;&nbsp;&nbsp; 0 for
 114 no&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 1 for yes<br>
 115 */<br>
 116 <br>
 117 &nbsp;&nbsp;&nbsp; <span style="font-weight: bold;">$hide_inaccessible_menu_items</span>
 118 = 0;<br>
 119 <br>
 120 /*<br>
 121 &nbsp;&nbsp;&nbsp; Brute force prevention.<br>
 122 &nbsp;&nbsp;&nbsp; $login_delay seconds delay is required
 123 between login attempts after $login_max_attemps failed logins.<br>
 124 &nbsp;&nbsp;&nbsp; Set $login_delay to 0 to disable the
 125 feature (not recommended)<br>
 126 */<br>
 127 &nbsp; &nbsp; <span style="font-weight: bold;">$login_delay</span>
 128 = 30;<br>
 129 &nbsp; &nbsp; <span style="font-weight: bold;">$login_max_attempts</span>
 130 = 10;
 131 <h2><strong></strong>Important Notes for release
 132 2.3.5.</h2>
 133 Change in the behaviour of <span style="font-weight: bold; font-style: italic;">Recurrent
 134 Invoices</span>.<br>
 135 <ul>
 136 <li>Now
 137 the Last Sent day is stamped with the former Last Sent (or Begin date
 138 the first time) + months + days. Before the Last Sent day was stamped
 139 with tthe creation date (today). The Invoice date is still todays date.
 140 </li>
 141 <li>If you for some reason want to make a pause in the
 142 recurrent
 143 invoices, you can now edit the Last Sent day in the Management section
 144 of Sales tab.</li>
 145 <li>Before the days value, together with a month
 146 value, decided which day in the month the invoice was due..
 147 &nbsp;This
 148 does not&nbsp;work now. You can&nbsp;change the day in the
 149 month you
 150 want the recurrency to happen by setting the Last Sent day with the new
 151 day in the Management section.&nbsp;</li>
 152 <li>If you create a new Recurrent Invoice the Beginning date
 153 can be set to the day in the month you want the recurrencies to be due.</li>
 154 </ul>
 155 <h2>Important Notes</h2>
 156 <p>Upgrade process can be done only by administrator of the first
 157 company created during FrontAccounting installation. This person is
 158 considered as a site admin who have granted access to potentially
 159 dangerous setup options, like Setup/Software Upgrade.</p>
 160 <p>In the following description sections related to older FA
 161 versions are
 162 prefixed with <span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[color
 163 tags]</span><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
 164 . Y</span>ou can skip tagged fragment safely if currently FA
 165 application is newer than the version in tag.</p>
 166 <p>Upgrade process consists of up to four stages, some of them
 167 are
 168 optional:</p>
 169 <ol>
 170 <li>
 171 <p>Application source files update </p>
 172 </li>
 173 <li>
 174 <p>Database upgrade &#8211; this step is needed only during upgrade
 175 which involves change in major application version number (e.g. from
 176 2.2.x to 2.3.x), and sometimes during upgrade from beta release to
 177 stable version. Otherwise this step can be skipped.</p>
 178 </li>
 179 <li>
 180 <p>Final cleanup &#8211; is needed when some old source files,
 181 obsoleted by new release should be removed.</p>
 182 </li>
 183 <li>
 184 <p>New features configuration &#8211; this is optional step needed
 185 for most major releases and some minor ones. </p>
 186 </li>
 187 </ol>
 188 <p style="margin-bottom: 0cm;">Before starting upgrade
 189 ensure nobody
 190 is using the application and make database backup for all companies.
 191 To be on safe side backup also old source files, especially those
 192 locally customized (if any).</p>
 193 <p>Log into admin account of first company.<strong> </strong><strong><span style="">If
 194 you use a theme other than the standard 3 (aqua, cool or default),
 195 switch to one of these before going further.</span></strong></p>
 196 <h2><strong><b>1. Application files update</b></strong></h2>
 197 <p style="margin-top: 0.42cm; page-break-after: avoid;"><font face="Liberation Sans, sans-serif"><font size="4"><strong><span style="">a. Source
 198 files update</span></strong></font></font></p>
 199 <p><strong><span style="">Extract distribution
 200 zip/tar.gz file in empty directory, and copy all the files to your
 201 FrontAccounting directory overwriting old files. If it is major
 202 release upgrade you can skip next step and go directly to cleanup.</span></strong></p>
 203 <p style="margin-top: 0.42cm; page-break-after: avoid;"><strong><font face="Liberation Sans, sans-serif"><font size="4"><span style="">b. Configuration
 204 files update</span></font></font></strong></p>
 205 <p><strong><span style="">Compare new
 206 </span></strong><strong><i><b>config.default.php</b></i></strong><strong>
 207 </strong><strong><span style="">file with the
 208 old
 209 </span></strong><strong><i><b>config.php </b></i></strong><strong><span style="font-style: normal;"><span style="">and
 210 add all n</span></span></strong><strong><span style="">ew
 211 settings (if any). </span></strong>
 212 </p>
 213 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 214 2.2beta]</span></span></strong></p>
 215 <p><strong> <span style="">$show_users_online
 216 = 0;</span></strong></p>
 217 <p><strong> <span style="">$def_print_destination
 218 = 0;</span></strong></p>
 219 <p><strong><span style="">$dflt_date_fmt=0;</span></strong></p>
 220 <p><strong><span style="">$dflt_date_sep=0;</span></strong></p>
 221 <p><strong><span style="">$table_style,table_style2
 222 changed</span></strong></p>
 223 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 224 2.3beta]</span></span></strong></p>
 225 <p><strong> <span style="">$alternative_tax_include_on_doc=0;</span></strong></p>
 226 <p><strong><span style="">$suppress_tax_rates
 227 = 0;</span></strong></p>
 228 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 229 2.3RC1]</span></span></strong><strong> </strong>
 230 </p>
 231 <p><strong><span style="">Application version
 232 information and a couple of other private FA variables are stored in
 233 </span></strong><strong><i><b>version.php</b></i></strong><strong>
 234 </strong><strong><span style="">file. The
 235 application version displayed in footer is defined in $version
 236 variable unless this is set in config.php file. If you want current
 237 release version to be displayed on every FA update just remove or
 238 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>
 239 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 240 2.3RC2]</span></span></strong></p>
 241 <p><strong> <span style="">$save_report_selections
 242 &nbsp;= 0; &nbsp;// A value &gt; 0 means days to save the
 243 report selections.</span></strong></p>
 244 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 245 2.3]</span></span></strong></p>
 246 <p><strong> <span style="">$save_po_item_codes
 247 &nbsp;= 0; &nbsp;//&nbsp; show item codes on purchase
 248 order&nbsp;</span></strong></p>
 249 <p><strong><span style="">$def_print_destination
 250 = 0; // &nbsp;default print destination. 0 = PDF/Printer, 1 = Excel</span></strong></p>
 251 <p><strong><span style="">$alternative_tax_include_on_docs
 252 = 0; // &nbsp;1 = print Subtotal tax excluded, tax and Total tax
 253 included</span></strong></p>
 254 <p><strong><span style="">$suppress_tax_rates
 255 = 0; // &nbsp;suppress tax rates on documents. 0 = no, 1 = yes.</span></strong></p>
 256 <strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;"></span></span></strong><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;"></span></span></strong>
 257 <h2><strong><b>2. Database upgrade</b></strong></h2>
 258 <p><strong><span style="">This step can be
 259 skipped
 260 for small version updates i.e. when you have already installed
 261 FrontAccounting version 2.3.1 or later. Before database upgrade is
 262 done on all company databases backup file is created automatically to
 263 enable database restore after failure.</span></strong></p>
 264 <p><strong><span style="">After major version
 265 upgrade overwriting files in first step makes the system unaccessible
 266 for all users but site admin, who have to run upgrade procedures to
 267 update all company databases to the new version provided with the
 268 release. After logging to administrator account of first installed
 269 company go directly to Setup/Software Upgrade screen, mark all
 270 subsequent 'Install' checkboxes and press 'Upgrade System'.</span></strong></p>
 271 <p style="">If something goes wrong during
 272 upgrade, you can eventually try forced upgrade option. Forced upgrade
 273 ignores some smaller errors which can arise during upgrade due to
 274 some exotic database configuration. This is depreciated option, so
 275 first read error messages if any, try to fix signalized problems,
 276 restore databases from backup and retry normal installation. To run
 277 upgrade in forced mode check box 'Force Upgrade', and press 'Upgrade
 278 System' again.</p>
 279 <h2>3. Final cleanup</h2>
 280 <p>Remove or rename install folder in main FrontAccounting
 281 directory.
 282 </p>
 283 <p>After upgrade is installed you can remove files obsoleted by
 284 new
 285 FrontAccounting version. Also old, unused settings <span style="font-style: normal;"><span style="">can
 286 be removed from </span></span><i><b>config.php</b></i><span style="font-style: normal;"><span style="">
 287 file.</span></span></p>
 288 <p style="margin-top: 0.42cm; page-break-after: avoid;"><font face="Liberation Sans, sans-serif"><font size="4">a.
 289 Source files cleanup</font></font></p>
 290 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 291 2.2beta]</span></span></strong></p>
 292 <p><strong><span style=""><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">/includes/reserved.inc
 293 &#8211; removed.</span></span></strong></p>
 294 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 295 2.1]</span></span></strong><strong> </strong>
 296 </p>
 297 <p><strong><span style="">/admin/db/v_banktrans.inc
 298 - removed</span></strong></p>
 299 <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.
 300 Config.php cleanup </span></span></font></font>
 301 </p>
 302 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">[&lt;FA
 303 2.2RC1]</span></span></strong><strong> </strong>
 304 </p>
 305 <p><strong><span style="">$security_headings,
 306 $security_groups arrays &#8211; moved to database (see Access Setup) </span></strong>
 307 </p>
 308 <p><strong><span style="">$def_app &#8211; moved
 309 to user configuration in database.</span></strong></p>
 310 <p><strong><span style="font-style: normal;"><span style="">$version
 311 &#8211; moved to </span></span></strong><strong><i><b>version.php</b></i></strong><strong><span style="font-style: normal;"><span style="">
 312 file. Remove</span></span></strong></p>
 313 <h2>4. New features configuration</h2>
 314 <p>During upgrade process new features are initialized to default
 315 status, and sometimes old settings are also changed to conform with
 316 new security policy. This automatic process is designed to be as
 317 neutral for end users as possible, however sometimes site or company
 318 admin intervention can be necessary to set thing after changes to
 319 their best state. Below you will find description of new settings
 320 available after upgrade.</p>
 321 <p><br>
 322 <br>
 323 </p>
 324 <p>----------------------</p>
 325 <ul>
 326 </ul>
 327 </body></html>