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
   9 <body dir="ltr" lang="en-US">
  10 <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
  11 Update</font></strong></p>
  12 <h2>Important Notes</h2>
  13 <p>Upgrade process can be done only by administrator of the first
  14 company created during FrontAccounting installation. This person is
  15 considered as a site admin who have granted access to potentially
  16 dangerous setup options, like Setup/Software Upgrade.</p>
  17 <p>In the following description sections related to older FA versions are
  18 prefixed with <span style="background: rgb(235, 97, 61) none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[color tags]</span><span style="background: transparent none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">
  19 . Y</span>ou can skip tagged fragment safely if currently FA
  20 application is newer than the version in tag.</p>
  21 <p>Upgrade process consists of up to four stages, some of them are
  22 optional:</p>
  23 <ol>
  24         <li><p>Application source files update
  25         </p>
  26         </li><li><p>Database upgrade &#8211; this step is needed only during
  27         upgrade which involves change in major application version number
  28         (e.g. from 2.2.x to 2.3.x), and sometimes during upgrade from beta
  29         release to stable version. Otherwise this step can be skipped.</p>
  30         </li><li><p>Final cleanup &#8211; is needed when some old source files,
  31         obsoleted by new release should be removed.</p>
  32         </li><li><p>New features configuration &#8211; this is optional step
  33         needed for most major releases and some minor ones.
  34         </p>
  35 </li></ol>
  36 <p style="margin-bottom: 0cm;">Before starting upgrade ensure nobody
  37 is using the application and make database backup for all companies.
  38 To be on safe side backup also old source files, especially those
  39 locally customized (if any).</p>
  40 <p>Log into admin account of first company.<strong> </strong><strong><span style="">If
  41 you use a theme other than the standard 3 (aqua, cool or default),
  42 switch to one of these before going further.</span></strong></p>
  43 <h2><strong><b>1. Application files update</b></strong></h2>
  44 <p style="margin-top: 0.42cm; page-break-after: avoid;"><font face="Liberation Sans, sans-serif"><font size="4"><strong><span style="">a. Source
  45 files update</span></strong></font></font></p>
  46 <p><strong><span style="">Extract distribution
  47 zip/tar.gz file in empty directory, and copy all the files to your
  48 FrontAccounting directory overwriting old files. If it is major
  49 release upgrade you can skip next step and go directly to cleanup.</span></strong></p>
  50 <p style="margin-top: 0.42cm; page-break-after: avoid;"><strong><font face="Liberation Sans, sans-serif"><font size="4"><span style="">b. Configuration
  51 files update</span></font></font></strong></p>
  52 <p><strong><span style="">Compare new
  53 </span></strong><strong><i><b>config.default.php</b></i></strong><strong>
  54 </strong><strong><span style="">file with the old
  55 </span></strong><strong><i><b>config.php </b></i></strong><strong><span style="font-style: normal;"><span style="">and
  56 add all n</span></span></strong><strong><span style="">ew
  57 settings (if any). </span></strong>
  58 </p>
  59 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  60 2.2beta]</span></span></strong></p>
  61 <p><strong> <span style="">$show_users_online = 0;</span></strong></p>
  62 <p><strong> <span style="">$def_print_destination
  63 = 0;</span></strong></p>
  64 <p><strong><span style="">$dflt_date_fmt=0;</span></strong></p>
  65 <p><strong><span style="">$dflt_date_sep=0;</span></strong></p>
  66 <p><strong><span style="">$table_style,table_style2
  67 changed</span></strong></p>
  68 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  69 2.3beta]</span></span></strong></p>
  70 <p><strong> <span style="">$alternative_tax_include_on_doc=0;</span></strong></p>
  71 <p><strong><span style="">$suppress_tax_rates = 0;</span></strong></p>
  72 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
  73 2.3RC1]</span></span></strong><strong> </strong>
  74 </p>
  75 <p><strong><span style="">Application version
  76 information and a couple of other private FA variables are stored in
  77 </span></strong><strong><i><b>version.php</b></i></strong><strong>
  78 </strong><strong><span style="">file. The
  79 application version displayed in footer is defined in $version
  80 variable unless this is set in config.php file. If you want current
  81 release version to be displayed on every FA update just remove or
  82 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>
  83 <h2><strong><b>2. Database upgrade</b></strong></h2>
  84 <p><strong><span style="">This step can be skipped
  85 for small version updates i.e. when you have already installed
  86 FrontAccounting version 2.3.1 or later. Before database upgrade is
  87 done on all company databases backup file is created automatically to
  88 enable database restore after failure.</span></strong></p>
  89 <p><strong><span style="">After major version
  90 upgrade overwriting files in first step makes the system unaccessible
  91 for all users but site admin, who have to run upgrade procedures to
  92 update all company databases to the new version provided with the
  93 release. After logging to administrator account of first installed
  94 company go directly to Setup/Software Upgrade screen, mark all
  95 subsequent 'Install' checkboxes and press 'Upgrade System'.</span></strong></p>
  96 <p style="">If something goes wrong during
  97 upgrade, you can eventually try forced upgrade option. Forced upgrade
  98 ignores some smaller errors which can arise during upgrade due to
  99 some exotic database configuration. This is depreciated option, so
 100 first read error messages if any, try to fix signalized problems,
 101 restore databases from backup and retry normal installation. To run
 102 upgrade in forced mode check box 'Force Upgrade', and press 'Upgrade
 103 System' again.</p>
 104 <h2>3. Final cleanup</h2>
 105 <p>Remove or rename install folder in main FrontAccounting directory.
 106 </p>
 107 <p>After upgrade is installed you can remove files obsoleted by new
 108 FrontAccounting version. Also old, unused settings <span style="font-style: normal;"><span style="">can
 109 be removed from  </span></span><i><b>config.php</b></i><span style="font-style: normal;"><span style="">
 110 file.</span></span></p>
 111 <p style="margin-top: 0.42cm; page-break-after: avoid;"><font face="Liberation Sans, sans-serif"><font size="4">a.
 112 Source files cleanup</font></font></p>
 113 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
 114 2.2beta]</span></span></strong></p>
 115 <p><strong><span style=""><span style="background: transparent none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">/includes/reserved.inc
 116 &#8211; removed.</span></span></strong></p>
 117 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
 118 2.1]</span></span></strong><strong> </strong>
 119 </p>
 120 <p><strong><span style="">/admin/db/v_banktrans.inc
 121 - removed</span></strong></p>
 122 <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.
 123 Config.php cleanup </span></span></font></font>
 124 </p>
 125 <p><strong><span style=""><span style="background: rgb(235, 97, 61) none repeat scroll 0%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">[&lt;FA
 126 2.2RC1]</span></span></strong><strong> </strong>
 127 </p>
 128 <p><strong><span style="">$security_headings,
 129 $security_groups arrays &#8211; moved to database (see Access Setup)
 130 </span></strong>
 131 </p>
 132 <p><strong><span style="">$def_app &#8211; moved
 133 to user configuration in database.</span></strong></p>
 134 <p><strong><span style="font-style: normal;"><span style="">$version
 135 &#8211; moved to </span></span></strong><strong><i><b>version.php</b></i></strong><strong><span style="font-style: normal;"><span style="">
 136 file. Remove</span></span></strong></p>
 137 <h2>4. New features configuration</h2>
 138 <p>During upgrade process new features are initialized to default
 139 status, and sometimes old settings are also changed to conform with
 140 new security policy. This automatic process is designed to be as
 141 neutral for end users as possible, however sometimes site or company
 142 admin intervention can be necessary to set thing after changes to
 143 their best state. Below you will find description of new settings
 144 available after upgrade.</p>
 145 <p><br><br>
 146 </p>
 147 <p>----------------------</p>
 148 <ul></ul>
 149 </body></html>