install efront II

//

[edit] Requirements

  • Hardware: There are no limits on the type of hardware used to host an eFront installation. However, as your needs grow, so will the need for additional resources. A simple eFront installation requires about 50M of free disk space and 32M of free system memory. However, a minimum of 128M free memory available to PHP is recommended. Disk space should be allocated according to usage
  • Software: eFront requires an environment running the following:
    • PHP version 5.1+ (PHP 5.2+ recommended)
    • Mysql Server 4+ (Mysql 5 is strongly recommended, and mandatory for eFront Enterprise installations)
    • Web server (Apache 2+ recommended, although eFront can work with Apache 1.x, IIS, nginx or lighttpd)

eFront may be installed either on a Windows or on a Linux environment. However, if you are going to use non-latin language settings, linux is preferred over windows due to the latter’s poor support for UTF-8 filenames

 

[edit] Setting up Apache/Mysql/PHP (AMP)

If you already have a working AMP environment, or installing on a hosted server, please proceed to the next step

The easiest way to obtain a working AMP installation is by installing XAMPP, http://www.apachefriends.org/en/xampp.html We suggest that you follow the installation instructions suitable for your working environment (windows, mac or linux)

 

[edit] Preparing eFront setup on Windows Server with Apache

  1. Uncompress eFront files to a system folder, for example C:\efront
  2. Using a text editor, open apache’s configuration file, httpd.conf. This file is usually located in C:/Program Files/Apache Software Foundation/Apache2.2/conf/ (or c:\xampp\apache\conf\httpd.conf for XAMPP installations)
  3. 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">
  4. Restart Apache, by right clicking on the apache icon on the bottom right corner of your desktop, or from the XAMPP control panel if you have installed xampp
  5. Proceed to “Installing eFront using the web interface wizard” below

 

[edit] Preparing eFront setup on Linux Server with Apache

  1. Uncompress eFront files to the desired location, for example /var/www/html/efront or /opt/lampp/efront/www
  2. Edit apache’s configuration file, usually httpd.conf, which for xampp installations resides in /opt/lampp/etc/httpd.conf.
  3. Assuming a XAMPP installation, change the line where it says: DocumentRoot "/opt/lampp/htdocs/" to DocumentRoot "/opt/lampp/efront/www" and the line where it says <Directory "/opt/lampp/htdocs"> to <Directory "/opt/lampp/efront/www">. You should use directories according to your own file structure
  4. Restart apache, usually running the command service httpd reload or something similar (consult your distribution’s documentation)
  5. Set the filesystem permissions as follows (assuming that “apache” is the user that runs the web server process):
 chown apache:apache libraries/   (only for the duration of the installation)
 chown apache:apache libraries/smarty/themes_cache
 chown -R apache:apache libraries/language/
 chown -R apache:apache backups/
 chown -R apache:apache upload/
 chown -R apache:apache www/content/
 chown -R apache:apache www/modules/
 chown -R apache:apache www/themes/
 chown -R apache:apache www/certificate_templates/
 chown -R apache:apache www/editor/tiny_mce/
 chown apache:apache www/phplivedocx/samples/mail-merge/convert/

You may now proceed to “Installing eFront using the web interface wizard” below

 

[edit] Installing eFront using the web interface wizard

  1. Point your browser to the page http://<sitename>/install/install.php. If you are installing on your local PC, this would be http://localhost/install/install.php
  2. Click the «Install» button
  3. Step 1 of the installation lists the prerequisites and settings required in order for the system to work correctly. If there aren’t any missing settings (marked with the “forbidden” sign), you may click on the continue button. Otherwise, you must fix these before continuing with the installation (see also Troubleshooting below). If you click on the “Check current PHP settings” link, you will see the current PHP info page. You may also use the “Error reporting” handle to change the error reporting level, in case you are experiencing trouble with the installation
  4. On step 2 of the installation, you must define the database connection details, the default administrator username, password and email, as well as whether you want to create default users and content. Pressing “Install” will complete the installation process
  5. After completing the installation process, you will be prompted to erase the installation directory and redirected to the system main page. Enjoy!

[edit] Troubleshooting

1. One or more red “forbidden” icons appear in step 1 of Installation, at the “Mandatory PHP Settings” section (usually the magic_quotes_gpc setting):

This means that some PHP settings that are mandatory for efront to function properly are not set or are set in different values than the recommended, and the system failed to fix them automatically. Recommended settings are:

 magic_quotes_gpc = Off
 register_globals = Off
 session.save_path = "/path/to/writable/dir/"		

(where /path/to/writable/dir/ is a directory where the web server can write, for example /tmp for Linux or C:\WINDOWS\Temp for windows). Please note that these are the default values for PHP installations and any other setting is strongly advised against from the PHP community. There are many ways to fix this situation:

  • If you are installing efront on your own server or locally, edit the file php.ini and change the settings accordingly. For windows xampp installations, the correct php.ini is located inside c:\xampp\apache\bin. Remember to restart your apache server after any changes in this file
  • If you are installing efront on a shared hosting environment, then you can do the following:
    • Create a file called “php.ini”
    • Place the above recommended settings inside this file. Set /path/to/writable/dir/ to something writable, usually /tmp will work
    • Upload the file php.ini inside efront’s www/ and www/install/ folders
    • Reload the page with step 1 to see if the settings changed
  • If the above method does not work, try the following:
    • Create a file called “.htaccess”
    • Place the following commands inside it:
 php_flag register_globals off
 php_flag magic_quotes_gpc off
 php_flag session.save_path "/path/to/writable/dir/"
    • Upload this file inside efront’s www/ folder
    • Reload the page with step 1 to see if the settings changed. If you get a “Server Error” message, remove the file you uploaded
  • If none of the above methods work, contact your hosting provider and ask them how to set them

2. One or more red “forbidden” icons appear in step 1 of Installation, at the “Filesystem Permissions” section (usually in Linux installations)

These are the folders that efront must have write access to, so you should edit these folder’s permissions to “writable” for the web server (for example, by changing ownership). The “libraries/” folder may be set to non-writable after the installation finishes

3. One or more yellow “warning” icons appear in step 1 of Installation, at the “Optional PHP extesions” section

These are PHP extensions that are not mandatory for efront. If you don’t have them installed, you may safely ignore them and proceed with the installation

4. One or more yellow “warning” icons appear in step 1 of Installation, at the “Recommended PHP Settings” section

These are PHP settings that are recommended to be set in specific values or ranges, but efront will work anyway. The most important is “memory_limit” which may give you errors if it is set too low

5. I get a “Parse error: syntax error, unexpected ‘{‘ in some/dir/efront/www/index.php on line 34”

This means that your server is set to execute scripts with PHP4. eFront requires PHP 5 to work, contact your system administrator to resolve this issue

6. After installing XAMPP, I can’t start apache, what’s wrong?

If you are running skype, it might be blocking apache’s default port. Try restarting your computer

7. My language is listed in the “unavailable” list.

If your language is listed in the “unavailable languages” list, this means that the system was unable to locate the correct locale for your language. In this case, you should edit the corresponding language file (for example, efront/libraries/language/lang-english.php.inc) and change the constant _HEADERLANGUAGETAG to the corresponding language locale installed in your system. On a linux environment, you can see this list by typing locale -a. For example, for english this may be “en_US.utf8”

[edit] Siteground / cPanel installation tutorial

 

[edit] CentOS without XAMPP installation (v. 3.5.2 of eFront)

After many users asking for it, here are instructions for installing eFront 3.5.2 on CentOS 5.2:
CentOS does not install MySQL and PHP by default, so you first need to install these applications and additional modules, before installing eFront.
Remember that Linux is case-sensitive, so type carefully or just copy and paste each instruction below (one line at a time).

Step 1: Install mandatory packages

 yum install httpd (if it isn't already installed--yum checks for you)
 yum install mysql-server (if it isn't already installed--yum checks for you)
 yum install php
 yum install php-mysql
 yum install php-mbstring 
 yum install php-pear   
 yum install php-devel      (* see explanation at the bottom of this page)
 yum install yum-priorities    (*)
 rpm -hUv http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-3.noarch.rpm   (*)
 yum install php-pecl-zip     (*)
 yum install php-gd (Optional, for automatic image resizing and manipulation)
 yum install php-ldap (Optional, if you need LDAP support)

Step 2: Environment considerations

Note that in some versions of CentOS, a firewall is installed by default which will block access to port 80, on which Apache runs. The following command will open this port:

iptables -I RH-Firewall-1-INPUT -p tcp --dport 80 -j ACCEPT

You might as well have to install unzip to handle eFront’s bundle:

yum install unzip

Step 3: Download and unzip eFront

Next you need to download eFront and unzip it in the folder where you want it installed (for example inside /var/www/efront). You must move the eFront folder there before extracting/uncompressing it.

If you are installing the community edition you can download directly using wget. For example for 3.6.3 use:

wget http://kent.dl.sourceforge.net/project/efrontlearning/efrontlearning/eFront%20v3.6.3/efront_3.6.3_build7455.zip

To unzip just use something like: (note that this depends on the eFront version)

unzip efront_3.6.3_build7455.zip

If you are in a local/testing environment, you can change all permissions by performing:

 chown -R apache:apache /var/www/efront/*

Otherwise, there is a list of folders that the web server needs write access to, in step 1 of the installation script.

Step 4: PHP configuration

Edit the file /etc/php.ini to customize php settings to your needs. Recommended minimum values for the following fields are:

 > memory limit: 64M
 > upload_max_filesize: 32M
 > post_max_size: 32M
 > max_execution_time: 120

Step 5: Apache configuration

Edit the apache configuration file (/etc/httpd/conf/httpd.conf) and change DocumentRoot to point to the “www” folder inside the efront directory. For example:
DocumentRoot “/var/www/efront/www”

A few lines later in the apache configuration file, you should also change to match the DocumentRoot directory, as follows:

<Directory “/var/www/efront/www”>

Step 6: Restart servers

Servers are usually not start immediately. You can use the following commands to start apache and mysql:

sudo /etc/init.d/mysqld restart
sudo /etc/init.d/httpd restart

Step 7: Install eFront via the web-browser

Using a browser point to something like the following URL: http://server_ip_or_domain_name/install/install.php. eFront’s installation splash screen should be displayed. Click on “New Installation” to proceed
Review all mandatory elements. If there is a “forbidden” icon, then you must fix this element in order to continue. Most of the times you can leave the mysql password blank for the installation process. There is also a list of directories where eFront needs write access to. Make sure that these folders are accessible and writable by the web server. (Note: The folder “libraries” needs only to be writable during the installation process, then can be changed to read-only after installation–the installation wizard provides this option at the end of installation)

Click on Continue and follow the on-screen instructions. Enjoy!

(*): CentOS currently does not provide PHP 5.2 through its update mechanism; it installs 5.1.6 instead. This is why extra packages are needed to be installed, in order to provide support for the Zip libraries (bundled within PHP since 5.2.0)

[edit] CentOS from RPM-package

Now it’s easy to setup eFront from RPM-package.

Step 1. You should enable eFront and EPEL repositories:

> rpm -ivh http://www.abbris.ru/efront/el5/noarch/efront-release-1.0-1.abbris.noarch.rpm
> rpm -hUv http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-3.noarch.rpm   (*)

Step 2. Install eFront package (and all necessary packages):

> yum install efront

While installing, all necessary configurations are made for apache and PHP as well as directory permissions. In the end of installation process httpd and mysqld are restarted automaticly. eFront are located in /var/www/efront directory and available with http://your_server_name/efront URL.

Step 3: Install eFront. Using Mozilla Firefox, point to http://localhost/efront/install/install.php (pay attention to the URL!). eFront’s installation splash screen should be displayed. Click on “New Installation” to proceed
Review all mandatory elements. If there is a “forbidden” icon, then you must fix this element in order to continue. Leave the mysql password blank for the installation process, then later edit the password. There is also a list of directories where eFront needs write access to. Make sure that these folders are accessible and writable by the web server. (Note: The folder “libraries” needs only to be writable during the installation process, then can be changed to read-only after installation–the installation wizard provides this option at the end of installation)

Step 4: Click on Continue and follow the on-screen instructions. Enjoy!

(*): CentOS currently does not provide PHP 5.2 through its update mechanism; it installs 5.1.6 instead. This is why extra packages are needed to be installed, in order to provide support for the Zip libraries (bundled within PHP since 5.2.0)

Explore posts in the same categories: install

Tinggalkan Balasan

Isikan data di bawah atau klik salah satu ikon untuk log in:

Logo WordPress.com

You are commenting using your WordPress.com account. Logout / Ubah )

Gambar Twitter

You are commenting using your Twitter account. Logout / Ubah )

Foto Facebook

You are commenting using your Facebook account. Logout / Ubah )

Foto Google+

You are commenting using your Google+ account. Logout / Ubah )

Connecting to %s


%d blogger menyukai ini: