Vtiger521:Windows Installation

From http://wiki.vtiger.com/archives

This documentation applies to vtigerCRM 5.2.1 and vtigerCRM 5.2.0

Contents

How do I choose right distribution?

Type Of User Distribution Type
I am new to Web-based software – Beginners vtiger CRM 5.2.0 EXE
I have hands-on experience with MySQL and PHP-based applications – Advanced PHP Users/Developers/Hosting Service Providers vtigr CRM 5.2.0 TAR GZ

Installation Prerequisites

  • You must have "Administrator privileges" on the system. If you are installing without Administrator privileges, vtiger CRM software will not be installed properly.
  • Before installing vtiger CRM software, stop the Apache and MySQL services.
  • vtiger CRM software is compatible with Apache 2.0.40 , MySQL 5.1.x and above , and PHP 5.0x and above.
  • Read/Write permissions for some of the vtiger CRM directories – Applicable to vtiger CRM Source Installation
  • PHP settings (php.ini) configuration -Applicable to vtiger CRM Source Installation

Installation steps on Windows

Step1: Download the vtiger CRM 5.2.0 EXE from vtigercrm-5.2.0.exe

Now save this file and then run.

Step2: The installation process will start with the Welcome page, click next to continue with the installation.

vtiger520-WindowsInstallation-WelcomePage.JPG

Step3: Now it will show the license Agreement page, read the license carefully, then select the check box and click next to continue with the installation.

vtiger520-WindowsInstallation-LicensePage.JPG

Step4: Clicking next button will take you to Apache Web Server & MySQL Configuration page, by default the apache port is 81. If the port is occupied by any other process it will show a message saying this port is not free please select any other free port. After giving the apache port click next. By default port MySQL uses 3307, if the port is occupied by any other process it will show a message saying this port is not free please select any other free port. The default User Name is root and password is empty, you can change them according to your convenience. After giving all the parameters click next

vtiger520-WindowsInstallation-ServerConfiguration.JPG

Step5: Now you will be prompted to enter a password for vtigerCRM admin user along with the password.

vtiger520-WindowsInstallation-CrmConfiguration.JPG

Step6: Clicking next will direct you to the Choose Installation Location page, here you can select the installation directory. By default c:\program files\vtigercrm-5.2.0-vb1 now click on the next button.

vtiger520-WindowsInstallation-DirectorySelection.JPG

Step7: Clicking next will show Choose Start Menu Folder page, select the check box if you don't want to create start menu folder. now click the install button.

vtiger520-WindowsInstallation-StartMenu.JPG

Step8: Clicking install button will start the installation process.

Step9: As soon as the installation done it will start the vtiger crm server, it will launch a command window.


Step10: Once it will start all the necessary services and process (Apache and MySql), it will launch the vtigercrm client. To continue with Configuration Wizard Click here

Using Source

System Requirements

  • Hardware: Intel 80486 with 512 MB RAM or more and at least 250 MB of disk space.
  • Web Browser: Firefox 2.x and above Internet Explorer 6 and 7
  • Web Server Apache: version 2.0.40 or higher or Microsoft IIS 5 or higher
  • Database MySQL: version 4.1.x through 5.1.x
  • PHP: version 5.0.x through 5.2.x

PHP Extensions

Following extensions should be enabled for your PHP setup

GD Mandatory Charts and graphs generation are dependent on this library.
IMAP Mandatory Webmails Module is dependent on this library.
Zlib Mandatory This library is already bundled in PHP 5.3 and later versions.
OpenSSL Optional Imap with OpenSSL should be enabled in case Mail server needs to be connected via SSL
Curl Optional

PHP Configuration

Make sure to verify if your PHP configuration meets the recommended values.

Variable Value
zend.ze1_compatibility_mode off
allow_call_time_reference on
error_reporting E_WARNING & ~E_NOTICE
safe_mode off
display_errors on
file_uploads on
max_execution_time 600
memory_limit 32M
log_errors off
output_buffering on
register_globals off
short_open_tag On

File Permissions

Provide read-write access to the following files and folder (recursively):

NOTE:

Read and Write permissions should be enabled for the following files and folders.


  • config.inc.php
  • tabdata.php
  • install.php
  • parent_tabdata.php
  • cache
  • cache/images/
  • cache/import/
  • storage/
  • install/
  • user_privileges/
  • Smarty/cache/
  • Smarty/templates_c/
  • modules/Emails/templates/
  • modules/
  • cron/modules/
  • test/vtlib/
  • backup/
  • Smarty/templates/modules/
  • test/wordtemplatedownload/
  • test/product/
  • test/user/
  • test/contact/
  • test/logo/
  • logs/
  • modules/Webmails/tmp/

Proceed with the next step of installation by visiting index.php from the browser.

Installation Steps Using Source

If Apache (or IIS), MySQL, PHP setup exists on the server, download vtigerCRM 520 and extract to the webserver's Document Root (or public_html) After extracting, it will create a folder named as vtigercrm and copied all the files into that. After this just go to the browser and install the product

  1. If you are using Apache (example:http://localhost:<apacheport>/vtigercrm)
  2. If you are using IIS (example:http://localhost/vtigercrm)

For continuing with Configuration Wizard click here

NOTE:

While using WAMP, keep vtigercrm source directory inside C:\wamp\www. Now start services (MySQL and Apache services) and go through browser to access vtigerCRM.


On IIS

How to Install IIS

please refer to this link for installing the IIS

Install and Configure PHP

Step1: Start by creating a directory into which you will extract the downloaded PHP files (php-5.2.6-Win32.zip). In this example I’m going to use C:\PHP as my installation directory. Then extract the files from php-5.2.6-Win32.zip into C:\PHP

Step2: Next locate the file ‘php.ini-recommended’ in C:\PHP and rename it to ‘php.ini’

vtiger510-IISphpinstallation-step1.JPG

Step3: Open the ‘php.ini’ file and find the line which reads extension_dir = “./” and change it to extension_dir = “C:\PHP\ext”. This tells PHP where the various extensions are located and as you can see the default path in the ‘php.ini-recommended’ file which ships with PHP points to the wrong location, so you need to change it.

You also need to add the location of your PHP directory to the server’s PATH environment variable so that Windows knows where to look for any PHP related executable (such as the PHP extension DLL‘s). To do this Right-click on My Computer, click Properties and on the Advanced tab click Environment Variables. In the Environment Variables dialog box, under System variables highlight the Path variable and click Edit.

vtiger510-IISphpinstallation-step2.JPG

Step4: Add ‘;C:\PHP’ (be sure to include the semi-colon separator) as shown here and click OK. You need to re-boot the server for this change to take effect.

vtiger510-IISphpinstallation-step3.JPG

After this make the necessary changes in php.ini to see the recommended php.ini values click here

Installing MySQL on the Server

Step1: Launch the mysql-5.0.51a-win32 installer file to start the MySql setup wizard.

vtiger510-IISmysqlinstallation-step1.JPG

Step2: Click Next and then choose a custom installation as this will allow us to specify an installation directory of our own choosing. In this example I will be using installing MySQL into the ‘C:\MySQL’ folder.

vtiger510-IISmysqlinstallation-step2.JPG

Step3: On the Custom setup dialog box click Change to specify the preferred installation directory.

vtiger510-IISmysqlinstallation-step3.JPG

Step4: Select the directory you want to use and then click OK to go back to the Custom setup dialog box.

vtiger510-IISmysqlinstallation-step4.JPG

Step5: Click OK. MySQL is now ready to be installed. Click Install to begin the installation.

vtiger510-IISmysqlinstallation-step5.JPG

Step6: At the MySQL.com Sign Up screen click Skip Sign-Up and then click Next.

vtiger510-IISmysqlinstallation-step6.JPG

Step7: On the next dialog box ensure that ‘Configure the MySQL Server now’ tick box is checked and click Finish.

vtiger510-IISmysqlinstallation-step7.JPG

Step8: The Server Instance Configuration Wizard is now launched. Click Next to begin configuring your MySQL server.

vtiger510-IISmysqlinstallation-step8.JPG

Step9: Choose Detailed Configuration and click Next.

vtiger510-IISmysqlinstallation-step9.JPG

Step10: In this example I am installing MySQL on the same machine as my IIS web server so I opt for the Server Machine option. Choose a server type which is appropriate for your requirements and click Next.

vtiger510-IISmysqlinstallation-step10.JPG

Step11: Choose the type of database which best suits your needs and click Next.

vtiger510-IISmysqlinstallation-step11.JPG

Step12: Leave the default setting of the MySQL installation path for the InnoDB Tablespace settings (unless you wish to change it) and click Next.

vtiger510-IISmysqlinstallation-step12.JPG

Step13: Select the appropriate number of concurrent connections you want to allow and click Next.

vtiger510-IISmysqlinstallation-step13.JPG

Step14: Leave the default networking options settings (unless you have reason to change them) and click Next.

vtiger510-IISmysqlinstallation-step14.JPG

Step15: Choose the appropriate character set for your requirements and click Next.

vtiger510-IISmysqlinstallation-step15.JPG

Step16: On the Windows options dialog box ensure that both ‘Install As Windows Service’ and ‘Include Bin Directory in Windows Path’ tick boxes are selected and click Next.

vtiger510-IISmysqlinstallation-step16.JPG

Step17: In the security options dialog box ensure that ‘Modify Security Settings’ is ticked and type in your new root password. Decide whether or not you wish to allow root access from remote machines or create an anonymous account and click Next.

vtiger510-IISmysqlinstallation-step17.JPG

Step18: If you are happy with the choices you have made click Execute to begin configuring your server.

vtiger510-IISmysqlinstallation-step18.JPG

Step19: Once the Configuration Wizard has finished click Finish to begin using your new MySQL server.

vtiger510-IISmysqlinstallation-step19.JPG

How To Use IIS

  • Go to start menu -->Administrative tools --> Internet Information Service
  • Now right click on website tab

vtiger510-IISInstallation-Step1.JPG

  • Give site name as per your convenience and click on next button

vtiger510-IISInstallation-Step2.JPG

  • Remain the parameters as per they are in image and click on next button

vtiger510-IISInstallation-Step3.JPG

  • Choose website home directory by default is (C:\Inetpub(you should kept your vtigercrm folder in this folder))

vtiger510-IISInstallation-Step4.JPG

  • or you can choose your new folder for that and click next button

vtiger510-IISInstallation-Step5.JPG

  • Now click on finish button to finish the IIS installation

vtiger510-IISInstallation-Step6.JPG

  • You have to make some changes in properties
  • So,you have to right click on the newly created website and move it to properties

vtiger510-IISInstallation-Step7.JPG

  • In the properties go to home directory and give the permissions according to the screen shot

vtiger510-IISInstallation-Step8.JPG

  • Now click on the configuration tab
  • New window will appear and in new window click on browse button
  • Make sure that you added .php Application Extensions

vtiger510-IISInstallation-Step9.JPG

  • Click on documentation tab and add index.php for default content page

vtiger510-IISInstallation-Step10.JPG

  • Now change some permissions again move to new website and right click on that and select the permission tab

vtiger510-IISInstallation-Step11.JPG

  • Select users and give all the permissions according to the screen shot

vtiger510-IISInstallation-Step12.JPG

  • Now click on the Web services extensions and make sure that php extension is there not
  • Click on a add a new web service extension

vtiger510-IISInstallation-Step13.JPG

  • Add the new web service extension acording to the step given here click on add

vtiger510-IISInstallation-Step14.JPG

  • Now browse the extension

vtiger510-IISInstallation-Step15.JPG

vtiger510-IISInstallation-Step16.JPG

  • After that allow the web service extension

vtiger510-IISInstallation-Step17.JPG

  • Now go to browser and give localhost you can see the configuration page of vtigercrm
  • To continue with the client installation please click here
Personal tools