2. Оглавление
1 Комплект поставки 3
1.................................................................................................................................................................... 3
Комплект поставки Cистемы
2.................................................................................................................................................................... 3
Состав дистрибутива
2 Требования к аппаратному и программному обеспечению 4
3 Установка Cистемы 6
4 Настройка параметров Системы 7
1.................................................................................................................................................................... 7
Раздел [DBConnect]
2.................................................................................................................................................................... 8
Раздел [Mail]
.................................................................................................................................................................... 10
3 Раздел [SMS]
.................................................................................................................................................................... 12
4 Раздел [ActiveMQ]
.................................................................................................................................................................... 14
5 Раздел [NTLMAuth]
.................................................................................................................................................................... 15
6 Раздел [Other]
5 Дополнительные возможности Системы и их настройка 18
.................................................................................................................................................................... 18
1 Настройка работы клиентских приложений
.................................................................................................................................................................... 19
2 Настройка почтовых и SMS-оповещений
.................................................................................................................................................................... 19
3 Настройка автоматической рассылки оповещений по задачам
.................................................................................................................................................................... 19
4 Настройка отправки оповещений по задачам, помещённых в очередь
.................................................................................................................................................................... 20
5 Настройка интеграции с электронной почтой
.................................................................................................................................................................... 21
6 Настройка доменной авторизации
7 Настройка параметров, обеспечивающих работу системы после
.................................................................................................................................................................... 22
перезагрузки сервера
.................................................................................................................................................................... 22
8 Настройка размера прикрепляемых файлов
6 Вход в Систему 23
7 Редактирование имён виртуальных хостов 25
8 Сопровождение установленной Системы 26
.................................................................................................................................................................... 26
1 Резервное копирование базы данных
.................................................................................................................................................................... 27
2 Работа с базой данных
.................................................................................................................................................................... 28
3 Резервное копирование PHP-сценариев
.................................................................................................................................................................... 28
4 Настройка поисковой системы
9 Перенос Системы на другой сервер 30
2
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, которая содержит
пользовательскую документацию к Системе.
Комплект поставки 3
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);
4
5. – для хранилища файлов рекомендуется использовать ext4, что позволяет создавать
неограниченное количество подкаталогов;
– рекомендуемый веб-браузер – Mozilla FireFox 3.6.13 и выше.
Замечание – Кроме указанных выше ОС, Система может быть установлена также и на
другие Unix-like дистрибутивы, но при этом могут возникать различные проблемы. За
консультациями, связанными с выбором ОС и точными версиями указанных ОС для Вашего
дистрибутива системы «Мотив 4U 1.7», обращайтесь в службу технической поддержки по
адресу support@motiw.ru.
Важно! Не рекомендуется использование файловых систем ext2 и ext3, так как они
обладают ограничением по количеству директорий в одной поддиректории – 32 768. Это
может со временем негативно сказаться на крупных инсталляциях Системы (200–300
пользователей при активном использовании Системы).
Требования к аппаратному и программному обеспечению 5
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 (для сервера и клиентов).
6
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
Значение: имя пользователя СУБД для подключения к базе данных.
Настройка параметров Системы 7
8. Пример:
dblogin=SYSDBA
Формат ключа: имя_пользователя
Ключ dbpassword
Значение: пароль пользователя СУБД для подключения к базе данных.
Пример:
dbpassword=masterkey
Формат ключа: пароль_пользователя
4.2 Раздел [Mail]
Содержит ключи, необходимые для настройки почты.
Ключ FromAddress
Значение: e-mail автоинформатора Системы. Этот адрес будет указываться в поле FROM
(от кого) в письмах, отправляемых автоинформатором пользователям Системы.
Пример:
FromAddress="test.lan@motiw.ru"
Формат ключа: name@yourhost.ru
Ключ FromName
Значение: имя автоинформатора Системы в письмах, посылаемых пользователям Системы.
Пример:
FromName="Автоинформатор системы Мотив"
Формат ключа: имя автоинформатора
Ключ MailSendMethod
Значение: переключатель метода отправки почты.
Возможные значения: 0 – для Unix-like операционных систем; 1 – для ОС Windows.
Пример:
MailSendMethod=1
Формат ключа: 0 или 1
Ключ SMTP
Значение: имя сервера, используемого в качестве почтового.
8
9. Пример:
SMTP="smtp.mail.ru"
Формат ключа: smtp.host
Ключ sendmail_from
Значение: e-mail адрес, указываемый в поле SENDER (отправитель), в письмах,
отправляемых автоинформатором пользователям Системы. В зависимости от настроек
SMTP-сервер может не отправлять почту, если sendmail_from не принадлежит ему.
Пример:
sendmail_from ="motiw@mail.ru"
Формат ключа: name@host
Ключ sendmail_path
Значение: путь к программе с параметрами отправки почты sendmail. Настройка действует
для Unix-like операционных систем.
Пример:
sendmail_path="/usr/sbin/sendmail -t"
Формат ключа: путь параметры
Ключ MailDisable
Значение: управляет возможностью блокирования отправки почты.
Возможные значения: 0 – разрешает отправку почты; 1 – блокирует отправку почты.
Пример:
MailDisable=0
Формат ключа: 0 или 1
Внимание! В случае если для 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.
Настройка параметров Системы 9
10. 4.3 Раздел [SMS]
Содержит ключи, необходимые для настройки отправки SMS.
Ключ SmsDisable
Значение: управляет возможностью блокирования отправки SMS.
Возможные значения: 0 – разрешает отправку SMS; 1 – блокирует отправку SMS.
Пример:
SmsDisable =1
Формат ключа: 0 или 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
10
11. Ключ SmsIsHttpMethodPost
Значение: переключатель метода отправки сообщений.
Возможные значения: 0 – метод GET; 1 – метод POST.
Пример:
SmsIsHttpMethodPost=0
Формат ключа: 0 или 1
Ключ SmsIsInRrussian
Значение: переключатель языка SMS.
Возможные значения: 0 – латиница (текст SMS будет транслитерирован); 1 – русский язык.
Пример:
SmsIsInRrussian=1
Формат ключа: 0 или 1
Ключ SmsIsLogSms
Значение: управляет возможностью ведения журнала отправленных SMS.
Возможные значения: 0 – отключить ведение журнала; 1 – включить ведение журнала.
Пример:
SmsIsLogSms=0
Формат ключа: 0 или 1
Ключ SmsLogPath
Значение: путь к журналу SMS.
Пример:
SmsLogPath="/var/log/logsms.log"
Формат ключа: путь
Ключ SmsMaxParts
Значение: максимальное количество частей, на которое будет разбиваться каждое
сообщение при превышении им предельной величины. Предельная величина одного SMS на
русском языке – 70 символов, на транслите – 160 символов.
Настройка параметров Системы 11
12. Пример:
SmsMaxParts=2
Формат ключа: числовое_значение
Ключ SmsProxyHost
Значение: хост и порт прокси-сервера для выхода в Интернет. Если этот ключ явно не
указан, то он не используется.
Пример:
SmsProxyHost="localhost:3128"
Формат ключа: host:port
Ключ SmsProxyLogin
Значение: логин пользователя для прокси-сервера. Если этот ключ явно не указан, то он не
используется.
Пример:
SmsProxyLogin="login"
Формат ключа: имя_пользователя
Ключ SmsProxyPass
Значение: пароль пользователя для прокси-сервера. Если этот ключ явно не указан, то он
не используется.
Пример:
SmsProxyPass="pass"
Формат ключа: пароль_пользователя
Ключ SmsProxyType
Значение: тип прокси-сервера по умолчанию (http, socks4 или socks5). Если этот ключ явно
не указан, то он не используется.
Пример:
SmsProxyType="http"
Формат ключа:тип_прокси-сервера
4.4 Раздел [ActiveMQ]
Внимание! Если СМДС не используется, параметры данного раздела настраивать не
следует.
12
13. Данный раздел содержит настройки доступа к серверу с установленным СМДС Системы.
СМДС Системы предназначен для ускорения получения новых задач и действий по текущим
задачам пользователя в клиентских приложениях.
Ключ AQAddress
Значение: имя или IP-адрес сервера с установленным СМДС Системы.
Пример:
AQAddress="host"
Формат ключа: hostname
Ключ AQPort
Значение: номер порта, на котором работает СМДС Системы.
Пример:
AQPort=4000
Формат ключа: номер_порта
Ключ AQClientPort
Значение: порт ActiveMQ для клиентских приложений.
Пример:
AQClientPort=4000
Формат ключа: номер_порта
Ключ AQQueue
Значение: имя очереди сообщений.
Пример:
AQQueue="localhost"
Формат ключа: hostname
Ключ AQExpireTime
Значение: время (в сек.), в течение которого сообщение будет храниться в очереди. По
умолчанию сообщение хранится 120 сек.
Пример:
AQExpireTime=600
Формат ключа: числовое_значение
Настройка параметров Системы 13
14. Ключ AQUseAjax
Значение: позволяет автоматически получать обновления по задачам в веб-интерфейсе.
Возможные значения: 1 – автоматическое обновление; 0 – обновление вручную. Значение
по умолчанию – 1.
Пример:
AQUseAjax=1
Формат ключа: 0 или 1
Ключ AQAjaxRequestTime
Значение: период опроса (в сек.) установленного ActiveMQ.
Пример:
AQAjaxRequestTime=300
Формат ключа: числовое_значение
4.5 Раздел [NTLMAuth]
Содержит ключи, необходимые для настройки доменной авторизации.
Ключ domain_auth_enable
Значение: управляет видимостью подраздела Доменная авторизация в пункте меню
Системы «Личные настройки».
Возможные значения: 0 – раздел не отображается; 1 – раздел отображается.
Пример:
domain_auth_enable=1
Формат ключа: 0 или 1
Ключ domain_auth_type
Значение: имя подключаемого модуля для использования возможности доменной
авторизации.
Возможные значения: mod_auth_sspi – для ОС Windows, mod_ntlm2 – для Unix-like
операционных систем.
Пример:
domain_auth_type = "mod_auth_sspi"
Формат ключа: mod_auth_sspi или mod_ntlm2
14
15. 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
Формат ключа: 0 или 1
Ключ reject_task_start_date_in_past
Значение: управляет возможностью создания задач с датой начала, меньшей, чем текущая.
Возможные значения: 0 – дата начала не может быть меньше текущей (если выбрана дата
меньше, то после сохранения задачи в качестве даты начала автоматически
устанавливается текущая дата); 1 – дата начала может быть меньше текущей.
Пример:
reject_task_start_date_in_past=1
Формат ключа: 0 или 1
Ключ IsLocalNet
Значение: переключатель способа загрузки приложений, необходимых для Системы в
некоторых отчётах (Capicom, VM).
Возможные значения: 0 – скачивать из Интернета; 1 – скачивать с сервера Системы.
Пример:
IsLocalNet=0
Формат ключа: 0 или 1
Настройка параметров Системы 15
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 включена.
16
17. Значение по умолчанию – 0.
Пример:
UseOnlinePreview=1
Формат ключа: 0 или 1
Ключ isnotshowsystemactions
Значение: управляет установкой по умолчанию флажка Не уведомлять об изменении
рабочей группы.
Возможные значения: 0 – флажок по умолчанию не установлен; в задаче отображается
системное действие об удалении участника; 1 – флажок по умолчанию установлен;
системное действие в задаче не отображается.
Пример:
isnotshowsystemactions=1
Формат ключа: 0 или 1
Ключ allow_respperson_edit_task
Значение: управляет возможностью редактировать поля задачи пользователем в роли
ответственного руководителя.
Возможные значения: 0 – возможность редактирования полей отключена. Ответственный
руководитель может только добавлять контролёров, исполнителей и внешних
пользователей, а также редактировать ИРГ и тип задачи; 1 – возможность редактирования
полей включена.
Пример:
allow_respperson_edit_task=1
Формат ключа: 0 или 1
Настройка параметров Системы 17
18. 5 Дополнительные возможности Системы и их
настройка
К дополнительным возможностям Системы можно отнести следующие:
– автоматическая рассылка почтовых и SMS-оповещений пользователям о событиях в
задачах, в которых они участвуют;
– автоматическая рассылка сообщений и напоминаний пользователям Системы в
заданное время;
– интеграция Системы с электронной почтой для обмена почтовыми сообщениями с
пользователями, не зарегистрированными в Системе;
– оперативное получение пользователями задач и поручений по ним, а также
сигнализация об их получении с помощью клиентских приложений;
– поиск задач и зарегистрированных по ним действий, документов и файлов,
прикреплённых к описанию задач, действиям и документам, а также помещённых в
библиотеку;
– использование параметров доменной авторизации при входе пользователей в
Систему.
Для использования вышеперечисленных возможностей необходима их дополнительная
настройка.
5.1 Настройка работы клиентских приложений
В комплект поставки Системы дополнительно входят клиентские приложения: программа
«Информер» (для пользователей ОС Windows XP и выше) и программа XConductor (для
пользователей ОС Mac OS X 10.5 и выше). Данные приложения предназначены для
оперативного получения новых задач и действий по текущим задачам пользователя, а
также для сигнализации об их получении.
Руководства по работе с клиентскими приложениями можно просмотреть, выбрав пункт
меню «Руководства» раздела Д ополнительно главного меню веб-интерфейса Системы.
Для обеспечения мгновенной доставки пользователям приложения новых действий по
задачам, оповещений об изменении состава исполнителей в рабочих группах задач и т.д.
используется сервер с установленным сервисом мгновенной доставки сообщений (СМДС)
ActiveMQ.
При запуске приложения обращаются к серверу с установленным СМДС по указанному в
настройках порту (номер порта не регламентирован – задаётся при запуске СМДС, но
обычно 4000).
При установке Системы на ОС Linux требуется обеспечить автоматический запуск СМДС.
18
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-
оповещений по задачам. При этом следует задать определённый промежуток времени,
через который оповещения будут отправлены пользователям. Оповещения отправлены не
Дополнительные возмож ности Системы и их настройка 19
20. будут, если в течение этого времени пользователем были просмотрены действия и
оповещения по задачам в веб-интерфейсе, PDA-интерфейсе или в клиентских приложениях.
Задание соответствующих настроек осуществляется администратором системы в пункте
меню «Настройки оповещений» раздела Администрирование.
Отправка оповещений по задачам, помещённых в очередь, осуществляется с помощью
файла send_mail_sms_from_queue.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/
send_mail_sms_from_queue.php /var/Motiw/scripts motiw >> /var/log/motiw.
send_mail_sms_from_queue.log
где: sudo -u apache – запуск выполняется от имени пользователя apache;
/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;
motiw – доменное имя сервера «Мотив 4U 1.7» (DNS);
>> /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. Сценарий запускается с двумя параметрами:
1. Корневой каталог, в котором расположены PHP-сценарии Системы.
2. Имя сервера (hostname).
Пример запуска процесса проверки в утилите cron приведён ниже.
20
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
где: sudo -u apache – запуск выполняется от имени пользователя apache;
/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;
motiw – доменное имя сервера «Мотив 4U 1.7» (DNS);
>> /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.
Дополнительные возмож ности Системы и их настройка 21
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
22
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.
Вход в Систему 23
24. Затем для входа в PDA-версию Системы следует в строке браузера ввести:
<адрес_сервера_системы>/pda. В появившемся окне авторизации в качестве имени и
пароля следует указать «admin».
Замечание – Вход в PDA-интерфейс Системы для пользователей, которые работали до
перехода на текущую версию в системе «Мотив» версии 3.8.1 и ниже, может также
осуществляться по адресу: pda.<адрес_сервера_Системы>.
Справочное руководство для PDA-версии Системы можно просмотреть в меню Системы
Д ополнительно –> «Руководства» –> «Руководство для PDA-версии».
Для доступа в Систему с пользовательских компьютеров следует прописать в DNS IP-адрес
и символьное имя сервера. Причём символьное имя сервера должно соответствовать имени,
указанному в параметрах ServerName или ServerAlias файла httpd.conf.
Для входа в Систему с пользовательского компьютера следует ввести в строке адреса
браузера:
http://<символьное_имя_сервера>
Для доступа к PDA-версии Системы с пользовательских компьютеров следует аналогичным
образом осуществить настройку параметров, описанных выше, или добавить запись в DNS.
24
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».
Редактирование имён виртуальных хостов 25
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
26
27. резервная копия базы данных будет сохранена в файл save_motiw.fbk. В случае успешного
завершения резервного копирования будет выдано сообщение:
gbak: closing file, committing, and finishing. xxxxxxx bytes written
Резервное копирование базы данных с помощью утилиты gbak не требует остановки
сервера Firebird.
Создание резервной копии базы данных следует планировать с необходимой частотой.
Планирование осуществляется с помощью утилиты cron.
Если на сервере произошёл сбой, в результате которого база данных оказалась
повреждённой, то следует обратиться в службу технической поддержки по адресу
support@motiw.ru.
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 <путь_к_файлу_БД>
и проверить функционирование Системы.
Сопровож дение установленной Системы 27
28. Если после проверки и/или исправления ошибок с помощью утилиты gfix вернуть БД в
рабочее состояние не удалось, то следует взять последнюю резервную копию и
восстановить из неё базу данных (команда должна быть записана в одну строку):
<путь_к_Firebird>/bin/gbak -r -c -v -user SYSDBA -pass masterkey
<путь_к_резервной_копии> <путь_к_файлу_БД>
В случае удачного восстановления будет выдано сообщение:
gbak: finishing, closing, and going home
В процессе продолжительной работы Системы рекомендуется осуществлять восстановление
получаемых резервных копий. Если процесс восстановления заканчивается ошибкой (такое
иногда может случаться), то следует попытаться исправить продуктивную базу данных с
помощью утилиты gfix, как это было описано выше. Если ошибку исправить не удаётся, то
следует обратиться в службу технической поддержки по адресу support@motiw.ru.
Для очистки базы данных от очереди почтовых и 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">
28
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>
Сопровож дение установленной Системы 29
30. 9 Перенос Системы на другой сервер
Для переноса Системы на другой сервер следует выполнить следующие действия:
1. Создать нужную площадку.
2. Получить ссылки на базу и прикреплённые файлы. Распаковать их в /var/Motiw/scripts, а
базу данных поместить в /var/Motiw/db.
3. В файле config_<название площадки>.ini, который находится по адресу /var/Motiw/
scripts/include, следует прописать путь к БД (параметр dbpath).
30