Vtiger521:Linux Installation
From http://wiki.vtiger.com/archives
This documentation applies to vtigerCRM 5.2.1 and vtigerCRM 5.2.0
Contents |
System Requirements
- Hardware Recommended:1.8GHz Processor with 2 GB RAM and 10 GB free disk space.
- Web Browser: Firefox 2.x, Chrome 5.x, IE 7.x
- Operating System : Debian 4.0/5.0, Centos up-to 5.2, Fedora Core 6/9
How do I choose right distribution?
| Type Of User | Distribution Type |
|---|---|
| I am new to Web-based software – Beginners | vtiger CRM 5.2.0 BIN |
| I have hands-on experience with MySQL and PHP-based applications – Advanced PHP Users/Developers/Hosting Service Providers | vtiger CRM 5.2.0 TAR GZ |
Operating System Dependency Packages
To install vtigerCRM520 Bin you need to install some dependencies, here are the dependencies for Debian ,Centos and Fedora
| Debian | Centos | Fedora |
|---|---|---|
| binutils | libpng | libpng |
| cpp | libpng-devel | libpng-devel |
| flex | libjpeg | libjpeg |
| gcc | libjpeg-devel | libjpeg-devel |
| libarchive-zip-perl | freetype | freetype |
| libc6-dev | freetype-devel | freetype-devel |
| libcompress-zlib-perl | xfree | zlib-devel |
| libpcre3 | Xfree86-dev | xorg-x11 |
| libpopt-dev | openssl | openssl-devel |
| lynx | openssl-devel | krb5-devel |
| m4 | krb5 | imap-2004d |
| make | krb5-devel | xorg-x11-dev |
| ncftp | make | |
| nmap | zlib | |
| perl | binutils | |
| perl-modules | automake | |
| unzip | gcc | |
| zip | flex | |
| zlib1g-dev | autoconf | |
| autoconf | bison | |
| automake1.9 | libxml2-devel | |
| libtool | gcc-c++ | |
| bison | perl-XML-LibXML | |
| openssl | ||
| autotools-dev | ||
| gcc | ||
| libpng12-dev | ||
| libjpeg62-dev | ||
| libfreetype6-dev | ||
| libssl-dev | ||
| libxml2-dev | ||
| libxml2 | ||
| g++ | ||
| gawk |
To install dependencies in debian use the following command (apt-get install package names)
Example:#apt-get install binutils cpp flex gcc libarchive-zip-perl libc6-dev libcompress-zlib-perl libpcre3 libpopt-dev lynx m4 make ncftp nmap openssl perl perl-modules unzip zip zlib1g-dev autoconf automake1.9 libtool bison autotools-dev gcc libpng12-dev libjpeg62-dev libfreetype6-dev libssl-dev libxml2-dev libxml2
To install dependencies in fedora use the following command (yum install package names)
Example:yum install libpng libpng-devel libjpeg libjpeg-devel freetype freetype-devel zlib-devel xorg-x11 openssl-devel krb5-devel imap-2004d xorg-x11-dev
To install dependencies in centos use the following command (yum install package names)
Example:yum install libpng libpng-devel libjpeg libjpeg-devel freetype freetype-devel xfree Xfree86-dev openssl openssl-devel kbr5 kbr5-devel make zlib krb5-devel binutils automake gcc flex autoconf bison libxml2-devel gcc-c++ perl-XML-LibXML
Binary Installation
To install vtigerCRM520vb1 bin please follow the below mentioned steps
Please ensure that you have administrator privileges on the system. If you are installing without administrator privilege, vtiger CRM software will not be installed properly.
For the convenience of first time users, vtiger CRM is bundled with compatible versions of Apache, MySQL, and PHP. Follow the procedure given below to install the complete package of vtiger CRM:
1.Download vtiger CRM 5.2.0 BIN ----> vtiger CRM 5.2.0 BIN
2.Log in as a root user.
3.Grant execute permission to run the vtigercrm-520vb1 bin file
#chmod 777 vtigercrm-5.2.0vb1.bin
4. Run the vtigercrm-5.1.0.bin file as given below:
#./vtigercrm-5.2.0vb1.bin
Please read the license agreement and enter Y to start the installation process or N to abort the installation.
5.To install the Apache follow the procedure given below:
- Press Y key to install the Apache when the following message is displayed:
Do you want to install Apache 2.0.50 that is bundled with vtiger CRM
- Specify the absolute path for installing the Apache when the following message is displayed:
Specify the absolute path for installing vtiger CRM (For example /home/vtiger) and then press ENTER:
- Press Y key to create a new directory
if it does not exist,the following message will be displayed: /home/vtiger directory does not exist. Create it now? Please type yes(y) or no(n)
- Specify the Apache port number when the following message is displayed:
Specify the port where you wish to start Apache: Port Number (example:82)
Make sure the Apche port should be free
6.To install the MySQL follow the procedure given below:
- Press Y key to install the MySQL when the following message is displayed:
Do you want to install MySQL 5.0.19 that is bundled with vtiger CRM?
- Specify the MySQL port number, user name, and password. If the port you have specified is free, installation process will continue otherwise specify a different port.
7.Installation details, such as Apache, MySQL, PHP, and GD library are displayed. Press C to continue or Q to abort the installation. Installation process takes approximately 5 minutes.
8.Press c to start vtiger CRM server immediately when the following message is displayed:
After installation the message will come like this
***************************************************************************************************** Please access the product at http://localhost:<apache port> *****************************************************************************************************
Then you can access the product through browser by giving localhost or ip address with apache portnumber
Example:http://localhost:82
To continue with Configuration Wizard please click here
How to start and stop vtigercrm5.2.0
Click here for start and stop the vtigercrm5.2.0
Source Installation
System Requirements
- Hardware: Hosted.
- Web Server: Apache 2.0.40 or above.
- Database: MySQL version 4.1.x through 5.1.x.
- PHP:PHP 5.0.x through 5.3.x.
- Web Browser: Firefox 1.5.x and above, IE7
- Operating System: Debian 4.0/5.0, Centos, Ubuntu or Fedora Core/6/9
MYSQL Requirements
Please make sure to review MySQL configuration (my.cnf or server start parameters)
| SQL_MODE | Should not have STRICT_TRANS_TABLE |
| ENGINE=InnoDB | Should be available. (Turn off --skip-innodb) |
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 | |
| 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 |
| allow_call_time_pass_reference | on |
| error_reporting | E_WARNING & ~E_NOTICE |
| safe_mode | off |
| display_errors | on |
| file_uploads | on |
| max_execution_time | 600 |
| memory_limit | 64M |
| 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 user/group who owns webserver process (like www-data or httpd or apache). |
- 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 for Source
- Download vtiger CRM 5.2.0 TAR GZ
- Now untar the source file in your apache web root to untar use the follwing command
tar -xvzf vtigercrm-5.2.0.tar.gz
- After untar the file give the permissions for that file by using this command
chmod -R a+rw filename(vtigercrm)
| NOTE:
Your apache and mysql should be start |
- Now go to the browser and access the product by using your ip address like this
http://192.168.0.1/vtigercrm
To continue with Configuration Wizard Click here
