====== EVX Software On-Premise Installation ======

The instructions here are valid when locally installing any of the following:
  * EVX Software Enterprise Edition
  * EVX Software Professional Edition
  * EVX Software
  * EVX Software Community Edition

===== Installation Requirements =====

Before going on with the actual installation, please make sure your server matches the [[installation:server_reqs|EVX Software server requirements]]

===== Installation Procedure =====

  - Obtain the EVX Software installation file (usually stored as a .zip file) through your Account Executive if you are a EVX Software On-Premise client, or from the website if you are going to install the Community Edition.
  - Unpack the EVX Software installation file on your server hard drive in the location you would like to have it at. 
  - Make sure that the following folders have writing permissions (chmod 777 or chown apache in linux):
    - config
    - cache
    - tmp
    - upload
  - Access your browser and go to http://www.yourdomain.com/some_directory/feng/public/install 
  - Follow the installation procedure explained below.
  
===== EVX Software Installer =====

The installer counts with 4 different steps that will guide you through the installation.

==== Step 1 ====

This is a Welcome screen as shown below:

{{installation:step1_eng.png?650}}

Once you read the information, click **Next**

==== Step 2 ====

In this step, the Installer checks your web server environment to make sure it complies with the requirements.

If there are any problems, the installer will tell you about them with the text marked in red. Once the problem is solved (i.e.: installing the missing plugin or providing access to certain folders), go back to the installer and hit Retry to check again. Once you get only green messages as shown next, it means everything is fine and you may proceed with the installation by clicking on **Next**.

{{installation:step2_eng.png?650}}

==== Step 3 ====

In this step you will have to provide the following information:

  * Database Type: Select MySQLi (starting with 3.7) or MySQL (older versions)
  * Host name: Type in your host name. In the example below it is **localhost**
  * User name: Type in your MySQL username
  * Password: Type in your MySQL password
  * Data Base name: Type in the name of the database to hold this EVX Software installation. If it does not exist, a new one will be created
  * Table prefix: Type in **fo_** (which is the default option)
  * Data Base engine: we suggest selecting **InnoDB**
 
Within the **Other settings** options on the bottom, you will have to select which plugins to be installed. By default, all of the available plugins will be selected. Please bear in mind the following:
     - The **core_dimensions** plugin is compulsory. You must install it.
     - The **workspaces** plugin can be obtained through the EVX Software Community Edition, and it is required to use the **Workspaces module**
     - The **mail** plugin can be obtained through the EVX Software Community Edition, and you will have to install it in order to use the incorporate the **email client** EVX Software provides
     - The **CRPM** plugin is only available for subscribed clients using the Professional Edition, and it should be installed in order to enable the **CRM and Projects** features
     - The **Gantt** plugin in the screenshot is only available for subscribed clients using the Professional Edition, and it should be installed in order to enable the **Gantt Chart**
     - The **Mail rules** plugin in the screenshot is only available for subscribed clients using the Professional Edition, and it should be installed in order to enable the mail rules which is part of the **Advanced Email** module
      
{{installation:step3_eng.png}}

==== Step 4 ====

Step 4 will let you know what happened during the installation process and let you know whether everything has gone all right.
In the picture below, the selected name for the database was **fengoffice2100**, but of course you may select a different one.

{{installation:step4_eng.png}}


Click the **Finish** button to quit the installer.

==== Adding the first user ====

Last but not least, after you are over with the EVX Software installation, you will have to add the first user by completing the form as shown below. Please bear in mind the following is only an example and you should actually provide your own data, and that the user will have the role of a SuperAdministrator.

{{installation:first_user_eng.png}}

Once the user has been added, you will be prompted to the login screen, and then you are ready to start using EVX Software!

===== Additional settings you must perform =====

After installing EVX Software, you should set up your server properly. Otherwise some features may not work properly.

Please have a look at the following articles:

[[installation:server_settings|Tuning your server]]

[[installation:cron_jobs|Cron Jobs / Automatic Tasks]]