Документация

Русскоязычная

Руководство пользователя и администратора системы SalesPlatform vtiger CRM 7.0

Руководство пользователя и администратора системы SalesPlatform vtiger CRM 6.4, 6.5

Инструкция по миграции до последней версии SalesPlatform vtiger CRM

Ресурсы для разработчиков SalesPlatform vtiger CRM

Англоязычная

Инструкции пользователя и администратора для vtiger CRM 6.x

Документация для разработчиков vtiger CRM

Краткая инструкция по установке SalesPlatform vtiger CRM в Linux Debian

Основными требованиями для установки являются web-сервер Apache, интерпретатор PHP (версия >= 5.4) и СУБД MySQL (версия >= 5.0). Вполне подойдут версии этих пакетов, находящиеся в стандартном репозитории Debian. Установим их с помощью aptitude:

# aptitude update
# aptitude install apache2 mysql-server php5

 

Помимо этих основных зависимостей следует установить также дополнительные:

# aptitude 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 g++ gawk
  libapache2-mod-php5 php5-gd php5-imap php5-zlib php5-curl php5-mysql
# pecl install timezonedb

 

Затем распаковываем дистрибутив в каталоге /var/www:

# cd /var/www/
# tar xzf <путь_к_дистрибутиву>/salesplatform-vtigercrm-6.5.0-201611.tar.gz

 

На время выполнения установки дадим веб-серверу права на запись для всех файлов и каталогов. Сделаем это, изменив владельца и группу на www-data (стандартный пользователь сервера Apache в Debian):

# cd vtigercrm
# chown -R www-data.www-data *

 

Необходимо также исправить конфигурационный файл PHP (/etc/php5/apache2/php.ini), задав следующие значения параметров:

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE
safe_mode = off
display_errors = off
file_uploads = on
max_execution_time = 600
memory_limit = 128M
log_errors = on
output_buffering = on
short_open_tag = on
max_input_vars = 100000
extension=timezonedb.so

 

Для PHP версий < 5.4 дополнительно:

allow_call_time_pass_reference = on
register_globals = off

 

Если установлен модуль PHP suhosin, то необходимо также исправить конфигурационный файл этого модуля (/etc/php5/conf.d/suhosin.ini), задав следующие значения параметров:

suhosin.get.max_value_length = 8192
suhosin.post.max_vars = 100000
suhosin.request.max_vars = 100000

 

В настройках MySQL рекомендуется установить UTF8 в качестве кодировки по умолчанию. Для этого создадим файл /etc/mysql/conf.d/utf8.cnf со следующим содержанием:

[mysqld]
collation_server=utf8_general_ci
character_set_server=utf8
sql_mode=NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
init_connect='SET collation_connection = utf8_general_ci'
init_connect='SET NAMES utf8'

 

Для MySQL версии < 5.5 дополнительно требуются опции default-character-set в секциях mysqld и mysql:

[mysqld]
default-character-set=utf8
[mysql]
default-character-set = utf8

 

Для корректной работы с кодировками при импорте данных в CRM на сервере должны быть установлены соответствующие кодировкам локали: CP1251, UTF-8 и ISO-8859-1. Необходимо проверить существующие локали и установить недостающие (важно точное соответствие названия кодировки и локали):

# locale -a
# localedef -i ru_RU -f CP1251 CP1251
# localedef -i ru_RU -f UTF-8 UTF-8
# localedef -i en_US -f ISO-8859-1 ISO-8859-1

 

Перезапускаем серверы:

# /etc/init.d/mysql restart
# /etc/init.d/apache2 restart

 

Наконец, все готово. Переходим в браузере по адресу: http://адрес_сервера/vtigercrm и попадаем в мастер начальной установки vtiger CRM, который в интерактивном режиме поможет выполнить начальную конфигурацию БД vtiger CRM.

При возникновении ошибки «Invalid request» при работе мастера необходимо задать переменную $GLOBALS['csrf']['secret'] в файле libraries/csrf-magic/csrf-magic.php случайной строкой.

После установки снимем права на запись для ряда подкаталогов системы:

# cd /var/www/vtigercrm
# chown -R root.root *
# chown -R www-data.www-data cache logs modules storage test user_privileges tabdata.php parent_tabdata.php config.inc.php
# chmod +x /var/www/vtigercrm/cron/vtigercron.sh

 

Для работы Планировщика необходимо создать файл vtiger в /etc/cron.d/ со следующим содержимым:

MAILTO=""
*/5 * * * * www-data /usr/bin/flock -n /tmp/vtigercron.lock /var/www/vtigercrm/cron/vtigercron.sh

Необходимо убедиться, что в скрипте vtigercron.sh указан верный путь к интерпретатору php.

Для интеграции с КЛАДР (SalesPlatform Vtiger CRM версии 6.1.0-201412 и выше) потребуется распаковать архив с sql-дампом адресов и импортировать его либо в базу данных CRM, либо в отдельную базу данных (начиная с версии SalesPlatform Vtiger CRM 6.2.0-201505):

$ cd <путь_к_бд_адресов>
$ tar xzf salesplatform-kladr-6.5.0-201611.tar.gz
$ mysql -u <пользователь> -p<пароль> <база_данных_кладр> -q < salesplatform-kladr.sql

Внимание. Данная операция может занять значительное количество времени.

Инструкция по настройке КЛАДР

 

Базовые некоторые настройки безопасности Vtiger для веб-сервера:

В конфигурационном файле Apache (например, /etc/apache2/sites-enabled/000-default.conf):

<Directory /var/www/>
  Options -Indexes
  AllowOverride All
</Directory>

 

В файле .htaccess Vtiger (например, /var/www/vtigercrm/.htaccess):

RedirectMatch 403 (?i)/+storage/
RedirectMatch 403 (?i)/+.*\.txt
RedirectMatch 403 (?i).*\.log$
RedirectMatch 403 (?i)/+(soap|cache|data|include|includes|logs|modules|pkg)/.(php|tpl)