Vtigercrm Installation Manual Windows 22r2w
This document was ed by and they confirmed that they have the permission to share it. If you are author or own the copyright of this book, please report to us by using this report form. Report 3l3c15
Overview 3z723u
& View Vtigercrm Installation Manual Windows as PDF for free.
More details 2i4a6q
- Words: 4,216
- Pages: 24
vtiger CRM 5.0.2 Installation Manual
((FFoorr W Wiin nd doow wss O OS S))
Document History Revision 5.0.2 Date: October 30, 2006
-2Table of Contents
1. System Requirements .......................................................................3 2. How do I choose right distribution? .....................................................4 3. Installation Prerequisites ...................................................................5 4. Installing in Apache Web Server .........................................................6 4.1 Installing Complete Package ................................................................ 6 4.2 Installing without Apache and MySQL.................................................... 8 4.3. Installing vtiger CRM Source ..............................................................10
5. Installing vtiger CRM in Microsoft IIS................................................. 13 6. Starting & Stopping vtiger CRM Server .............................................. 14 7. Configuring vtiger CRM Server.......................................................... 15 8. Starting vtiger CRM in Web Browser .................................................. 18 9. Upgrading to 5.0.2 ......................................................................... 19 10. Troubleshooting Tips ..................................................................... 20 11. Known Issues............................................................................... 22 12. Related Documents ....................................................................... 23 13. Customer ......................................................................... 24
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-3-
1. System Requirements •
Hardware: x486 with 512 MB RAM or higher with a minimum of 250 MB disk space.
•
Operating System: Windows 2000/NT/XP.
•
Web Server: Apache version 2.0.40 and higher or Microsoft version IIS 5 and higher.
•
Database: MySQL version 4.1.x through 5.1.x.
•
PHP: 5.0.x through 5.1.x version.
•
Web Browser: IE 5.5/6.0, Firefox 1.5.x and above, or Opera version 7.21 and above.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-4-
2. How do I choose right distribution? vtiger CRM software is available in both executable and source formats. You can choose the right distribution according to your experience with LAMP/WAMP based applications.
Recommended vtiger CRM Distributions Type of
Distribution Type
I am new to Web-based software – Beginners
vtigercrm-5.0.2.exe
I have hands-on experience with Apache and MySQL, but not familiar with PHP – Intermediate s
vtigercrm-5.0.2.exe
I have hands-on experience with MySQL and PHP-based applications – Advanced PHP s/Developers/Hosting Service Providers
vtigercrm-5.0.2.tar.gz
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-5-
3. Installation Prerequisites •
You must have " privileges" on the system. If you are installing without 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 4.1.x through 5.1.x, and PHP 5.0x through 5.1.x. If these software are already installed in your system, you can use the same. Otherwise use the Apache and MySQL bundled with vtiger CRM software.
•
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
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-6-
4. Installing in Apache Web Server To install vtiger CRM, Apache, MySQL, and PHP are very essential. You can install vtiger CRM according to your software requirements: •
Install complete package of vtiger CRM - vtigercrm-5.0.2.exe. Note: Use this package if you have not installed Apache, MySQL, and PHP packages in your system.
•
Install vtiger CRM with bundled PHP - vtigercrm-5.0.2.exe. Note: This package is same as above except that you may not install Apache and MySQL. But PHP package will be installed even though it is available in your system. Use this package if you have already installed Apache and MySQL, packages in your system.
•
Install vtiger CRM source – vtigercrm-5.0.2.tar.gz. Note: Use this package if you have already installed Apache or Microsoft IIS, MySQL, and PHP in your system.
4.1 Installing Complete Package For the convenience of business community and novice PHP, vtiger CRM is bundled with optimized versions of Apache, MySQL, and PHP along with vtiger CRM core modules. To install the complete package of vtiger CRM: 1. vtigercrm-5.0.2.exe from the Sourceforge.net. 2. Run the vtigercrm-5.0.2.exe. Installation process starts within a few seconds. 3. In the Welcome to the InstallShield Wizard for vtiger CRM dialog, click the Next button. 4. In vtiger CRM Software License Agreement dialog, read the license agreement and click the Yes button if you accept the license agreement. 5. Follow the steps given below to install Apache Web server bundled with vtiger CRM:
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-7i.
In the Install Apache Options dialog, select the Install Apache option and click the Next button.
ii.
In the Install Apache Web Server Port Selection dialog, enter the port number in which Apache Web server must be started and click the Next button. If you are not sure, you can use the default port number "80".
iii.
In the Apache Service Option dialog, select the Start the apache as a service check box to automatically start vtiger CRM as a service during startup.
6. Follow the steps given below to install MySQL bundled with vtiger CRM: i.
In the Install MySQL Options dialog, select the Install MySQL option and click the Next button.
ii.
In the MySQL Connection Parameters Configuration dialog, enter the following MySQL connection parameters and click the Next button: Port Number: The port at which MySQL database server to must be started. Name: The name to in to the MySQL database. : The for the . If you are not sure, use the default Port as 3306, and Name as root. Keep the field empty.
7. In the Chose Destination Location dialog, either use the default directory C:\Program Files\vtigerCRM5_0 or select a new directory. After selecting the destination directory, click the Next button. 8. In the Select Program Folder dialog, either use the default program folder vtiger CRM 5 or enter a new folder. Now click the Next button. 9. In the Start Copying Files dialog, review Apache, MySQL, and PHP configuration settings. Click the Next button to start the installation or click the Cancel button to abort the installation. It will take approximately five minutes to complete the installation. Note: During vtiger CRM installation, <Apache Home>/conf/httpd.conf and %SystemRoot%/php.ini files will be modified. Also a backup copy of these files will be stored under %SystemRoot%/vtigerbackup folder. Please proceed further if you accept these changes.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-810. In the Installation Wizard Complete dialog, select the Yes I want to start the server option if you want to start vtiger CRM server immediately. Also select the Yes, I want vtiger CRM icon on desktop option if you want a desktop shortcut. Click the Finish button. It will take a few minutes to start vtiger CRM server.
4.2 Installing without Apache and MySQL Use the existing Apache and MySQL if already installed in your system provided these versions are compatible with vtiger CRM. Follow the procedure given below to install only vtiger CRM: 1. vtigercrm-5.0.2.exe from the Sourceforge.net. 2. Run the vtigercrm-5.0.2.exe. Installation process starts within a few seconds. 3. In the Welcome to the InstallShield Wizard for vtiger CRM dialog, click the Next button. 4. In vtiger CRM Software License Agreement dialog, read the license agreement and click the Yes button, if you accept the license agreement. 5. Follow the steps given below to use the existing Apache Web server: i.
In the Install Apache Options dialog, select the Use Installed Apache option and click the Next button.
ii.
In the Apache Web Server Home Selection, browse the directory where the Apache is installed. Please note that if you give a wrong directory, installation will not proceed further.
iii.
The Apache configuration file httpd.conf present under the <Apache Home>/conf directory, will be modified during vtiger CRM installation. Click Yes if you accept the “This selection will take backup and modify the httpd.conf file of the Apache installed in your system. Do you want to continue?” message.
iv.
In the Apache Web Server Home Selection dialog, click the Next button.
6. Follow the steps given below to use the existing MySQL: i.
In the Install MySQL Options dialog, select the Use Installed MySQL option and click the Next button.
ii.
In the MySQL Path Selection dialog, browse the directory where MySQL is installed and click the Next button.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-9Warning: If you give a wrong directory, installation will not proceed further. iii.
In the MySQL Connection Parameters Configuration dialog, enter the following MySQL connection parameters and click the Next button: Port Number: The port at which MySQL database server is running. Name: The name to to the MySQL database. : The for the . If you are not sure, you can use the default Port – 3306, Name – root. Keep the field empty.
7. In the Choose Destination Location dialog, either use the default program folder or enter a new folder. Now click the Next button. 8. In the Start Copying Files dialog, review the Apache, MySQL, and PHP configuration settings. Click the Next button to start the installation or click the Cancel button to abort the installation. It takes approximately five minutes to complete the installation. Note: During vtiger CRM software installation, the <Apache Home>/conf/httpd.conf and %SystemRoot%/php.ini files will be modified. Also a backup copy of these files will be stored with file extension as vtigercrm.backup. Please proceed further if you accept the changes. 9. In the Installation Wizard Complete dialog, select the Yes I want to start the server check box if you want to start vtiger CRM server immediately. Also select the Yes, I want vtiger CRM icon on desktop check box if you want a desktop shortcut. Click the Finish button.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 10 -
4.3. Installing vtiger CRM Source If you are already using WAMP environment for other PHP based applications, you can very well use the same setup for vtiger CRM installation, provided your setup meets the vtiger CRM requirements. IMPORTANT NOTE vtiger CRM Source installation is targeted only for the Advanced s/Developers/Hosting Providers. Beginners are strongly recommended to use the vtiger optimized WAMP setup (vtigercrm-5.0.2.exe). If you are using PHP based application first time, please skip this section and follow the steps in 5.1 Installing Complete Package
How to get WAMP? WAMP stands for Windows, Apache, MySQL, and PHP. You can optimized Apache, MySQL, and PHP with some other Add-on packages from various sources. The most popular sites that provide WAMP setup are WAMPP and XAMPP (apachefriends.com). There are many Websites offers WAMP distributions freely. Recommended WAMP Distributions: WAMP: Version 1.6.5 XAMPP: Version 1.5.3a Before using your own WAMP setup, please ensure that Apache, MySQL, and PHP versions meet the vtiger CRM requirements. •
Apache – 2.0.40 and above
•
MySQL – 4.1.x through 5.1.x
•
PHP – 5.1.x (you must configure php.ini settings as per Pre-installation Check List. Otherwise some of the features will not work.
To install vtiger CRM Source 1. vtigercrm-5.0.2.tar.gz from the Sourceforge.net. 2. Extract the vtigercrm-5.0.2.tar.gz file into Apache root directory (For example, C:\Program Files\Apache Group\Apache2\htdocs)
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 11 3. Start Web Browser and follow the procedure given in the "Configuring vtiger CRM Server" section for completing vtiger CRM installation.
Pre-installation Check List
1. You must have READ/WRITE permissions on the following vtiger CRM folders: •
PHP Configuration - config.inc.php
•
Cache Directory - cache/
•
Mail Merge Template Directory -test/wordtemplate/
•
s Directory - storage/
•
Install Directory - install/
•
Installation file -install.php
•
Product Image Directory -test/product/
•
Image Directory - test//
•
Image Directory- test//
•
Logo Directory- test/logo/
•
Email Templates Directory -modules/Emails/templates/
•
Privileges - _privileges/
•
Smarty Compile Directory - Smarty/templates_c
•
Tabdata File Permission - tabdata.php
•
ParentTabdata File Permission - parent_tabdata.php
•
Smarty Cache Directory - Smarty/cache
2. Your php.ini must configured with following parameters: •
safe_mode = Off
•
display_errors = On
•
file_s = On
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 12 Pre-installation Check List
•
_globals = Off
•
max_execution_time = 600
•
output_buffering= On
•
memory_limit = 32M
•
error_reporting = E_WARNING & ~E_NOTICE
•
allow_call_time_reference = On
•
log_errors = Off
•
short_open_tag= On
•
extension=php_gd2.dll
•
extension=php_imap.dll
•
extension=php_mysql.dll
•
extension=php_mysqli.dll
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 13 -
5. Installing vtiger CRM in Microsoft IIS vtiger CRM source can be installed in Microsoft IIS. You must have already installed the Microsoft IIS 5 or above, MySQL, and PHP before installing vtiger CRM.
Configuring Microsoft IIS to work with PHP-based application Please follow the procedure given below to execute PHP scripts in Microsoft IIS: 1. Configuring the php.ini file: the Windows binary for the latest version of PHP (vtiger CRM s PHP version 5.1.x). Once you've ed it, unzip it to a C:\ and rename the folder to "php". Open the PHP.INI-DIST file from the C:\PHP folder and locate the following line: ;cgi.force_redirect = 1 Remove comment in the above line and change the setting to 0 as shown below to run PHP under IIS. Make the necessary changes and save the file as php.ini in your Windows folder (C:\WINNT on my computer): cgi.force_redirect = 0 2. Configuring PHP in Microsoft IIS. Please refer to the following sites for more details: • http://in.php.net/manual/en/install.windows.iis.php • http://www.phpbuddy.com/category.php?cat_id=INST Note: All the directories under vtigerCRM should have READ access permission. Otherwise, some of the images/files cannot be executed. To install vtiger CRM in Microsoft IIS, follow the procedure given below: 1. vtigercrm-5.0.2.tar.gz from the Sourceforge.net. 2. Extract the vtigercrm-5.0.2.tar.gz file into IIS root directory (For example, C:\Inetpub\wwwroot\). 3. Start Web browser and follow the procedure given in the "Configuring vtiger CRM Server" section for completing vtiger CRM installation.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 14 -
6. Starting & Stopping vtiger CRM Server You can start or stopped according to the type of distribution. To start vtiger CRM Server •
•
If you have installed the Apache and MySQL that are bundled with vtiger CRM, start vtiger CRM server as given below: •
Select Start
Program Files
vtiger CRM
•
Click vtiger CRM desktop shortcut.
Start vtiger CRM
If you are using your own WAMP setup, start Apache manually and connect to vtiger CRM from http://
:<port number>/
/index.php.
To stop vtiger CRM Server •
If you have installed the bundled Apache, MySQL, and PHP with vtiger CRM, select Start Program Files vtiger CRM Stop vtiger CRM.
•
If you are using your own WAMP setup, stop the Apache and MySQL manually.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 15 -
7. Configuring vtiger CRM Server After installing vtiger CRM, you must configure vtiger CRM server with database, Website, currency, and istration access details. The vtiger CRM database tables and demo data are populated during configuration, which will take about 5 minutes time. 1. Start Web browser and enter
/vtigerCRM/index.php in location bar. 2. In the Registration page, complete the product registration (optional). Click the Start button. 3. In the System Check page, PHP, MySQL database, config.php, directories that have read/write permissions, and GD graphics library version status are displayed. Click the Next button. Note: Please ensure that all the directories have the read/write permission; otherwise, you cannot work with features that require file and . 4. In the System Configuration page, enter the appropriate values for Database, Site Configuration, and istration sections. Afterwards click Next button. Database Configuration •
Host Name (mandatory) – By default, Host Name is set as <System Name>:
. Please do not change the port number as it is added during installation.
•
Name (mandatory)– Specify name for accessing the database.
•
(optional)– Specify for the name.
•
Database Name (mandatory)– By default database name is vtigercrm5. You can also create a database as per your requirements.
•
Root Name (mandatory)– If you have selected the create data option in Database Name field, specify root name for creating database.
•
Root (mandatory)– Specify for the root name.
Site Configuration
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 16 •
URL (mandatory) – Enter the host name. By default, it is http://<system name>.
•
Path (mandatory) – By default, this is the path where vtiger CRM is installed.
•
Path to Cache Directory (must have write permission) - By default, this is cache/. This folder is used to store the files, such as attachments, and import/export- related files temporarily.
Configuration •
name – By default, the name is set as “”.
•
(mandatory) – By default, the is set as “”. You can change after logging in to vtiger CRM.
•
Email ID – By default email ID is [email protected]. You can also change the ’s e-mail ID.
Currency Configuration •
Name (mandatory) – Specify your fiscal currency name (For example, Dollar).
•
Symbol (mandatory) – Specify your currency symbol (For example, $).
•
Code (mandatory) – Specify international code of your currency (For example, USD).
5. In the Confirm Settings page, review the configuration information. If you want to change the details, click the Change button. If you want to populate some data, select the Also populate demo data? check box. Now click the Next button. 6. In the Config File Creation page, click the Next button. It will take approximately 4 minutes to complete the configuration. 7. In the Create Database Tables page, the created database tables are displayed. Click the Finish button to complete the installation process. Once installation is completed successfully, installation directory will be locked to secure your installation against unauthorized access. In the page, by default the Name field is set as “”. In field, enter the you have set during installation process. Once you have logged in successfully, you can view the vtiger CRM Home page as shown
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 17 below:
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 18 -
8. Starting vtiger CRM in Web Browser •
If you installed the Apache and MySQL that are bundled with vtiger CRM, select Start Program Files vtiger CRM vtiger CRM Client
•
If you are using vtiger CRM source with your own WAMP environment, open the http://
/index.php in Web browser.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 19 -
9. Upgrading to 5.0.2 We strongly recommend s to migrate from the vtiger CRM previous version to the latest version vtiger CRM 5.0.2. Currently we are providing UI based data migration for the following versions •
V 4.2.x
V 5.0.2
•
V 5.0.0
V 5.0.2
•
V 5.0.1
V 5.0.2
Warning: Please don't forget to take the source code backup before extracting the patch; otherwise all your custom code will be overwritten by the new code. To version 5.0.2 1. the vtiger CRM 5 - Patch 2 patch from Sourceforge.net 2. Extract the vtiger_CRM_5.0.0_Patch_2.zip to
directory 3. Now, open the vtiger CRM in Web browser and as a 4. Click the Settings
Other Settings
Migration Wizard link.
5. In the Migration Wizard, follow the steps given the wizard.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 20 -
10. Troubleshooting Tips 1. I am unable to complete the initial configuration process and the following error message is displayed in Web browser: Warning: mysql_connect(): Host <'Server Name'> is not allowed to connect to this MySQL server in C:\Program Files\vtigerCRM\apache\htdocs\vtigerCRM\database\DatabaseConnection.php on line 42 Could not connect to server <Server Name>:<port no> as vtigercrm.Host <'Server Name'> is not allowed to connect to this MySQL server Solution: This error message is displayed when you have not uninstalled the older version of vtiger CRM fully. Follow the procedure given below to overcome this issue: 1. Stop vtiger CRM server from Start vtiger CRM.
Program Files
vtiger CRM
Stop
2. Start the Command Prompt and enter the following command: :\mysql –u root –port 3. Drop the existing vtigercrm database from MySQL as given below: mysql>drop database vtigercrm; 4. Start vtiger CRM server from Start --> Program Files -->vtiger CRM ->Start vtiger CRM. 2. After completing the installation I am not sure, how to start vtiger CRM. •
If you are using bundled Apache and MySQL with vtiger CRM Start vtiger CRM server from Start Program Files vtiger CRM Start vtiger CRM. After a few seconds, start vtiger CRM client from Start Program Files vtiger CRM Start vtiger CRM.
•
If are using the existing Apache and MySQL Start the Apache Web server manually from the <Apache Home>/bin directory then start Web browser and enter the following URL: http://
/
/index.php
3. By default, the value for log4php.rootLogger is set as “debug” in log4php.properties file present under
directory. If you experience any problems, change the logging level to “fatal” or “warning”
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 21 Line: 10 log4php.rootLogger=debug, A2
Please refer to: vtiger Knowledge Base for more troubleshooting tips. If your problem is not solved please feel free to post in vtiger Discussions.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 22 -
11. Known Issues •
If you select Start Program Files vtiger CRM start vtiger CRM. First you have to start Apache manually then use Start Program Files vtiger CRM start vtiger CRM to start vtiger CRM.
•
If you select to use the existing Apache and (or) MySQL options during installation, stopping vtiger CRM using Start Program Files vtiger CRM Stop vtiger CRM will not work. You have to stop Apache and MySQL manually. Note: vtiger CRM does not stop the Apache and MySQL as you may be using Apache and MySQL software for some other applications.
•
While uninstalling vtiger CRM, some of the files are not deleted. You have to delete those files manually.
•
If the -specific Apache is selected and PHP is already associated with the existing Apache (conf/httpd.conf), bundled PHP cannot be associated with the existing Apache. To overcome this issue, you have to install another instance of Apache and associate the bundled PHP with this instance.
•
In case of Apache, if the entry "ScriptAlias /cgi-bin/
” is not present in <Apache Home>/conf/httpd.conf then the httpd.conf file will not be updated to associate PHP with Apache. The has to manually edit the httpd.conf file.
•
If you create a new role with space in the name (for example, Sales ), then you will have issues allocating permissions.
•
You cannot change the ’s role once specific role is assigned to the .
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 23 -
12. Related Documents You can refer to the following documents to work with other vtiger CRM Add-ons: •
vtiger Outlook Plug-in Manual
•
vtiger Office Plug-in Manual
•
vtiger Thunderbird Extension Manual
•
vtiger Customer Portal Manual
•
vtiger Web Forms Manual
•
vtiger Firfox Toolbar Manual
Note: The vtiger Outlook Plug-in, vtiger Office Plug-in, and vtiger Thunderbird/Mozilla Extension are browser-side software and work only with Microsoft Outlook, Microsoft Office, and Thunderbird/Mozilla respectively.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 24 -
13. Customer Please post your valuable comments, feature requests, and issues in vtiger CRM Discussions (http://www.vtiger.com/discussions/) so that we can provide technical for you. Information: vtiger Systems India Pvt. Ltd. 40-41-42, Flat D-II, Sivasundar Apartments, Shastri Street, Velachery, Chennai – 600 042, INDIA Phone No: +91-44-4202-1990 Toll Free (USA & Canada): +1-877-788-4437
Public : http://discussions.vtiger.com
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
((FFoorr W Wiin nd doow wss O OS S))
Document History Revision 5.0.2 Date: October 30, 2006
-2Table of Contents
1. System Requirements .......................................................................3 2. How do I choose right distribution? .....................................................4 3. Installation Prerequisites ...................................................................5 4. Installing in Apache Web Server .........................................................6 4.1 Installing Complete Package ................................................................ 6 4.2 Installing without Apache and MySQL.................................................... 8 4.3. Installing vtiger CRM Source ..............................................................10
5. Installing vtiger CRM in Microsoft IIS................................................. 13 6. Starting & Stopping vtiger CRM Server .............................................. 14 7. Configuring vtiger CRM Server.......................................................... 15 8. Starting vtiger CRM in Web Browser .................................................. 18 9. Upgrading to 5.0.2 ......................................................................... 19 10. Troubleshooting Tips ..................................................................... 20 11. Known Issues............................................................................... 22 12. Related Documents ....................................................................... 23 13. Customer ......................................................................... 24
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-3-
1. System Requirements •
Hardware: x486 with 512 MB RAM or higher with a minimum of 250 MB disk space.
•
Operating System: Windows 2000/NT/XP.
•
Web Server: Apache version 2.0.40 and higher or Microsoft version IIS 5 and higher.
•
Database: MySQL version 4.1.x through 5.1.x.
•
PHP: 5.0.x through 5.1.x version.
•
Web Browser: IE 5.5/6.0, Firefox 1.5.x and above, or Opera version 7.21 and above.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-4-
2. How do I choose right distribution? vtiger CRM software is available in both executable and source formats. You can choose the right distribution according to your experience with LAMP/WAMP based applications.
Recommended vtiger CRM Distributions Type of
Distribution Type
I am new to Web-based software – Beginners
vtigercrm-5.0.2.exe
I have hands-on experience with Apache and MySQL, but not familiar with PHP – Intermediate s
vtigercrm-5.0.2.exe
I have hands-on experience with MySQL and PHP-based applications – Advanced PHP s/Developers/Hosting Service Providers
vtigercrm-5.0.2.tar.gz
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-5-
3. Installation Prerequisites •
You must have " privileges" on the system. If you are installing without 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 4.1.x through 5.1.x, and PHP 5.0x through 5.1.x. If these software are already installed in your system, you can use the same. Otherwise use the Apache and MySQL bundled with vtiger CRM software.
•
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
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-6-
4. Installing in Apache Web Server To install vtiger CRM, Apache, MySQL, and PHP are very essential. You can install vtiger CRM according to your software requirements: •
Install complete package of vtiger CRM - vtigercrm-5.0.2.exe. Note: Use this package if you have not installed Apache, MySQL, and PHP packages in your system.
•
Install vtiger CRM with bundled PHP - vtigercrm-5.0.2.exe. Note: This package is same as above except that you may not install Apache and MySQL. But PHP package will be installed even though it is available in your system. Use this package if you have already installed Apache and MySQL, packages in your system.
•
Install vtiger CRM source – vtigercrm-5.0.2.tar.gz. Note: Use this package if you have already installed Apache or Microsoft IIS, MySQL, and PHP in your system.
4.1 Installing Complete Package For the convenience of business community and novice PHP, vtiger CRM is bundled with optimized versions of Apache, MySQL, and PHP along with vtiger CRM core modules. To install the complete package of vtiger CRM: 1. vtigercrm-5.0.2.exe from the Sourceforge.net. 2. Run the vtigercrm-5.0.2.exe. Installation process starts within a few seconds. 3. In the Welcome to the InstallShield Wizard for vtiger CRM dialog, click the Next button. 4. In vtiger CRM Software License Agreement dialog, read the license agreement and click the Yes button if you accept the license agreement. 5. Follow the steps given below to install Apache Web server bundled with vtiger CRM:
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-7i.
In the Install Apache Options dialog, select the Install Apache option and click the Next button.
ii.
In the Install Apache Web Server Port Selection dialog, enter the port number in which Apache Web server must be started and click the Next button. If you are not sure, you can use the default port number "80".
iii.
In the Apache Service Option dialog, select the Start the apache as a service check box to automatically start vtiger CRM as a service during startup.
6. Follow the steps given below to install MySQL bundled with vtiger CRM: i.
In the Install MySQL Options dialog, select the Install MySQL option and click the Next button.
ii.
In the MySQL Connection Parameters Configuration dialog, enter the following MySQL connection parameters and click the Next button: Port Number: The port at which MySQL database server to must be started. Name: The name to in to the MySQL database. : The for the . If you are not sure, use the default Port as 3306, and Name as root. Keep the field empty.
7. In the Chose Destination Location dialog, either use the default directory C:\Program Files\vtigerCRM5_0 or select a new directory. After selecting the destination directory, click the Next button. 8. In the Select Program Folder dialog, either use the default program folder vtiger CRM 5 or enter a new folder. Now click the Next button. 9. In the Start Copying Files dialog, review Apache, MySQL, and PHP configuration settings. Click the Next button to start the installation or click the Cancel button to abort the installation. It will take approximately five minutes to complete the installation. Note: During vtiger CRM installation, <Apache Home>/conf/httpd.conf and %SystemRoot%/php.ini files will be modified. Also a backup copy of these files will be stored under %SystemRoot%/vtigerbackup folder. Please proceed further if you accept these changes.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-810. In the Installation Wizard Complete dialog, select the Yes I want to start the server option if you want to start vtiger CRM server immediately. Also select the Yes, I want vtiger CRM icon on desktop option if you want a desktop shortcut. Click the Finish button. It will take a few minutes to start vtiger CRM server.
4.2 Installing without Apache and MySQL Use the existing Apache and MySQL if already installed in your system provided these versions are compatible with vtiger CRM. Follow the procedure given below to install only vtiger CRM: 1. vtigercrm-5.0.2.exe from the Sourceforge.net. 2. Run the vtigercrm-5.0.2.exe. Installation process starts within a few seconds. 3. In the Welcome to the InstallShield Wizard for vtiger CRM dialog, click the Next button. 4. In vtiger CRM Software License Agreement dialog, read the license agreement and click the Yes button, if you accept the license agreement. 5. Follow the steps given below to use the existing Apache Web server: i.
In the Install Apache Options dialog, select the Use Installed Apache option and click the Next button.
ii.
In the Apache Web Server Home Selection, browse the directory where the Apache is installed. Please note that if you give a wrong directory, installation will not proceed further.
iii.
The Apache configuration file httpd.conf present under the <Apache Home>/conf directory, will be modified during vtiger CRM installation. Click Yes if you accept the “This selection will take backup and modify the httpd.conf file of the Apache installed in your system. Do you want to continue?” message.
iv.
In the Apache Web Server Home Selection dialog, click the Next button.
6. Follow the steps given below to use the existing MySQL: i.
In the Install MySQL Options dialog, select the Use Installed MySQL option and click the Next button.
ii.
In the MySQL Path Selection dialog, browse the directory where MySQL is installed and click the Next button.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
-9Warning: If you give a wrong directory, installation will not proceed further. iii.
In the MySQL Connection Parameters Configuration dialog, enter the following MySQL connection parameters and click the Next button: Port Number: The port at which MySQL database server is running. Name: The name to to the MySQL database. : The for the . If you are not sure, you can use the default Port – 3306, Name – root. Keep the field empty.
7. In the Choose Destination Location dialog, either use the default program folder or enter a new folder. Now click the Next button. 8. In the Start Copying Files dialog, review the Apache, MySQL, and PHP configuration settings. Click the Next button to start the installation or click the Cancel button to abort the installation. It takes approximately five minutes to complete the installation. Note: During vtiger CRM software installation, the <Apache Home>/conf/httpd.conf and %SystemRoot%/php.ini files will be modified. Also a backup copy of these files will be stored with file extension as vtigercrm.backup. Please proceed further if you accept the changes. 9. In the Installation Wizard Complete dialog, select the Yes I want to start the server check box if you want to start vtiger CRM server immediately. Also select the Yes, I want vtiger CRM icon on desktop check box if you want a desktop shortcut. Click the Finish button.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 10 -
4.3. Installing vtiger CRM Source If you are already using WAMP environment for other PHP based applications, you can very well use the same setup for vtiger CRM installation, provided your setup meets the vtiger CRM requirements. IMPORTANT NOTE vtiger CRM Source installation is targeted only for the Advanced s/Developers/Hosting Providers. Beginners are strongly recommended to use the vtiger optimized WAMP setup (vtigercrm-5.0.2.exe). If you are using PHP based application first time, please skip this section and follow the steps in 5.1 Installing Complete Package
How to get WAMP? WAMP stands for Windows, Apache, MySQL, and PHP. You can optimized Apache, MySQL, and PHP with some other Add-on packages from various sources. The most popular sites that provide WAMP setup are WAMPP and XAMPP (apachefriends.com). There are many Websites offers WAMP distributions freely. Recommended WAMP Distributions: WAMP: Version 1.6.5 XAMPP: Version 1.5.3a Before using your own WAMP setup, please ensure that Apache, MySQL, and PHP versions meet the vtiger CRM requirements. •
Apache – 2.0.40 and above
•
MySQL – 4.1.x through 5.1.x
•
PHP – 5.1.x (you must configure php.ini settings as per Pre-installation Check List. Otherwise some of the features will not work.
To install vtiger CRM Source 1. vtigercrm-5.0.2.tar.gz from the Sourceforge.net. 2. Extract the vtigercrm-5.0.2.tar.gz file into Apache root directory (For example, C:\Program Files\Apache Group\Apache2\htdocs)
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 11 3. Start Web Browser and follow the procedure given in the "Configuring vtiger CRM Server" section for completing vtiger CRM installation.
Pre-installation Check List
1. You must have READ/WRITE permissions on the following vtiger CRM folders: •
PHP Configuration - config.inc.php
•
Cache Directory - cache/
•
Mail Merge Template Directory -test/wordtemplate/
•
s Directory - storage/
•
Install Directory - install/
•
Installation file -install.php
•
Product Image Directory -test/product/
•
Image Directory - test//
•
Image Directory- test//
•
Logo Directory- test/logo/
•
Email Templates Directory -modules/Emails/templates/
•
Privileges - _privileges/
•
Smarty Compile Directory - Smarty/templates_c
•
Tabdata File Permission - tabdata.php
•
ParentTabdata File Permission - parent_tabdata.php
•
Smarty Cache Directory - Smarty/cache
2. Your php.ini must configured with following parameters: •
safe_mode = Off
•
display_errors = On
•
file_s = On
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 12 Pre-installation Check List
•
_globals = Off
•
max_execution_time = 600
•
output_buffering= On
•
memory_limit = 32M
•
error_reporting = E_WARNING & ~E_NOTICE
•
allow_call_time_reference = On
•
log_errors = Off
•
short_open_tag= On
•
extension=php_gd2.dll
•
extension=php_imap.dll
•
extension=php_mysql.dll
•
extension=php_mysqli.dll
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 13 -
5. Installing vtiger CRM in Microsoft IIS vtiger CRM source can be installed in Microsoft IIS. You must have already installed the Microsoft IIS 5 or above, MySQL, and PHP before installing vtiger CRM.
Configuring Microsoft IIS to work with PHP-based application Please follow the procedure given below to execute PHP scripts in Microsoft IIS: 1. Configuring the php.ini file: the Windows binary for the latest version of PHP (vtiger CRM s PHP version 5.1.x). Once you've ed it, unzip it to a C:\ and rename the folder to "php". Open the PHP.INI-DIST file from the C:\PHP folder and locate the following line: ;cgi.force_redirect = 1 Remove comment in the above line and change the setting to 0 as shown below to run PHP under IIS. Make the necessary changes and save the file as php.ini in your Windows folder (C:\WINNT on my computer): cgi.force_redirect = 0 2. Configuring PHP in Microsoft IIS. Please refer to the following sites for more details: • http://in.php.net/manual/en/install.windows.iis.php • http://www.phpbuddy.com/category.php?cat_id=INST Note: All the directories under vtigerCRM should have READ access permission. Otherwise, some of the images/files cannot be executed. To install vtiger CRM in Microsoft IIS, follow the procedure given below: 1. vtigercrm-5.0.2.tar.gz from the Sourceforge.net. 2. Extract the vtigercrm-5.0.2.tar.gz file into IIS root directory (For example, C:\Inetpub\wwwroot\). 3. Start Web browser and follow the procedure given in the "Configuring vtiger CRM Server" section for completing vtiger CRM installation.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 14 -
6. Starting & Stopping vtiger CRM Server You can start or stopped according to the type of distribution. To start vtiger CRM Server •
•
If you have installed the Apache and MySQL that are bundled with vtiger CRM, start vtiger CRM server as given below: •
Select Start
Program Files
vtiger CRM
•
Click vtiger CRM desktop shortcut.
Start vtiger CRM
If you are using your own WAMP setup, start Apache manually and connect to vtiger CRM from http://
To stop vtiger CRM Server •
If you have installed the bundled Apache, MySQL, and PHP with vtiger CRM, select Start Program Files vtiger CRM Stop vtiger CRM.
•
If you are using your own WAMP setup, stop the Apache and MySQL manually.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 15 -
7. Configuring vtiger CRM Server After installing vtiger CRM, you must configure vtiger CRM server with database, Website, currency, and istration access details. The vtiger CRM database tables and demo data are populated during configuration, which will take about 5 minutes time. 1. Start Web browser and enter
Host Name (mandatory) – By default, Host Name is set as <System Name>:
•
Name (mandatory)– Specify name for accessing the database.
•
(optional)– Specify for the name.
•
Database Name (mandatory)– By default database name is vtigercrm5. You can also create a database as per your requirements.
•
Root Name (mandatory)– If you have selected the create data option in Database Name field, specify root name for creating database.
•
Root (mandatory)– Specify for the root name.
Site Configuration
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 16 •
URL (mandatory) – Enter the host name. By default, it is http://<system name>.
•
Path (mandatory) – By default, this is the path where vtiger CRM is installed.
•
Path to Cache Directory (must have write permission) - By default, this is cache/. This folder is used to store the files, such as attachments, and import/export- related files temporarily.
Configuration •
name – By default, the name is set as “”.
•
(mandatory) – By default, the is set as “”. You can change after logging in to vtiger CRM.
•
Email ID – By default email ID is [email protected]. You can also change the ’s e-mail ID.
Currency Configuration •
Name (mandatory) – Specify your fiscal currency name (For example, Dollar).
•
Symbol (mandatory) – Specify your currency symbol (For example, $).
•
Code (mandatory) – Specify international code of your currency (For example, USD).
5. In the Confirm Settings page, review the configuration information. If you want to change the details, click the Change button. If you want to populate some data, select the Also populate demo data? check box. Now click the Next button. 6. In the Config File Creation page, click the Next button. It will take approximately 4 minutes to complete the configuration. 7. In the Create Database Tables page, the created database tables are displayed. Click the Finish button to complete the installation process. Once installation is completed successfully, installation directory will be locked to secure your installation against unauthorized access. In the page, by default the Name field is set as “”. In field, enter the you have set during installation process. Once you have logged in successfully, you can view the vtiger CRM Home page as shown
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 17 below:
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 18 -
8. Starting vtiger CRM in Web Browser •
If you installed the Apache and MySQL that are bundled with vtiger CRM, select Start Program Files vtiger CRM vtiger CRM Client
•
If you are using vtiger CRM source with your own WAMP environment, open the http://
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 19 -
9. Upgrading to 5.0.2 We strongly recommend s to migrate from the vtiger CRM previous version to the latest version vtiger CRM 5.0.2. Currently we are providing UI based data migration for the following versions •
V 4.2.x
V 5.0.2
•
V 5.0.0
V 5.0.2
•
V 5.0.1
V 5.0.2
Warning: Please don't forget to take the source code backup before extracting the patch; otherwise all your custom code will be overwritten by the new code. To version 5.0.2 1. the vtiger CRM 5 - Patch 2 patch from Sourceforge.net 2. Extract the vtiger_CRM_5.0.0_Patch_2.zip to
Other Settings
Migration Wizard link.
5. In the Migration Wizard, follow the steps given the wizard.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 20 -
10. Troubleshooting Tips 1. I am unable to complete the initial configuration process and the following error message is displayed in Web browser: Warning: mysql_connect(): Host <'Server Name'> is not allowed to connect to this MySQL server in C:\Program Files\vtigerCRM\apache\htdocs\vtigerCRM\database\DatabaseConnection.php on line 42 Could not connect to server <Server Name>:<port no> as vtigercrm.Host <'Server Name'> is not allowed to connect to this MySQL server Solution: This error message is displayed when you have not uninstalled the older version of vtiger CRM fully. Follow the procedure given below to overcome this issue: 1. Stop vtiger CRM server from Start vtiger CRM.
Program Files
vtiger CRM
Stop
2. Start the Command Prompt and enter the following command: :\mysql –u root –port 3. Drop the existing vtigercrm database from MySQL as given below: mysql>drop database vtigercrm; 4. Start vtiger CRM server from Start --> Program Files -->vtiger CRM ->Start vtiger CRM. 2. After completing the installation I am not sure, how to start vtiger CRM. •
If you are using bundled Apache and MySQL with vtiger CRM Start vtiger CRM server from Start Program Files vtiger CRM Start vtiger CRM. After a few seconds, start vtiger CRM client from Start Program Files vtiger CRM Start vtiger CRM.
•
If are using the existing Apache and MySQL Start the Apache Web server manually from the <Apache Home>/bin directory then start Web browser and enter the following URL: http://
3. By default, the value for log4php.rootLogger is set as “debug” in log4php.properties file present under
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 21 Line: 10 log4php.rootLogger=debug, A2
Please refer to: vtiger Knowledge Base for more troubleshooting tips. If your problem is not solved please feel free to post in vtiger Discussions.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 22 -
11. Known Issues •
If you select Start Program Files vtiger CRM start vtiger CRM. First you have to start Apache manually then use Start Program Files vtiger CRM start vtiger CRM to start vtiger CRM.
•
If you select to use the existing Apache and (or) MySQL options during installation, stopping vtiger CRM using Start Program Files vtiger CRM Stop vtiger CRM will not work. You have to stop Apache and MySQL manually. Note: vtiger CRM does not stop the Apache and MySQL as you may be using Apache and MySQL software for some other applications.
•
While uninstalling vtiger CRM, some of the files are not deleted. You have to delete those files manually.
•
If the -specific Apache is selected and PHP is already associated with the existing Apache (conf/httpd.conf), bundled PHP cannot be associated with the existing Apache. To overcome this issue, you have to install another instance of Apache and associate the bundled PHP with this instance.
•
In case of Apache, if the entry "ScriptAlias /cgi-bin/
•
If you create a new role with space in the name (for example, Sales ), then you will have issues allocating permissions.
•
You cannot change the ’s role once specific role is assigned to the .
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 23 -
12. Related Documents You can refer to the following documents to work with other vtiger CRM Add-ons: •
vtiger Outlook Plug-in Manual
•
vtiger Office Plug-in Manual
•
vtiger Thunderbird Extension Manual
•
vtiger Customer Portal Manual
•
vtiger Web Forms Manual
•
vtiger Firfox Toolbar Manual
Note: The vtiger Outlook Plug-in, vtiger Office Plug-in, and vtiger Thunderbird/Mozilla Extension are browser-side software and work only with Microsoft Outlook, Microsoft Office, and Thunderbird/Mozilla respectively.
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
- 24 -
13. Customer Please post your valuable comments, feature requests, and issues in vtiger CRM Discussions (http://www.vtiger.com/discussions/) so that we can provide technical for you. Information: vtiger Systems India Pvt. Ltd. 40-41-42, Flat D-II, Sivasundar Apartments, Shastri Street, Velachery, Chennai – 600 042, INDIA Phone No: +91-44-4202-1990 Toll Free (USA & Canada): +1-877-788-4437
Public : http://discussions.vtiger.com
Copyright 2003-2006 vtiger.com. All rights reserved. vtiger is a trademark of vtiger.com. All other trademarks are the property of their respective owners.
Related Documents g842
Vtigercrm Installation Manual Windows 22r2w
November 2019 44
Installation Aps Windows q1x6
October 2020 0
Moshell Installation For Windows 2k1s25
November 2019 86
Windows Automated Installation Kit.docx 91n7
September 2022 0
Windows Self Installation x3mw
December 2019 35
Windows Installation Fedena 2u1a
November 2019 41More Documents from "Nischitha Nish K V" 72d5k
Vtigercrm Installation Manual Windows 22r2w
November 2019 44
Affixus Hip Fracture Nail Surgical Technique 2c1z22
November 2019 132
360441549-ee204-solved-examples-on-transformers.pdf 4f81
December 2021 0
Swot Adidas 5d172
January 2022 0
Meristematic Tissues 4x475f
March 2021 0