Installation instructions

From EFrontWiki

[edit] Windows installation

1. Decompress eFront files to a system folder, for example
C:\eFront.
This way, the structure below should be created:
C:\eFront\www
C:\eFront\libraries
C:\eFront\backups
C:\eFront\upload
C:\eFront\modules
2. Download XAMPP software from the internet :
(latest URL at this moment http://www.apachefriends.org/download.php?xampp-win32-1.6.2-installer.exe)
3. Run the downloaded XAMPP file, to install it:

  a. At the introductory screen, press "Next"
  b. Select the installation folder (you may leave the default proposed)
  c. At the third step, "XAMPP Options", at the "SERVICE SECTION" we select "Install Apache as service" and "Install MySQL as service"
  d. Click on "Install" and then "Finish" to complete XAMPP installation
  e. If a firewall is installed to the system, it may ask whether to allow Apache to access the internet. It must be permitted to  access the Internet and accept connections through it. 
  f. Finally, we start the XAMPP control panel

4. Using a text editor, open the file c:\xampp\apache\conf\httpd.conf for editing
5. Change the line where it says
DocumentRoot "C:/xampp/htdocs"
to
DocumentRoot "C:/eFront/www" (since we placed eFront folder at C:\)
and the line
<Directory "C:/xampp/htdocs">
to
<Directory "C:/eFront/www">
6. From the XAMPP control panel, we restart Apache (pressing "Stop" and then "Start". If this doesn't work, try restarting the computer)
7. Access the location http://localhost/install/install.php, preferrable using Internet Explorer 7 or Mozilla Firefox
8. Click the «Install» button
9. The first step lists the prerquisites and settings required in order for the system to work correctly. If there aren't any prohibitive situation (marked with the "forbidden" sign), we may move on.
10. At the second step, user must insert the database settings. Database type is always "MySQL". Database host is usually "localhost" (or may be a single dot "."). Database user is root and password may be left blank (unless after installing XAMPP we set one). Database name may be anything, preferrably "efront".
11. Clicking on "Next" will create the database and the corresponding database tables.
12. The next step has to do with system settings. You may use default values provided. Most of these settings may be later changed through the administrator menu.
13. At the next step we must create an administrator account and optionally a sample professor and student account.
14. Finally, we may optionally insert a sample lesson, either the default provided, or one that we upload.
15. After finishing installation, we may use the system by accessing its home page, usually http://localhost.
16. Important note: You *must* delete the installation directory, in order for the system to function.

[edit] Linux Installation

1. Uncompress eFront files in the desired folder, for example /opt/lampp/eFront, thus creating the following structure: /opt/lampp/eFront/www /opt/lampp/eFront/libraries /opt/lampp/eFront/backups /opt/lampp/eFront/message_attachments 2. Download and install XAMPP for Linux, from http://www.apachefriends.org/en/xampp-linux.html 3. After installing XAMPP, you must edit the file /opt/lampp/etc/httpd.conf (with any text editor) and perform the following chages:

  - Change the line where it says:
    DocumentRoot "/opt/lampp/htdocs/"
    to:
    DocumentRoot "/opt/lampp/eFront/www"
  - Change the line where it says:
    <Directory "/opt/lampp/htdocs">
    to:
    <Directory "/opt/lampp/eFront/www">

4. Using the XAMPP control panel (or manually) restart Apache service 5. Using Mozilla Firefox, point to http://localhost/install/install.php 6. Follow the on-screen instructions to setup eFront 7. Note: Several directories should be writable by the web server, but the most important is libraries/smarty, since it is needed in order to perform installation