Русскоязычная
Руководство пользователя и администратора системы SalesPlatform Vtiger CRM 7
Руководство пользователя и администратора системы SalesPlatform Vtiger CRM 6.4, 6.5
Инструкция по миграции до последней версии SalesPlatform Vtiger CRM
Ресурсы для разработчиков SalesPlatform Vtiger CRM
Англоязычная
Инструкции пользователя и администратора для Vtiger CRM 6.x
Документация для разработчиков Vtiger CRM
Краткая инструкция по установке SalesPlatform Vtiger CRM в Linux Debian
Минимальные системные требования к серверу (до 5 активных пользователей): 1Ghz x 1CPU, 1Gb RAM, 20Gb HDD.
Основными требованиями для установки являются 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-7.1.0-201803.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/ libraries/tcpdf/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-7.0.1-201711.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)