====== Feng OnSite Installation ====== The instructions here are valid when locally installing any of the following: * Feng Office Enterprise Edition * Feng Office Professional Edition * EVX Software * Feng Office Community Edition ===== Installation Requirements ===== Before going on with the actual installation, please make sure your server matches the [[installation:server_reqs|Feng Office server requirements]] ===== Installation Procedure ===== - Obtain the Feng Office installation file (usually stored as a .zip file) through your Account Executive if you are a Feng onSite client, or from the website if you are going to install the Community Edition. - Unpack the Feng Office 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. ===== Feng Office 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 Feng Office 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 Feng Office Community Edition, and it is required to use the **Workspaces module** - The **mail** plugin can be obtained through the Feng Office Community Edition, and you will have to install it in order to use the incorporate the **email client** Feng Office 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 Feng Office 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 Feng Office! ===== Additional settings you must perform ===== After installing Feng Office, 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]]