Install guide linux

Руководство администратора системы

Установка и обслуживание системы МОТИВ (ОС LINUX)

версия 1.7

2

Оглавление

1 Комплект поставки 3

.................................................................................................................................................................... 31 Комплект поставки Cистемы

.................................................................................................................................................................... 32 Состав дистрибутива

2 Требования к аппаратному и программному обеспечению 4

3 Установка Cистемы 6

4 Настройка параметров Системы 7

.................................................................................................................................................................... 71 Раздел [DBConnect]

.................................................................................................................................................................... 82 Раздел [Mail]

.................................................................................................................................................................... 103 Раздел [SMS]

.................................................................................................................................................................... 124 Раздел [ActiveMQ]

.................................................................................................................................................................... 145 Раздел [NTLMAuth]

.................................................................................................................................................................... 156 Раздел [Other]

5 Дополнительные возможности Системы и их настройка 18

.................................................................................................................................................................... 181 Настройка работы клиентских приложений

.................................................................................................................................................................... 192 Настройка почтовых и SMS-оповещений

.................................................................................................................................................................... 193 Настройка автоматической рассылки оповещений по задачам

.................................................................................................................................................................... 194 Настройка отправки оповещений по задачам, помещённых в очередь

.................................................................................................................................................................... 205 Настройка интеграции с электронной почтой

.................................................................................................................................................................... 216 Настройка доменной авторизации

.................................................................................................................................................................... 227 Настройка параметров, обеспечивающих работу системы послеперезагрузки сервера

.................................................................................................................................................................... 228 Настройка размера прикрепляемых файлов

6 Вход в Систему 23

7 Редактирование имён виртуальных хостов 25

8 Сопровождение установленной Системы 26

.................................................................................................................................................................... 261 Резервное копирование базы данных

.................................................................................................................................................................... 272 Работа с базой данных

.................................................................................................................................................................... 283 Резервное копирование PHP-сценариев

.................................................................................................................................................................... 284 Настройка поисковой системы

9 Перенос Системы на другой сервер 30

Комплект поставки 3

1 Комплект поставки

1.1 Комплект поставки Cистемы

Комплект поставки системы «Мотив 4U 1.7» (далее – Системы) включает:

– программное обеспечение, необходимое для работы Системы;

– клиентские приложения, предназначенные для оперативного получения информациио состоянии задач пользователей Системы.

Программное обеспечение, необходимое для работы Системы, включает в себя:

– СУБД Firebird 2.1;

– веб-сервер Apache 2.2;

– PHP 5.2.13;

– Zend Optimizer 3.3.9;

– Ioncube Loader 3.3;

– cервер Tomcat 5;

– Java Development Kit 6.0;

– Memcached 1.4.3;

– OpenSSL 0.9.8a.

1.2 Состав дистрибутива

Поставляемый дистрибутив включает архив Motiw4U-1.7-Linux.tar.bz2, содержащий папкуpool, в которой располагаются все необходимые для установки программы, файлы ибиблиотеки, файл сценария install_linux.sh для запуска установки Cистемы на ОС Linux,Install_guide_Linux.pdf, а также папку Documentation, которая содержитпользовательскую документацию к Системе.

4

2 Требования к аппаратному и программномуобеспечению

1. Требования к аппаратному обеспечению

Аппаратные требования, предъявляемые к конфигурации сервера, зависят от количествапользователей Системы и установленной на сервере операционной системы.

Минимальные аппаратные требования, предъявляемые к конфигурации сервера

Параметры сервераКоличество пользователей в Системе

100 250 500 1000

Количество ядер (шт.) 2 2 4 8

Тактовая частота процессора (Ггц) 2,5 2,5 2,5 2,5

Оперативная память (Гб) 4 6 8 16

Свободное дисковое пространство (Гб) 200 400 600 1000

Наличие сетевой карты 100 Мбит/сек + + + +

Для более 1000 пользователей Системы необходимо использовать два сервера. Первыйсервер – для СУБД Firebird. Второй сервер – для Web-сервисов (Apache, Tomcat дляиндексирования объектов и работы поиска). Каждый из двух серверов долженсоответствовать аппаратным требования для сервера с 1000 пользователями.

Внимание!

Не рекомендуется устанавливать другие СУБД на сервере, так как это может привести кнекорректной работе СУБД Firebird.

При одновременной работе в Системе более 40 пользователей на сервере с ОС Windowsвысокая производительность Системы не гарантируется. В качестве ОС серверарекомендуется использовать Linux.

2. Требования к программному обеспечению:

– рекомендуемые дистрибутивы: Debian, Gentoo, Ubuntu, Centos, RHEL, Fedoraпоследних версий;

– архиватор – bzip2;

– компилятор – gcc;

– программные пакеты: flex, zlib, openssl, perl и xinetd (inetd);

Требования к аппаратному и программному обеспечению 5

– для хранилища файлов рекомендуется использовать ext4, что позволяет создаватьнеограниченное количество подкаталогов;

– рекомендуемый веб-браузер – Mozilla FireFox 3.6.13 и выше.

Замечание – Кроме указанных выше ОС, Система может быть установлена также и надругие Unix-like дистрибутивы, но при этом могут возникать различные проблемы. Законсультациями, связанными с выбором ОС и точными версиями указанных ОС для Вашегодистрибутива системы «Мотив 4U 1.7», обращайтесь в службу технической поддержки поадресу [email protected].

Важно! Не рекомендуется использование файловых систем ext2 и ext3, так как ониобладают ограничением по количеству директорий в одной поддиректории – 32 768. Этоможет со временем негативно сказаться на крупных инсталляциях Системы (200–300пользователей при активном использовании Системы).

mailto:[email protected]

6

3 Установка Cистемы

Если в системе уже установлена и работает одна из программ: СУБД Firebird, веб-серверApache или другой веб-сервер, PHP, Zend Optimizer, Tomcat – то перед запуском установкиСистемы их следует удалить, иначе успешная установка Системы не может бытьгарантирована.

Для корректной работы почтовых уведомлений перед установкой Системы на ОС Linuxследует установить Mail Transfer Agent с отключённой авторизацией для localhost.

Установка Системы осуществляется запуском сценария Install.Linux.sh, которыйрасполагается в папке Motiw4U-1.7-Linux дистрибутива.

Замечание – Запускать сценарий на выполнение следует только после перехода вдиректорию /Motiw4U-1.7-Linux.

В процессе установки будут выведены строки следующего содержания:

Hello. Input the directory where Motiw scripts & database will be placed

or press Enter to install to default directory [/var/Motiw]

P.S. All needed software will be install in /var/Motiw/software

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

Для корректного экспорта данных из Системы на русском языке следует установить дляоперационной системы русскую локализацию (locale). Настройка кодировки для работы срусским языком осуществляется выполнением команды:

export LANG="ru_RU.UTF-8"

После установки Системы для обращения к ней по имени следует определить в httpd.confсекцию Virtual host, директиву Server name и добавить запись <ip> <servername> вфайле hosts (для сервера и клиентов).

Настройка параметров Системы 7

4 Настройка параметров Системы

Настройка параметров Системы осуществляется в файле config_motiw.ini, который состоитиз следующих разделов:

– [DBConnect];

– [Mail];

– [SMS];

– [ActiveMQ];

– [NTLMAuth];

– [Other].

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

Предупреждение – Названия ключей чувствительны к регистру.

4.1 Раздел [DBConnect]

Содержит ключи, необходимые для подключения к базе данных.

Ключ dbpath

Значение: полный путь к базе данных.

Путь к базе данных рекомендуется прописывать с использованием интерфейса обратнойпетли (loopback interface). Ниже приведён пример с использованием петли localhost.

Путь к базе данных записывается в формате Unix, то есть с использованием прямого (/), ане обратного (\) слеша.

Пример:

dbpath="localhost:/var/httpd/motiw/db/motiw.fdb"

Формат ключа: хост:путь

Ключ dbname

Значение: имя файла базы данных.

Если ключ dbpath не содержит имени файла базы данных, то его можно указать в ключеdbname.

Пример:

dbname="motiw.fdb"

Формат ключа: имя_файла_базы_данных

Ключ dblogin

Значение: имя пользователя СУБД для подключения к базе данных.

8

Пример:

dblogin=SYSDBA

Формат ключа: имя_пользователя

Ключ dbpassword

Значение: пароль пользователя СУБД для подключения к базе данных.

Пример:

dbpassword=masterkey

Формат ключа: пароль_пользователя

4.2 Раздел [Mail]

Содержит ключи, необходимые для настройки почты.

Ключ FromAddress

Значение: e-mail автоинформатора Системы. Этот адрес будет указываться в поле FROM(от кого) в письмах, отправляемых автоинформатором пользователям Системы.

Пример:

FromAddress="[email protected]"

Формат ключа: [email protected]

Ключ FromName

Значение: имя автоинформатора Системы в письмах, посылаемых пользователям Системы.

Пример:

FromName="Автоинформатор системы Мотив"

Формат ключа: имя автоинформатора

Ключ MailSendMethod

Значение: переключатель метода отправки почты.

Возможные значения: 0 – для Unix-like операционных систем; 1 – для ОС Windows.

Пример:

MailSendMethod=1

Формат ключа: 0 или 1

Ключ SMTP

Значение: имя сервера, используемого в качестве почтового.



Пример:

SMTP="smtp.mail.ru"

Формат ключа: smtp.host

Ключ sendmail_from

Значение: e-mail адрес, указываемый в поле SENDER (отправитель), в письмах,отправляемых автоинформатором пользователям Системы. В зависимости от настроекSMTP-сервер может не отправлять почту, если sendmail_from не принадлежит ему.

Пример:

sendmail_from ="[email protected]"

Формат ключа: name@host

Ключ sendmail_path

Значение: путь к программе с параметрами отправки почты sendmail. Настройка действуетдля Unix-like операционных систем.

Пример:

sendmail_path="/usr/sbin/sendmail -t"

Формат ключа: путь параметры

Ключ MailDisable

Значение: управляет возможностью блокирования отправки почты.

Возможные значения: 0 – разрешает отправку почты; 1 – блокирует отправку почты.

Пример:

MailDisable=0


Внимание! В случае если для SMTP сервера требуются имя пользователя и пароль, следуетвыполнить следующие действия. В файле php.ini в разделе [mail function] следуетпрописать параметры:

auth_username=account_name – имя аккаунта;

auth_password=account_password – пароль.

Возможна ситуация, когда перед авторизацией на SMTP сервере требуется авторизация наPOP3 сервере. В этом случае следует прописать параметры:

pop3_server=pop.имя сервера

pop3_username=account_name

pop3_password=account_password

После внесения параметров необходимо перезапустить службу Apache2.

10

4.3 Раздел [SMS]

Содержит ключи, необходимые для настройки отправки SMS.

Ключ SmsDisable

Значение: управляет возможностью блокирования отправки SMS.

Возможные значения: 0 – разрешает отправку SMS; 1 – блокирует отправку SMS.

Пример:

SmsDisable =1


Ключ SmsHttpMethodLogin

Значение: имя пользователя, полученное при регистрации в службе оказания услуг подоставке SMS.

Пример:

SmsHttpMethodLogin="user"

Формат ключа: user_name

Ключ SmsHttpMethodPassword

Значение: пароль пользователя, полученный при регистрации в службе оказания услуг подоставке SMS.

Пример:

SmsHttpMethodPassword ="passw"

Формат ключа: user_password

Ключ SmsOriginator

Значение: название отправителя сообщения.

Пример:

SmsOriginator="Motiw"

Формат ключа: только латинские буквы либо цифры.

Ключ SmsOperatorHttpSendURL

Значение: адрес веб-скрипта, управляющего отправкой SMS получателям.

Пример:

SmsOperatorHttpSendURL="smsmail.ru/corp/multi.php"

Формат ключа: имя_URL


Ключ SmsIsHttpMethodPost

Значение: переключатель метода отправки сообщений.

Возможные значения: 0 – метод GET; 1 – метод POST.

Пример:

SmsIsHttpMethodPost=0


Ключ SmsIsInRrussian

Значение: переключатель языка SMS.

Возможные значения: 0 – латиница (текст SMS будет транслитерирован); 1 – русский язык.

Пример:

SmsIsInRrussian=1


Ключ SmsIsLogSms

Значение: управляет возможностью ведения журнала отправленных SMS.

Возможные значения: 0 – отключить ведение журнала; 1 – включить ведение журнала.

Пример:

SmsIsLogSms=0


Ключ SmsLogPath

Значение: путь к журналу SMS.

Пример:

SmsLogPath="/var/log/logsms.log"

Формат ключа: путь

Ключ SmsMaxParts

Значение: максимальное количество частей, на которое будет разбиваться каждоесообщение при превышении им предельной величины. Предельная величина одного SMS нарусском языке – 70 символов, на транслите – 160 символов.

12

Пример:

SmsMaxParts=2

Формат ключа: числовое_значение

Ключ SmsProxyHost

Значение: хост и порт прокси-сервера для выхода в Интернет. Если этот ключ явно неуказан, то он не используется.

Пример:

SmsProxyHost="localhost:3128"

Формат ключа: host:port

Ключ SmsProxyLogin

Значение: логин пользователя для прокси-сервера. Если этот ключ явно не указан, то он неиспользуется.

Пример:

SmsProxyLogin="login"

Формат ключа: имя_пользователя

Ключ SmsProxyPass

Значение: пароль пользователя для прокси-сервера. Если этот ключ явно не указан, то онне используется.

Пример:

SmsProxyPass="pass"

Формат ключа: пароль_пользователя

Ключ SmsProxyType

Значение: тип прокси-сервера по умолчанию (http, socks4 или socks5). Если этот ключ явноне указан, то он не используется.

Пример:

SmsProxyType="http"

Формат ключа:тип_прокси-сервера

4.4 Раздел [ActiveMQ]

Внимание! Если СМДС не используется, параметры данного раздела настраивать неследует.


Данный раздел содержит настройки доступа к серверу с установленным СМДС Системы.СМДС Системы предназначен для ускорения получения новых задач и действий по текущимзадачам пользователя в клиентских приложениях.

Ключ AQAddress

Значение: имя или IP-адрес сервера с установленным СМДС Системы.

Пример:

AQAddress="host"

Формат ключа: hostname

Ключ AQPort

Значение: номер порта, на котором работает СМДС Системы.

Пример:

AQPort=4000

Формат ключа: номер_порта

Ключ AQClientPort

Значение: порт ActiveMQ для клиентских приложений.

Пример:

AQClientPort=4000


Ключ AQQueue

Значение: имя очереди сообщений.

Пример:

AQQueue="localhost"

Формат ключа: hostname

Ключ AQExpireTime

Значение: время (в сек.), в течение которого сообщение будет храниться в очереди. Поумолчанию сообщение хранится 120 сек.

Пример:

AQExpireTime=600


14

Ключ AQUseAjax

Значение: позволяет автоматически получать обновления по задачам в веб-интерфейсе.Возможные значения: 1 – автоматическое обновление; 0 – обновление вручную. Значениепо умолчанию – 1.

Пример:

AQUseAjax=1


Ключ AQAjaxRequestTime

Значение: период опроса (в сек.) установленного ActiveMQ.

Пример:

AQAjaxRequestTime=300


4.5 Раздел [NTLMAuth]

Содержит ключи, необходимые для настройки доменной авторизации.

Ключ domain_auth_enable

Значение: управляет видимостью подраздела Доменная авторизация в пункте менюСистемы «Личные настройки».

Возможные значения: 0 – раздел не отображается; 1 – раздел отображается.

Пример:

domain_auth_enable=1


Ключ domain_auth_type

Значение: имя подключаемого модуля для использования возможности доменнойавторизации.

Возможные значения: mod_auth_sspi – для ОС Windows, mod_ntlm2 – для Unix-likeоперационных систем.

Пример:

domain_auth_type = "mod_auth_sspi"

Формат ключа: mod_auth_sspi или mod_ntlm2


4.6 Раздел [Other]

Содержит дополнительные настройки Системы.

Ключ LoginLanguage

Значение: переключатель языка окна авторизации. Язык выбирается из списка языковСистемы.

Возможные значения: RU – русский язык; EN – английский язык; DE – немецкий язык.

Пример:

LoginLanguage="RU"

Формат ключа: RU или EN или DE

Ключ reject_task_start_date_in_future

Значение: управляет возможностью создания задач с датой начала, большей, чем текущая.

Возможные значения: 0 – дата начала может быть больше текущей; 1 – дата начала неможет быть больше текущей (если выбрана дата больше, то после сохранения задачи вкачестве даты начала автоматически устанавливается текущая дата).

Пример:

reject_task_start_date_in_future=1


Ключ reject_task_start_date_in_past

Значение: управляет возможностью создания задач с датой начала, меньшей, чем текущая.

Возможные значения: 0 – дата начала не может быть меньше текущей (если выбрана датаменьше, то после сохранения задачи в качестве даты начала автоматическиустанавливается текущая дата); 1 – дата начала может быть меньше текущей.

Пример:

reject_task_start_date_in_past=1


Ключ IsLocalNet

Значение: переключатель способа загрузки приложений, необходимых для Системы внекоторых отчётах (Capicom, VM).

Возможные значения: 0 – скачивать из Интернета; 1 – скачивать с сервера Системы.

Пример:

IsLocalNet=0


16

Ключ tomcat_port

Значение: номер порта, по которому работает сервер Tomcat.

Значение по умолчанию 8080.

Пример:

tomcat_port=8080


Ключ UseGMT

Значение: управляет форматом отображения времени в Системе.

Возможные значения: On – время в Системе отображается с учётом часового поясапользователя; Off – используется время сервера Системы.

Значение по умолчанию Off.

Пример:

UseGMT=«On»

Формат ключа: «On» или «Off»

Ключ solr_port

Значение: номер порта, по которому работает сервер Solr.

Значение по умолчанию 8081.

Пример:

solr_port=8081


Ключ solr_host

Значение: хост сервера с установленным Solr.

Значение по умолчанию localhost.

Пример:

solr_host=localhost

Формат ключа: host

Ключ UseOnlinePreview

Значение: управляет возможностью просмотра прикреплённых файлов в формате HTML.

Возможные значения: 0 – возможность просмотра файлов в формате HTML отключена; 1 –возможность просмотра файлов в формате HTML включена.


Значение по умолчанию – 0.

Пример:

UseOnlinePreview=1


Ключ isnotshowsystemactions

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

Возможные значения: 0 – флажок по умолчанию не установлен; в задаче отображаетсясистемное действие об удалении участника; 1 – флажок по умолчанию установлен;системное действие в задаче не отображается.

Пример:

isnotshowsystemactions=1


Ключ allow_respperson_edit_task

Значение: управляет возможностью редактировать поля задачи пользователем в ролиответственного руководителя.

Возможные значения: 0 – возможность редактирования полей отключена. Ответственныйруководитель может только добавлять контролёров, исполнителей и внешнихпользователей, а также редактировать ИРГ и тип задачи; 1 – возможность редактированияполей включена.

Пример:

allow_respperson_edit_task=1


18

5 Дополнительные возможности Системы и ихнастройка

К дополнительным возможностям Системы можно отнести следующие:

– автоматическая рассылка почтовых и SMS-оповещений пользователям о событиях взадачах, в которых они участвуют;

– автоматическая рассылка сообщений и напоминаний пользователям Системы взаданное время;

– интеграция Системы с электронной почтой для обмена почтовыми сообщениями спользователями, не зарегистрированными в Системе;

– оперативное получение пользователями задач и поручений по ним, а такжесигнализация об их получении с помощью клиентских приложений;

– поиск задач и зарегистрированных по ним действий, документов и файлов,прикреплённых к описанию задач, действиям и документам, а также помещённых вбиблиотеку;

– использование параметров доменной авторизации при входе пользователей вСистему.

Для использования вышеперечисленных возможностей необходима их дополнительнаянастройка.

5.1 Настройка работы клиентских приложений

В комплект поставки Системы дополнительно входят клиентские приложения: программа«Информер» (для пользователей ОС Windows XP и выше) и программа XConductor (дляпользователей ОС Mac OS X 10.5 и выше). Данные приложения предназначены дляоперативного получения новых задач и действий по текущим задачам пользователя, атакже для сигнализации об их получении.

Руководства по работе с клиентскими приложениями можно просмотреть, выбрав пунктменю «Руководства» раздела Дополнительно главного меню веб-интерфейса Системы.

Для обеспечения мгновенной доставки пользователям приложения новых действий позадачам, оповещений об изменении состава исполнителей в рабочих группах задач и т.д.используется сервер с установленным сервисом мгновенной доставки сообщений (СМДС)ActiveMQ.

При запуске приложения обращаются к серверу с установленным СМДС по указанному внастройках порту (номер порта не регламентирован – задаётся при запуске СМДС, нообычно 4000).

При установке Системы на ОС Linux требуется обеспечить автоматический запуск СМДС.

Дополнительные возможности Системы и их настройка 19

5.2 Настройка почтовых и SMS-оповещений

Настройка параметров для почтовых оповещений осуществляется в разделе [Mail], а SMS-оповещений – в разделе [SMS] конфигурационного файла Системы config_motiw.ini. Дляиспользования автоматической рассылки почтовых оповещений в параметрах раздела [Mail]следует указать адрес SMTP-сервера, а также задать значение ключей MailSendMethod=0и MailDisable=0. Для использования автоматической рассылки SMS-оповещений впараметрах раздела [SMS] следует указать имя и пароль пользователя, полученные прирегистрации в службе оказания услуг по доставке SMS, адрес веб-скрипта, управляющегоотправкой SMS получателям, а также задать значение ключа SmsDisable=0.

Подробное описание параметров файла config_motiw.ini см. в разделе 4 данногоруководства.

5.3 Настройка автоматической рассылки оповещений по задачам

Автоматическая рассылка почтовых и SMS-оповещений по задачам осуществляется спомощью файла sendmailreminds.php, который располагается в каталоге servicesкорневой директории Системы.

Для этого следует периодически исполнять данный файл через интерпретатор php,располагающийся в директории /var/Motiw/software/bin/php. Сценарий запускается с двумяпараметрами:

1. Корневой каталог, в котором расположены PHP-сценарии Системы.

2. Имя сервера (hostname).

Пример запуска процесса автоматической рассылки оповещений по задачам в утилите cronприведён ниже.

sudo -u apache /var/Motiw/software/bin/php /var/Motiw/scripts/services/sendmailreminds.php /var/Motiw/scripts motiw >> /var/log/motiw.sendmailreminds.log

где: sudo -u apache – запуск выполняется от имени пользователя apache;

/var/Motiw/software/bin/php /var/Motiw/scripts/services/sendmailreminds.php –запускается PHP, которому в качестве параметра передаётся файл sendmailreminds.php;

/var/Motiw/scripts/services/sendmailreminds.php – файл sendmailreminds.php, которомув качестве параметра передаётся путь /var/Motiw/scripts;

motiw – доменное имя сервера «Мотив 4U 1.7» (DNS);

>> /var/log/motiw.sendmailreminds.log – результат вышеперечисленных операцийперенаправляется в лог-файл motiw.sendmailreminds.log.

5.4 Настройка отправки оповещений по задачам, помещённых в очередь

Предусмотрена возможность использования отложенной отправки почтовых и SMS-оповещений по задачам. При этом следует задать определённый промежуток времени,через который оповещения будут отправлены пользователям. Оповещения отправлены не

20

будут, если в течение этого времени пользователем были просмотрены действия иоповещения по задачам в веб-интерфейсе, PDA-интерфейсе или в клиентских приложениях.Задание соответствующих настроек осуществляется администратором системы в пунктеменю «Настройки оповещений» раздела Администрирование.

Отправка оповещений по задачам, помещённых в очередь, осуществляется с помощьюфайла send_mail_sms_from_queue.php, который располагается в каталоге servicesкорневой директории Системы. Для этого следует периодически исполнять данный файлчерез интерпретатор php, располагающийся в директории /var/Motiw/software/bin/php.Сценарий запускается с двумя параметрами:



Пример запуска процесса отправки оповещений по задачам, помещённых в очередь, вутилите cron приведён ниже.

sudo -u apache /var/Motiw/software/bin/php /var/Motiw/scripts/services/send_mail_sms_from_queue.php /var/Motiw/scripts motiw >> /var/log/motiw.send_mail_sms_from_queue.log


/var/Motiw/software/bin/php /var/Motiw/scripts/services/send_mail_sms_from_queue.php– запускается PHP, которому в качестве параметра передаётся файлsend_mail_sms_from_queue.php;

/var/Motiw/scripts/services/send_mail_sms_from_queue.php – файлsend_mail_sms_from_queue.php, которому в качестве параметра передаётся путь /var/Motiw/scripts;


>> /var/log/motiw.send_mail_sms_from_queue.log – результат вышеперечисленныхопераций перенаправляется в лог-файл motiw.send_mail_sms_from_queue.log.

5.5 Настройка интеграции с электронной почтой

Интеграция с электронной почтой подразумевает под собой настройку опроса почтовыхящиков пользователей на наличие новых писем. Для использования этой возможности впапку /var/Motiw/scripts/license/motiw помещается файл лицензии motiw4u_17.lic.

Опрос почтовых ящиков осуществляется с помощью файла imap_fetcher.php, которыйрасполагается в каталоге services корневой директории Системы. Для этого следуетпериодически исполнять данный файл через интерпретатор php, располагающийся вдиректории /var/Motiw/software/bin/php. Сценарий запускается с двумя параметрами:



Пример запуска процесса проверки в утилите cron приведён ниже.

Дополнительные возможности Системы и их настройка 21

sudo -u apache /var/Motiw/software/bin/php /var/Motiw/scripts/services/imap_fetcher.php /var/Motiw/scripts motiw >> /var/log/motiw.imap_fetcher.log


/var/Motiw/software/bin/php /var/Motiw/scripts/services/imap_fetcher.php – запускаетсяPHP, которому в качестве параметра передаётся файл imap_fetcher.php;

/var/Motiw/scripts/services/imap_fetcher.php – файл imap_fetcher.php, которому вкачестве параметра передаётся путь /var/Motiw/scripts;


>> /var/log/motiw.imap_fetcher.log – результат вышеперечисленных операцийперенаправляется в лог-файл motiw.imap_fetcher.log.

5.6 Настройка доменной авторизации

Для использования доменной авторизации пользователями Системы следует осуществить еёнастройку:

1. Прописать загрузку модуля mod_ntlm2.

Для этого надо убедиться, что в файле httpd.conf раскомментирована строка

LoadModule ntlm_module modules/mod_ntlm2.so

2. Убедиться, что в файле config_motiw.ini в разделе [NTLMAuth] раскомментированыследующие параметры:

;Доменная авторизация

domain_auth_enable = 1;

;для Unix-like операционных систем:

domain_auth_type = "mod_ntlm2";

Причём строка для ОС Windows должна быть закомментирована:

;для ОС Windows:

;domain_auth_type = "mod_auth_sspi";

3. В файле .htaccess, располагающемся в директории /scripts/auth, в строке

NTLMDomain DOMAINNAME

в качестве параметра DOMAINNAME указать имя домена сети и в строке

NTLMDomain DOMAIN_SERVER

в качестве параметра DOMAIN_SERVER указать NetBIOS имя хоста-домена.

4. Убедиться, что параметр DOMAIN_SERVER соотнесён с IP-адресом в файле hosts.

22

Дальнейшая настройка доменной авторизации осуществляется каждым пользователемсамостоятельно (см. «Руководство пользователя»).

5.7 Настройка параметров, обеспечивающих работу системы послеперезагрузки сервера

После перезагрузки сервера следует обеспечить автозапуск сервера Apache и СМДС.

Для этого следует добавить строки

/var/Motiw/software/apache2/bin/apachectl start

nohup /var/apache-activemq/bin/activemq > /var/log/activemq.log &

export JAVA_HOME=<путь к JDK>

export PATH=$PATH:$JAVA_HOME/jdk/bin

<путь>/var/Motiw/software/Tomcat/bin/startup.sh

memcached –u nobody

в файл /etc/rc.local, команды которого выполняются на завершающем этапе загрузкииспользуемой операционной системы.

Описанные выше команды применимы для RedHat–based дистрибутива. В случаеиспользования отличного от RedHat–based дистрибутива следует узнать, какиепользовательские команды выполняются на данном этапе загрузки, и прописать их.

5.8 Настройка размера прикрепляемых файлов

Настройка максимального размера файла для прикрепления к задачам, действиям идокументам осуществляется в файле php.ini, расположенном в директории /etc.

В подразделе File Uploads для параметра upload_max_filesize следует прописатьмаксимальный размер. По умолчанию установлено значение 2 Мб.

; Maximum allowed size for uploaded files.

upload_max_filesize = 2M

В связи с тем что к добавляемому файлу также прикрепляется служебная информация, дляпараметра post_max_size следует указать большее значение, чем для параметраupload_max_filesize, а для параметра memory_limit большее значение, чем дляpost_max_size. В противном случае файл не будет закачан на сервер.

; Maximum size of POST data that PHP will accept

post_max_size = 3M

; Maximum amount of memory a script may consume

memory_limit = 4M

Вход в Систему 23

6 Вход в Систему

Для входа в установленную Систему c локального компьютера следует в окне браузера(рекомендуется использовать Mozilla FireFox версии не ниже 3.6.13) ввести в строку адреса:http://localhost. В открывшемся окне авторизации (рис. 1) в качестве имени и пароля следуетуказать «admin» – реквизиты администратора системы по умолчанию, и нажать кнопкуВход. При этом откроется окно загрузки файла лицензии.

Файл лицензии не входит в комплект поставки дистрибутива Системы, а предоставляетсяменеджером по работе с клиентами. Нажав кнопку Обзор на форме загрузки, следуетуказать путь к каталогу, в котором хранится файл лицензии motiw4u_17.lic. При успешнойзагрузке файла лицензии откроется окно авторизации пользователя в Системе, в которомдля входа в Систему следует повторно ввести реквизиты администратора системы поумолчанию.

Рис. 1. Окно входа в установленную Систему

Справочное руководство для пользователей Системы располагается в пункте меню«Руководства» раздела Дополнительно главного меню Системы.

Руководство для администратора системы admin_system_guide.pdf, включающее описаниеисходной настройки Системы, располагается в каталоге Motiw/Documentation.

Для использования PDA-версии Системы следует привести в соответствие параметрыServerName или ServerAlias, указываемые в файле httpd.conf, и символьное имя сервера,указываемое в файле hosts.

Например, указав в качестве имени сервера «pda» в файле hosts, который располагается вдиректории /etc/hosts, следует, соответственно, указать «pda» и в качестве одного изпараметров – ServerName или� ServerAlias. Эти параметры прописываются в файле httpd.conf, который располагается в директории /var/Motiw/software/apache2/conf.

24

Затем для входа в PDA-версию Системы следует в строке браузера ввести:<адрес_сервера_системы>/pda. В появившемся окне авторизации в качестве имени ипароля следует указать «admin».

Замечание – Вход в PDA-интерфейс Системы для пользователей, которые работали доперехода на текущую версию в системе «Мотив» версии 3.8.1 и ниже, может такжеосуществляться по адресу: pda.<адрес_сервера_Системы>.

Справочное руководство для PDA-версии Системы можно просмотреть в меню СистемыДополнительно –> «Руководства» –> «Руководство для PDA-версии».

Для доступа в Систему с пользовательских компьютеров следует прописать в DNS IP-адреси символьное имя сервера. Причём символьное имя сервера должно соответствовать имени,указанному в параметрах ServerName или ServerAlias файла httpd.conf.

Для входа в Систему с пользовательского компьютера следует ввести в строке адресабраузера:

http://<символьное_имя_сервера>

Для доступа к PDA-версии Системы с пользовательских компьютеров следует аналогичнымобразом осуществить настройку параметров, описанных выше, или добавить запись в DNS.

Редактирование имён виртуальных хостов 25

7 Редактирование имён виртуальных хостов

Для изменения символьного имени сервера следует внести изменения в файл httpd.conf,который располагается в директории /var/Motiw/software/apache2/conf.

NameVirtualHost *:80

<VirtualHost *:80>

DocumentRoot <путь_к_каталогу_scripts>

ServerName <имя_сервера>

ServerAlias <псевдоним_сервера>

</VirtualHost>

<VirtualHost *:80>

DocumentRoot <путь_к_директории_scripts/pda.motiw>

ServerName <pda.имя_сервера>

ServerAlias <псевдоним_сервера>

</VirtualHost>

Задание нового символьного имени для виртуального сервера осуществляется в строкеServerName или ServerAlias. После внесения изменений следует перезапустить серверApache.

Затем следует внести соответствующие изменения в файл hosts, который располагается вдиректории /etc, а также прописать символьное имя сервера в DNS.

Для входа в Систему после изменения символьного имени сервера следует в окне браузераввести:

для веб-версии Системы:

http://<новое_имя_сервера>

для PDA-версии Системы:

http://<адрес_сервера_системы>/pda

или http://pda.<новое_имя_сервера>

Замечание – Второй способ для PDA-версии Системы указан для пользователей, которыеработали до перехода на текущую версию в системе «Мотив» версии 3.8.1 и ниже.

Для входа как в веб-, так и в PDA-интерфейс в окне авторизации следует в качестве имени ипароля пользователя указать «admin».

26

8 Сопровождение установленной Системы

Процесс обеспечения сохранности данных, хранящихся в Системе, включает в себя рядпростых, но необходимых действий. Эти действия выполняются, как правило, системнымадминистратором, имеющим доступ к серверу, на котором установлена Система.

Для сопровождения Системы следует:

1. Периодически выполнять проверку и резервное копирование файла базы данных. Данныйфайл имеет расширение *.fdb, который обычно располагается в директории /var/Motiw/db.

2. Периодически выполнять резервное копирование директории с PHP-сценариями Системы,в которой в том числе содержатся различные информационные файлы (прикрепляемые кзадачам и документам, хранящиеся в библиотеке и др.). PHP-сценарии располагаются вподдиректории /var/Motiw/scripts.

3. Периодически выполнять чистку семафоров СУБД и перезапуск служб. Для упрощенияэтих процедур имеется скрипт автоматизированного обслуживания базы данных и СУБД.

4. При обновлении системы «Мотив 4U 1.7», которая установлена по пути, отличному отстандартного, следует внимательно проверить изменённые параметры в файлеmotiw_patcher.ini.

В функции системного администратора входит также и перенос Системы с одного сервера надругой. Для этого следует:

1) Установить систему «Мотив 4U 1.7» на новом сервере.

Важно! Версия Системы, устанавливаемая на новом сервере, должна совпадать с версиейСистемы на сервере, с которого осуществляется перенос.

2) Сделать резервную копию базы данных на «старом» сервере.

3) Скопировать папку scripts на «старом» сервере.

4) Восстановить на новом сервере данные из созданной резервной копии и заменить папкуscripts.

8.1 Резервное копирование базы данных

Резервное копирование базы данных выполняется при помощи утилиты gbak, входящей впоставку SQL-сервера Firebird. Данная утилита располагается в директории<путь_к_Firebird>/bin.

При вызове утилиты gbak следует указать параметры подключения к базе данных: имя(user) и пароль администратора базы данных (pass). Значения по умолчанию – имяадминистратора – SYSDBA, пароль – masterkey.

В результате запуска следующей команды (команда должна быть записана в одну строку):

<путь_к_Firebird>/bin/gbak -b -t -v -user SYSDBA -pass masterkey "localhost:<путь_к_файлу_БД>" save_motiw.fbk

Сопровождение установленной Системы 27

резервная копия базы данных будет сохранена в файл save_motiw.fbk. В случае успешногозавершения резервного копирования будет выдано сообщение:

gbak: closing file, committing, and finishing. xxxxxxx bytes written

Резервное копирование базы данных с помощью утилиты gbak не требует остановкисервера Firebird.

Создание резервной копии базы данных следует планировать с необходимой частотой.Планирование осуществляется с помощью утилиты cron.

Если на сервере произошёл сбой, в результате которого база данных оказаласьповреждённой, то следует обратиться в службу технической поддержки по адресу[email protected].

8.2 Работа с базой данных

Для корректной работы БД рекомендуется не реже чем раз в 3 месяца производитьпроверку БД с помощью системной утилиты gfix, расположенной в директории<путь_к_Firebird>/bin. А также проверку БД следует производить при появлении большогочисла ошибок вида «Query error:…», получаемых при попытке войти в Систему илиосуществить какие-либо действия в ней. Для проверки БД следует выполнить следующее.

1. Запретить подключение к БД другим пользователям, кроме администратора БД (SYSDBA),с помощью команды:

<путь_к_Firebird>/bin/gfix -shut -force 0 -user SYSDBA -pass masterkey<путь_к_файлу_БД>

2. Выполнить проверку БД с помощью команды:

<путь_к_Firebird>/bin/gfix -v -full -user SYSDBA -pass masterkey <путь_к_файлу_БД>

Данная команда должна вывести информацию о наличии ошибок в БД. Если их нет и запусккоманды не привёл к изменениям на экране, то в файле БД ошибок нет. В этом случаеследует ещё раз проверить причину возникновения ошибок – возможно, она заключается внеправильных или изменившихся настройках Системы или в других изменениях.

В случае наличия ошибок в файле БД gfix должен вывести сообщение следующего вида:

number of index page errors xxx

number of database page errors xxx

Ошибки в файле БД следует исправить командой:

<путь_к_Firebird>/bin/gfix -mend -full -ignore -user SYSDBA -pass masterkey<путь_к_файлу_БД>

После этого рекомендуется снова проверить БД на наличие ошибок. Если ошибок необнаружено, то следует разрешить доступ к БД с помощью команды:

<путь_к_Firebird>/bin/gfix -online -user SYSDBA -pass masterkey <путь_к_файлу_БД>

и проверить функционирование Системы.


28

Если после проверки и/или исправления ошибок с помощью утилиты gfix вернуть БД врабочее состояние не удалось, то следует взять последнюю резервную копию ивосстановить из неё базу данных (команда должна быть записана в одну строку):

<путь_к_Firebird>/bin/gbak -r -c -v -user SYSDBA -pass masterkey<путь_к_резервной_копии> <путь_к_файлу_БД>

В случае удачного восстановления будет выдано сообщение:

gbak: finishing, closing, and going home

В процессе продолжительной работы Системы рекомендуется осуществлять восстановлениеполучаемых резервных копий. Если процесс восстановления заканчивается ошибкой (такоеиногда может случаться), то следует попытаться исправить продуктивную базу данных спомощью утилиты gfix, как это было описано выше. Если ошибку исправить не удаётся, тоследует обратиться в службу технической поддержки по адресу [email protected].

Для очистки базы данных от очереди почтовых и SMS-уведомлений следует периодическизапускать скрипт mail_cleaner.php, запланировав его выполнение в утилите cron:

m h dom mon dow php -c /<путь_к_php.ini> /var/Motiw/scripts/mail_cleaner.php.

8.3 Резервное копирование PHP-сценариев

Кроме PHP-сценариев и прочих файлов, обеспечивающих функционирование Системы, вдиректории scripts содержится важная информация в виде прикрепляемых к задачам,действиям и документам файлов, а также, например, файлов с фотографиямипользователей, логотипом компании и некоторых других.

Всю эту информацию следует периодически сохранять на резервные носители.

Создание резервной копии директории scripts следует планировать с необходимой частотой.

Выполняя резервное копирование, следует учитывать, что этот процесс может заниматьдлительное время (в зависимости от объёма и количества файлов в директории scripts),замедляя при этом работу самой Системы. В таких случаях резервное копированиерекомендуется выполнять в то время, когда наблюдается низкая активность пользователейСистемы (например, в ночные часы).

8.4 Настройка поисковой системы

Настройка поисковой системы приведена в «Руководстве администратора системы».

При разведении Системы на два сервера в файле settings.xml необходимо указатьследующие параметры:

<?xml version="1.0" encoding="Windows-1251"?>

<settings>

<host isMultihosts="false" name="localhost">


Сопровождение установленной Системы 29

<motiw path="/usr/local/Motiw/scripts"/>

<database charset="WIN1251" host="IP адрес сервера с БД"

jndiName="jdbc/IP адрес сервера с БД" password="пароль БД"

path="/usr/local/db/motiw.fdb"

role="common" user="логин БД"/>

<indexPaths pathValue="/usr/local/Tomcat/motiw-indexes/localhost"/>

</host>

<settings>

30

9 Перенос Системы на другой сервер

Для переноса Системы на другой сервер следует выполнить следующие действия:

1. Создать нужную площадку.

2. Получить ссылки на базу и прикреплённые файлы. Распаковать их в /var/Motiw/scripts, абазу данных поместить в /var/Motiw/db.

3. В файле config_<название площадки>.ini, который находится по адресу /var/Motiw/scripts/include, следует прописать путь к БД (параметр dbpath).

© 2001-2012 Motiw are

8-800-555-43-21

http://w w w .motiw .ru

Education

Install guide linux