install.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><title>FrontAccounting</title></head>
   3 <body>
   4 <div><strong><span style="font-size: 20pt;"><span style="color: rgb(204, 102, 0); font-style: italic;">Front</span>Accounting
   5 Installation</span></strong></div>
   6 <h2>Pre-requisites</h2>
   7 <ul style="margin-top: 0pt;" type="disc">
   8 <li>A working HTTP web server eg. <em><strong>Apache,
   9 IIS</strong></em>. </li>
  10 <li><strong><em>PHP</em></strong>
  11 installed on the web server. </li>
  12 <li>A working <strong><em>MySQL</em></strong>
  13 server - with <strong><em>innodb</em></strong>
  14 tables enabled (see notes below) </li>
  15 <li><strong><em>Adobe Acrobat Reader</em></strong>
  16 - or another PDF reader for viewing the PDF reports before printing them out. </li>
  17 </ul>
  18 <h2>Important Notes</h2>
  19 <ul>
  20 <li>One critical aspect of the PHP installation is the setting
  21 of <strong><em>session.auto_start</em></strong>
  22 in the php.ini file. Some rpm distributions of PHP have the default
  23 setting of <strong><em>session.auto_start = 1</em></strong>.
  24 This starts a new session at the beginning of each script. However,
  25 this makes it impossible to instantiate any class objects that the
  26 system relies on. Classes are used extensively by this system. When
  27 sessions are required they are started by the system and this setting
  28 of <strong><em>session.auto_start</em></strong>
  29 can and should be set to 0. </li>
  30 <li>
  31 For security reasons both Register Globals and Magic Quotes php settings
  32 should be set to Off. When FrontAccounting is used with www server running
  33 php as Apache module, respective flags are set in .htaccess file. When your
  34 server uses CGI interface to PHP you should set
  35 <strong><em>magic_quotes_gpc = 0</em></strong> and
  36 <strong><em>register_globals = 0</em></strong> in php.ini file.
  37 </li>
  38 <li><strong><em>Innodb</em></strong>
  39 tables must be enabled in the MySQL server. These tables allow database
  40 transactions which are a critical component of the software. This is
  41 enabled by default in the newer versions of MySQL. If you need to
  42 enable it yourself, consult the MySQL manual. </li>
  43 <li>FrontAccounting is implemented and tested with MySQL.
  44 Generally
  45 it should work with other databases, but this is not supported in any
  46 way at the moment. </li>
  47 </ul>
  48 <h2>Copying all the project files to the correct directory</h2>
  49 <ul>
  50 <li>You must obviously have downloaded the project archive to
  51 be reading this file. </li>
  52 <li>All the files inside this archive should be copied to a
  53 directory under the web server root directory. </li>
  54 <li>For example, create a folder called <strong>/account</strong>,
  55 and extract the archive into this folder. </li>
  56 </ul>
  57 <h2>Installation Steps</h2><ol><li>If you have the option to create multiple databases on your
  58 host, create one, fi. <strong>frontacc</strong>, otherwise
  59 write down the database name for your account. At the same time look up
  60 the username and password for the database. You will need these
  61 informations during the wizard install. </li>
  62 <li>Enter <strong><em>your_url/account</em></strong>
  63 (or whatever directory you entered). This will run the install wizard if this is the first time you run FrontAccounting,
  64 setup a drill company and optional populating with initial demo data. You can later
  65 on create your own real company. It is a good idea to get familiar with
  66 the system before starting your own company.&nbsp; </li>
  67 <li>After successfully install, remove or rename your install
  68 directory for safety reasons. You don't need it any more.</li>
  69 </ol><h2>&nbsp;Logging In For the First Time</h2>
  70 <ol>
  71 <li>Pleae ensure that the folder <strong>/company/0</strong>
  72 on the server is <strong>writable</strong>. </li>
  73 <li>Open a browser and enter the URL for the web server
  74 directory where FrontAccounting is installed. </li>
  75 <li>Enter the user name:&nbsp; '<strong>admin</strong>'
  76 </li>
  77 <li>Enter the password you created during install.
  78 </li>
  79 <li>(NB : enter without quotation marks). </li>
  80 <li>
  81 <div>You can set up additional user accounts from the System
  82 Setup
  83 tab. Be careful not to delete the demonstration user until a new user
  84 has been set up. If there are no users defined the next time you try to
  85 login you won't be able to. The only way then to create a user to login
  86 with is to manually edit the SQL table "users" to insert a user.</div>
  87 </li>
  88 </ol>
  89 <h2>Setting Up Company Specific Data</h2>
  90 <ol>
  91 <li>All the standing configuration data is defined from the
  92 Setup tab
  93 and each link should be reviewed to enter appropriate data for the
  94 business. </li></ol><h2>Troubleshooting</h2>
  95 <ol>
  96 <li>If FrontAccounting is installed locally, you may have the <strong><em>session
  97 save path</em></strong> not set correctly. Normally this is
  98 set in your php.ini (for Windows). The entry is called <strong><em>session.save_path</em></strong>.
  99 Make sure this is set to a directory that actually exists. The default
 100 is set to /tmp, which may not be valid. </li>
 101 <li>If you are installing FrontAccounting onto a shared server,
 102 you may have to set the session save path within FrontAccounting. At
 103 the top of&nbsp;
 104 /includes/session.inc you will find this line : </li>
 105 <li>Uncomment this line and set the path to a directory that
 106 exists
 107 on your server. Make sure that you have read/write privileges on this
 108 directory. </li>
 109 </ol>
 110 <p>&nbsp;</p>
 111 </body></html>