гл вление
I омплект пост вки 4
1 омплект пост вки системы
............................................................................................ 4
2 ост в дистрибутив
............................................................................................ 4
II ребов ния к пп р тному и прогр ммному
обеспечению 6
III собенности уст новки 8
IV ст новк системы н Windows 9
V ст новк системы н дистрибутивы Linux 14
VI ст новк системы н дистрибутивы FreeBSD 5 15
VII ополнительные возможности системы и их
н стройк 16
1 стройк почтовых уведомлений
............................................................................................ 16
2 стройк втом............................................................................................
тической р ссылки н помин ний по з д ч м 16
3 стройк отпр вки оповещений по з д ч м, помещенных в
очередь ............................................................................................ 17
4 стройк р боты прогр ммы « нформер»
............................................................................................ 17
стройк перед чи информ ции
............................................................................................................ 17
с сервер системы
стройк получения клиентским приложением информ ции от
............................................................................................................ 18
пуск сервис мгновенной дост вки сообщений
............................................................................................................ 19
стройк п р метров, обеспечив ющих р боту системы после перез грузки сервер
............................................................................................................ 20
льтерн тивный з пуск сервис inf_daemon для опер ционных систем семейств 20
............................................................................................................ Unix
пуск прогр ммы нформер под опер ционными систем ми семейств Unix
............................................................................................................ 22
5 стройк индексиров ния для поисковой системы
............................................................................................ 23
6 стройк интегр ции с электронной почтой
............................................................................................ 24
7 стройк доменной вториз ции
............................................................................................ 24
VIII стройк п р метров системы 26
1 здел [DBConnect]
............................................................................................ 26
2 здел [Mail] ............................................................................................ 27
3 здел [SMS] ............................................................................................ 28
4 здел [InfDaemon]
............................................................................................ 30
5 здел [Modules]............................................................................................ 30
6 здел [BackForm]
............................................................................................ 31
2
7 здел [NTLMAuth]
............................................................................................ 31
8 здел [Other] ............................................................................................ 32
IX стройк р змер ф йлов 33
X ход в систему 34
XI ед ктиров ние имён вирту льных хостов 36
XII опровождение уст новленной системы 37
1 езервное копиров ние б зы д нных
............................................................................................ 37
2 езервное копиров ние PHP-сцен риев
............................................................................................ 39
3 бот со скриптом сервисного обслужив ния
............................................................................................
и 39
осст новление и доб ............................................................................................................ 41
вление дминистр тор системы
гл вление 3
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 – прогр мм уст новки приложения Java
Development Kit;
– Motiw-3.8.1-Win32.exe – прогр мм уст новки системы н Windows;
– user_guied_admin.pdf – руководство по уст новке и обслужив нию системы в
форм те .pdf;
– и п пку tools, в которой р спол г ются следующие рхивы:
– dbservice – содержит скрипты сервисного обслужив ния и . одробнее о
р боте скрипт опис но в пункте 12.3 д нного руководств .
– MApiC – содержит утилиту вызовов API-интерфейс системы и примеры
api-функций. одробное опис ние р боты с утилитой опис но в « уководстве
прогр ммист ».
4
р з рхивиров нном виде п пк \\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 (см. « уководство дминистр тор
системы»)
омплект пост вки 5
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, но при этом могут возник ть р зличные проблемы.
6
иним льные прогр ммно- пп р тные требов ния, предъявляемые к клиентским ст нциям:
– процессор т ктовой ч стотой от 1,0 ц;
– 512 Mb опер тивной п мяти;
– VGA монитор с р зрешением от 1024x768;
– н личие сетевой к рты;
– опер ционн я систем Windows XP/Vista;
– рекомендуемые web-бр узеры – Microsoft Internet Explorer 6.0 и выше, т кже
Mozilla FireFox 1.5, 2.0;
– рекомендуемый п кет офисных приложений не ниже MS Office 2002.
ребов ния к пп р тному и прогр ммному обеспечению 7
3 собенности уст новки
сли в системе уже уст новлен и р бот ет одн из прогр мм: Firebird, web-сервер Apache
или другой web-сервер, PHP, Zend Optimizer, Tomcat – то перед з пуском уст новки системы
их необходимо уд лить, ин че успешн я уст новк системы не может быть
г р нтиров н .
еред уст новкой системы н Windows необходимо уст новить приложение Java
Development Kit (JDK), которое р спол г ется в рхиве Motiw-3.8.1-Win32.zip
jdk-1_5_0_06-windows-i586-p.exe
осле уст новки JDK необходимо созд ть переменную окружения JAVA_HOME и PATH. ля
этого необходимо открыть окно свойств системы ( ой компьютер/ войств ) и выбр ть вкл дку
« ополнительно». тем необходимо воспользов ться кнопкой еременные среды и в
р зделе истемные переменные н ж ть кнопку озд ть. окне созд ния переменной
необходимо в к честве имени переменной з д ть JAVA_HOME, в к честве зн чения
переменной ук з ть полный путь к уст новленному приложению JDK. пример, C:\\Program
Files\\Java\\jdk-1_5_0_06
ля переменной PATH в к честве п р метр необходимо з д ть путь к вирту льной м шине Java
Development Kit. о умолч нию JDK уст н влив ется в к т лог C:\\Program
Files\\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 соответственно пост вляемого
дистрибутив .
8
4 ст новк системы н Windows
ст новк системы н Windows осуществляется з пуском прогр ммы уст новки
Motiw-3.8.1-Win32.exe. ри этом появится окно (рис.1), в котором необходимо
выбр ть язык уст новки системы.
ис. 1. кно выбор язык уст новки
лее появится ди логовое окно (рис. 2), в котором необходимо озн комиться с
информ цией по уст новке.
ис. 2. кно приветствия
ст новк системы н Windows 9
тем необходимо н ж ть кнопку лее. открывшемся окне (рис. 3) с помощью
кнопки бзор необходимо ук з ть к т лог, в который будет уст новлен систем .
ис. 3. кно выбор п пки для уст новки в неё системы
осле выбор к т лог необходимо н ж ть кнопку лее. ри этом откроется окно
(рис. 4), в котором при необходимости можно уст новить призн к созд ния ярлык в
меню уск.
10
ис. 4. кно выбор п пки для созд ния в ней ярлык
осле н ж тия кнопки лее откроется окно (рис. 5), в котором необходимо н ж ть
кнопку ст новить для з пуск процесс уст новки.
ст новк системы н Windows 11
ис. 5. кно переход к ст рту уст новки системы
ри этом произойдет копиров ние всех необходимых для р боты системы ф йлов. о
з вершении копиров ния систем будет полностью уст новлен (рис. 6). о з вершении
уст новки web-сервер Apache будет втом тически з пущен.
12
ис. 6. кно з вершения уст новки
пуск уст новленной системы будет произведен втом тически при включении опции «
ткрыть отив в бр узере».
зменение н строек системы, т ких к к подключение к б зе д нных, почтовые
н стройки, SMS и т.д., можно осуществить в ф йле config_motiw.ini, который
р спол г ется в директории \\Motiw\\scripts\\include\\. одробное опис ние
п р метров ф йл опис но в р зделе 8 д нного руководств .
ст новк системы н Windows 13
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\"
противном случ е корректный экспорт д нных из системы н русском языке не может быть
г р нтиров н.
14
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 of
apache 1.3.x
– при появлении ди лог уст новки PHP dom-xml выст вить Include DOM (E)XSLT
support
– при появлении ди лог уст новки 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 осуществляется н логичным обр зом.
ст новк системы н дистрибутивы FreeBSD 5 15
7 ополнительные возможности системы и их
н стройк
дополнительным возможностям системы можно отнести следующие:
– втом тическ я р ссылк почтовых уведомлений о событиях с з д ч ми пользов теля;
– втом тическ я р ссылк сообщений и н помин ний пользов телям системы в з д нное
время;
– опер тивное получение пользов телями з д ч и сигн лиз ция новых действий с
помощью прогр ммы « нформер»;
– р сширенный поиск з д ч и з регистриров нных по ним действий, т кже ф йлов
документов;
– интегр ция системы с электронной почтой для обмен почтовыми сообщениями с
пользов телями, не з регистриров нными в системе ;
– использов ние пользов телями п р метров доменной вториз ции при входе в систему.
ля использов ния вышеперечисленных возможностей необходим их дополнительн я
н стройк .
7.1 стройк почтовых уведомлений
стройк п р метров для почтовых уведомлений осуществляется в р зделе Mail
конфигур ционного ф йл системы config_motiw.ini. ля использов ния
втом тической р ссылки почтовых уведомлений в п р метр х необходимо ук з ть дрес
SMTP-сервер в р зделе SMTP, т кже присвоить п р метру MailSendMethod зн чение 1.
одробное опис ние п р метров ф йл config_motiw.ini опис но в р зделе 8 д нного
руководств .
7.2 стройк втом тической р ссылки н помин ний по з д ч м
к т логе services корневой директории системы р сположен ф йл
sendmailreminds.php.
ля р ссылки втом тических н помин ний по з д ч м дост точно периодически исполнять
д нный ф йл через интерпрет тор php.exe, р спол г ющийся в директории C:\\Program
Files\\Motiw\\software\\PHP\\cli. цен рий з пуск ется с двумя п р метр ми:
1. орневой к т лог, в котором р сположены PHP-сцен рии системы (н пример, при
уст новке системы н Windows – C:\\Program Files\\Motiw\\scripts);
2. мя сервер (hostname) (н пример, motiw).
римеч ние – уть к ф йлу php.exe необходимо прописыв ть в к вычк х.
16
7.3 стройк отпр вки оповещений по з д ч м, помещенных в очередь
редусмотрен возможность использов ния отложенной отпр вки почтовых и SMS-уведомлений
по з д ч м. ри этом необходимо з д ть определённый промежуток времени, через который
уведомления будут отпр влены пользов телям. ри условии, что в течение этого времени
пользов телем были просмотрены действия и сообщения по з д ч м в веб-интерфейсе или в
прогр мме « нформер», уведомления по почте и SMS отпр влены не будут. д ние
соответствующих н строек осуществляется дминистр тором системы в пункте меню
« стройки оповещений».
ля использов ния вышеопис нной возможности необходимо осуществить дополнительную
н стройку.
к т логе services корневой директории системы р сположен ф йл
send_mail_sms_from_queue.php.
ля отпр вки оповещений по з д ч м из очереди дост точно периодически исполнять д нный
скрипт через интерпрет тор php.exe, р спол г ющийся в директории C:\\Program
Files\\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):
ополнительные возможности системы и их н стройк 17
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=<произвольный текст>
18
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++. ля этого можно обр титься к
р зр ботчик м системы.
ополнительные возможности системы и их н стройк 19
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 может служить, н пример,
20
использов ние схемы процесс init inittab.
ополнительные возможности системы и их н стройк 21
ля этого из скрипт иници лиз ции системы следует уд лить строку з пуск сервис
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\"
22
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] – ф йлы библиотек документов.
ополнительные возможности системы и их н стройк 23
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:\\Program
Files\\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.
24
ля этого н до убедиться, что строчк
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.
льнейш я н стройк доменной вториз ции осуществляется к ждым пользов телем
с мостоятельно (см. « уководство пользов теля»).
ополнительные возможности системы и их н стройк 25
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
одержит п роль пользов теля для подключения к б зе д нных.
орм т ключ : п роль_пользов теля
26
8.2 здел [Mail]
одержит ключи, необходимые для н стройки почты.
люч FromAddress
н чение ключ – email втоинформ тор системы отив. тот дрес будет ук зыв ться в поле
FROM (от кого) в письм х, отпр вляемых втоинформ тором пользов телям системы.
орм т ключ : name@yourhost.ru
люч 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 =\"motiw@mail.ru\"
орм т ключ : name@host
люч sendmail_path
одержит путь к прогр мме с п р метр ми отпр вки почты sendmail. стройк действует для
Unix/Linux.
стройк п р метров системы 27
ример:
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\"
28
орм т ключ должен содерж ть только л тинские буквы либо цифры.
люч 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
стройк п р метров системы 29
орм т ключ : числовое_ зн чение
люч SmsProxyHost
одержит прокси-сервер для выход в нтернет. сли этот ключ явно не ук з н, то он не
используется.
орм т ключ : host:port
люч SmsProxyLogin
одержит логин пользов теля для прокси-сервер . сли этот ключ явно не ук з н, то он не
используется.
люч SmsProxyPass
одержит п роль для логин пользов теля для прокси-сервер . сли этот ключ явно не ук з н,
то он не используется.
люч SmsProxyType
одержит тип прокси-сервер по умолч нию (http или socks4 или socks5). сли этот ключ явно не
ук з н, то он не используется.
ример:
SmsProxyType=\"http\"
8.4 здел [InfDaemon]
одержит н стройки доступ к серверу дост вки мгновенных сообщений системы отив. ервер
мгновенных сообщений системы отив предн зн чен для ускорения дост вки действий по
з д ч м в прогр мме « нформер».
люч DaemonAddress
одержит имя сервер мгновенных сообщений системы отив.
ример:
DaemonAddress=\"yourhost\"
орм т ключ : hostname
люч DaemonPort
одержит номер порт , н котором р бот ет сервер мгновенных сообщений системы отив.
ример:
DaemonPort=4000
орм т ключ : номер_порт
8.5 здел [Modules]
одержит список подключ емых р сширений основного меню системы отив.
30
8.6 здел [BackForm]
одержит н стройки пункт меню системы отив « ожел ния и з меч ния».
люч EnableBackForm
пр вляет видимостью пункт меню системы отив « ожел ния и з меч ния».
озможные зн чения: 1 – пункт видимый, 0 – пункт невидимый.
ример:
EnableBackForm=1
орм т ключ : 0 или 1
люч BackFormSupportAdress
одержит email, список email, н который будут отпр вляться пожел ния и з меч ния.
ример:
BackFormSupportAdress =\"admin@yourhost,support@motiw.ru\"
орм т ключ : name@yourhost.ru[,name@yourhost.ru]
люч 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\"
стройк п р метров системы 31
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
32
9 стройк р змер ф йлов
стройк м ксим льного р змер ф йл для прикрепления к з д ч м, действиям и
документ м осуществляется в ф йле php.ini, р сположенном в директории
\\Motiw\\software\\PHP.
подр зделе File Uploads для п р метр upload_max_filesize следует пропис ть нужный
р змер. о умолч нию уст новлено зн чение 2 б.
; Maximum allowed size for uploaded files.
upload_max_filesize = 2M
стройк р змер ф йлов 33
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:\\Program
Files\\Motiw\\software\\apache2\\conf.
34
тем для вход в систему с pda необходимо в строке бр узер ввести http://pda.
появившемся окне вториз ции в к честве имени ук з ть admin, в к честве п роля admin.
пр вочное руководство для pda-версии системы можно просмотреть в меню системы « отив»
–> « уководств » –> « уководство для PDA-версии».
ля доступ в систему с пользов тельских компьютеров необходимо пропис ть в DNS
ip- дрес сервер и символьное имя сервер . ричем символьное имя сервер должно
соответствов ть имени, ук з нному в п р метр х ServerName или ServerAlias ф йл
httpd.conf.
ля вход в систему с пользов тельского компьютер необходимо ввести в строке дрес
бр узер
http://<символьное_имя_сервер >
ля доступ к pda-версии с пользов тельских компьютеров необходимо н логичным
обр зом осуществить н стройку п р метров, опис нных выше.
ход в систему 35
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.
36
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.
опровождение уст новленной системы 37
озд ние резервной копии б зы д нных необходимо пл ниров ть с необходимой
ч стотой. ри р боте системы н 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 xxx
number 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, к к это было опис но выше. сли ошибку испр вить не уд ется, то
необходимо обр титься к р зр ботчику.
38
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 н
опровождение уст новленной системы 39
пок з этой стр ницы в ф йле 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. осле успешного прохождения тестов можно з пуск ть сервисный скрипт обслужив ния. то
40
скрипт 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. ри этом откроется окно, в котором
будет предложено ввести имя пользов теля и п роль.
опровождение уст новленной системы 41
диный беспл тный телефон:
8-800-555-43-21
л вный офис:
(495) 233-76-76 (многок н льный)
119072, оссия, г. оскв ,
городное шоссе, д.1,
бизнес центр « ибинтек»
ехническ я поддержк :
(495) 540-18-40
(4722) 58-29-69
support@motiw.ru
www.motiw.ru
info@motiw.ru
0 comments
Post a comment