Russian 504 installation manual for linux

From vtiger.com

Вернуться на страницу русскоязычной документации

Статус: рабочий черновик

Краткая сводка: Настоящий документ содержит перевод официального руководства vtiger.com по установке vtiger CRM версии 5.0.4 на ОС Linux.

Установка vtiger CRM 5.0.4 на ОС Linux (официальное руководство)

[edit] Требования к системе

• Аппаратное обеспечение: x486 или лучше с 512 MB RAM или больше, минимум 250 MB свободного места на жестком диске
• Операционная система: RedHat Linux 7.2/8.0/9.0, SuSe 9.0, Debian 3.0/4.0, Mandrake 10.0, или Fedora Core 3/6.
• Веб сервер: Apache 2.0.40 или более новый.
• Сервер базы данных: MySQL версий от 4.1.x до 5.1.x.
• PHP: версий от 5.0.x до 5.2.x.
• Браузер: Firefox 1.5.x и более новый или Opera 7.21 и более новый.

[edit] Выбор дистрибутива

vtiger CRM поставляется как в виде исполняемого файла установки, так и в исходных кодах. Вы можете выбрать наиболее подходящий дистрибутив в зависимости от опыта работы с веб-приложениями LAMP/WAMP.

Рекомендации по выбору дистрибутива vtiger CRM

[edit] Требуемые пакеты Linux

Внимание

Данный раздел носит информационный характер и предоставляется "КАК ЕСТЬ", без каких-либо гарантий, как явных, так и подразумеваемых.

Обратите внимание, что таблица скопирована из английского описания, как есть, без каких-либо исправлений.

[edit] Mandriva 2007.1

• libjpeg
• freetype
• libfreetype6 (в репозитории PLF)
• libpng3
• zlib1
• openssl
• libopenssl0.9.8-devel
• imap2006
• php packages
• php-adodb
• php-imap

[edit] До начала установки

• Убедитесь, что у вас права администратора в системе. Если установка производится пользователем, не обладающим правами администратора, система vtiger CRM не будет установлена правильно.
• До начала установки системы vtiger CRM 5 остановите сервисы Apache и MySQL.
• Программное обеспечение vtiger CRM 5 совместимо с Apache 2.0.40 и более новым, MySQL версий от 4.1.x до 5.1.x и PHP версий от 5.0.x до 5.2.x. Если эти пакеты уже установлены в вашей системе, их можно использовать. В противном случае используйте Apache и MySQL, входящие в комплект программного обеспечнеия vtiger CRM.
• У пользователя, от имени которого производится установка, должны быть права Чтения/Записи для некоторых каталогов vtiger CRM – Относится к установке vtiger CRM из исходных кодов
• Необходимо произвести настройку PHP ф вайле php.ini - Относится к установке vtiger CRM из исходных кодов

[edit] Установка vtiger CRM

Для использования системы vtiger CRM необходимы Apache, MySQL, и PHP. Вы можете установить систему vtiger CRM в зависимости от ваших требований:

Установка полного пакета vtiger CRM – vtigercrm-5.0.4.bin.

Установка vtiger CRM с поставляемым в комплекте PHP – vtigercrm-5.0.4.bin.

Установка только кодов vtiger CRM – vtigercrm-5-0-4.tar.gz.

[edit] Установка полного пакета

Для удобства начинающих пользователей vtiger CRM укомплектован совместимыми версиями Apache, MySQL, и PHP. Следуйте приведенным ниже инструкциям для установки полного пакета системы vtiger CRM:

1. Скачайте vtigercrm-5.0.4.bin с Sourceforge.net.
2. Подключитесь к системе как пользователь root.
3. Установите атрибуты исполнения для запуска файла vtigercrm-5.0.4.bin:
   

   #chmod 777 vtigercrm-5.0.4.bin

4. Запустите файл vtigercrm-5.0.4.bin как показано ниже:
   

   #./vtigercrm-5.0.4.bin

   Прочитайте лицензионное соглашение и нажмите клавишу Y для начала процесса установки или N для прекращения установки.
5. Для установки Apache выполните следующие шаги:
   1. Нажмите клавишу Y, чтобы установить Apache, когда будет выведено сообщение:

      Do you want to install Apache 2.0.50 that is bundled with vtiger CRM.

   2. Укажите абсолютный путь для установки Apache, когда будет выведено следующее сообщение:

      Specify the absolute path for installing vtiger CRM (For example /home/vtiger) and then press ENTER

   3. Нажмите клавишу Y для создания директории, если она не существует, когда будет выведено следующее сообщение:

      Please type yes (y) or no (n): /home/<vtiger CRM directory > directory does not exist. Create it now?

   4. Укажите номер порта для Apache, когда будет выведено следующее сообщение:

      Specify the port where you wish to start Apache: Port Number

6. Для установки MySQL следуйте инструкциям ниже:
   1. Нажмите клавишу Y для установки MySQL, когда будет выведено следующее сообщение:
      

      Do you want to install MySQL 5.0.19 that is bundled with vtiger CRM?

   2. Укажите номер порта MySQL, имя учетной записи и пароль. Если указан свободный порт, процедура установки будет продолжена, в противном случае программа установки попросит указать иной порт.
7. Будут показаны подробности установки, включая установку Apache, MySQL, PHP, и библиотеки GD. Нажмите клавишу C для продолжения установки или Q для прекращения установки. Процесс установки займет около 5 минут.
8. Нажмите клавишу Y для немедленного запуска сервера vtiger CRM, когда будет выведено следующее сообщение:

   Do you want to start vtiger CRM server?

Вы можете стартовать сервер выполнением файла startvTiger.sh, расположенного в директории <vtiger CRM Home>/bin.

[edit] Установка vtiger CRM без Apache и MySQL

Если на Вашей машине уже установлены Apache версии 2.0.40 и MySQL 4.1.x или более поздние, выполните описанные ниже шаги:

1. Загрузите файл vtigercrm-5.0.4.bin с Sourceforge.net.
2. Войдите в операционную систему как пользователь root.
3. Установите атрибут исполнения на файл vtigercrm-5.0.4.bin:

   chmod 777 vtigercrm-5.0.4.bin

4. Запустите на исполнение файл vtigercrm-5.0.2.bin, как показано ниже:

   ./vtigercrm-5.0.4.bin

   Пожалуйста, прочитайте лицензионное соглашение и нажмите клавишу Y, чтобы начать установку, или N, чтобы прервать установку.
5. Совершите перечисленные ниже шаги, чтобы использовать уже существующий Apache:
   1. Нажмите клавишу N для того, чтобы использовать существующий Apache, когда вы увидите следующее сообщение:

      Do you want to install Apache, 2.0.50 that is bundled with vtiger CRM ? Yes(y)/No(n):

   2. Нажмите клавишу Y для подтверждения использования существующего Apache, когда вы увидите следующее сообщение:

      Do you want to continue Yes(Y)/No(N): <Enter y if you are sure>

   3. Укажите директорию Apache в ответ на запрос:

      Specify the location of Apache in your system (For example /etc/httpd):

      Если Вы укажете неправильную директорию, будет выведено следующее сообщение:

      Kindly provide the location for httpd file in your system (example: /usr/sbin):

      Примечание: Если указанная директория или версия Apache несовместима, система предложит установить Apache из комплекта поставки.

   4. Укажите порт для Apache, когда будет выведено следующее сообщение:

      Specify the port where you wish to start the Apache:

      Примечание: Если какое-то иное приложение уже использует указанный порт, Вы можете выбрать другой порт, нажав N, или прекратить процедуру установки, нажав C.

6. Следуйте описанным ниже шагам, чтобы использовать существующий MySQL:
   1. Нажмите N для того, чтобы использовать существующий MySQL, когда будет выведено следующее сообщение:

      Do you want to Install the MySQL 5_1_19 that is bundled with vtigerCRM ? Yes(Y)/No(N):

   2. Укажите директорию MySQL, когда будет выведено следующее сообщение:

      Enter the absolute path of MySQL installed in your system:

      Укажите параметры соединения с MySQL, такие, как номер порта, пользовательское имя и пароль, а также расположение файла socket MySQL.

      Примечание: Если Вы укажете ошибочные параметры, будет выведено следующее сообщение:

      
      

      Either some other application is running on the port specified or there might be some errors in the connection parameters. Kindly start the specified mysql server and press C to continue with installation, press Y to re-enter the connection parameters, N to install the bundled MySQL or Q to quit: y Kindly re-enter the mysql connection parameters

7. Если при вводе данных во время выполнения шагов с 1 по 6 ошибок не обнаружено, вся введенная информация будет выведена на экран. Проверьте правильность деталей и нажмите C для продолжения или 'Q для прекращения установки.
8. Процесс установки занимает приблизительно 5 минут. Пожалуйста, игнорируйте выводимые в процессе установки сообщения.
9. При успешном завершении процесса установки будет выведено следующее сообщение:

   *********************** INFO *************************** Product Successfully installed Kindly use the link http://<hostname>/vtiger/install.php through your browser to start using the product ********************************************************

   Скопируйте приведенный на консоли URL в Web браузер и переходите к настройке сервера vtiger CRM.
10. Запустите ваш существующий Apache и проведите окончательную настройку вашего сервера vtigerCRM.

[edit] Установка vtiger CRM из исходного кода

Если вы уже используете среду WAMP для других приложений, базирующихся на PHP, вы можете легко использовать ту же схему для установки vtiger CRM, подразумевая, что ваши настройки удовлетворяют требованиям vtiger CRM.

ВАЖНОЕ ПРИМЕЧАНИЕ: Установка vtiger CRM из исходного кода предназначена только для Продвинутых пользователей, Разработчиков, и Провайдеров хостинга. Мы настоятельно рекомендуем начинающим пользователям и пользователям PHP среднего уровня использовать оптимизированную vtiger установку LAMP (vtigercrm-5.0.4.bin). Если вы используете приложения, базирующиеся на PHP, первый раз, пожалуйста, пропустите эту секцию, и следуйте инструкциям, изложенным в разделе "Установка полного пакета".

Как получить LAMP? LAMP означает Linux, Apache, MySQL, и PHP. Вы можете получить оптимизированный пакет Apache, MySQL, и PHP из различных источников. Наиболее популярными сайтами, предлагающими пакет LAMP, являются BitRock и LAMPP. Существует много иных Web сайтов, предлагающих бесплатные дистрибутивы LAMP. До начала использования вашей собственной установки LAMP, пожалуйста, убедитесь, что версии Apache, MySQL, и PHP удовлетворяют требованиям vtiger CRM. Apache – 2.0.40 и более новый MySQL – версии от 4.1.x до 5.1.x PHP – версии от 5.0.x до 5.2.x (вы должны установить настройки в php.ini, как это описано в разделе «Что необходимо проделать до начала установки». В противном случае некоторые функции не будут работать).

Для установки vtiger CRM из исходного кода

1. Загрузите файл vtigercrm-5.0.4.tar.gz с Sourceforge.net.
2. Распакуйте файл vtigercrm-5.0.4.tar.gz в корневую директорию Apache.
3. Запустите Web браузер и следуйте инструкциям, приведенным в разделе «Конфигурирование сервера vtiger CRM».

chown apache:root directoryname -R

man chmod

[edit] Запуск и остановка vtiger CRM

Для запуска сервера vtiger CRM выполните следующую команду в директории <vtiger_CRM_Home>/bin:

sh startvtiger.sh

Для остановки сервера vtiger CRM выполните следующую команду в директории <vtiger Home>/bin:

sh stopvtiger.sh 

[edit] Модернизация vtiger CRM

Этот раздел предназначен только для пользователей предыдущих версий системы vtiger CRM (v4.2.3 / v5.0.0 / v5.0.1 / v5.0.2 / v5.0.3). Если вы устанавливаете систему vtiger CRM в первый раз, пропустите данный раздел.

Внимание: Не забудьте сделать резервную копию кода до установки патча. В противном случае весь ваш собственный код будет удален при распаковке нового кода.

Шаг 1: Скачайте файл vtiger CRM 5.0.0 – Patch 4.

Шаг 2: Распакуйте файл vtigercrm-5.0.0-patch4.zip в корневую директорию vtiger CRM.

Шаг 3: Произведите миграцию ваших баз данных с предыдущей версии на новую версию.

Для миграции с v4.2.3, 5.0.0, 5.0.1, 5.0.2, 5.0.3, 5.0.4rc на v5.0.4.

1. Выберите Settings --> Other Settings --> Migration Wizard

2. В Migration Wizard, выберите вариант, соответствующий вашим требованиям.

Миграция баз данных занимает несколько минут. Пожалуйста, не закрывайте ваш браузер до окончания процесса миграции.

Более подробно процедура миграции описана в документе Migration Steps.

Шаг 4: Удалите ненужные файлы и директории.

С целью улучшения безопасности мы изменили расположение файлов vtiger CRM. Соответственно рекомендуем удалить перечисленные ниже файлы. Пожалуйста, соблюдайте разумную осторожность при удалении файлов.

Перечисленные файлы следует удалить из директории <vtiger CRM Home>/modules/Users

Announcement.php createrole.php listroles.php profilePrivileges.php RoleDeleteStep1.php RoleDetailView.php SaveRole.php ListProfiles.php listinventorynotifications.php SaveInventoryNotification.php EditInventoryNotification.php listnotificationschedulers.php SaveNotification.php EditNotification.php CreateSharingRule.php listwordtemplates.php upload.php deletewordtemplate.php createemailtemplate.php deleteemailtemplate.php detailviewemailtemplate.php editemailtemplate.php listemailtemplates.php saveemailtemplate.php

istgroups.php createnewgroup.php GroupDetailView.php ListLoginHistory.php UpdateDefaultFieldLevelAccess.php DefaultFieldPermissions.php EditDefOrgFieldLevelAccess.php OrgSharingDetailView.php SaveSharingRule.php DefModuleView.php AuditTrailList.php ShowAuditTrail.php AuditTrail.php SaveAuditTrail.php savetermsandconditions.php OrganizationTermsandConditions.php createrole.php listroles.php profilePrivileges.php RoleDeleteStep1.php RoleDetailView.php SaveRole.php add2db.php downloadfile.php ListProfiles.php

[edit] Настройка сервера vtiger CRM

После установки vtiger CRM вам необходимо произвести настройку сервера vtiger CRM, указав такие подробности, как название базы данных, Web сайт, валюту, и информацию для доступа администратора к системе. Во время настройки будут созданы таблицы баз данных и при необходимости - тестовые данные, что займет приблизительно 5 минут.

Для настройки сервера vtiger CRM

1. Запустите Web браузер и наберите адрес сервера http://<host-name>/vtigerCRM/index.php.
2. На странице Registration заполните форму регистрации (не обязательно). Нажмите кнопку [Start].
3. На странице System Check проверьте правильность настроек PHP и базы данных MySQL, убедитесь, что на файлы и каталоги установлены права чтения/записи, и проверьте статус графической библиотекм GD. Если все параметры правильны, нажмите кнопку [Next].

   Примечание: Пожалуйста, убедитесь, что на все необходимые директории установлены права чтения/записи; в противном случае вы не сможете пользоваться функциями, которым требуется загрузка или выгрузка файлов.

4. На странице System Configuration укажите соответствующие значения в разделах Database, Site Configuration, и Administration sections. Затем нажмите кнопку [Next].
   • Database Configuration - настройка базы данных
     • Host Name (Имя системы) (обязательное поле) - По умолчанию, Host Name записывается в форме <System Name>:<Port No>. Пожалуйста не изменяйте Port No, так как его значение задается во время установки.
     • User Name (Учетная запись) (обязательное поле) – Укажите имя учетной записи для доступа к базе данных.
     • Password (Пароль) – Укажите пароль для учетной записи.
     • Database Name (Имя базы данных) (обязательное поле) – По умолчанию имя базы данных vtigercrm5. Вы можете назвать базу данных в соответствии с вашими требованиями.
     • Root User Name (Учетная запись root) (обязательное поле)– Если вы выбрали вариант создания базы данных, укажите имя пользователя root с правами создания баз данных.
     • Root Password (Пароль учетной записи root) – Укажите пароль для учетной записи root.
   • Site Configuration - настройка сайта
     • URL (обязательное поле) – Укажите адрес хоста. По умолчанию, это http://<system name>.
     • Path (Путь) (обязательное поле) – По умолчанию, это директория, куда установлен vtiger CRM.
     • Path to Cache Directory (Расположение директории кэширования) (span style="font-weight:bold; color:red">must have write permission</span>) - Значение по умолчанию cache/. Эта директория используется для временного хранения таких файлов, как вложения, и файлов, относящихся к операциям импорта/экспорта данных.
   • Admin Configuration - настройка администрирования
     • User name (Учетная запись) – Значение по умолчанию устанавливается в admin.
     • Admin password (Пароль администратора) (обязательное поле) – По умолчанию значение устанавливается в “admin”. Вы можете изменить пароль после входа в vtiger CRM.
     • Email ID (Эл. почта администратора) – По умолчанию значение устанавливается в admin@your-domain.com. Вы можете изменить это поле на адрес электронной почты администратора системы.
   • Currency Configuration - настройка валюты
     • Name (Название) (обязательное поле) – Укажите название вашей основной валюты (например, Ruble).
     • Symbol (обозначение) (обязательное поле) – Укажите символ вышей валюты (например, R).
     • Code (код) (обязательное поле) – Укажите международное обозначение вышей валюты (например, RUB).
5. На странице Confirm Settings проверьте правильноеть настроек. Если что-либо необходимо изменить, нажмите кнопку [Change] и вы вернетесь к предыдущему шагу. Если вам требуется заполнить систему демонстрационными данными, отметьте поле [Also populate demo data?]. Когда все готово, нажмите кнопку [Next].
6. На странице Config File Creation нажмите кнопку [Next]. Завершение настройки занимает примерно 4 минуты.
7. На странице Create Database Tables нажмите кнопку [Finish] для завершения настройки vtiger CRM.

По окончании успешной настройки директория установки будет закрыта для повышения безопасности установки от несанкционированного доступа.

На странице входа в систему (Login) имя учетной записи по умолчанию устанавливается в значение admin. Введите пароль, заданный в процессе установки, в поле Password. После успешного входа в систему вы увидите Главную страницу vtiger CRM (Home page), пример которой приведен ниже:

Главная страница системы vtiger CRM

[edit] Настройка расписания уведомлений

Вы можете настроить уведомления, такие, как Big deals (Крупные сделки), Pending Tasks (отложенные задания), Event Reminder (напоминания о событиях), Support Start и End dates (даты начали и окончания поддержки), и другие при помощи изменения порта вашего веб-сервера Apache в файле sendreminder.sh, расположенном в директории <vtiger CRM Home>cron/, как показано ниже:

wget http://localhost:APACHEPORT/SendReminder.php -O intimatelog.tx

[edit] Советы по устранению неисправностей

Если при подключении к vtiger CRM при помощи браузера в окне браузера выводится сообщение:

Forbidden

Произведите с файлом httpd.conf, расположенным в директории <vtiger_CRM_home>/installs/apache/conf, следующие действия:

• Измените <Directory /> на <Directory /home/<user>
• Установите права на исполнение файла httpd.conf:

  chmod -R 777 /home/<user>

• Перезапустите сервер Apache из директории установки Apache:

  ./bin/httpd -d . -f ./conf/httpd.conf -k stop
  ./bin/httpd -d . -f ./conf/httpd.conf -k start
  

По умолчанию значение log4php.rootLogger в файле log4php.properties, расположенном в директории <vtiger_CRM_Home>, установлено в debug.

Если у Вас возникли какие-либо проблемы, измените значение уровня протоколирования на fatal или warning.

Строка: 10

log4php.rootLogger=debug, A2 

Изучите открытую базу знаний vtiger для получения дополнительных советов по устранению неисправностей. Если решение вашей проблемы еще на описано, пожалуйста, сообщите об этом в vtiger Discussions.

[edit] Известные проблемы

Если вы прервете процесс установки vtiger CRM, временная директория, созданная в процессе установки в директории установки, не будет удалена автоматически. Вам необходимо удалить ее вручную.

[edit] Установка vtiger и PHP 5.2.x

См. документ vtiger CRM on PHP 5.2.x. Документ относится к установке версии 5.0.3, а не версии 5.0.4.

[edit] Дополнительная документация

Чтобы использовать расширения для программного обеспечения vtiger CRM, Вы можете дополнительно изучить следующие документы:

• Расширение vtiger Outlook 5.0.4 - Руководство пользователя
• Расширение vtiger Office 5.0.4 - Руководство пользователя
• Расширение vtiger Thunderbird 5.0.4 - Руководство пользователя
• Дополнение vtiger Firefox Toolbar 5.0.4 - Руководство пользователя
• vtiger Customer Portal 5.0.4 - Руководство пользователя
• vtiger Web Forms 5.0.4 - Руководство пользователя

[edit] Техническая поддержка

Просим Вас присылать Ваши комментарии, вопросы по функциональности, и сообщения о проблемах в vtiger Forums (http://forums.vtiger.com), чтобы мы могли оказать Вам техническую помощь и поддержку. Рабочий язык форума – английский.

Контактная информация:

vtiger Systems India Pvt. Ltd.
Sree Narayana Complex,
11 Sarathy Nagar,
Vijayanagar, Velachery,
Chennai 600 042,
INDIA
India: +91-80-23146984
USA & Canada: +1-408-716-8592

Открытая поддержка: http://forums.vtiger.com

Пакет локализации для русского языка:
http://forge.vtiger.com/projects/ru-lang/
Там же можно сообщать о неточностях и ошибках настоящего перевода

Перевод на русский язык
ООО «А-Проект»
http://www.aproect.ru

Sergei Kostigoff
http://www.kostigoff.net