2. Оглавление
1 Комплект поставки 3
1 Комплект поставки Cистемы
............................................................................................................................................... 3
2 Состав дистрибутива
............................................................................................................................................... 3
2 Требования к аппаратному и программному обеспечению 4
3 Установка Системы 5
4 Настройка параметров Системы 8
1 Раздел [DBConnect]
............................................................................................................................................... 8
2 Раздел [Mail]
............................................................................................................................................... 9
3 Раздел [SMS]
............................................................................................................................................... 10
4 Раздел [ActiveMQ]
............................................................................................................................................... 13
5 Раздел [Other]
............................................................................................................................................... 15
5 Дополнительные возможности Системы и их настройка 19
1 Настройка работы клиентских приложений
............................................................................................................................................... 19
2 Настройка почтовых и SMS-оповещений
............................................................................................................................................... 19
3 Настройка автоматической рассылки оповещений по задачам
............................................................................................................................................... 20
4 Настройка отправки оповещений по задачам, помещённых в очередь
............................................................................................................................................... 20
5 Настройка интеграции с электронной почтой
............................................................................................................................................... 21
6 Настройка размера прикрепляемых файлов
............................................................................................................................................... 22
6 Вход в Систему 23
7 Редактирование имён виртуальных хостов 25
8 Сопровождение установленной Системы 26
1 Резервное копирование базы данных
............................................................................................................................................... 26
2 Работа с ............................................................................................................................................... 27
базой данных
3 Резервное копирование PHP-сценариев
............................................................................................................................................... 28
4 Настройка поисковой системы
............................................................................................................................................... 28
2
3. 1 Комплект поставки
1.1 Комплект поставки Cистемы
Комплект поставки системы МОТИВ (далее – Системы) включает:
– программное обеспечение, необходимое для работы Системы;
– клиентские приложения, предназначенные для оперативного получения информации
о состоянии задач пользователей Системы.
Программное обеспечение, необходимое для работы Системы, включает в себя:
– СУБД Firebird 2.1;
– веб-сервер Apache 2.2;
– PHP 5.3;
– ionCube;
– cервер Apache Tomcat 6.0;
– Memcached 1.4.
1.2 Состав дистрибутива
Поставляемый дистрибутив включает архив Motiw4U-1.7.pkg.bz2, содержащий
установочный пакет Motiw4U-1.7.pkg для запуска установки Cистемы на ОС Mac OS X 10.5
(Leopard).
Комплект поставки 3
4. 2 Требования к аппаратному и программному
обеспечению
Минимальные программно-аппаратные требования, предъявляемые к конфигурации
сервера, следующие:
– процессор с тактовой частотой от 1,5 ГГц;
– 1024 Mb оперативной памяти;
– 1 Gb свободного дискового пространства;
– наличие сетевой карты;
– операционная система Mac OS X 10.5 (Leopard) ;
– архитектура i386.
4
5. 3 Установка Системы
Если в системе уже установлена и работает одна из программ: СУБД Firebird, веб-сервер
Apache или другой веб-сервер, PHP, ionCube, Apache Tomcat – то перед запуском установки
Системы их следует удалить, иначе успешная установка Системы не может быть
гарантирована.
Для нормальной работы почтовых уведомлений перед установкой Системы следует
настроить Mail Transfer Agent (postfix) с отключённой авторизацией для localhost.
Установка Системы на ОС Mac OS X осуществляется запуском установочного пакета
Motiw4U-1.7.pkg, который расположен в архиве Motiw4U-1.7.pkg.bz2 поставляемого
дистрибутива. При этом откроется окно приветствия (рис. 1).
Рис. 1. Окно приветствия
После нажатия кнопки Продолжить откроется окно настройки установки (рис. 2), в котором
следует ознакомиться с информацией по установке.
Установка Системы 5
6. Рис. 2. Окно настройки установки
Далее следует нажать кнопку Установить. В открывшемся окне (рис. 3) следует ввести имя
и пароль администратора компьютера и нажать кнопку OK.
Рис. 3. Окно идентификации пользователя
После этого начнётся процесс установки. При этом произойдёт копирование всех
необходимых для работы Cистемы файлов. По завершении копирования Система будет
полностью установлена и на экране появится окно завершения установки (рис. 4). По
завершении установки веб-сервер Apache будет автоматически запущен.
6
7. Рис. 4. Окно завершения установки
После установки Системы для обращения к ней по имени следует определить в httpd.conf
секцию Virtual host, директиву Server name и добавить запись <ip> <servername> в
файле hosts (для сервера и клиентов).
Изменение настроек Cистемы, таких, как подключение к базе данных, почтовые настройки,
SMS и т.д., можно осуществить в файле config_motiw.ini, который располагается в
директории /usr/local/motiw/scripts/include/. Подробное описание параметров файла см. в
разделе 4 данного руководства.
Установка Системы 7
8. 4 Настройка параметров Системы
Настройка параметров Системы осуществляется в файле config_motiw.ini, который состоит
из следующих разделов:
– [DBConnect];
– [Mail];
– [SMS];
– [ActiveMQ];
– [Other].
Каждый раздел содержит набор ключей, для каждого из которых следует задать
соответствующее значение. Если значение ключа отлично от числового, то оно
записывается в кавычках.
Предупреждение – Названия ключей чувствительны к регистру.
4.1 Раздел [DBConnect]
Содержит ключи, необходимые для подключения к базе данных.
Ключ dbpath
Значение: полный путь к базе данных.
Путь к базе данных рекомендуется прописывать с использованием интерфейса обратной
петли (loopback interface). Ниже приведён пример с использованием петли localhost.
Путь к базе данных записывается в формате Unix, то есть с использованием прямого (/), а
не обратного () слеша.
Пример:
dbpath="localhost:/usr/local/motiw/db/motiw.fdb"
Формат ключа: хост:путь
Ключ dbname
Значение: имя файла базы данных.
Если ключ dbpath не содержит имени файла базы данных, то его можно указать в ключе
dbname.
Пример:
dbname="motiw.fdb"
Формат ключа: имя_файла_базы_данных
8
9. Ключ dblogin
Значение: имя пользователя СУБД для подключения к базе данных.
Пример:
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
Настройка параметров Системы 9
10. Ключ SMTP
Значение: имя сервера, используемого в качестве почтового.
Пример:
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
4.3 Раздел [SMS]
Содержит ключи, необходимые для настройки отправки SMS.
Ключ SmsDisable
Значение: управляет возможностью блокирования отправки SMS.
Возможные значения: 0 – разрешает отправку SMS; 1 – блокирует отправку SMS.
10
11. Пример:
SmsDisable =1
Формат ключа: 0 или 1
Ключ SmsHttpMethodLogin
Значение: имя пользователя, полученное при регистрации в службе оказания услуг по
доставке SMS.
Пример:
SmsHttpMethodLogin="user"
Формат ключа: user_name
Ключ SmsHttpMethodPassword
Значение: пароль пользователя, полученный при регистрации в службе оказания услуг по
доставке SMS.
Пример:
SmsHttpMethodPassword ="passw"
Формат ключа: user_password
Ключ SmsOriginator
Значение: название отправителя SMS.
Пример:
SmsOriginator="Motiw"
Формат ключа: только латинские буквы либо цифры.
Ключ SmsOperatorHttpSendURL
Значение: адрес веб-скрипта, управляющего отправкой SMS получателям.
Пример:
SmsOperatorHttpSendURL="smsmail.ru/corp/multi.php"
Формат ключа: имя_URL
Ключ SmsIsHttpMethodPost
Значение: переключатель метода отправки сообщений.
Возможные значения: 0 – метод GET; 1 – метод POST.
Настройка параметров Системы 11
12. Пример:
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
Формат ключа: числовое_значение
Ключ SmsProxyHost
Значение: хост и порт прокси-сервера для выхода в Интернет. Если этот ключ явно не
указан, то он не используется.
12
13. Пример:
SmsProxyHost="localhost:3128"
Формат ключа: host:port
Ключ SmsProxyLogin
Значение: логин пользователя для прокси-сервера. Если этот ключ явно не указан, то он не
используется.
Пример:
SmsProxyLogin="login"
Формат ключа: имя_пользователя
Ключ SmsProxyPass
Значение: пароль пользователя для прокси-сервера. Если этот ключ явно не указан, то он
не используется.
Пример:
SmsProxyPass="pass"
Формат ключа: пароль_пользователя
Ключ SmsProxyType
Значение: тип прокси-сервера по умолчанию (http, socks4 или socks5). Если этот ключ явно
не указан, то он не используется.
Пример:
SmsProxyType="http"
Формат ключа:тип_прокси-сервера
4.4 Раздел [ActiveMQ]
Внимание! Если СМДС не используется, параметры данного раздела настраивать не
следует.
Содержит настройки доступа к серверу с установленным СМДС Системы. СМДС Системы
предназначен для ускорения получения новых задач и действий по текущим задачам
пользователя в клиентских приложениях.
Ключ AQAddress
Значение: имя или IP-адрес сервера с установленным СМДС Системы.
Настройка параметров Системы 13
14. Пример:
AQAddress="host"
Формат ключа: hostname
Ключ AQPort
Значение: номер порта, на котором работает СМДС Системы.
Пример:
AQPort=4000
Формат ключа: номер_порта
Ключ AQClientPort
Значение: порт ActiveMQ для клиентских приложений.
Пример:
AQClientPort=4000
Формат ключа: номер_порта
Ключ AQQueue
Значение: имя очереди сообщений.
Пример:
AQQueue="localhost"
Формат ключа: hostname
Ключ AQExpireTime
Значение: время (в сек.), в течение которого сообщение будет храниться в очереди. По
умолчанию сообщение хранится 120 сек.
Пример:
AQExpireTime=600
Формат ключа: числовое_значение
Ключ AQUseAjax
Значение: позволяет автоматически получать обновления по задачам в веб-интерфейсе.
Возможные значения: 1 – автоматическое обновление; 0 – обновление вручную. Значение
по умолчанию – 1.
Пример:
AQUseAjax=1
Формат ключа: 0 или 1
14
15. Ключ AQAjaxRequestTime
Значение: период опроса (в сек.) установленного ActiveMQ.
Пример:
AQAjaxRequestTime=300
Формат ключа: числовое_значение
4.5 Раздел [Other]
Содержит дополнительные настройки Системы.
Ключ LoginLanguage
Значение: переключатель языка окна авторизации. Язык выбирается из списка языков
Системы.
Возможные значения: RU – русский язык; EN – английский язык; DE – немецкий язык.
Пример:
LoginLanguage="RU"
Формат ключа: RU или EN или DE
Ключ reject_task_start_date_in_future
Значение: управляет возможностью создания задач с датой начала, большей, чем текущая.
Возможные значения: 0 – дата начала может быть больше текущей; 1 – дата начала не
может быть больше текущей (если выбрана дата больше, то после сохранения задачи в
качестве даты начала автоматически устанавливается текущая дата).
Пример:
reject_task_start_date_in_future=1
Формат ключа: 0 или 1
Ключ reject_task_start_date_in_past
Значение: управляет возможностью создания задач с датой начала, меньшей, чем текущая.
Возможные значения: 0 – дата начала не может быть меньше текущей (если выбрана дата
меньше, то после сохранения задачи в качестве даты начала автоматически
устанавливается текущая дата); 1 – дата начала может быть меньше текущей.
Пример:
reject_task_start_date_in_past=1
Формат ключа: 0 или 1
Настройка параметров Системы 15
16. Ключ Taskvaluation
Значение: управляет возможностью выставления оценок при завершении задач.
Возможные значения: 0 – оценка не выставляется; 1 – оценка выставляется.
Пример:
Taskvaluation=1
Формат ключа: 0 или 1
Ключ IsLocalNet
Значение: переключатель способа загрузки приложений, необходимых для Системы в
некоторых отчётах (Capicom, VM).
Возможные значения: 0 – скачивать из Интернета; 1 – скачивать с сервера Системы.
Пример:
IsLocalNet=0
Формат ключа: 0 или 1
Ключ tomcat_port
Значение: номер порта, по которому работает сервер Apache Tomcat.
Значение по умолчанию 8080.
Пример:
tomcat_port=8080
Формат ключа: номер_порта
Ключ IsFileSignature
Значение: управляет возможностью подписывать с помощью электронной цифровой
подписи (ЭЦП) файлы, прикрепляемые к описанию задач, к карточкам документов и
действиям по задачам. Файлы, прикреплённые к описанию задачи, можно подписать только
в момент создания задачи. Файлы, прикреплённые к действию по задаче или карточке
документа, можно подписать только до сохранения их на сервере Системы.
Возможные значения: 0 – не подписывать прикреплённые файлы с помощью ЭЦП; 1 –
подписывать прикреплённые файлы с помощью ЭЦП.
Пример:
isFileSignature=1
Формат ключа: 0 или 1
16
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
Настройка параметров Системы 17
18. Ключ isnotshowsystemactions
Значение: управляет установкой по умолчанию флажка Не уведомлять об изменении
рабочей группы.
Возможные значения: 0 – флажок по умолчанию не установлен; в задаче отображается
системное действие об удалении участника; 1 – флажок по умолчанию установлен;
системное действие в задаче не отображается.
Пример:
isnotshowsystemactions=1
Формат ключа: 0 или 1
Ключ allow_respperson_edit_task
Значение: управляет возможностью редактировать поля задачи пользователем в роли
ответственного руководителя.
Возможные значения: 0 – возможность редактирования полей отключена. Ответственный
руководитель может только добавлять контролёров, исполнителей и внешних
пользователей, а также редактировать ИРГ и тип задачи; 1 – возможность редактирования
полей включена.
Пример:
allow_respperson_edit_task=1
Формат ключа: 0 или 1
18
19. 5 Дополнительные возможности Системы и их
настройка
К дополнительным возможностям Системы можно отнести следующие:
– автоматическая рассылка почтовых и SMS-оповещений пользователям о событиях в
задачах, в которых они участвуют;
– автоматическая рассылка сообщений и напоминаний пользователям Системы в
заданное время;
– интеграция Системы с электронной почтой для обмена почтовыми сообщениями с
пользователями, не зарегистрированными в Системе;
– оперативное получение пользователями задач и поручений по ним, а также
сигнализация об их получении с помощью клиентских приложений;
– поиск задач и зарегистрированных по ним действий, документов и файлов,
прикреплённых к описанию задач, действиям и документам, а также помещённых в
библиотеку.
Для использования вышеперечисленных возможностей необходима их дополнительная
настройка.
5.1 Настройка работы клиентских приложений
В комплект поставки Системы дополнительно входят клиентские приложения: программа
«Информер» (для пользователей ОС Windows 2000 и выше) и программа XConductor (для
пользователей ОС Mac OS X 10.5.1 и выше). Данные приложения предназначены для
оперативного получения новых задач и действий по текущим задачам пользователя, а
также для сигнализации об их получении.
Руководства по работе с клиентскими приложениями доступны в пункте «Руководства»
раздела Д ополнительно главного меню веб-интерфейса Системы.
Для обеспечения мгновенной доставки пользователям приложения новых действий по
задачам, оповещений об изменении состава исполнителей в рабочих группах задач и т.д.
используется сервер с установленным сервисом мгновенной доставки сообщений (СМДС)
ActiveMQ.
При запуске приложения обращаются к серверу с установленным СМДС по указанному в
настройках порту (номер порта не регламентирован – задаётся при запуске СМДС, но
обычно 4000).
5.2 Настройка почтовых и SMS-оповещений
Настройка параметров для почтовых оповещений осуществляется в разделе [Mail], а SMS-
оповещений – в разделе [SMS] конфигурационного файла Системы config_motiw.ini. Для
использования автоматической рассылки почтовых оповещений в параметрах раздела [Mail]
Дополнительные возмож ности Системы и их настройка 19
20. следует указать адрес SMTP-сервера, а также задать значение ключей MailSendMethod=0
и MailDisable=0. Для использования автоматической рассылки SMS-оповещений в
параметрах раздела [SMS] следует указать имя и пароль пользователя, полученные при
регистрации в службе оказания услуг по доставке SMS, адрес веб-скрипта, управляющего
отправкой SMS получателям, а также задать значение ключа SmsDisable=0.
Подробное описание параметров файла config_motiw.ini см. в разделе 4 данного
руководства.
5.3 Настройка автоматической рассылки оповещений по задачам
Автоматическая рассылка почтовых и SMS-оповещений по задачам осуществляется с
помощью файла sendmailreminds.php, который располагается в каталоге services
корневой директории Системы. Для этого следует периодически исполнять данный файл
через интерпретатор php, располагающийся в директории /usr/local/bin/php. Сценарий
запускается с двумя параметрами:
1. Корневой каталог, в котором расположены PHP-сценарии Системы.
2. Имя сервера (hostname).
Пример запуска процесса автоматической рассылки оповещений по задачам в утилите cron
приведён ниже.
sudo -u www /usr/local/bin/php /usr/local/motiw/scripts/services/sendmailreminds.php /
usr/local/motiw/scripts motiw >> /var/log/motiw.sendmailreminds.log
где: sudo -u www – запуск выполняется от имени пользователя www;
/usr/local/bin/php /usr/local/motiw/scripts/services/sendmailreminds.php – запускается
PHP, которому в качестве параметра передаётся файл sendmailreminds.php;
/usr/local/motiw/scripts/services/sendmailreminds.php – файл sendmailreminds.php,
которому в качестве параметра передаётся путь /usr/local/motiw/scripts;
motiw – доменное имя сервера МОТИВ (DNS);
>> /var/log/motiw.sendmailreminds.log – результат вышеперечисленных операций
перенаправляется в лог-файл motiw.sendmailreminds.log.
5.4 Настройка отправки оповещений по задачам, помещённых в очередь
Предусмотрена возможность использования отложенной отправки почтовых и SMS-
оповещений по задачам. При этом следует задать определённый промежуток времени,
через который оповещения будут отправлены пользователям. Оповещения отправлены не
будут, если в течение этого времени пользователем были просмотрены действия и
оповещения по задачам в веб-интерфейсе, PDA-интерфейсе или в клиентских приложениях.
Задание соответствующих настроек осуществляется администратором системы в пункте
меню «Настройки оповещений» раздела Администрирование.
20
21. Отправка оповещений по задачам, помещённых в очередь, осуществляется с помощью
файла send_mail_sms_from_queue.php, который располагается в каталоге services
корневой директории Системы. Для этого следует периодически исполнять данный файл
через интерпретатор php, располагающийся в директории /usr/local/bin/php. Сценарий
запускается с двумя параметрами:
1. Корневой каталог, в котором расположены PHP-сценарии Системы.
2. Имя сервера (hostname).
Пример запуска процесса отправки оповещений по задачам, помещённых в очередь, в
утилите cron приведён ниже.
sudo -u www /usr/local/bin/php /usr/local/motiw/scripts/services/
send_mail_sms_from_queue.php /usr/local/motiw/scripts motiw >> /var/log/motiw.
send_mail_sms_from_queue.log
где: sudo -u www – запуск выполняется от имени пользователя www;
/usr/local/bin/php /usr/local/motiw/scripts/services/send_mail_sms_from_queue.php –
запускается PHP, которому в качестве параметра передаётся файл
send_mail_sms_from_queue.php;
/usr/local/motiw/scripts/services/send_mail_sms_from_queue.php – файл
send_mail_sms_from_queue.php, которому в качестве параметра передаётся путь /usr/
local/motiw/scripts;
motiw – доменное имя сервера МОТИВ (DNS);
>> /var/log/motiw.send_mail_sms_from_queue.log – результат вышеперечисленных
операций перенаправляется в лог-файл motiw.send_mail_sms_from_queue.log.
5.5 Настройка интеграции с электронной почтой
Файл лицензии motiw4u_17.lic помещается в Систему через пункт меню «Настройки
системы» в разделе Администрирование.
Интеграция с электронной почтой подразумевает под собой настройку опроса почтовых
ящиков пользователей на наличие новых писем. Для использования этой возможности
следует поместить в Систему файл лицензии motiw4u_17.lic через пункт меню «Настройки
системы» в разделе Администрирование.
Опрос почтовых ящиков осуществляется с помощью файла imap_fetcher.php, который
располагается в каталоге services корневой директории Системы. Для этого следует
периодически исполнять данный файл через интерпретатор php, располагающийся в
директории /usr/local/bin/php. Сценарий запускается с двумя параметрами:
1. Корневой каталог, в котором расположены PHP-сценарии Системы.
2. Имя сервера (hostname).
Пример запуска процесса проверки почтовых ящиков пользователей в утилите cron
приведён ниже.
Дополнительные возмож ности Системы и их настройка 21
22. sudo -u www /usr/local/bin/php /usr/local/motiw/scripts/services/imap_fetcher.php /usr/
local/motiw/scripts motiw >> /var/log/motiw.imap_fetcher.log
где: sudo -u www – запуск выполняется от имени пользователя www;
/usr/local/bin/php /usr/local/motiw/scripts/services/imap_fetcher.php – запускается PHP,
которому в качестве параметра передаётся файл imap_fetcher.php;
/usr/local/motiw/scripts/services/imap_fetcher.php – файл imap_fetcher.php, которому в
качестве параметра передаётся путь /usr/local/motiw/scripts;
motiw – доменное имя сервера МОТИВ (DNS);
>>/var/log/motiw.imap_fetcher.log – результат вышеперечисленных операций
перенаправляется в лог-файл motiw.imap_fetcher.log.
5.6 Настройка размера прикрепляемых файлов
Настройка максимального размера файла для прикрепления к задачам, действиям и
документам осуществляется в файле php.ini, расположенном в директории /usr/local/etc.
В подразделе File Uploads для параметра upload_max_filesize следует прописать
максимальный размер. По умолчанию установлено значение 2 Мб.
; Maximum allowed size for uploaded files.
upload_max_filesize = 2M
В связи с тем, что к добавляемому файлу также прикрепляется служебная информация, для
параметра post_max_size следует указать большее значение, чем для параметра
upload_max_filesize, а для параметра memory_limit большее значение, чем для
post_max_size. В противном случае файл не будет закачан на сервер.
; Maximum size of POST data that PHP will accept
post_max_size = 3M
; Maximum amount of memory a script may consume
memory_limit = 4M
22
23. 6 Вход в Систему
Для входа в установленную Систему c локального компьютера следует в окне браузера
(рекомендуется использовать Mozilla FireFox версии не ниже 1.5) ввести в строку адреса:
http://localhost. В открывшемся окне авторизации (рис. 5) в качестве имени и пароля следует
указать «admin» – реквизиты администратора системы по умолчанию, и нажать кнопку
Вход. При этом откроется окно загрузки файла лицензии.
Файл лицензии не входит в комплект поставки дистрибутива Системы, а предоставляется
менеджером по работе с клиентами. Нажав кнопку Обзор на форме загрузки, следует
указать путь к каталогу, в котором хранится файл лицензии motiw4u_17.lic. При успешной
загрузке файла лицензии откроется окно авторизации пользователя в Системе, в котором
для входа в Систему следует повторно ввести реквизиты администратора системы по
умолчанию.
Рис. 5. Окно входа в установленную Систему
Справочное руководство для пользователей Системы можно просмотреть в меню Системы
Д ополнительно –> «Руководства» –> «Руководство пользователя системы Мотив».
Руководство для администратора системы admin_system_guide.pdf, включающее описание
исходной настройки Системы, располагается в каталоге /usr/local/motiw/scripts/FAQ.
Для использования PDA-версии Системы следует привести в соответствие параметры
ServerName или ServerAlias, указываемые в файле httpd.conf, и символьное имя сервера,
указываемое в файле hosts.
Например, указав в качестве имени сервера «pda» в файле hosts, который располагается в
директории /etc/hosts, следует, соответственно, указать «pda» и в качестве одного из
параметров – ServerName или ServerAlias. Эти параметры прописываются в файле httpd.
conf, который располагается в директории /usr/local/apache2/conf.
Вход в Систему 23
24. Затем для входа в PDA-версию Системы следует в строке браузера ввести:
<адрес_сервера_системы>/pda. В появившемся окне авторизации в качестве имени и
пароля пользователя следует указать «admin».
Замечание – Вход в PDA-интерфейс Системы для пользователей, которые работали до
перехода на текущую версию в системе МОТИВ версии 3.8.1 и ниже, может также
осуществляться по адресу: pda.<адрес_сервера_Системы>.
Справочное руководство для PDA-версии Системы можно просмотреть в меню Системы
Д ополнительно –> «Руководства» –> «Руководство для PDA-версии».
Для доступа в Систему с пользовательских компьютеров следует прописать в DNS IP-адрес
и символьное имя сервера. Причём символьное имя сервера должно соответствовать имени,
указанному в параметрах ServerName или ServerAlias файла httpd.conf.
Для входа в Систему с пользовательского компьютера следует ввести в строке адреса
браузера:
http://<символьное_имя_сервера>
Для доступа к PDA-версии Системы с пользовательских компьютеров следует аналогичным
образом осуществить настройку параметров, описанных выше, или добавить запись в DNS.
24
25. 7 Редактирование имён виртуальных хостов
Для изменения символьного имени сервера следует внести изменения в файл httpd.conf,
который располагается в директории /usr/local/apache2/conf/extra/httpd-vhost.conf.
NameVirtualHost *:80
<VirtualHost *:80>
DocumentRoot <путь_к_каталогу_scripts>
ServerName <motiw.имя_сервера>
ServerAlias <псевдоним_сервера>
</VirtualHost>
<VirtualHost *:80>
DocumentRoot <путь_к_директории_scripts/pda.motiw>
ServerName <pda.имя_сервера>
ServerAlias <псевдоним_сервера>
</VirtualHost>
Задание нового символьного имени для виртуального сервера осуществляется в строке
ServerName или ServerAlias. После внесения изменений следует перезапустить сервер
Apache.
Затем следует внести соответствующие изменения в файл hosts, который располагается в
директории /etc, а также прописать символьное имя сервера в DNS.
Для входа в Систему после изменения символьного имени сервера следует в адресной
строке окна браузера ввести:
для веб-версии Системы:
http://motiw.<новое_имя_сервера>
для PDA-версии Системы:
http://<адрес_сервера_системы>/pda
или http://pda.<новое_имя_сервера>
Замечание – Второй способ для PDA-версии Системы указан для пользователей, которые
работали до перехода на текущую версию в системе МОТИВ версии 3.8.1 и ниже.
Для входа как в веб-, так и в PDA-интерфейс в окне авторизации следует в качестве имени и
пароля пользователя указать «admin».
Редактирование имён виртуальных хостов 25
26. 8 Сопровождение установленной Системы
Процесс обеспечения сохранности данных, хранящихся в Системе, включает в себя ряд
простых, но необходимых действий. Эти действия выполняются, как правило, системным
администратором, имеющим доступ к серверу, на котором установлена Система.
Для сопровождения Системы следует:
1. Периодически выполнять проверку и резервное копирование файла базы данных. Данный
файл имеет расширение *.fdb, который обычно располагается в директории /usr/local/
motiw/db.
2. Периодически выполнять резервное копирование директории с PHP-сценариями Системы,
в которой в том числе содержатся различные информационные файлы (прикрепляемые к
задачам и документам, хранящиеся в библиотеке и др.). PHP-сценарии располагаются в
поддиректории /usr/local/motiw/scripts.
3. Периодически выполнять чистку семафоров СУБД и перезапуск служб. Для упрощения
этих процедур имеется скрипт автоматизированного обслуживания базы данных и СУБД.
4. При обновлении системы МОТИВ, которая установлена по пути, отличному от
стандартного, следует внимательно проверить изменённые параметры в файле
motiw_patcher.ini.
В функции системного администратора входит также и перенос Системы с одного сервера на
другой. Для этого следует:
1. Установить систему МОТИВ на новом сервере.
Важно! Версия Системы, устанавливаемая на новом сервере, должна совпадать с версией
Системы на сервере, с которого осуществляется перенос.
2. Сделать резервную копию базы данных на «старом» сервере.
3. Скопировать папку scripts на «старом» сервере.
4. Восстановить на новом сервере данные из созданной резервной копии и заменить папку
scripts.
8.1 Резервное копирование базы данных
Резервное копирование базы данных выполняется при помощи утилиты gbak, входящей в
поставку SQL-сервера Firebird. Данная утилита располагается в директории
<путь_к_Firebird>/bin.
При вызове утилиты gbak следует указать параметры подключения к базе данных: имя
(user) и пароль администратора базы данных (pass). Значения по умолчанию – имя
администратора – SYSDBA, пароль – masterkey.
В результате запуска следующей команды (команда должна быть записана в одну строку):
<путь_к_Firebird>/bin/gbak -b -t -v -user SYSDBA -pass masterkey "localhost:
<путь_к_файлу_БД>" save_motiw.fbk
26
27. резервная копия базы данных будет сохранена в файл save_motiw.fbk. В случае успешного
завершения резервного копирования будет выдано сообщение:
gbak: closing file, committing, and finishing. xxxxxxx bytes written
Резервное копирование базы данных с помощью утилиты gbak не требует остановки
сервера Firebird.
Создание резервной копии базы данных следует планировать с необходимой частотой.
Планирование осуществляется с помощью утилиты cron.
Если на сервере произошёл сбой, в результате которого база данных оказалась
повреждённой, то следует обратиться в службу технической поддержки по адресу
support@motiw.ru.
8.2 Работа с базой данных
Для корректной работы БД рекомендуется не реже чем раз в 3 месяца производить
проверку БД с помощью системной утилиты gfix, расположенной в директории
<путь_к_Firebird>/bin. А также проверку БД следует производить при появлении большого
числа ошибок вида «Query error:…», получаемых при попытке войти в Систему или
осуществить какие-либо действия в ней. Для проверки БД следует выполнить следующее.
1. Запретить подключение к БД другим пользователям, кроме администратора БД (SYSDBA),
с помощью команды:
<путь_к_Firebird>/bin/gfix -shut -force 0 -user SYSDBA -pass masterkey
<путь_к_файлу_БД>
2. Выполнить проверку БД с помощью команды:
<путь_к_Firebird>/bin/gfix -v -full -user SYSDBA -pass masterkey <путь_к_файлу_БД>
Данная команда должна вывести информацию о наличии ошибок в БД. Если их нет и запуск
команды не привёл к изменениям на экране, то в файле БД ошибок нет. В этом случае
следует ещё раз проверить причину возникновения ошибок – возможно, она заключается в
неправильных или изменившихся настройках Системы или в других изменениях.
В случае наличия ошибок в файле БД gfix должен вывести сообщение следующего вида:
number of index page errors xxx
number of database page errors xxx
Ошибки в файле БД следует исправить командой:
<путь_к_Firebird>/bin/gfix -mend -full -ignore -user SYSDBA -pass masterkey
<путь_к_файлу_БД>
После этого рекомендуется снова проверить БД на наличие ошибок. Если ошибок не
обнаружено, то следует разрешить доступ к БД с помощью команды:
<путь_к_Firebird>/bin/gfix -online -user SYSDBA -pass masterkey <путь_к_файлу_БД>
и проверить функционирование Системы.
Сопровож дение установленной Системы 27
28. Если после проверки и/или исправления ошибок с помощью утилиты gfix вернуть БД в
рабочее состояние не удалось, то следует взять последнюю резервную копию и
восстановить из неё базу данных (команда должна быть записана в одну строку):
<путь_к_Firebird>/bin/gbak -REP -c -v -user SYSDBA -pass masterkey
<путь_к_резервной_копии> <путь_к_файлу_БД>
В случае удачного восстановления будет выдано сообщение:
gbak: finishing, closing, and going home
В процессе продолжительной работы Системы рекомендуется осуществлять восстановление
получаемых резервных копий. Если процесс восстановления заканчивается ошибкой (такое
иногда может случаться), то следует попытаться исправить продуктивную базу данных с
помощью утилиты gfix, как это было описано выше. Если ошибку исправить не удаётся, то
следует обратиться в службу технической поддержки по адресу support@motiw.ru.
8.3 Резервное копирование PHP-сценариев
Кроме PHP-сценариев и прочих файлов, обеспечивающих функционирование Системы, в
директории scripts содержится важная информация в виде прикрепляемых к задачам,
действиям и документам файлов, а также, например, файлов с фотографиями
пользователей, логотипом компании и некоторых других
Всю эту информацию следует периодически сохранять на резервные носители.
Создание резервной копии директории scripts следует планировать с необходимой частотой.
Выполняя резервное копирование, следует учитывать, что этот процесс может занимать
длительное время (в зависимости от объёма и количества файлов в директории scripts),
замедляя при этом работу самой Системы. В таких случаях резервное копирование
рекомендуется выполнять в то время, когда наблюдается низкая активность пользователей
Системы (например, в ночные часы).
8.4 Настройка поисковой системы
Настройка поисковой системы приведена в «Руководстве администратора системы».
При разведении Системы на два сервера в файле 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="пароль БД"
28