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




                                верси 1.7
                                     я
Оглавление
      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
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
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
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
В открывшемся окне (рис. 3) нажатием кнопки Обзор следует указать каталог, в который
будет установлена Система.




                 Рис. 3. Окно выбора папки для установки в неё Системы

После выбора каталога следует нажать кнопку Далее. При этом откроется окно (рис. 4), в
котором при необходимости можно отключить опцию создания ярлыка в меню Пуск.




                  Рис. 4. Окно выбора папки для создания в ней ярлыка



6
После нажатия кнопки Далее откроется окно (рис. 5), в котором следует нажать кнопку
Установить для запуска процесса установки.




                   Рис. 5. Окно перехода к старту установки Системы

При этом произойдёт копирование всех необходимых для работы Системы файлов. По
завершении копирования Система будет полностью установлена (рис. 6). По завершении
установки Системы веб-сервер Apache будет автоматически запущен.




                          Рис. 6. Окно завершения установки



                                                                 Установка Cистемы   7
Запуск установленной Системы будет произведён автоматически при включении опции
«Открыть Мотив в браузере».
После установки Системы для обращения к ней по имени следует определить в httpd.conf
секцию Virtual host, директиву Server name и добавить запись <ip> <servername> в
файле hosts (для сервера и клиентов).
Изменение настроек Cистемы, таких, как подключение к базе данных, почтовые настройки,
SMS и т.д., можно осуществить в файле config_motiw.ini, который располагается в
директории Motiwscriptsinclude. Подробное описание параметров файла см. в разделе 4
данного руководства.




8
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
Пример:
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
Пример:
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
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
Ключ 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
Ключ SmsProxyHost
Значение: хост и порт прокси-сервера для выхода в Интернет. Если этот ключ явно не
указан, то он не используется.
Пример:
SmsProxyHost="localhost:3128"
Формат ключа: host:port


Ключ SmsProxyLogin
Значение: логин пользователя для прокси-сервера. Если этот ключ явно не указан, то он не
используется.
Пример:
SmsProxyLogin="login"
Формат ключа: имя_пользователя


Ключ SmsProxyPass
Значение: пароль пользователя для прокси-сервера. Если этот ключ явно не указан, то он
не используется.
Пример:
SmsProxyPass="pass"
Формат ключа: пароль_пользователя


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


4.4 Раздел [ActiveMQ]
Внимание! Если СМДС не используется, параметры данного раздела настраивать не
следует.
Данный раздел содержит настройки доступа к серверу с установленным СМДС Системы.
СМДС Системы предназначен для ускорения получения новых задач и действий по текущим
задачам пользователя в клиентских приложениях.



14
Ключ 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
Пример:
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
Пример:
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
Ключ 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
Ключ isnotshowsystemactions
Значение: управляет установкой по умолчанию флажка Не уведомлять об изменении
рабочей группы.
Возможные значения: 0 – флажок по умолчанию не установлен; в задаче отображается
системное действие об удалении участника; 1 – флажок по умолчанию установлен;
системное действие в задаче не отображается.
Пример:
isnotshowsystemactions=1
Формат ключа: 0 или 1


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




                                                     Настройка параметров Системы   19
5    Дополнительные возможности Системы и их
     настройка
К дополнительным возможностям Системы можно отнести следующие:
     – автоматическая рассылка почтовых и SMS-оповещений пользователям о событиях в
       задачах, в которых они участвуют;
     – автоматическая рассылка сообщений и напоминаний пользователям Системы в
       заданное время;
     – интеграция Системы с электронной почтой для обмена почтовыми сообщениями с
       пользователями, не зарегистрированными в Системе;
     – оперативное получение пользователями задач и поручений по ним, а также
       сигнализация о их получении с помощью клиентских приложений;
     – поиск задач и зарегистрированных по ним действий, документов и файлов,
       прикреплённых к описанию задач, действиям и документам, а также помещённых в
       библиотеку;
     – использование параметров доменной авторизации при входе пользователей в
       Систему.
Для использования вышеперечисленных возможностей необходима их дополнительная
настройка.


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




20
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
>> "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
>> "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
Для этого надо убедиться, что в файле 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
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
Например, указав в качестве имени сервера «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
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
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
В результате запуска следующей команды (команда должна быть записана в одну строку):
<путь_к_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
После этого рекомендуется снова проверить БД на наличие ошибок. Если ошибок не
обнаружено, то следует разрешить доступ к БД с помощью команды:
<путь_к_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
"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
© 2001-2012 Motiw are 
   8-800-555-43-21
 http://w w w .motiw .ru

Install guide windows

  • 1.
    Руководство администратора системы Установкаи обслуживани си е стемы МОТИВ (ОС WINDOWS) верси 1.7 я
  • 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
  • 32.
    © 2001-2012 Motiware  8-800-555-43-21 http://w w w .motiw .ru