© 2015 X2Engine Inc.

Installation

From X2Engine
Revision as of 23:49, 3 October 2012 by Demitri (talk | contribs) (Running The Installation)
Jump to: navigation, search


System Requirements

Before installing X2EngineCRM, you should first ascertain whether your hosting environment is properly configured. The following features are required for X2EngineCRM to function properly:

  • PHP version 5.3 or later
  • PHP's cURL library
  • A password-protected MySQL database server connection, and a database on which the user of the connection has all rights (i.e. select, drop, create and update).
  • The Apache 2 web server, with mod_rewrite enabled.

Next, ensure that the requirements of Yii Framework, the application building framework on which X2Engine is designed, are met. To do this:

  • Download Yii Framework and upload the "requirements" folder to your web server.
  • Navigate to the requirements folder on your server using a web browser. You should see a page that looks similar to this:

400px

Note that the following requirements are not necessary:

  • The SQLite and PostgreSQL extensions; X2Engine depends on MySQL, so these other extensions will not be used.
  • The DOM extension; it is not required.
  • The caching extensions (Memcache, APC cache); caching is not currently required, although APC can increase performance
  • The SOAP extension; the classes that depend on it are not used

Enabling PHP extensions

If your server does not meet the minimum system requirements for running X2Engine, and you are a system administrator of your server, you will be able to install the necessary modules. Note, however, that as of the most recent version, the MySQL PDO extension is the only extension used by X2Engine that isn't included by default and always enabled in PHP 5.3; the reflection class and extensions SPL, PCRE and Ctype should all be available if PHP is at version 5.3 or later.

In most distributions of Linux, PHP extensions can be easily installed by the distribution's default Package management system. That is the recommended method of installing them; typically, the package manager will automatically configure and reload the HTTP server to enable them.

Ubuntu & Debian

sudo apt-get install php5-mysql

The extension mbstring will typically be included in the Apache module package.

CentOS, RHEL & Oracle Linux

sudo yum install php-pdo php-mbstring

Without Requirements: What Won't Work

If your server environment does not meet the minimum system requirements, and it is not possible to add PHP extensions, you can still install X2Engine, though it is not recommended. Note the following issues that can occur:

Minor Issues

  • cURL extension missing:
    • Timezone widget will not work
    • Cannot use local scripts that make API calls

Major Issues

  • PHP version earlier than 5.3 (not recommended; has not been tested on versions earlier than 5.3)
    • Chat widget will not work
    • Installation form does not fully render (X2EngineCRM versions 1.6.5 - 1.6.6)
    • Numerous controllers, models and components that use the function lcfirst

Critical Problems

  • mbstring extension missing
    • Application crashes
  • pdo_mysql extension missing
    • Application cannot run (required by Yii)
  • All other PHP extensions:
    • Application cannot run (required by Yii)

Recommended System

The following attributes of the hosting environment are by no means required. However, they are the same as the primary servers on which X2EngineCRM is most commonly developed and tested, and thus would be the most likely to never cause problems:

  • PHP 5.3.2
  • MySQL 5.5
  • Apache 2.2
  • Ubuntu 12.04

Running The Installation

Minimum Knowledge Requirements

Installing X2EngineCRM requires you are able to perform the following taks (and have basic knowledge of how to perform them):

  1. Upload files to a server via FTP/SFTP or otherwise, using a server-based file manager
  2. Creating a MySQL database and a database user, if they aren't available already
  3. Using a web browser, and knowing what URL to use to access a location on the server

Using The Installation Page

Installation generally proceeds as follows:

  1. Make sure a MySQL database and a database user with full permissions to that database are available from the web server.
  2. Upload the contents of the x2engine folder to the document root of the web server, or a subdirectory if desired.
  3. Navigate to the webroot (or subdirectory) where the contents of the folder were uploaded.
  4. Fill out the installation form. Note the following:
    • If you leave "Create Sample Data" checked, the installer will insert fictitious contact, user, account and action records into the initial installation for testing purposes. Uncheck the box if this is not desired.
    • You can test the database connection without submitting the form by using the "Test Connection" button.

Using The Silent Installer

It is possible to install X2EngineCRM from the command line via SSH or otherwise. This is performed as follows:

  1. There is a script in the root of the web application named installConfig.php. Fill it with the same information that would be submitted by the installation page form, except for the variable $unique_id; leave it as is.
  2. Change directory into the root folder of the web application.
  3. Run php initialize.php silent