install manual

42
СИСТЕМА ОПЕРАТИВНОГО УПРАВЛЕНИЯ КОМПАНИЕЙ РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ

Upload: guest0104ce

Post on 15-Jul-2015

880 views

Category:

Technology


6 download

TRANSCRIPT

Page 1: Install Manual

СИСТЕМА ОПЕРАТИВНОГО УПРАВЛЕНИЯКОМПАНИЕЙ

РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ

Page 2: Install Manual

2

Оглавление

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

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

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

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

III Особенности установки 8

IV Установка системы на ОС Windows 9

V Установка системы на дистрибутивы ОС Linux 14

VI Установка системы на дистрибутивы ОС FreeBSD 5 15

VII Дополнительные возможности системы МОТИВ и ихнастройка 16

............................................................................................ 161 Настройка почтовых уведомлений

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

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

............................................................................................ 174 Настройка работы программы «Информер»

............................................................................................................ 17Настройка передачи информации СМДС с сервера системы МОТИВ

............................................................................................................ 18 Настройка получения клиентским приложением информации от СМДС

............................................................................................................ 19Запуск сервиса мгновенной доставки сообщений

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

............................................................................................................ 20 Альтернативный запуск сервиса inf_daemon для операционных систем семейства Unix

............................................................................................................ 22 Запуск программы Информер под операционными системами семейства Unix

............................................................................................ 235 Настройка индексирования для поисковой системы

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

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

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

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

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

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

............................................................................................ 304 Раздел [InfDaemon]

............................................................................................ 305 Раздел [Modules]

............................................................................................ 316 Раздел [BackForm]

Page 3: Install Manual

Оглавление 3

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

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

IX Настройка размера файлов 33

X Вход в систему 34

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

XII Сопровождение установленной системы МОТИВ 37

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

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

............................................................................................ 393 Работа со скриптом сервисного обслуживания СУБД и БД

............................................................................................................ 41Восстановление и добавление администратора системы

Page 4: Install Manual

4

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

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

Комплект поставки системы МОТИВ включает:

– программное обеспечение, необходимое для работы системы МОТИВ;

– программа «Информер», предназначенное для оперативного получения информации осостоянии задач пользователей системы МОТИВ.

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

– СУБД Firebird 1.5.2;

– web-сервер Apache 2.0.59;

– PHP 5.2.3;

– Zend Optimizer 3.3.0;

– Сервер Tomcat;

– Java Development Kit 5.0.

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

Поставляемый дистрибутив включает:

– Motiw-3.8.1-Win32.zip – архив, содержащий файлы и программы для установкисистемы на ОС Windows;

– Motiw-3.8.1-Linux.tar.bz2 – архив, содержащий файлы и программы для установкисистемы на ОС Linux;

– Motiw-3.8.1-FreeBSD5.tar.bz2 – архив, содержащий файлы и программы дляустановки системы на ОС FreeBSD 5;

– Motiw-3.8.1-FreeBSD6.tar.bz2 – архив, содержащий файлы и программы дляустановки системы на ОС FreeBSD 6.

В разархивированном виде папка \Motiw-3.8.1- Win32 содержит следующие файлы:

– jdk-1_5_0_06-windows-i586-p.exe – программа установки приложения JavaDevelopment Kit;

– Motiw-3.8.1-Win32.exe – программа установки системы МОТИВ на ОС Windows;

– user_guied_admin.pdf – руководство по установке и обслуживанию системы МОТИВ вформате .pdf;

– и папку tools, в которой располагаются следующие архивы:

– dbservice – содержит скрипты сервисного обслуживания СУБД и БД. Подробнее оработе скрипта описано в пункте 12.3 данного руководства.

– MApiC – содержит утилиту вызовов API-интерфейса системы МОТИВ и примерыapi-функций. Подробное описание работы с утилитой описано в «Руководствепрограммиста».

Page 5: Install Manual

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

В разархивированном виде папка \Motiw-3.8.1-Linux содержит папку pool, в которойрасполагаются все необходимые для установки программы, файлы и библиотеки, файл сценарияInstall.Linux.sh для запуска установки системы на Linux, а также папку Documentation,которая содержит всю техническую документацию по системе МОТИВ.

В разархивированном виде папка \Motiw-3.8.1-FreeBSD5 содержит следующие файлы и папки:

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

– admin_recover – включает файлы, необходимые для восстановления утраченногопароля администратора системы МОТИВ.

– ports – содержит файлы, необходимые для взаимодействия системы МОТИВ с ОСFreeBSD.

– files – включает настроечные файлы системы МОТИВ, файл базы данных, а также архивports.tgz, который содержит основные правила установки ОС FreeBSD и настройкипортов;

– Documentation – содержит всю техническую документацию по системе МОТИВ;

– README.txt – текстовый файл, описывающий последовательность установки системыМОТИВ на ОС FreeBSD.

В разархивированном виде папка \Motiw-3.8.1-FreeBSD6 содержит те же файлы, что и\Motiw-3.8.1-FreeBSD5, для установки системы МОТИВ на ОС FreeBSD 6.

Файлы-сценарии для выгрузки данных в MS Excel и в MS Word расположены вдиректории plugins/exportXLS и plugins/exportRTF (см. «Руководство администраторасистемы»)

Page 6: Install Manual

6

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

Требования к аппаратному и программному обеспечению системы МОТИВ для серверной иклиентской части различны.

Минимальные программно-аппаратные требования, предъявляемые к конфигурации сервера приустановке системы на ОС Windows, следующие:

– процессор тактовой частотой от 1,5 ГГц;

– 1024 Mb оперативной памяти;

– 1 Gb свободного дискового пространства (рекомендуется SCSI);

– наличие сетевой карты;

– операционная система Windows XP/2003;

– рекомендуемый web-браузер Microsoft Internet Explorer 6.0;

– файловая система NTFS.

Важно! Не рекомендуются использование файловых систем FAT16 и FAT32, так как ониобладают ограничением по размеру файлов – 2 Гб максимум. Это может со временем негативносказаться на крупных инсталляциях системы МОТИВ (200–300 пользователей при активномиспользовании системы).

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

– процессор тактовой частотой от 1,5 ГГц;

– 1024 Mb оперативной памяти;

– 1 Gb свободного дискового пространства (рекомендуется SCSI);

– наличие сетевой карты;

– операционные системы Fedora Core 2, Suse 9.2, FreeBSD 5, 6;

– web-браузер;

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

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

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

– файловая система ReiserFS.

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

Замечание – Кроме указанных выше ОС, система МОТИВ может быть установлена также и надругие дистрибутивы Linux, но при этом могут возникать различные проблемы.

Page 7: Install Manual

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

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

– процессор тактовой частотой от 1,0 ГГц;

– 512 Mb оперативной памяти;

– VGA монитор с разрешением от 1024x768;

– наличие сетевой карты;

– операционная система Windows XP/Vista;

– рекомендуемые web-браузеры – Microsoft Internet Explorer 6.0 и выше, а такжеMozilla FireFox 1.5, 2.0;

– рекомендуемый пакет офисных приложений не ниже MS Office 2002.

Page 8: Install Manual

8

3 Особенности установки

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

Перед установкой системы на ОС Windows необходимо установить приложение JavaDevelopment Kit (JDK), которое располагается в архиве Motiw-3.8.1-Win32.zipjdk-1_5_0_06-windows-i586-p.exe

После установки JDK необходимо создать переменную окружения JAVA_HOME и PATH. Дляэтого необходимо открыть окно свойств системы (Мой компьютер/Свойства) и выбрать вкладку«Дополнительно». Затем необходимо воспользоваться кнопкой Переменные среды и вразделе Системные переменные нажать кнопку Создать. В окне создания переменнойнеобходимо в качестве имени переменной задать JAVA_HOME, а в качестве значенияпеременной указать полный путь к установленному приложению JDK. Например, C:\ProgramFiles\Java\jdk-1_5_0_06

Для переменной PATH в качестве параметра необходимо задать путь к виртуальной машине JavaDevelopment Kit. По умолчанию JDK устанавливается в каталог C:\ProgramFiles\Java\jdk-1_5_0_06\bin

После этого можно перейти к установке системы на ОС Windows. Приложение для инсталляциисистемы на ОС Windows Motiw-3.8.1-Win32.exe расположено в архивеMotiw-3.8.1-Win32.zip поставляемого дистрибутива.

Необходимые файлы для инсталляции системы на ОС Linux расположены в каталогеMotiw-3.8.1-Linux поставляемого дистрибутива.

Необходимые файлы для инсталляции системы на ОС FreeBSD 5 и FreeBSD 6 расположены вкаталоге Motiw-3.8.1-FreeBSD5 и Motiw-3.8.1-FreeBSD6 соответственно поставляемогодистрибутива.

Page 9: Install Manual

Установка системы на ОС Windows 9

4 Установка системы на ОС Windows

Установка системы на ОС Windows осуществляется запуском программы установкиMotiw-3.8.1-Win32.exe. При этом появится окно (рис.1), в котором необходимовыбрать язык установки системы.

Рис. 1. Окно выбора языка установки

Далее появится диалоговое окно (рис. 2), в котором необходимо ознакомиться синформацией по установке.

Рис. 2. Окно приветствия

Page 10: Install Manual

10

Затем необходимо нажать кнопку Далее. В открывшемся окне (рис. 3) с помощьюкнопки Обзор необходимо указать каталог, в который будет установлена система.

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

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

Page 11: Install Manual

Установка системы на ОС Windows 11

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

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

Page 12: Install Manual

12

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

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

Page 13: Install Manual

Установка системы на ОС Windows 13

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

Запуск установленной системы будет произведен автоматически при включении опции «Открыть Мотив в браузере».

Изменение настроек системы, таких как подключение к базе данных, почтовыенастройки, SMS и т.д., можно осуществить в файле config_motiw.ini, которыйрасполагается в директории \Motiw\scripts\include\. Подробное описаниепараметров файла описано в разделе 8 данного руководства.

Page 14: Install Manual

14

5 Установка системы на дистрибутивы ОС Linux

Для установки системы необходимо запустить сценарий Install.Linux.sh, который располагаетсяв папке /Motiw-3.8.1-Linux дистрибутива.

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

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

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

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

P.S. All needed software will be install in /usr/local

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

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

export LANG="ru_RU.UTF-8"

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

Page 15: Install Manual

Установка системы на дистрибутивы ОС FreeBSD 5 15

6 Установка системы на дистрибутивы ОС FreeBSD 5

В комплект поставки системы МОТИВ входит базовый минимум необходимых системе пакетов(для FreeBSD 5, FreeBSD 6). Однако в ходе установки системы может возникнуть необходимостьналичия специфичного пакета для вашей системы портов. Необходимый пакет можно скачать изсети Интернет.

Перед запуском сценария необходимо распаковать во временную директорию файлMotiw-3.8.1-FreeBSD5.tar.gz.

Для этого необходимо выполнить следующую команду:

mkdir /usr/tmp

tar -xzf Motiw-3.8.1-FreBSD5.tar.gz -C /usr/tmp

Далее необходимо запустить сценарий сборки порта устанавливаемой системы, выполнивследующие команды:

cd /usr/tmp/Motiw-3.8.1-FreeBSD5/

make install clean

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

– при появлении диалога установки PHP необходимо выбрать Use apache 2.x instead ofapache 1.3.x

– при появлении диалога установки PHP dom-xml выставить Include DOM (E)XSLTsupport

– при появлении диалога установки boost выбрать THREADS.

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

/usr/local/firebird/bin/gsec -modifay <имя> -pw <пароль>

После создания нового пользователя необходимо прописать заданные имя и пароль вконфигурационном файле /usr/local/www/data/motiw/include/config_motiw.ini (поляdblogin и dbpassword соответственно) и в файле /usr/local/jakarta-tomcat5.0/settings.xml(поля user и password соответственно).

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

– деинсталировать пакет, выполнив команду:

make clean && make deinstall && make distclean

– распаковать предлагаемые вместе с дистрибутивом системы МОТИВ системные порты:

tar -xzf ./files/ports.tar.gz -C /usr

– повторить процесс установки.

При возникновении проблем с сервером tomcat его необходимо перезапустить, выполнивкоманду:

cd /usr/local/jakarta-tomcat5.0/bin && ./shutdown.sh && ./startup.sh

Установка системы МОТИВ на дистрибутивы FreeBSD 6 осуществляется аналогичным образом.

Page 16: Install Manual

16

7 Дополнительные возможности системы МОТИВ и ихнастройка

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

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

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

– оперативное получение пользователями задач и сигнализация новых действий спомощью программы «Информер»;

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

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

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

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

7.1 Настройка почтовых уведомлений

Настройка параметров для почтовых уведомлений осуществляется в разделе Mailконфигурационного файла системы МОТИВ config_motiw.ini. Для использованияавтоматической рассылки почтовых уведомлений в параметрах необходимо указать адресSMTP-сервера в разделе SMTP, а также присвоить параметру MailSendMethod значение 1.

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

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

В каталоге services корневой директории системы МОТИВ расположен файлsendmailreminds.php.

Для рассылки автоматических напоминаний по задачам достаточно периодически исполнятьданный файл через интерпретатор php.exe, располагающийся в директории C:\ProgramFiles\Motiw\software\PHP\cli. Сценарий запускается с двумя параметрами:

1. Корневой каталог, в котором расположены PHP-сценарии системы МОТИВ (например, приустановке системы на ОС Windows – C:\Program Files\Motiw\scripts);

2. Имя сервера (hostname) (например, motiw).

Примечание – Путь к файлу php.exe необходимо прописывать в кавычках.

Page 17: Install Manual

Дополнительные возможности системы МОТИВ и их настройка 17

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

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

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

В каталоге services корневой директории системы МОТИВ расположен файлsend_mail_sms_from_queue.php.

Для отправки оповещений по задачам из очереди достаточно периодически исполнять данныйскрипт через интерпретатор php.exe, располагающийся в директории C:\ProgramFiles\Motiw\software\PHP\cli. Сценарий запускается с двумя параметрами:

1. Корневой каталог, в котором расположены PHP-сценарии системы МОТИВ (например, приустановке системы на ОС Windows – C:\Program Files\Motiw\scripts);

2. Имя сервера (hostname) (например, motiw).

Примечание – Путь к файлу php.exe необходимо прописывать в кавычках.

7.4 Настройка работы программы «Информер»

В комплекте поставки системы МОТИВ для пользователей операционных систем класса Windowsпоставляется дополнительное программа «Информер».

«Информер» гарантирует оперативное получение задач, отслеживает поступившие сотрудникупоручения и сигнализирует о пополнении списка задач. Руководство по использованиюпрограммы «Информер» можно просмотреть, выбрав пункт меню «Информер» раздела МОТИВглавного меню web-интерфейса системы МОТИВ.

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

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

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

7.4.1 Настройка передачи информации СМДС с сервера системы МОТИВ

СМДС может быть запущен на том же сервере, что и система МОТИВ, либо на выделенномсервере. Для начала работы необходимо запустить выполняемый модуль inf_daemon(exe):

Page 18: Install Manual

18

C:\Motiw\inf_daemon port=<port_number> [-d | -l | -i | u]

/var/motiw/ inf_daemon port=<port_number> [-d | -l | -i | u]

Параметры:

port – обязательный параметр, значение <port_number> определяет номер порта, предназначенного для установки соединений, как с сервером системы «Мотив», так и склиентскими программами.

-d – запуск сервиса в фоновом режиме (только *nix–версия).

-l – вывод детального журнала работы сервиса в поток stdout.

-i – установка программы как Windows-сервиса (только для Windows-версии).

-u – удаление программы из списка Windows-сервисов (только для Windows-версии)

Подробнее о параметрах СМДС, задаваемых в конфигурационном файле config_motiw.ini,описано в разделе 8.4 данного руководства.

7.4.2 Настройка получения клиентским приложением информации от СМДС

Для получения клиентом информации от СМДС необходимо выполнить следующие шаги:

– создать TCP-соединение с сервисом;

– зарегистрироваться;

Регистрация выполняется путём передачи по установленному соединению строки следующегоформата:

from=client;clientname=<имя клиента>;clientversion=<версия клиента>;userid=<IDпользователя>; username=<имя пользователя>'; server=<имясервера>';protocolversion=<версия клиентского протокола>;

После этого необходимо получить ответный пакет от СМДС. При успешной регистрации этотпакет имеет следующий вид:

userid=<ID пользователя>

Примечания

1. Для корректной работы <имя сервера> должно совпадать с именем сервера, указанным внастройках системы «Мотив».

2. <версия клиентского протокола> в настоящее время равна 2.

– периодически посылать по установленному соединению пакет СМДС для поддержкисоединения;

Для этого необходимо послать по установленному соединению строку следующего формата:

from=echo;info=<произвольный текст>

– периодически опрашивать соединение для получения информации от СМДС.

Данные, полученные из соединения, могут быть двух видов:

1) ответ на пакет проверки соединения:

from=echo;info=<произвольный текст>

Page 19: Install Manual

Дополнительные возможности системы МОТИВ и их настройка 19

2) пакет с данными, имеющий следующий вид:

from=server;code=<код события>;subid=<ID объекта>;userid=<ID пользователя>;server=<Имя сервера>;info=<произвольная информация>

Возможные значения параметров <код события> и <ID объекта> представлены в таблице 1.

Таблица 1

<кодсобытия

>

описание <ID объекта>

1 Новое действие ID действия

2 Изменение состояния задачи ID задачи

3 Исключение пользователя из задачи ID задачи

4 Новое сообщение\оповещение\напоминание Не используется

7 Сброс признаков «Новая задач» и «Новоедействие»

Примечание – Параметр info в данной версии не используется.

7.4.3 Запуск сервиса мгновенной доставки сообщений

Для запуска сервиса мгновенной доставки сообщений inf_daemon на ОС Linux необходимоналичие следующих библиотек:

§ для пакета библиотек libstdc++:

– libstdc++.so.5

§ для пакета библиотек glibc:

–  libc.so.6 ;

–  libpthread.so.0;

–  libm.so.6;

–  ld-linux.so.2 ();

§ для пакета библиотек libgcc:

– libgcc_s.so.1.

При наличии в системе более свежих библиотек libstdc++ (например, 6-й версии) необходимоустановить библиотеки совместимости compat-libstdc++.

При необходимости есть возможность получения inf_daemon, скомпилированного ссоответствующей версией системных библиотек libstdc++. Для этого можно обратиться кразработчикам системы.

Page 20: Install Manual

20

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

Настройка параметров осуществляется при установке системы на дистрибутивы ОС Linux. Приустановке системы на ОС Windows запуск сервера Apache и сервиса мгновенной доставкисообщений inf_daemon осуществляются автоматически.

После перезагрузки сервера необходимо обеспечить автозапуск сервера Apache и сервисамгновенной доставки сообщений inf_daemon.

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

/usr/local/apache2/bin/apachectl start

/usr/local/inf_daemon port=4000 –d

export JAVA_HOME=<путь к JDK>

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

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

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

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

При работе системы МОТИВ на ОС FreeBSD автозапуск серверов обеспечивается автоматическизапускаемым сценарием tomcat.sh, который располагается в директории /usr/local/etc/rc.d

Примечание – В параметрах запуска сервиса мгновенной доставки сообщений принеобходимости можно указать другой порт (inf_daemon port=*). В этом случае при запускепрограммы «Информер» в соответствующем разделе необходимо прописывать используемыйпорт.

7.4.5 Альтернативный запуск сервиса inf_daemon для операционных систем семействаUnix

По умолчанию сервис inf_daemon запускается из скриптов инициализации системы (init.d, rc.d)как правило, это файлы /etc/rc.d/rc.local, /etc/rc.local, /etc/rc.d/boot.local,/etc/conf.d/local.start и т.д. в зависимости от операционной системы.

Строка запуска в этом файле выглядит следующим образом:

<путь к сервису>/inf_daemon port=4000 -d

Для профилактического перезапуска сервиса в таком случае следует использовать команды егоостанова и последующего запуска:

killall inf_daemon

< путь к сервису >/inf_daemon port=4000 -d

Однако такой способ не всегда бывает приемлемым, например, при использовании утилиты cron.

Альтернативным способом запуска и перезапуска inf_daemon может служить, например,

Page 21: Install Manual

Дополнительные возможности системы МОТИВ и их настройка 21

использование схемы процесса init inittab.

Page 22: Install Manual

22

Для этого из скрипта инициализации системы следует удалить строку запуска сервисаinf_daemon и добавить её в файл /etc/inittab. Строка в /etc/inittab при этом будет выглядетьследующим образом:

de::respawn:sh -c "sleep 5 && cd /var/log/inf && exec /usr/local/inf_daemon port=4000"

где /var/log/inf – предварительно созданная директория для логов сервиса inf_daemon;

/usr/local – путь к размещению исполняемого файла inf_daemon.

Внимание! Параметр -d для inf_daemon в этом случае указывать не следует, иначе init небудет известно о завершении процесса inf_daemon и init будет запускать бесконечное числопроцессов сервиса inf_daemon.

После добавления строки в файл /etc/inittab следует выполнить команду init q, чтобы процессinit перечитал файл настроек /etc/inittab.

В результате inf_daemon будет запущен от родительского процесса init, который будет следитьза его работой и в случае падения запускать заново. За это отвечает опция respawn.

Профилактический перезапуск inf_daemon также можно производить всего одной командой:killall inf_daemon (к примеру, раз в сутки из утилиты cron).

Внимание! Необходимо контролировать, чтобы одновременно не был запущен еще одинпроцесс inf_daemon с теми же параметрами. В этом случае inf_daemon не сможет открыть тотже порт и прекратит свою работу. Признаком этого будет появление большого количества пустыхфайлов в директории логов сервиса inf_daemon и наличие более 2-х процессов inf_daemon содинаковыми параметрами (по ps ax | grep inf_daemon). При возникновении такой ситуацииследует завершить процессы по команде:

killall inf_daemon

затем найти и удалить скрипт, из которого запускается лишняя копия inf_daemon.

7.4.6 Запуск программы Информер под операционными системами семейства Unix

Запуск программы Информер может быть осуществлён под операционной системой семействаUnix при выполнении следующих необходимых условий:

– Установлена одна из последних версий эмулятора Windows API: wine (скачать еёможно по адресу http://www.winehq.org/).

– Установлен пакет поддержки Internet Explorer в эмуляторе wine ies4linux (желательно споддержкой Internet Explorer, начиная с версии 6.0). Скачать пакет поддержки можно поадресу http://www.tatanka.com.br/).

– В системе установлена библиотека GdiPlus.dll из пакета Windows Service Pack,скопированная в директорию %windir%/system32/ эмулятора wine.

(пример: /home/user/.ies4linux/ie6/drive_c/windows/system32/)

– В настройках эмулятора указать Windows XP или Windows 2000 для приложенияSCInformer.exe.

Скрип запуска программы Информер может иметь следующий вид:

#! /bin/bash

export WINEPREFIX="/home/user/.ies4linux/ie6"

Page 23: Install Manual

Дополнительные возможности системы МОТИВ и их настройка 23

wine ~/.ies4linux/ie6/drive_c/informer/SCInformer.exe

7.5 Настройка индексирования для поисковой системы

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

Если система МОТИВ установлена на ОС Windows, например, на ОС Windows XP, то настройкаавтоматического индексирования производится следующим образом.

На «Панели управления» необходимо выбрать параметр «Назначенные задания». Впоявившемся окне с помощью мастера необходимо добавить задания для индексирования иоптимизации индексов системы. Для этого в окне выбора программы необходимо с помощьюкнопки Обзор выбрать приложения indexing.bat и optimize.bat, которые располагаются вдиректории \Tomcat\apps. Для каждого задания необходимо задать периодичность запускаприложения. Для приложения indexing.bat рекомендуется задать запуск от одного донескольких раз в сутки. Запуск приложения optimize.bat рекомендуется производить в ночныечасы, когда система не перегружена.

Если система МОТИВ установлена на дистрибутивы ОС Linux и FreeBSD, то настройкаавтоматического индексирования производится следующим образом.

Запуск сценариев индексирования и оптимизации необходимо прописать в утилите cron.Сценарий для индексирования indexing.sh должен запускаться с периодичностью 10–30 минут (взависимости от активности пользователей) в течение рабочего дня. Сценарий для оптимизацииoptimize.sh должен запускаться в нерабочее время (ночью) и может при высокой активностипользователей выполняться на протяжении часа.

В файлах indexing.bat и optimize.bat прописываются параметры запуска индексирования иоптимизации индексов. При необходимости можно внести изменения в эти параметры.

Формат запуска команд следующий:

java -jar -Xms256m -Xmx512m indexing.jar -s C:\Sever\Tomcat\settings.xml -h localhost -a,

где – Xms <Начальный объем кучи JVM, m|Gb|b>

- Xmx <Максимальный объем кучи JVM, m|Gb|b>

-s – путь к файлу настроек settings.xml

-h – имя хоста

-a – объект индексирования. При установке ключа –a индексируются все объекты.

Индексировать можно следующие объекты:

indexTaskActions [-ta] – задачи и действия по задачам;

indexTaskFiles [-tf] – файлы, прикрепленные к задачам и действиям;

indexDocumentFiles [-df] – файлы документов;

indexDocuments [-d] – документы;

indexDocumentLibrary [-dl] – файлы библиотека документов.

Page 24: Install Manual

24

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

Для использования возможности интеграции с электронной почтой необходимо загрузить такжефайл лицензии motiw381e.lic. Для этого следует поместить файл лицензии в папкуMotiw\scripts\license.

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

Если система МОТИВ установлена на ОС Windows, то планирование осуществляется следующимобразом.

1. Создать файл формата .bat следующего содержания:

"C:\Program Files\Motiw\software\PHP\cli\php.exe" "C:\Program Files\Motiw\scripts\services\ imap_fetcher.php" "C:\ProgramFiles\Motiw\scripts" motiw >> c:\imap.fetcher.log

Если установленная система имеет имя отличное от motiw, то в bat-файле следует указать этоимя.

2. Запланировать выполнение bat-файла.

На «Панели управления» следует выбрать параметр «Назначенные задания». Впоявившемся окне с помощью мастера необходимо добавить задания для проверки почтовыхящиков. Для этого в окне выбора программы необходимо с помощью кнопки Обзор выбратьbat-файл. Для задания необходимо задать периодичность запуска bat-файл. Рекомендуетсязапускать bat-файл с интервалом не менее чем 10–15 минут во избежание ситуации содновременным запуском нескольких процессов проверки почтовых ящиков.

Если система МОТИВ установлена на ОС Linux, то запуск процесса проверки необходимопрописать в утилите cron. Для этого следует прописать следующее:

sudo -u apache php /var/httpd/Motiw/services/imap_fetcher.php /var/httpd/Motiw motiw >>/var/tmp/motiw.imap_fetcher.log

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

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

/var/httpd/Motiw motiw – файлу imap_fetcher.php в качестве параметра передается/var/httpd/Motiw;

motiw – доменное имя сервера (DNS);

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

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

Для использования доменной авторизации пользователями системы необходимо осуществить еёнастройку. Настройка доменной авторизации для операционных систем Windows и Linuxразлична.

Настройка для системы, установленной на ОС Windows.

1. Следует прописать загрузку модуля mod_auth_sspi.

Page 25: Install Manual

Дополнительные возможности системы МОТИВ и их настройка 25

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

LoadModule sspi_auth_module modules/mod_auth_sspi.so

в файле httpd.conf раскомментирована.

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

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

domain_auth_enable = 1;

;для Windows:

domain_auth_type = "mod_auth_sspi";

Причем строка для Linux должна быть закомментирована

;для Linux:

;domain_auth_type = "mod_ntlm2";

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

SSPIDomain DOMAINNAME

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

Настройка для системы, установленной на ОС Linux.

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

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

LoadModule ntlm_module modules/mod_ntlm2.so

в файле httpd.conf раскомментирована.

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

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

domain_auth_enable = 1;

;для Linux:

domain_auth_type = "mod_ntlm2";

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

;для Windows:

;domain_auth_type = "mod_auth_sspi";

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

NTLMDomain DOMAINNAME

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

NTLMDomain DOMAIN_SERVER

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

4. Параметр DOMAIN_SERVER должен быть соотнесен с ip-адресом в файле hosts.

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

Page 26: Install Manual

26

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

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

– [DBConnect];

– [Mail];

– [SMS];

– [InfDaemon];

– [Modules];

– [BackForm];

– [NTLMAuth];

– [Other].

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

8.1 Раздел [DBConnect]

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

Ключ dbpath

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

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

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

Пример:

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

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

Ключ dbname

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

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

Ключ dblogin

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

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

Ключ dbpassword

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

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

Page 27: Install Manual

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

8.2 Раздел [Mail]

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

Ключ FromAddress

Значение ключа – email автоинформатора системы Мотив. Этот адрес будет указываться в полеFROM (от кого) в письмах, отправляемых автоинформатором пользователям системы.

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

Ключ FromName

Значение ключа – имя автоинформатора системы Мотив в письмах, посылаемых пользователямсистемы.

Пример:

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

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

Ключ MailSendMethod

Переключатель метода отправки почты. Для ОС Windows значение этого ключа должно быть 1,для Unix-систем 0.

Пример:

MailSendMethod=1

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

Ключ SMTP

Значением должно быть имя сервера, используемого в качестве почтового. Настройка действуеттолько для ОС Windows.

Пример:

SMTP="smtp.mail.ru"

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

Ключ sendmail_from

Содержит email адрес, указываемый в поле SENDER (отправитель) в письмах, отправляемыхавтоинформатором пользователям системы.

Настройка действует только для ОС Windows и связана с ключом SMTP. В зависимости отнастроек SMTP-сервер может не отправлять почту, если sendmail_from не принадлежит ему.

Пример:

sendmail_from ="[email protected]"

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

Ключ sendmail_path

Содержит путь к программе с параметрами отправки почты sendmail. Настройка действует для ОСUnix/Linux.

Page 28: Install Manual

28

Пример:

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

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

Ключ MailDisable

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

Пример:

MailDisable=0

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

8.3 Раздел [SMS]

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

Ключ SmsDisable

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

Пример:

SmsDisable =1

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

Ключ SmsHttpMethodLogin

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

Пример:

SmsHttpMethodLogin="user"

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

Ключ SmsHttpMethodPassword

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

Пример:

SmsHttpMethodPassword ="passw"

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

Ключ SmsOriginator

Содержит название отправителя сообщения, которое будет отображаться на телефонеполучателя.

Пример:

SmsOriginator="Motiw"

Page 29: Install Manual

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

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

Ключ SmsOperatorHttpSendURL

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

Пример:

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

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

Ключ SmsIsHttpMethodPost

Переключатель метода отправки сообщений. При установке значения 0 используется метод GET,значения 1 – метод POST.

Пример:

SmsIsHttpMethodPost=0

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

Ключ SmsIsInRrussian

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

Пример:

SmsIsInRrussian=1

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

Ключ SmsIsLogSms

Управляет возможностью ведения журнала отправленных SMS-сообщений.

Пример:

SmsIsLogSms=0

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

Ключ SmsLogPath

Содержит путь к журналу SMS-сообщений.

Пример:

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

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

Ключ SmsMaxParts

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

Пример:

SmsMaxParts=2

Page 30: Install Manual

30

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

Ключ SmsProxyHost

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

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

Ключ SmsProxyLogin

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

Ключ SmsProxyPass

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

Ключ SmsProxyType

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

Пример:

SmsProxyType="http"

8.4 Раздел [InfDaemon]

Содержит настройки доступа к серверу доставки мгновенных сообщений системы Мотив. Сервермгновенных сообщений системы Мотив предназначен для ускорения доставки действий позадачам в программе «Информер».

Ключ DaemonAddress

Содержит имя сервера мгновенных сообщений системы Мотив.

Пример:

DaemonAddress="yourhost"

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

Ключ DaemonPort

Содержит номер порта, на котором работает сервер мгновенных сообщений системы Мотив.

Пример:

DaemonPort=4000

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

8.5 Раздел [Modules]

Содержит список подключаемых расширений основного меню системы Мотив.

Page 31: Install Manual

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

8.6 Раздел [BackForm]

Содержит настройки пункта меню системы Мотив «Пожелания и замечания».

Ключ EnableBackForm

Управляет видимостью пункта меню системы Мотив «Пожелания и замечания».

Возможные значения: 1 – пункт видимый, 0 – пункт невидимый.

Пример:

EnableBackForm=1

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

Ключ BackFormSupportAdress

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

Пример:

BackFormSupportAdress ="admin@yourhost,[email protected]"

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

Ключ BackFormSupportName

Значение ключа – имя службы поддержки системы Мотив в письмах, посылаемых на адрес(а)BackFormSupportAdress.

Пример:

BackFormSupportName="Техническая поддержка системы Мотив"

8.7 Раздел [NTLMAuth]

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

Ключ domain_auth_enable

Управляет видимостью опции «Доменная авторизация» в пункте меню «Мои реквизиты»системы Мотив.

Возможные значения 1 – опция видимая, 0 – опция невидимая.

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

Ключ domain_auth_type

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

Формат ключа для ОС Linux:

domain_auth_type = "mod_ntlm2"

Формат ключа для ОС Windows:

domain_auth_type = "mod_auth_sspi"

Page 32: Install Manual

32

8.8 Раздел [Other]

Содержит другие настройки системы

Ключ LoginLanguage

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

RU – русский язык

EN – английский язык

DE – немецкий язык

Пример.

LoginLanguage="RU"

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

Ключ TaskValuation

Управляет возможностью выставления оценок при завершении задач.

Возможные значения: 1 – оценка выставляется; 0 – оценка не выставляется.

Пример:

TaskValuation=1

Ключ IsLocalNet

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

Возможные значения: 1– скачивать с сервера системы Мотив, 0 – скачивать из Internet.

Пример:

IsLocalNet=0

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

Ключ tomcat_port

Содержит номер порта, по которому работает сервер tomcat.

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

Page 33: Install Manual

Настройка размера файлов 33

9 Настройка размера файлов

Настройка максимального размера файла для прикрепления к задачам, действиям идокументам осуществляется в файле php.ini, расположенном в директории\Motiw\software\PHP.В подразделе File Uploads для параметра upload_max_filesize следует прописать нужныйразмер. По умолчанию установлено значение 2 Мб. ; Maximum allowed size for uploaded files.upload_max_filesize = 2M

Page 34: Install Manual

34

10Вход в систему

После установки системы в главном меню программ появится ярлык «Motiw», включающийссылки на программу «Информер», систему МОТИВ, а также сопроводительную документацию.

Для входа в установленную систему МОТИВ c локального компьютера необходимо щёлкнуть поярлыку МОТИВ или в окне браузера (рекомендуется использовать MS Internet Explorer версии нениже 6.0) ввести в строку адреса: http://localhost. При этом откроется окно авторизации (рис. 7),в котором необходимо ввести имя admin и пароль admin – реквизиты администратора системыпо умолчанию, и нажать кнопку Вход. При этом откроется окно загрузки файла лицензии.

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

Для входа в систему необходимо ввести реквизиты администратора системы по умолчанию.

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

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

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

Для использования pda-версии МОТИВ необходимо привести в соответствие параметровServerName или ServerAlias, указываемых в файле httpd.conf, и символьного имени сервера,указываемое в файле hosts.

Например, указав в качестве имени сервера pda в файле hosts, который располагается вдиректории C:\WINDOWS\system32\drivers\etc\, необходимо соответственно указать pda ив качестве одного из параметров – ServerName или ServerAlias. Эти параметрыпрописываются в файле httpd.conf, который располагается в директории C:\ProgramFiles\Motiw\software\apache2\conf.

Page 35: Install Manual

Вход в систему 35

Затем для входа в систему МОТИВ с pda необходимо в строке браузера ввести http://pda. Впоявившемся окне авторизации в качестве имени указать admin, а в качестве пароля admin.

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

Для доступа в систему МОТИВ с пользовательских компьютеров необходимо прописать в DNSip-адрес сервера и символьное имя сервера. Причем символьное имя сервера должносоответствовать имени, указанному в параметрах ServerName или ServerAlias файлаhttpd.conf.

Для входа в систему МОТИВ с пользовательского компьютера необходимо ввести в строке адресабраузера

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

Для доступа к pda-версии МОТИВ с пользовательских компьютеров необходимо аналогичнымобразом осуществить настройку параметров, описанных выше.

Page 36: Install Manual

36

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

Для изменения символьного имени сервера необходимо внести изменения в файл httpd.conf,который располагается в директории C:\Program Files\Motiw\software\Apache2\conf – приустановке системы на ОС Windows, /usr/local/apache2/conf – при установке на дистрибутивыОС Linux, /usr/local/apache2/conf – при установке на дистрибутивы ОС FreeBSD.

NameVirtualHost *:80

<VirtualHost *:80>

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

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

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

</VirtualHost>

<VirtualHost *:80>

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

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

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

</VirtualHost>

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

Затем необходимо внести соответствующие изменения в файл hosts, который располагается вдиректории C:\WINDOWS\system32\drivers\etc\ при установке системы на ОС Windows или/etc при установке на дистрибутивы ОС Linux или ОС FreeBSD, а также прописать символьноеимя сервера в DNS.

Для входа в систему МОТИВ после изменения символьного имени сервера необходимо в окнебраузера ввести

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

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

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

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

В обоих случаях для авторизации необходимо указать имя пользователя admin и пароль admin.

Page 37: Install Manual

Сопровождение установленной системы МОТИВ 37

12Сопровождение установленной системы МОТИВ

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

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

1.Периодически выполнять проверку и резервное копирование файла базы данных. Данный файлимеет расширение *.gdb или *.fdb в зависимости от версии системы. При установке системы наОС Windows – в директории c:\Program Files\Motiw\db. При установке системы МОТИВ надистрибутивы Linux данный файл обычно находится в директории /var/Motiw/db. Приустановке системы МОТИВ на дистрибутивы FreeBSD данный файл обычно находится вдиректории /var/db/Motiw

2.Периодически выполнять резервное копирование директории с PHP-сценариями системы, вкоторой, в том числе, содержатся различные информационные файлы (прикрепляемые к задачами документам, хранящиеся в библиотеке документов и др.). PHP-сценарии располагаются вподдиректории scripts. При установке системы на ОС Windows – в директорииc:\Program Files\Motiw. При установке системы на ОС Linux эта поддиректория обычнорасполагается в директории /var/Motiw. При установке системы МОТИВ на дистрибутивыFreeBSD данный файл обычно находится в директории /usr/local/www/motiw.

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

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

Резервное копирование базы данных выполняется при помощи утилиты gbak, входящей впоставку SQL-сервера Firebird. Данная утилита располагается в директории:

<путь_к_Firebird>/bin

Резервное копирование базы данных выполняется при помощи утилиты gbak, входящейв поставку SQL-сервера Firebird. Данная утилита располагается в директории:<путь_к_Firebird>/binПри вызове утилиты gbak следует указать параметры подключения к базе данных: имя(user) и пароль администратора базы данных (pass). Значения по умолчанию – имяадминистратора – SYSDBA, а пароль – masterkey.В результате запуска следующей команды (команда должна быть записана в однустроку):<путь_к_Firebird>/bin/gbak –b –t –v –user SYSDBA –pass masterkey"localhost:<путь_к_файлу_БД>" save_motiw.gbkрезервная копия базы данных будет сохранена в файл save_motiw.gbk. В случаеуспешного завершения резервного копирования будет выдано сообщение:gbak: closing file, committing, and finishing. xxxxxxx bytes writtenРезервное копирование базы данных с помощью утилиты gbak не требует остановкисервера Firebird.

Page 38: Install Manual

38

Создание резервной копии базы данных необходимо планировать с необходимойчастотой. При работе системы на ОС Windows планирование осуществляется спомощью пункта меню «Панель управления/Назначенные задания». При работесистемы на ОС Linux необходимо использовать утилиту cron.Если на сервере произошел сбой, в результате которого база данных оказаласьповрежденной (понять это можно, например, по наличию большого числа ошибок вида«Query error: …», получаемых при попытке войти в систему или осуществитькакие-либо действия в ней), то необходимо выполнить следующее.1. Запретить подключение к БД другим пользователям, кроме SYSDBA, с помощьюутилиты gfix, расположенной там же, где и gbak:<путь_к_Firebird>/bin/gfix -shut -force 0 –user * –pass **<путь_к_файлу_БД> Где (здесь и далее):* – имя администратора БД;** – пароль администратора БД.2. Выполнить проверку БД с помощью команды:<путь_к_Firebird>/bin/gfix -v -full –user * –pass ** <путь_к_файлу_БД>Данная команда должна вывести информацию о наличии ошибок в БД. Если их нет, изапуск команды не привел к изменениям на экране, то в файле БД ошибок нет. В этомслучае необходимо еще раз проверить причину возникновения ошибок – возможно, оназаключается в неправильных или изменившихся настройках системы или в другихизменениях.В случае ошибок в файле БД gfix должен вывести сообщение следующего вида:number of index page errors xxxnumber of database page errors xxxОшибки в файле БД необходимо исправить командой:<путь_к_Firebird>/bin/gfix -mend -full -ignore –user * –pass **<путь_к_файлу_БД>После этого рекомендуется снова проверить БД на наличие ошибок. Если ошибок необнаружено, то необходимо разрешить доступ к БД с помощью команды<путь_к_Firebird>/bin/gfix -online –user * –pass ** <путь_к_файлу_БД> и проверить функционирование системы.Если после проверки и/или исправления ошибок с помощью утилиты gfix вернуть БД врабочее состояние не удалось, то необходимо взять последнюю резервную копию ивосстановить из нее базу данных (эту команду нужно набирать в одну строку):<путь_к_Firebird>/bin/gbak –r –c -v –user * –pass ** <путь_к_резервной_копии> <путь_к_файлу_БД>В случае удачного восстановления будет выдано сообщение:

gbak: finishing, closing, and going home

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

Page 39: Install Manual

Сопровождение установленной системы МОТИВ 39

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

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

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

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

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

12.3Работа со скриптом сервисного обслуживания СУБД и БД

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

Скрипт dbservice состоит из двух частей: web – dwebservice.sh и db – ddbservice.sh. Такоеразделение необходимо для работы сервисного скрипта на распределённых серверах, в которыхweb (apache, tomcat, inf_daemon) и СУБД (firebird) части физически разнесены на разныесервера.

Сервер, на котором располагаются и web, и СУБД-части, является частным случаемраспределённого сервера. Поэтому работа данного сервисного скрипта можно осуществлять и натаком сервере.

Перед запуском сервисного скрипта обслуживания следует выполнить ряд процедур.

1. Скопировать скрипты на соответствующие сервера:

dwebservice.sh – на web-сервер;

ddbservice.sh – на СУБД-сервер.

Если обе части находятся на одном сервере, то скопировать оба скрипта на этот сервер.

2. Настроить скрипты.

Для этого следует открыть скрипт в текстовом редакторе и прописать параметры в секцииCONFIG.

Описание параметров dwebservice.sh:

PAGE_ORIG – путь к оригинальному файлу httpd.conf сервера Аpache, который настроен наработу системы Мотив.

PAGE_DUMMY – путь к файлу httpd.conf.dummy сервера Аpache, настроенного на показстраницы-заставки. Данная страница будет отображаться во время проведенияпрофилактических работ у всех пользователей системы.

Замечание – Страница-заставка должна быть создана заранее и содержать текст,информирующий о проведении работ по обслуживанию. Следует настроить сервер Аpache на

Page 40: Install Manual

40

показ этой страницы в файле httpd.conf.dummy.

APACHE_D – путь к файлу управления сервером apache (обычно apachectl).

CRON_D – путь к файлу управления утилиты cron.

TOMCAT – путь к директории, в которую установлен Tomcat.

INF_DAEMON – путь к исполняемому файлу inf_daemon.

INF_LOG_DIR – путь к директории, в которой будут писаться логи работы inf_daemon.

JAVA_HOME – путь к директории, в которую установлен JDK

Описание параметров ddbservice.sh:

DB_FILE – путь к файлу базы данных;

SYSDBA – имя администратора СУБД;

MASTERKEY – пароль администратора СУБД;

CRON_D – путь к файлу управления утилиты cron;

FB_DIR – путь к директории, в которую установлена СУБД Firebird. В этой директориисоздаются lock-файлы isc* (семафоры), которые сервисный скрипт должен очищать.

ISQL – путь к исполняемому файлу isql. Автоматически берётся из директории, указанной впараметре FB_DIR. Если файл isql находится в другом месте, то следует указатьсоответствующий путь.

GBAK – путь к исполняемому файлу gbak. Автоматически берётся из директории, указанной впараметре FB_DIR. Если файл gbak находится в другом месте, то следует указатьсоответствующий путь.

GFIX – путь к исполняемому файлу gfix. Автоматически берётся из директории, указанной впараметре FB_DIR. Если файл gfix находится в другом месте, то следует указатьсоответствующий путь.

DWEBSERVICE – путь к скрипту dwebservice.sh.

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

DWEBSERVICE="ssh root@web-server /var/tmp/dwebservice.sh"

Для случая, когда web и СУБД части находятся на одном сервере, это может быть локальныйпуть:

DWEBSERVICE="/var/tmp/dwebservice.sh"

Важно! Убедитесь в правильности указанного пути к скрипту dwebservice.sh.

3. Проверить работу скриптов. Для этого следует запустить их на соответствующих серверах спараметром test. Пример:

./dwebservice.sh test

./ddbservice.sh test

В случае успешной настройки будет выведено сообщение "Test Ok." В случае некорректнойнастройки – "Please correct CONFIG section."

4. После успешного прохождения тестов можно запускать сервисный скрипт обслуживания. Это

Page 41: Install Manual

Сопровождение установленной системы МОТИВ 41

скрипт ddbservice.sh (на СУБД сервере). Скрипт dwebservice.sh (на web-сервере) запускать ненужно, так как он вызывается автоматически скриптом ddbservice.sh.

5. Скрипт ddbservice.sh сначала проверяет все настройки на корректность и затем запускаетсясам процесс сервисного обслуживания базы данных и СУБД. В процессе своей работы он трижды(1 – проверка, 2 – перевод в сервисный режим, 3 – возврат к нормальной работе) будет вызыватьскрипт dwebservice.sh из переменной DWEBSERVICE. Поэтому если СУБД и web частифизически разнесены и в переменной DWEBSERVICE путь к скрипту указан через ssh, торекомендуется настроить авторизацию по ключу без пароля для ssh между web и СУБДсерверами. Это позволит при каждом обращении к скрипту dwebservice.sh не вводить пароль кweb-серверу вручную.

Во время выполнения скрипт будет сообщать о ходе работы на стандартное устройство вывода.По окончании работы будет выведено сообщение "All Done.".

После выполнения скрипт создает log-файлы. Имя log-файла указывается в переменной LOGсекции CONFIG в каждом скрипте. По умолчанию это файлы ddbservice.log иddbservice.web.log для СУБД и web серверов соответственно.

По log-файлам можно отследить корректность работы скрипта сервисного обслуживания. Вовремя работы скрипт автоматически создает файл базы данных с расширением .bak. Если привыполнении скрипта зафиксированы ошибки, то следует заменить файл базы данных насозданный во время выполнения скрипта.

12.3.1 Восстановление и добавление администратора системы

В случаях удаления администратора системы, создаваемого по умолчанию, предусмотренавозможность его восстановления. Для этого необходимо осуществить запуск скриптаadminrecover.php, который располагается в каталоге Motiw\admin_recover. Для этогонеобходимо предварительно скопировать этот файл в корень папки scripts и обратиться к этомускрипту через браузер, например, http://localhost/adminrecover.php. При этом откроется окноприглашения восстановления администратора системы.

Для добавления нового администратора системы необходимо запустить скрипт createadm.php,который располагается в каталоге Motiw\admin_recover. Для этого необходимопредварительно скопировать этот файл в корень папки scripts и обратиться к этому скриптучерез браузер, например, http://localhost/createadmin.php. При этом откроется окно, в которомбудет предложено ввести имя пользователя и пароль.

Page 42: Install Manual

Единый бесплатный телефон:8-800-555-43-21

Главный офис:(495) 233-76-76 (многоканальный)119072, Россия, г. Москва,Загородное шоссе, д.1, бизнес центр «Сибинтек»

Техническая поддержка:(495) 540-18-40(4722) [email protected]

[email protected]