2. Оглавление
1 Комплект поставки 3
1 Комплект поставки Cистемы
........................................................................................................................................................... 3
2 Состав дистрибутива
........................................................................................................................................................... 3
2 Требования к аппаратному и программному обеспечению 4
3 Установка Cистемы 5
4 Настройка параметров Системы 9
1 Раздел [DBConnect]
........................................................................................................................................................... 9
2 Раздел [Mail]
........................................................................................................................................................... 10
3 Раздел [SMS]
........................................................................................................................................................... 12
4 Раздел [ActiveMQ]
........................................................................................................................................................... 14
5 Раздел [NTLMAuth]
........................................................................................................................................................... 16
6 Раздел [Other]
........................................................................................................................................................... 16
5 Дополнительные возможности Системы и их настройка 20
1 Настройка работы клиентских приложений
........................................................................................................................................................... 20
2 Настройка почтовых и SMS-оповещений
........................................................................................................................................................... 21
3 Настройка автоматической рассылки оповещений по задачам
........................................................................................................................................................... 21
4 Настройка отправки оповещений по задачам, помещённых в очередь
........................................................................................................................................................... 22
5 Настройка интеграции с электронной почтой
........................................................................................................................................................... 23
6 Настройка доменной авторизации
........................................................................................................................................................... 23
7 Настройка размера прикрепляемых файлов
........................................................................................................................................................... 24
6 Вход в Систему 25
7 Редактирование имён виртуальных хостов 27
8 Сопровождение установленной Системы 28
1 Резервное копирование базы данных
........................................................................................................................................................... 28
2 Работа с базой данных
........................................................................................................................................................... 29
3 Очистка очереди уведомлений
........................................................................................................................................................... 30
4 Резервное копирование PHP-сценариев
........................................................................................................................................................... 31
5 Настройка поисковой системы
........................................................................................................................................................... 31
2
3. 1 Комплект поставки
1.1 Комплект поставки Cистемы
Комплект поставки системы «Мотив 4U 1.7» (далее – Системы) включает:
– программное обеспечение, необходимое для работы Системы;
– клиентские приложения, предназначенные для оперативного получения информации
о состоянии задач пользователей Системы.
Программное обеспечение, необходимое для работы Системы, включает в себя:
– СУБД Firebird 2.5.1;
– веб-сервер Apache 2.2.22;
– PHP 5.3.15;
– Zend Optimizer 3.3.9;
– Ioncube PHP Loader v4.2.2
– cервер Tomcat 6;
– Memcached 1.4.4;
– OpenSSL 0.9.8a.
1.2 Состав дистрибутива
Поставляемый дистрибутив включает архив Motiw4U-1.7-Win32.zip, содержащий файлы и
программы для установки Системы на ОС Windows.
В разархивированном виде папка Motiw4U-1.7- Win32 содержит следующие файлы:
– jre-7u5-windows-i586.exe – программа установки приложения Java Development Kit;
– Motiw4U-1.7-Win32.exe – программа установки Системы на ОС Windows;
– install_guide_Windows.pdf – руководство по установке и обслуживанию Системы
в формате *.pdf;
– и папку tools, в которой располагается архив MApiC, содержащий утилиту вызовов
API-интерфейса Системы и примеры API-функций. Подробное описание работы с
утилитой описано в «Руководстве программиста».
Комплект поставки 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. Требования к программному обеспечению
– операционная система – Windows XP/2003/2008 32bit;
– наличие приложения Java Development Kit не ниже версии 5;
– файловая система – NTFS;
– рекомендуемые веб-браузеры – Microsoft Internet Explorer 8.0 и выше, а также
Mozilla FireFox 3.6.13 и выше;
– рекомендуемый пакет офисных приложений MS – не ниже MS Office 2003.
Важно! Не рекомендуется использование файловых систем FAT16 и FAT32, так как они
обладают ограничением по размеру файлов – 2 Гб максимум. Это может со временем
негативно сказаться на крупных инсталляциях Системы (200 – 300 пользователей при
активном использовании Системы).
4
5. 3 Установка Cистемы
Если в системе уже установлена и работает одна из программ: СУБД Firebird, веб-сервер
Apache или другой веб-сервер, PHP, Zend Optimizer, Tomcat – то перед запуском установки
Системы их следует удалить, иначе успешная установка Системы не может быть
гарантирована.
Перед установкой Системы следует установить приложение Java(TM) Runtime Environment
Version 7 и выше, установочный файл jre-7u5-windows-i586.exe которого располагается в
архиве Motiw4U-1.7-Win32.zip.
Установка Системы на ОС Windows осуществляется запуском программы установки
Motiw4U-1.7-Win32.exe. При этом откроется окно (рис. 1), в котором следует выбрать язык
установки Системы.
Рис. 1. Окно выбора языка установки
Далее откроется диалоговое окно (рис. 2), в котором после ознакомления с информацией по
установке следует нажать кнопку Далее.
Рис. 2. Окно приветствия
Установка Cистемы 5
6. В открывшемся окне (рис. 3) нажатием кнопки Обзор следует указать каталог, в который
будет установлена Система.
Рис. 3. Окно выбора папки для установки в неё Системы
После выбора каталога следует нажать кнопку Далее. При этом откроется окно (рис. 4), в
котором при необходимости можно отключить опцию создания ярлыка в меню Пуск.
Рис. 4. Окно выбора папки для создания в ней ярлыка
6
7. После нажатия кнопки Далее откроется окно (рис. 5), в котором следует нажать кнопку
Установить для запуска процесса установки.
Рис. 5. Окно перехода к старту установки Системы
При этом произойдёт копирование всех необходимых для работы Системы файлов. По
завершении копирования Система будет полностью установлена (рис. 6). По завершении
установки Системы веб-сервер Apache будет автоматически запущен.
Рис. 6. Окно завершения установки
Установка Cистемы 7
8. Запуск установленной Системы будет произведён автоматически при включении опции
«Открыть Мотив в браузере».
После установки Системы для обращения к ней по имени следует определить в httpd.conf
секцию Virtual host, директиву Server name и добавить запись <ip> <servername> в
файле hosts (для сервера и клиентов).
Изменение настроек Cистемы, таких, как подключение к базе данных, почтовые настройки,
SMS и т.д., можно осуществить в файле config_motiw.ini, который располагается в
директории Motiwscriptsinclude. Подробное описание параметров файла см. в разделе 4
данного руководства.
8
9. 4 Настройка параметров Системы
Настройка параметров Системы осуществляется в файле config_motiw.ini, который состоит
из следующих разделов:
– [DBConnect];
– [Mail];
– [SMS];
– [ActiveMQ];
– [NTLMAuth];
– [Other].
Каждый раздел содержит набор ключей, для каждого из которых следует задать
соответствующее значение. Если значение ключа отлично от числового, то оно
записывается в кавычках.
Предупреждение – Названия ключей чувствительны к регистру.
4.1 Раздел [DBConnect]
Содержит ключи, необходимые для подключения к базе данных.
Ключ dbpath
Значение: полный путь к базе данных.
Путь к базе данных рекомендуется прописывать с использованием интерфейса обратной
петли (loopback interface). Ниже приведён пример с использованием петли localhost.
Путь к базе данных записывается в формате Unix, то есть с использованием прямого (/), а
не обратного () слеша.
Пример:
dbpath="localhost:C:/Program Files/Motiw/db/motiw.fdb"
Формат ключа: хост:путь
Ключ dbname
Значение: имя файла базы данных.
Если ключ dbpath не содержит имени файла базы данных, то его можно указать в ключе
dbname.
Пример:
dbname="motiw.fdb"
Формат ключа: имя_файла_базы_данных
Ключ dblogin
Значение: имя пользователя СУБД для подключения к базе данных.
Настройка параметров Системы 9
10. Пример:
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
Значение: имя сервера, используемого в качестве почтового.
10
11. Пример:
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 директории C:windows в разделе [mail
function] следует прописать параметры:
auth_username=account_name – имя аккаунта;
auth_password=account_password – пароль.
Возможна ситуация, когда перед авторизацией на SMTP сервере требуется авторизация на
POP3 сервере. В этом случае следует прописать параметры:
pop3_server=pop.имя сервера
pop3_username=account_name
pop3_password=account_password
После внесения параметров необходимо перезапустить службу Apache2.
Настройка параметров Системы 11
12. 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
12
13. Ключ 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 символов.
Пример:
SmsMaxParts=2
Формат ключа: числовое_значение
Настройка параметров Системы 13
14. Ключ SmsProxyHost
Значение: хост и порт прокси-сервера для выхода в Интернет. Если этот ключ явно не
указан, то он не используется.
Пример:
SmsProxyHost="localhost:3128"
Формат ключа: host:port
Ключ SmsProxyLogin
Значение: логин пользователя для прокси-сервера. Если этот ключ явно не указан, то он не
используется.
Пример:
SmsProxyLogin="login"
Формат ключа: имя_пользователя
Ключ SmsProxyPass
Значение: пароль пользователя для прокси-сервера. Если этот ключ явно не указан, то он
не используется.
Пример:
SmsProxyPass="pass"
Формат ключа: пароль_пользователя
Ключ SmsProxyType
Значение: тип прокси-сервера по умолчанию (http, socks4 или socks5). Если этот ключ явно
не указан, то он не используется.
Пример:
SmsProxyType="http"
Формат ключа:тип_прокси-сервера
4.4 Раздел [ActiveMQ]
Внимание! Если СМДС не используется, параметры данного раздела настраивать не
следует.
Данный раздел содержит настройки доступа к серверу с установленным СМДС Системы.
СМДС Системы предназначен для ускорения получения новых задач и действий по текущим
задачам пользователя в клиентских приложениях.
14
15. Ключ AQAddress
Значение: имя или IP-адрес сервера с установленным СМДС Системы.
Пример:
AQAddress="host"
Формат ключа: hostname
Ключ AQPort
Значение: номер порта, на котором работает СМДС Системы.
Пример:
AQPort=4000
Формат ключа: номер_порта
Ключ AQClientPort
Значение: порт ActiveMQ для клиентских приложений.
Пример:
AQClientPort=4000
Формат ключа: номер_порта
Ключ AQQueue
Значение: имя очереди сообщений.
Пример:
AQQueue="localhost"
Формат ключа: hostname
Ключ AQExpireTime
Значение: время (в сек.), в течение которого сообщение будет храниться в очереди. По
умолчанию сообщение хранится 120 сек.
Пример:
AQExpireTime=600
Формат ключа: числовое_значение
Ключ AQUseAjax
Значение: позволяет автоматически получать обновления по задачам в веб-интерфейсе.
Возможные значения: 1 – автоматическое обновление; 0 – обновление вручную. Значение
по умолчанию – 1.
Настройка параметров Системы 15
16. Пример:
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, mod_ntlm2 – для Unix-like операционных систем.
Пример:
domain_auth_type = "mod_auth_sspi"
Формат ключа: mod_auth_sspi
4.6 Раздел [Other]
Содержит дополнительные настройки Системы.
Ключ LoginLanguage
Значение: переключатель языка окна авторизации. Язык выбирается из списка языков
Системы.
Возможные значения: RU – русский язык; EN – английский язык; DE – немецкий язык.
16
17. Пример:
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
Ключ tomcat_port
Значение: номер порта, по которому работает сервер Tomcat.
Значение по умолчанию 8080.
Пример:
tomcat_port=8080
Формат ключа: номер_порта
Настройка параметров Системы 17
18. Ключ 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
Формат ключа: 0 или 1
18
19. Ключ isnotshowsystemactions
Значение: управляет установкой по умолчанию флажка Не уведомлять об изменении
рабочей группы.
Возможные значения: 0 – флажок по умолчанию не установлен; в задаче отображается
системное действие об удалении участника; 1 – флажок по умолчанию установлен;
системное действие в задаче не отображается.
Пример:
isnotshowsystemactions=1
Формат ключа: 0 или 1
Ключ allow_respperson_edit_task
Значение: управляет возможностью редактировать поля задачи пользователем в роли
ответственного руководителя.
Возможные значения: 0 – возможность редактирования полей отключена. Ответственный
руководитель может только добавлять контролёров, исполнителей и внешних
пользователей, а также редактировать ИРГ и тип задачи; 1 – возможность редактирования
полей включена.
Пример:
allow_respperson_edit_task=1
Формат ключа: 0 или 1
Настройка параметров Системы 19
20. 5 Дополнительные возможности Системы и их
настройка
К дополнительным возможностям Системы можно отнести следующие:
– автоматическая рассылка почтовых и SMS-оповещений пользователям о событиях в
задачах, в которых они участвуют;
– автоматическая рассылка сообщений и напоминаний пользователям Системы в
заданное время;
– интеграция Системы с электронной почтой для обмена почтовыми сообщениями с
пользователями, не зарегистрированными в Системе;
– оперативное получение пользователями задач и поручений по ним, а также
сигнализация о их получении с помощью клиентских приложений;
– поиск задач и зарегистрированных по ним действий, документов и файлов,
прикреплённых к описанию задач, действиям и документам, а также помещённых в
библиотеку;
– использование параметров доменной авторизации при входе пользователей в
Систему.
Для использования вышеперечисленных возможностей необходима их дополнительная
настройка.
5.1 Настройка работы клиентских приложений
В комплект поставки Системы дополнительно входят клиентские приложения: программа
«Информер» (для пользователей ОС Windows XP и выше) и программа XConductor (для
пользователей ОС Mac OS X 10.5 и выше). Данные приложения предназначены для
оперативного получения новых задач и действий по текущим задачам пользователя, а
также для сигнализации о их получении.
Руководства по работе с клиентскими приложениями можно просмотреть, выбрав пункт
меню «Руководства» раздела Д ополнительно главного меню веб-интерфейса Системы.
Для обеспечения мгновенной доставки пользователям приложения новых действий по
задачам, оповещений об изменении состава исполнителей в рабочих группах задач и т.д.
используется сервер с установленным сервисом мгновенной доставки сообщений (СМДС)
ActiveMQ.
При запуске приложения обращаются к серверу с установленным СМДС по указанному в
настройках порту (номер порта не регламентирован – задаётся при запуске СМДС, но
обычно 4000).
20
21. 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.exe,
который располагается в директории C:Program FilesMotiwsoftwarePHP. Сценарий
запускается с двумя параметрами:
1. Корневой каталог, в котором расположены PHP-сценарии Системы.
2. Имя сервера (hostname).
Примечание – Путь к файлу php.exe следует указывать в кавычках.
В меню «Панели управления» следует выбрать пункт «Назначенные задания». В
открывшемся окне с помощью мастера следует добавить задания для проверки почтовых
ящиков. Для этого в окне выбора программы следует нажать кнопку Обзор, в открывшемся
окне выбрать bat-файл и задать периодичность его запуска. Рекомендуется запускать bat-
файл с интервалом не менее чем 10–15 минут во избежание ситуации с одновременным
запуском нескольких процессов автоматической рассылки оповещений по задаче.
Пример содержимого bat-файла приведён ниже.
"C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program
FilesMotiwscriptsservicessendmailreminds.php" "C:Program FilesMotiwscripts"
motiw >> "C:logmotiw.sendmailreminds.log"
где: "C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program FilesMotiwsripts
sendmailreminds.php" – запускается PHP, которому в качестве параметра передаётся файл
sendmailreminds.php;
"C:Program FilesMotiwscriptssendmailreminds.php" – файл sendmailreminds.php в
качестве параметра передаётся путь "C:Program FilesMotiwscripts";
motiw – доменное имя сервера «Мотив 4U 1.7» (DNS);
Дополнительные возмож ности Системы и их настройка 21
22. >> "C:logmotiw.sendmailreminds.log" – результат вышеперечисленных операций
перенаправляется в лог-файл motiw.sendmailreminds.log.
5.4 Настройка отправки оповещений по задачам, помещённых в очередь
Предусмотрена возможность использования отложенной отправки почтовых и SMS-
оповещений по задачам. При этом следует задать определённый промежуток времени,
через который оповещения будут отправлены пользователям. Оповещения отправлены не
будут, если в течение этого времени пользователем были просмотрены действия и
оповещения по задачам в веб-интерфейсе, PDA-интерфейсе или в клиентских приложениях.
Задание соответствующих настроек осуществляется администратором системы в пункте
меню «Настройки оповещений» раздела Администрирование.
Для использования вышеописанной возможности следует осуществить дополнительную
настройку Системы.
Отправка оповещений по задачам, помещённых в очередь, осуществляется с помощью
файла send_mail_sms_from_queue.php, который располагается в каталоге services
корневой директории Системы. Для этого следует периодически исполнять данный файл
через интерпретатор php.exe, располагающийся в директории C:Program
FilesMotiwsoftwarePHP. Сценарий запускается с двумя параметрами:
1. Корневой каталог, в котором расположены PHP-сценарии Системы.
2. Имя сервера (hostname).
Примечание – Путь к файлу php.exe следует указывать в кавычках.
В меню «Панели управления» следует выбрать пункт «Назначенные задания». В
открывшемся окне с помощью мастера следует добавить задания для проверки почтовых
ящиков. Для этого в окне выбора программы следует нажать кнопку Обзор, в открывшемся
окне выбрать bat-файл и задать периодичность его запуска. Рекомендуется запускать bat-
файл с интервалом не менее чем 10–15 минут во избежание ситуации с одновременным
запуском нескольких процессов отправки оповещений по задачам, помещённых в очередь.
Пример содержимого bat-файла приведён ниже.
"C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program
FilesMotiwscriptsservicessend_mail_sms_from_queue.php" "C:Program
FilesMotiwscripts" motiw >> "C:logmotiw.send_mail_sms_from_queue.log"
где: "C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program
FilesMotiwsriptsservicessend_mail_sms_from_queue.php" – запускается PHP, которому
передаётся файл send_mail_sms_from_queue.php в качестве параметра;
"C:Program FilesMotiwscriptssend_mail_sms_from_queue.php" – файл
send_mail_sms_from_queue.php, которому в качестве параметра передаётся путь "C:
Program FilesMotiwscripts";
motiw – доменное имя сервера «Мотив 4U 1.7» (DNS);
22
23. >> "C:logmotiw.send_mail_sms_from_queue.log" – результат вышеперечисленных
операций перенаправляется в лог-файл motiw.send_mail_sms_from_queue.log.
5.5 Настройка интеграции с электронной почтой
Интеграция с электронной почтой подразумевает под собой настройку опроса почтовых
ящиков пользователей на наличие новых писем. Для использования этой возможности
следует поместить в папку Motiwscriptslicense файл лицензии motiw4u_17.lic.
Опрос почтовых ящиков осуществляется с помощью файла imap_fetcher.php, который
располагается в каталоге services корневой директории Системы. Для этого следует
периодически исполнять данный файл через интерпретатор php.exe, который
располагается в директории C:Program FilesMotiwsoftwarePHP. Сценарий запускается с
двумя параметрами:
1. Корневой каталог, в котором расположены PHP-сценарии Системы.
2. Имя сервера (hostname).
Примечание – Путь к файлу php.exe следует указывать в кавычках.
В меню «Панели управления» следует выбрать пункт «Назначенные задания». В
появившемся окне с помощью мастера следует добавить задания для проверки почтовых
ящиков. Для этого в окне выбора программы следует нажать кнопку Обзор, в открывшемся
окне выбрать bat-файл и задать периодичность его запуска. Рекомендуется запускать bat-
файл с интервалом не менее чем 10–15 минут во избежание ситуации с одновременным
запуском нескольких процессов проверки почтовых ящиков.
Пример содержимого bat-файла приведён ниже.
"C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program
FilesMotiwscriptsservicesimap_fetcher.php" "C:Program FilesMotiwscripts" motiw
>> "C:logmotiw.imap_fetcher.log"
где: "C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program
FilesMotiwsriptsservicesimap_fetcher.php" – запускается PHP, которому в качестве
параметра передаётся файл imap_fetcher.php;
"C:Program FilesMotiwscriptsimap_fetcher.php" – файл imap_fetcher.php, которому в
качестве параметра передаётся путь "C:Program FilesMotiwscripts";
motiw – доменное имя сервера «Мотив 4U 1.7» (DNS);
>> "C:logmotiw.imap_fetcher.log" – результат вышеперечисленных операций
перенаправляется в лог-файл motiw.imap_fetcher.log.
5.6 Настройка доменной авторизации
Для использования доменной авторизации пользователями Системы следует осуществить её
настройку.
1. Прописать загрузку модуля mod_auth_sspi.
Дополнительные возмож ности Системы и их настройка 23
24. Для этого надо убедиться, что в файле httpd.conf раскомментирована строка
LoadModule sspi_auth_module modules/mod_auth_sspi.so
2. Убедиться, что в файле config_motiw.ini в разделе [NTLMAuth] раскомментированы
следующие параметры:
;Доменная авторизация
domain_auth_enable = 1;
;для ОС Windows:
domain_auth_type = "mod_auth_sspi";
Причём строка для Unix-like операционных систем должна быть закомментирована:
;для Unix-like операционных систем:
;domain_auth_type = "mod_ntlm2";
3. В файле .htaccess, располагающемся в директории scriptsauth, в строке
SSPIDomain DOMAINNAME
в качестве параметра DOMAINNAME указать имя домена сети.
5.7 Настройка размера прикрепляемых файлов
Настройка максимального размера файла для прикрепления к задачам, действиям и
документам осуществляется в файле php.ini, расположенном в директории C:Windows.
В подразделе 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
24
25. 6 Вход в Систему
После установки Системы в главном меню программ появится ярлык «Motiw», включающий
ссылки на программы «Информер» и XConductor, Систему, а также сопроводительную
документацию.
Для входа в установленную Систему c локального компьютера следует щёлкнуть по ярлыку
«Motiw» или в окне браузера (рекомендуется использовать MS Internet Explorer версии не
ниже 8.0 и Mozilla FireFox версии не ниже 3.6.13) ввести в строку адреса: http://localhost. В
открывшемся окне авторизации (рис. 7) в качестве имени и пароля следует указать
«admin» – реквизиты администратора системы по умолчанию, и нажать кнопку Вход. При
этом откроется окно загрузки файла лицензии.
Файл лицензии не входит в комплект поставки дистрибутива Системы, а предоставляется
менеджером по работе с клиентами. Нажав кнопку Обзор на форме загрузки, следует
указать путь к каталогу, в котором хранится файл лицензии motiw4u_17.lic. При успешной
загрузке файла лицензии откроется окно авторизации пользователя в Системе, в котором
для входа в Систему следует повторно ввести реквизиты администратора системы по
умолчанию.
Рис. 7. Окно входа в установленную Систему
Справочное руководство для пользователей Системы можно просмотреть в меню Системы
Д ополнительно –> «Руководства» –> «Руководство пользователя системы Мотив».
Руководство для администратора системы admin_system_guide.pdf, включающее описание
исходной настройки Системы, располагается в каталоге MotiwDocumentation.
Для использования PDA-версии Системы следует привести в соответствие параметры
ServerName или ServerAlias, указываемые в файле httpd.conf, и символьное имя сервера,
указываемое в файле hosts.
Вход в Систему 25
26. Например, указав в качестве имени сервера «pda» в файле hosts, который располагается в
директории C:WINDOWSsystem32driversetc, следует, соответственно, указать «pda» и в
качестве одного из параметров – ServerName или ServerAlias. Эти параметры
прописываются в файле httpd.conf, который располагается в директории C:Program
FilesMotiwsoftwareapache2conf.
Затем для входа в PDA-версию Системы следует в строке браузера ввести:
<адрес_сервера_системы>/pda. В появившемся окне авторизации в качестве логина и
пароля следует указать admin.
Замечание – Вход в PDA-интерфейс Системы для пользователей, которые работали до
перехода на текущую версию в системе «Мотив» версии 3.8.1 и ниже, может также
осуществляться по адресу: pda.<адрес_сервера_Системы>.
Справочное руководство для PDA-версии Системы можно просмотреть в меню Системы
Д ополнительно –> «Руководства» –> «Руководство для PDA-версии».
Для доступа в Систему с пользовательских компьютеров следует прописать в DNS IP-адрес
и символьное имя сервера. Причём символьное имя сервера должно соответствовать имени,
указанному в параметрах ServerName или ServerAlias файла httpd.conf.
Для входа в Систему с пользовательского компьютера следует ввести в строке адреса
браузера:
http://<символьное_имя_сервера>
Для доступа к PDA-версии Системы с пользовательских компьютеров следует аналогичным
образом осуществить настройку параметров, описанных выше, или добавить запись в DNS.
26
27. 7 Редактирование имён виртуальных хостов
Для изменения символьного имени сервера следует внести изменения в файл httpd.conf,
который располагается в директории C:Program FilesMotiwsoftwareApache2conf.
NameVirtualHost *:80
<VirtualHost *:80>
DocumentRoot <путь_к_каталогу_scripts>
ServerName <имя_сервера>
ServerAlias <псевдоним_сервера>
</VirtualHost>
<VirtualHost *:80>
DocumentRoot <путь_к_директории_scriptspda.motiw>
ServerName <pda.имя_сервера>
ServerAlias <псевдоним_сервера>
</VirtualHost>
Задание нового символьного имени для виртуального сервера осуществляется в строке
ServerName или ServerAlias. После внесения изменений следует перезапустить сервер
Apache.
Затем следует внести соответствующие изменения в файл hosts, который располагается в
директории C:WINDOWSsystem32driversetc, а также прописать символьное имя
сервера в DNS.
Для входа в Систему после изменения символьного имени сервера следует в окне браузера
ввести:
для веб-версии Системы:
http://<новое_имя_сервера>
для PDA-версии Системы:
http://<адрес_сервера_системы>/pda
или http://pda.<новое_имя_сервера>
Замечание – Второй способ для PDA-версии Системы указан для пользователей, которые
работали до перехода на текущую версию в системе «Мотив» версии 3.8.1 и ниже.
Для входа как в веб-, так и в PDA-интерфейс в окне авторизации следует в качестве имени и
пароля пользователя указать «admin».
Редактирование имён виртуальных хостов 27
28. 8 Сопровождение установленной Системы
Процесс обеспечения сохранности данных, хранящихся в Системе, включает в себя ряд
простых, но необходимых действий. Эти действия выполняются, как правило, системным
администратором, имеющим доступ к серверу, на котором установлена Система.
Для сопровождения Системы следует:
1. Периодически выполнять проверку и резервное копирование файла базы данных. Данный
файл имеет расширение *.fdb, который обычно располагается в директории С:Program
FilesMotiwdb.
2. Периодически выполнять резервное копирование директории с PHP-сценариями Системы,
в которой в том числе содержатся различные информационные файлы (прикрепляемые к
задачам и документам, хранящиеся в библиотеке и др.). PHP-сценарии располагаются в
поддиректории С:Program FilesMotiwscripts.
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.
28
29. В результате запуска следующей команды (команда должна быть записана в одну строку):
<путь_к_Firebird>bingbak -b -t -v -user SYSDBA -pass masterkey "localhost:
<путь_к_файлу_БД>" save_motiw.fbk
резервная копия базы данных будет сохранена в файл save_motiw.fbk. В случае успешного
завершения резервного копирования будет выдано сообщение:
gbak: closing file, committing, and finishing. xxxxxxx bytes written
Резервное копирование базы данных с помощью утилиты gbak не требует остановки
сервера Firebird.
Создание резервной копии базы данных следует планировать с необходимой частотой.
Планирование осуществляется с помощью пункта меню «Панель управления»->
«Назначенные задания».
Если на сервере произошёл сбой, в результате которого база данных оказалась
повреждённой, то следует обратиться в службу технической поддержки по адресу
support@motiw.ru.
8.2 Работа с базой данных
Для корректной работы БД рекомендуется не реже чем раз в 3 месяца производить
проверку БД с помощью системной утилиты gfix, расположенной в директории
<путь_к_Firebird>bin. А также проверку БД следует производить при появлении большого
числа ошибок вида «Query error:…», получаемых при попытке войти в Систему или
осуществить какие-либо действия в ней. Для проверки БД следует выполнить следующее.
1. Запретить подключение к БД другим пользователям, кроме администратора БД (SYSDBA),
с помощью команды:
<путь_к_Firebird>bingfix -shut -force 0 -user SYSDBA -pass masterkey
<путь_к_файлу_БД>
2. Выполнить проверку БД с помощью команды:
<путь_к_Firebird>bingfix -v -full -user SYSDBA -pass masterkey <путь_к_файлу_БД>
Данная команда должна вывести информацию о наличии ошибок в БД. Если их нет и запуск
команды не привёл к изменениям на экране, то в файле БД ошибок нет. В этом случае
следует ещё раз проверить причину возникновения ошибок – возможно, она заключается в
неправильных или изменившихся настройках Системы или в других изменениях.
В случае наличия ошибок в файле БД gfix должен вывести сообщение следующего вида:
number of index page errors xxx
number of database page errors xxx
Ошибки в файле БД следует исправить командой:
<путь_к_Firebird>bingfix -mend -full -ignore -user SYSDBA -pass masterkey
<путь_к_файлу_БД>
Сопровож дение установленной Системы 29
30. После этого рекомендуется снова проверить БД на наличие ошибок. Если ошибок не
обнаружено, то следует разрешить доступ к БД с помощью команды:
<путь_к_Firebird>bingfix -online -user SYSDBA -pass masterkey <путь_к_файлу_БД>
и проверить функционирование Системы.
Если после проверки и/или исправления ошибок с помощью утилиты gfix вернуть БД в
рабочее состояние не удалось, то следует взять последнюю резервную копию и
восстановить из неё базу данных (команда должна быть записана в одну строку):
<путь_к_Firebird>bingbak -r -c -v -user SYSDBA -pass masterkey
<путь_к_резервной_копии> <путь_к_файлу_БД>
В случае удачного восстановления будет выдано сообщение:
gbak: finishing, closing, and going home
В процессе продолжительной работы Системы рекомендуется осуществлять восстановление
получаемых резервных копий. Если процесс восстановления заканчивается ошибкой (такое
иногда может случаться), то следует попытаться исправить продуктивную базу данных с
помощью утилиты gfix, как это было описано выше. Если ошибку исправить не удаётся, то
следует обратиться в службу технической поддержки по адресу support@motiw.ru.
8.3 Очистка очереди уведомлений
Очистка базы данных от очереди почтовых и SMS-уведомлений осуществляется с помощью
файла mail_cleaner.php, который располагается в каталоге scripts корневой директории
Системы.
Для очистки следует периодически исполнять данный файл через интерпретатор php.exe,
который располагается в директории C:Program FilesMotiwsoftwarePHP. Сценарий
запускается посредством корневого каталога, в котором расположены PHP-сценарии
Системы.
Примечание – Путь к файлу php.exe следует указывать в кавычках.
В меню «Панели управления» следует выбрать пункт «Назначенные задания». В
открывшемся окне с помощью мастера следует добавить задания для очистки очереди. Для
этого в окне выбора программы следует нажать кнопку Обзор, в открывшемся окне выбрать
bat-файл и задать периодичность его запуска. Рекомендуется запускать bat-файл с
интервалом не менее чем один раз в день во избежание ситуации с одновременным
запуском нескольких процессов очистки.
Пример содержимого bat-файла приведён ниже.
"C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program
FilesMotiwscriptsmail_cleaner.php"
где: "C:Program FilesMotiwsoftwarePHPphp.exe" "C:Program
FilesMotiwsriptsmail_cleaner.php" – запускается PHP, которому в качестве параметра
передаётся файл mail_cleaner.php;
30
31. "C:Program FilesMotiwscriptsmail_cleaner.php" – файл mail_cleaner.php в качестве
параметра передаётся путь "C:Program FilesMotiwscripts".
8.4 Резервное копирование PHP-сценариев
Кроме PHP-сценариев и прочих файлов, обеспечивающих функционирование Системы, в
директории scripts содержится важная информация в виде прикрепляемых к задачам,
действиям и документам файлов, а также, например, файлов с фотографиями
пользователей, логотипом компании и некоторых других
Всю эту информацию следует периодически сохранять на резервные носители.
Создание резервной копии директории scripts следует планировать с необходимой частотой.
Выполняя резервное копирование, следует учитывать, что этот процесс может занимать
длительное время (в зависимости от объёма и количества файлов в директории scripts),
замедляя при этом работу самой Системы. В таких случаях резервное копирование
рекомендуется выполнять в то время, когда наблюдается низкая активность пользователей
Системы (например, в ночные часы).
8.5 Настройка поисковой системы
Настройка поисковой системы приведена в «Руководстве администратора системы».
При разведении Системы на два сервера в файле settings.xml необходимо указать
следующие параметры:
<?xml version="1.0" encoding="Windows-1251"?>
<settings>
<host isMultihosts="false" name="localhost">
<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>
Сопровож дение установленной Системы 31