Руководство технолога NauDoc - CRM74crm74.ru/uploads/soft-naudoc/install_naudoc.pdf · Руководство по установке naudoc Оглавление

NauDoc 4

Руководство по установке

Руководство по установке NauDoc

Оглавление1. УСТАНОВКА НА ОС MICROSOFT WINDOWS.....................................................................................3

1.1. ВЫЗОВ МАСТЕРА УСТАНОВКИ NAUDOC..............................................................................................................31.2. ВЫБОР КАТАЛОГА ДЛЯ УСТАНОВКИ СЕРВЕРА ПРИЛОЖЕНИЙ....................................................................................31.3. ВЫБОР КАТАЛОГА ДЛЯ УСТАНОВКИ NAUDOC......................................................................................................41.4. ВЫБОР РЕЖИМА ЗАПУСКА СЕРВЕРА ПРИЛОЖЕНИЙ ZOPE.........................................................................................51.5. ДОБАВЛЕНИЕ ПАПКИ В МЕНЮ «ПУСК»..............................................................................................................51.6. ЗАВЕРШЕНИЕ ПРОЦЕССА УСТАНОВКИ..................................................................................................................61.7. УСТАНОВКА ДОПОЛНИТЕЛЬНЫХ КОМПОНЕНТОВ...................................................................................................7

1.7.1. Установка Graphviz...........................................................................................................................71.7.2. Установка TrayAgent.........................................................................................................................71.7.3. Установка модуля “Интеграция с FineReader”.............................................................................8

2. УСТАНОВКА НА ОС СЕМЕЙСТВА UNIX.............................................................................................92.1. УСТАНОВКА ИНТЕРПРЕТАТОРА ЯЗЫКА PYTHON-2.4.4...........................................................................................92.2. УСТАНОВКА ДОПОЛНИТЕЛЬНЫХ БИБЛИОТЕК PYTHON..........................................................................................102.3. УСТАНОВКА ZOPE 2.10.7..............................................................................................................................102.4. УСТАНОВКА NAUDOC...................................................................................................................................112.5. УСТАНОВКА ДОПОЛНИТЕЛЬНЫХ ПРОДУКТОВ ZOPE..............................................................................................112.6. ЗАПУСК СЕРВЕРА ПРИЛОЖЕНИЙ ZOPE...............................................................................................................112.7. УСТАНОВКА ДОПОЛНИТЕЛЬНЫХ БИБЛИОТЕК......................................................................................................11

2.7.1. Установка PIL..................................................................................................................................112.7.2. Установка конвертеров..................................................................................................................122.7.3. Установка Graphviz.........................................................................................................................14

3. ВХОД В NAUDOC........................................................................................................................................143.1. ВХОД В NAUDOC НА СЕРВЕРЕ.........................................................................................................................143.2. ВХОД В NAUDOC ИЗ ЛОКАЛЬНОЙ СЕТИ............................................................................................................153.3. АКТИВАЦИЯ NAUDOC...................................................................................................................................15

4. УСТАНОВКА И НАСТРОЙКА ДОПОЛНИТЕЛЬНЫХ КОМПОНЕНТОВ...................................164.1. НАСТРОЙКА РАБОТЫ NAUDOC ЧЕРЕЗ APACHE...................................................................................................16

4.1.1. Отличия при настройке под Windows...........................................................................................174.2. НАСТРОЙКА РАБОТЫ NAUDOC ЧЕРЕЗ IIS.........................................................................................................17

4.2.1. Настройка сервера Zope.................................................................................................................174.2.2. Настройка Internet Information Server...........................................................................................184.2.3. Настройка расширения FastCGI....................................................................................................254.2.4. Настройка взаимодействия NauDoc с LDAP-сервером под управлением Active Directory.....26 Подсистема управления пользовательским интерфейсом..................................................................264.2.5. Настройка NTLM-аутентификации в NauDoc............................................................................27

5. ОБНОВЛЕНИЕ СО СТАРЫХ ВЕРСИЙ.................................................................................................275.1. ПЕРЕХОД С NAUDOC V3.4.X..........................................................................................................................275.2. ОБНОВЛЕНИЕ NAUDOC V4.X..........................................................................................................................28

NAUMEN, 2002 – 2009

1. Установка на ОС Microsoft WindowsВ инструкции рассматривается установка программного продукта NauDoc 4 на компьютер (сервер), работающий под управлением операционных систем Microsoft Windows 2000 Professional/2000,2003 Server/XP/Vista.Рекомендуемая конфигурация компьютера, на который устанавливается NauDoc:Intel Core 2 Duo 3 ГГц, RAM >2Гб, HDD >100 Гб.На рабочем месте пользователя NauDoc рекомендуется использовать интернет-браузер Interent Explorer 6 и выше или Mozilla Firefox 2 и выше.

1.1. Вызов мастера установки NauDocДважды щелкнув «мышью» на файле NauDoc-4.exe. На экране появится окно мастера установки.

Для перехода на следующий шаг нажмите кнопку «Далее».

1.2. Выбор каталога для установки сервера приложенийВ окне мастера установки укажите название каталога на жестком диске компьютера, в который будет установлен сервер приложений Zope. По умолчанию, мастер установки предложит установить Zope в каталог C:\Program Files\Zope-2.10.

Сервер приложений Zope (www.zope.org) является необходимым компонентом при использовании NauDoc.


1.3. Выбор каталога для установки NauDocВ окне мастера установки укажите название каталога на жестком диске сервера, на который будет установлен программный продукт NauDoc. По умолчанию мастер установки предложит установить продукт в каталог C:\Program Files\NauDoc-4.


1.4. Выбор режима запуска сервера приложений ZopeВ окне мастера установки выберите режим запуска для сервера приложений Zope:

• «Запускать сервер вручную»: если выбран данный режим, то после установки пользователь запускает сервер Zope каждый раз вручную, когда потребуется запустить NauDoc на сервере. В этом случае удобно разместить ярлык для запуска на рабочий стол ОС.

• «Запускать как системную службу»: данный режим означает, что сервер Zope запускается автоматически как все системные службы ОС Microsoft Windows NT/2000/XP/Vista, и при возникновении ошибки происходит автоматический перезапуск сервера.

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


1.5. Добавление папки в меню «Пуск»В окне мастера установки укажите название папки в системном меню «Пуск», в которой будут находиться служебные ярлыки NauDoc.


1.6. Завершение процесса установкиПосле завершения установки NauDoc в окне мастера появится следующее сообщение.

Нажмите кнопку «Готово», чтобы закрыть окно мастера установки.

1.7. Установка дополнительных компонентов1.7.1. Установка Graphviz

Для работы модуля «Графическое отображение процессов» необходимо установить Graphviz 1.14.Для установке запустите файл graphviz-1.14.exe и следуйте указаниям инсталлера.

1.7.2. Установка TrayAgentМодуль TrayAgent состоит из модуля, устанавиваемого на сервере и утилиты для рабочей станцииNauDoc-TrayAgent-1.0-Install.exe.Загрузить утилиту можно из NauDoc в меню «Пользователь» → «Настройки TrayAgent». После загрузки запустите утилиту NauDoc-TrayAgent-1.0-Install.exe.После запуска выберите язык и нажмите кнопку «OK».В появившемся диалоговом окне выполните следующие действия:

• Нажмите кнопку “Далее”;• Нажмите кнопку «Согласен»;• Выберите папку установки (по умолчанию «C:\Program Files\NauDoc Tray Agent»)• Нажмите кнопку “Далее”;• Выберите папку в меню «Пуск» (По умолчанию «NauDoc Tray Agent 1.0»)• Если не нужно создавать ярлык приложения на Рабочем Столе поставьте флажок в поле «Не

создавать ярлыки»• Нажмите кнопку “Установить”;

В результате выполнения этих действий начнется процесс установки приложения. После окончания установки нажмите на кнопку «Готово». Установить утилиту необходимо на всех рабочих станциях, где будет использоваться TrayAgent.Для запуска программы откройте «Пуск»→«Программы» →«NauDoc Tray Agent 1.0» → «NauDoc Tray Agent», или щелкните «мышью» по ярлыку на рабочем столе.

После этого в появившемся окне авторизации укажите:• адрес сервера NauDoc;• системное имя пользователя NauDoc;• пароль;• При желании можно установить флажки в поле «Сохранить пароль» и поле «Автоматический вход в систему. В этом случае при последующих запусках программы вход в систему будет происходить автоматически. Включение этих опций снижает безопасность системы.

После этого нажмите кнопку «Далее». В случае успешного соединения с сервером появится соответствующее сообщения, а в панели задач Windows (правый нижний угол) будет добавлен значок . При возникновении ошибки появится новое окно с ее описанием.

В этом случае нажмите кнопку «Далее» и проверьте правильность адреса сервера, системного имени или пароля. Если данная ошибка повторится, обратитесь к системному администратору.

1.7.3. Установка модуля “Интеграция с FineReader”Для интеграции с ABBYY Fine Reader 7.0 Scripting Edition необходимо на компьютере клиента

установить приложения «Fine Reader с экспортом в NauDoc» (файл FR.exe).Первое из них осуществляет возможность «поточного» ввода документов в NauDoc, второе

позволяет распознавать текст во вложениях документа.

Инструкция по установке приложения «FineReader с экспортом в NauDoc»1. Под учетной записью администратора активировать в NauDoc модуль “Интеграция с FineRead-

er”2. Установить ABBYY FineReader Scripting Edition 7.0 на компьютер пользователя с диска ABBYY

и зарегистрировать лицензию.3. Запустить файл FR.exe и следовать инструкциям. По умолчанию приложение будет установлено

в папку C:\Program Files\NAUMEN\FineReader with export to NauDoc, в меню «Пуск» будет со-здана группа «NAUMEN» и в ней «FineReader with export to NauDoc».

4. После запуска нужно настроить параметры сохранения. Для этого нужно нажать кнопку с «от-вертками» в панели инструментов справа. На вкладке «Доступ» необходимо указать:

a. Имя пользователя, например user1b. Пароль и подтверждение пароляc. Имя или ip адрес сервераd. Номер порта – по умолчанию 8080e. Путь к папке (например, путь к домашней папке - /docs/storage/members/user1)f. Категория по умолчанию – Document.

5. В той же форме на вкладке «Сохранение файлов» необходимо указать параметры сохранения файлов-изображений в NauDoc.

6. После распознавания документа необходимо его сохранить в NauDoc. Для этого можно в меню «Файл» выбрать пункт «Передать выбранные страницы в NauDoc» или «Передать все страницы в NauDoc», также можно можно воспользоваться мастером сохранения результатов. При этом запускается браузер и в нем открывается страница, на которой нужно указать название доку-мента, категорию и при необходимости заполнить реквизиты. Затем нажать кнопку «Приме-нить». Если все прошло успешно, появится сообщение «Документ сохранен».

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

Более подробно принцип работы с FineReader в NauDoc описан в руководстве пользователя NauDoc в главе 22.

2. Установка на ОС семейства UNIXРассматривается установка на примере ОС Linux. Для некоторых систем могут быть особенности в

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

2.1. Установка интерпретатора языка Python-2.4.4Должен быть установлен zlib-1.2.1Скорее всего, модуль zlib уже установлен, в этом случае установка не требуется. Проверить можно выполнением команды: ld -lz. Если результатом ее выполнения будет сообщение ld: cannot find -lz, это означает, что модуль zlib не установлен. Установка производится из архива zlib-1.2.1.tar.gz.Выполните следующие действия:

1. распакуйте архив zlib-1.2.1.tar.gz;2. выполните команду:./configure3. выполните команду:make && make install

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

1. распакуйте архив Python-2.4.4.tgz;

2. выполните команду:./configure3. выполните команду:make && make install

Примечание! Возможна ситуация, когда в файлы, созданные конфигурационного скриптом для системы сборки, не попали некоторые необходимые модули (например, _socket и zlib). Это случается, когда в операционной системе не установлены соответствующие библиотеки. В этом случае раскомментируйте в файле Python-2.4.4/Modules/Setup.dist соответствующие строки.

2.2. Установка дополнительных библиотек PythonУстановка дополнительных библиотек производится из архива egenix-mx-base-3.1.2.tar.gz.

Внимание! Здесь и далее в процессе установки все python-скрипты необходимо запускатьтолько интерпретатором Python 2.4.4, который был установлен на первом шаге.

Для того чтобы установить библиотеки, выполните следующие действия:1. распакуйте архив egenix-mx-base-3.1.2.tar.gz.2. выполните команду:python setup.py install

2.3. Установка Zope 2.10.7Установка сервера приложений Zope производится из архива Zope-2.10.7-src.tgz. Производить установку Zope необходимо от учетной записи специального пользователя (например, zope). В противном случае необходимо после установки сменить владельца у директорий /opt/zope и /opt/naudoc.Для того чтобы установить Zope, выполните следующие действия:1. распакуйте архив Zope-2.10.7-src.tgz2. в директории /Zope-2.10.7-src выполните команду:./configure --prefix=/opt/zope --with-python=/usr/local/bin/python2.4где /opt/zope - путь до директории, где будет установлена рабочая версия Zope (разрешается выбрать и другой путь).3. выполните команду:python2.4 /opt/zope/bin/mkzopeinstance.py --dir=/opt/naudocгде /opt/naudoc - путь до директории, где будет установлен экземпляр Zope (Zope instance).4. отредактируйте файл /opt/naudoc/etc/zope.conf, добавив строчкуdefault-zpublisher-encoding windows-12515. создайте системный аккаунт от имени которого будет запускаться сервер приложений Zope, например zope. Отредактируйте файл /opt/naudoc/etc/zope.conf, указав в строке имя пользователя, от которого будет работать Zope.effective-user zopeОБРАТИТЕ ВНИМАНИЕ: пользователь zopе должен быть владельцем каталога (и содержимого) /opt/naudoc

Примечание! При установке на ОС Solaris необходимо отредактировать файлlib/python/ZODB/cPickleCache.c, закомментировав строчку #445:assert(key != Py_None);

2.4. Установка NauDocУстановка продукта NauDoc 4 производится из архива NauDoc-4.tgz. Для того чтобы установить NauDoc, выполните следующие действия:

1. распакуйте архив NauDoc-4.tgz2. После этого действия в файловой системе должны появиться директория, содержащая

поддиректории /Products и /zopeedit , а также файл Data.fs, содержащий базу данных3. NauDoc.4. скопируйте директорию /Products в директорию /opt/naudoc;5. Рекомендация. Избегайте избыточной вложенности папок, типа /opt/naudoc/ Products/

Products/…6. скопируйте директорию /zopeedit в директорию /opt/naudoc/lib/python;7. скопируйте файл Data.fs в директорию /opt/naudoc/var

Внимание! Владельцем папки /opt/naudoc/Products и /opt/naudoc/lib/python/zopeedit такжедолжен быть специальный пользователь zope.

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

1. перейдите в директорию /opt/naudoc/Products/ TextIndexNG2;2. выполните команду:

python2.4 setup.py build3. выполните команду:

python2.4 setup.py install

2.6. Запуск сервера приложений ZopeДля запуска сервера приложений Zope необходимо от учетной записи пользователя zope выполнить команду:/opt/naudoc/bin/zopectl start

2.7. Установка дополнительных библиотекБез установки дополнительных библиотек система NauDoc запустится и будет работать за

исключением некоторого функционала.

2.7.1. Установка PILУстановка jpegsrc.v6b и tiff-v3.5.7

Установка производится из архивов jpegsrc.v6b.tar.gz и tiff-v3.5.7.tar.gz. Для установки каждой из этих библиотек выполните следующие действия:

1. распакуйте архив;2. выполните команду:

./configure3. выполните команду:

make && make install

Внимание! После завершения установки не удаляйте директории, из которых устанавливались библиотеки, эти директории понадобятся в дальнейшем при установке библиотеки Imaging-1.1.4-tiff.

Установка Imaging-1.1.4-tiffУстановка производится из архива Imaging-1.1.4-tiff.tar.gz. Выполните следующие действия:

1. распакуйте архив Imaging-1.1.4-tiff.tar.gz;2. зайдите в директорию /libImaging;3. выполните команду:

./configure4. отредактируйте содержание Makefile, указав правильные пути в переменные JPEGINCLUDE и

TIFFINCLUDE (это будут пути к каталогам, которые были не удалены в п.4.1, примерно такие: /tmp/jpeg-6b и /tmp/tiff-v3.5.7/libtiff);

5. отредактируйте содержание файла ImConfig.h, добавив в него строку:#define HAVE_LIBTIFF 1

6. выполните команду:make

7. перейдите из директории /libImaging на один уровень выше;8. отредактируйте файл setup.py, прописав в переменные JPEGDIR и TIFFDIR правильные пути (те

же, что на шаге 4).9. выполните команду:

python setup.py build10. выполните команду:

python setup.py install

2.7.2. Установка конвертеровПопробуйте установить указанные ниже продукты через менеджер пакетов вашего дистрибутива (некоторые продукты могут иметь зависимости). Если они отсутствуют, скомпилируйте из исходных кодов по инструкции ниже.Установка libiconv-1.9.1Чаще всего конвертер уже установлен, в этом случае установка не требуется. Проверить можно по наличию команды iconv.Установка производится из архива libiconv-1.9.1.tar.gz. Выполните следующие действия:




Установка freetype-2.1.8Установка производится из архива freetype-2.1.8.tar.gz. Выполните следующие действия:



make && make installУстановка libpng-1.2.5Установка производится из архива libpng-1.2.5.tgz. Выполните следующие действия:

1. распакуйте архив;2. из созданной при распаковке архива директории /scripts скопируйте соответствующий makefile

(для ОС Solaris это будет makefile.solaris);3. переименуйте файл в Makefile;4. выполните команду:

make && make installУстановка libwmf-0.2.8.3Установка производится из архива libwmf-0.2.8.3.tar.gz. Выполните следующие действия:



make && make installУстановка wv-1.0.2-patchedУстановка производится из архива wv-1.0.2-patched.tar.gz. Выполните следующие действия:




Примечание! Может при запуске не обнаружить библиотеку libwv-1.0.so.2. В этом случае необходимо сделать символическую ссылку с таким именем в директории /usr/lib, ссылающуюся на libwv-1.0.so.2.0.0.

Установка xlhtml-0.5Установка производится из архива xlhtml-0.5.tgz. Выполните следующие действия:



make && make installУстановка unrtf-0.18.1.fixedУстановка производится из архива unrtf-0.18.1.fixed.tar.gz. Выполните следующие действия:

1. распакуйте архив;

2. выполните команду:./configure

3. выполните команду:make && make installУстановка xpdf-2.03Установка производится из архива xpdf-2.03.tar.gz. Выполните следующие действия:




2.7.3. Установка GraphvizДля работы модуля «Графическое отображение процессов» необходимо установить Graphviz 1.14.Установка производится из архива graphviz-1.14 .tar.gz. Выполните следующие действия:



make && make installЛибо установите продукт из пакетов.

3. Вход в NauDoc

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

1. откройте окно интернет-браузера;2. введите в адресную строку браузера: http://localhost:8080/docs;3. в появившемся окне авторизации введите данные учетной записи администратора NauDoc (по

умолчанию имя пользователя – admin, пароль – admin).

На экране появится пользовательский интерфейс NauDoc.

3.2. Вход в NauDoc из локальной сетиДля входа в NauDoc с компьютеров, находящихся в одной локальной сети ссервером, на котором установлен NauDoc, выполните следующие действия:

1. откройте окно интернет-браузера;2. введите в адресную строку браузера:

http://<имя сервера>:8080/docs , где <имя сервера> - доменное имя или IP- адрес сервера, на котором установлен NauDoc.

3.3. Активация NauDocДля работы бесплатной версии NauDoc Free активация не требуется. Для активации модулей NauDoc Pro необходимо зайти в систему под учетной записью администратора, затем перейти на вкладку «Сервис», пункт меню «Модули расширения».Если у Вас уже есть лицензионный ключ, то введите название предприятия и ключ в соответствующие поля и нажмите кнопку «Применить». В этом случае модули, предусмотренные вашей лицензией будут включены при активации ключа.Если требуется выполнить активацию модулей в демо-режиме, то отметьте требуемые модули и нажмите кнопку «Изменить настройки». Для тестирования NauDoc Pro обязательно должны быть включены модули: «Служебный модуль», «Справочники», «Справочник оргструктуры», «Журналы регистрации»

Примечание! Лицензионный ключ состоит из двух частей. Первая — «Компания», вторая — «Лицензионный ключ». При активациии ключа необходимо правильно вводить оба поля

В демонстрационном режиме работы конфигурации «Автоматизация делопроизводства» не доступно редактирование настроек категорий документов данной конфигурации. Время работы модулей в демо-режиме — 30 дней с момента активации.

Примечание! Настройки конфигурации «автоматизация делопроизводства» хранятся в СУБД. Конфигурацию нельзя перенести из одной СУБД в другую, поэтому при переходе с NauDoc Free на NauDoc Pro нельзя импортировать бизнес-процесы этой конфигурации. Совет: Если Вы планируете использовать бизнес-процессы конфигурации «автоматизация делопроизводства», но хотите поработать с системой в демо-режиме, сразу устанавливайте систему с дистрибутива редакции NauDoc Pro Base и выше.

4. Установка и настройка дополнительных компонентов

4.1. Настройка работы NauDoc через ApacheПо умолчанию NauDoc обрабатывает запросы пользователей средствами веб-сервера Medusa, являющегося компонентом сервера приложений Zope. В большинстве случаев этого достаточно, но если доступ в NauDoc открыт из сети Интернет, рекомендуется настроить работу Zope через веб-сервер Apache.

Примечание! По умолчанию описывается настройка под Linux. Под Windows есть некоторые отличия, они указаны в конце параграфа.

Для Apache нужен модуль mod_fastcgi - через него будут состыковываться Zope и Apache. Директива FastCgiExternalServer является основной директивой и подключает внешнее FastCGI приложение. Для того чтобы приложение работало корректно в директории, которая является корневой для URL веб сайта необходимо создать директорию, которая будет обозначать URL для Zope. В данном случае это директория /var/www. Опция -socket /tmp/fcgi/zope.soc указывает, что работа будет вестись через файловый сокет который находится в файле /tmp/fcgi/zope.soc. Опция -pass-header Authorization указывает на то, что Apache не должен обрабатывать заголовки авторизации, и должен их передавать внешнему FastCGI приложению. Вот пример, как может выглядеть кусок httpd.conf для работы Zope через Apache (здесь Zope работает прямо от корневого URL сайта - в этом случае значения DocumentRoot и FastCGIExternalServer должны совпадать): LoadModule fastcgi_module modules/mod_fastcgi.so

DocumentRoot "/var/www"

<Directory "/var/www"> Options FollowSymLinks Includes ExecCGI AllowOverride All SetHandler fastcgi-script Order allow,deny Allow from all</Directory>

FastCgiExternalServer /var/www -socket /tmp/fcgi/zope.soc \ -idle-timeout 600 \ -pass-header Authorization

RewriteEngine on

RewriteRule ^/(.*) /var/www/1/$1

После того, как необходимые изменения внесены, необходимо запустить сервер приложений Zope таким образом, чтобы он работал через сокет. Для этого нужно в конфигурационном файле Zope, который находится в каталоге /naudoc/etc/zope.conf отредактировать следующие строки: <fast-cgi> # valid key is "address"; the address may be hostname:port, port, # or a path for a Unix-domain socket address /tmp/fcgi/zope.soc </fast-cgi>После сохранения изменений следует перезапустить сервер приложений Zope.Директория /var/www должна существовать в файловой системе и доступна для пользователя, от которого запущен Apache.

4.1.1. Отличия при настройке под WindowsВ Windows нет файловых сокетов, поэтому приходится открывать порт для FCGI. Zope вместо пути к сокету нужно указать FCGI_PORT (в файле /naudoc/etc/zope.conf, директива <fast-cgi>). Соответственно, в httpd.conf директиве FastCgiExternalServer вместо ключа -socket нужно будет передавать -host с адресом хоста, на котором запущен Zope и номером порта, указанным в FCGI_PORT. Например, -host=localhost:10000. Кусок httpd.conf для примера: LoadModule fastcgi_module modules/mod_fastcgi.dll

DocumentRoot "C:\Temp\htdocs"

<Directory "C:\Temp\htdocs"> Options Indexes FollowSymLinks ExecCGI SetHandler fastcgi-script AllowOverride None Order allow,deny Allow from all</Directory>

FastCgiExternalServer "C:\Temp\htdocs" -host localhost:10000 \ -idle-timeout 600 \ -pass-header Authorization

RewriteEngine onRewriteRule ^/(.*) "C:/Temp/htdocs/1/$1"

4.2. Настройка работы NauDoc через IIS4.2.1. Настройка сервера Zope

isapi_fcgi.dll можно скачать по ссылке: http://naudoc.ru/images/knowbase/isapi_fcgi.dll msvcr71.dll можно скачать по ссылке: http://naudoc.ru/images/knowbase/msvcr71.dll

Для взаимодействия Internet Information Server с сервером Zope со стороны IIS используется дополнительно устанавливаемое расширение FastCGI, а со стороны Zope — встроенный обработчик запросов FastCGI и объект Virtual Host Monster.

Настройка работы через FastCGI

Для обработки FastCGI-запросов необходимо задать TCP-порт, на котором Zope будет принимать запросы. Номер порта выбирается произвольно и указывается в качестве аргумента опции «-F» в

http://naudoc.ru/images/knowbase/msvcr71.dll

http://www.naudoc.ru/images/knowbase/msvcr71.dll

http://naudoc.ru/images/knowbase/isapi_fcgi.dll

http://www.naudoc.ru/images/knowbase/isapi_fcgi.dll

командной строке запуска сервера. Рекомендуется ограничить доступ к этому порту при помощи системного Firewall таким образом, чтобы принимались только соединения от Internet Information Server.

Пример команды запуска сервера Zope:

start –F 8090

Установка Virtual Host Monster С помощью ZMI следует создать объект типа Virtual Host Monster в корневой папке Zope. Идентификатор не важен, но рекомендуется использовать “VirtualHostMonster”. Никаких дополнительных настроек не требуется.

4.2.2. Настройка Internet Information Server

Установка расширения FastCGI Расширение FastCGI представлено файлом ISAPI_FCGI.DLL, который следует поместить в любое место на диске сервера, откуда он может быть подключен к IIS, например, в папку “C:\Inetpub\FastCGI”.

Настройка виртуального каталога

Каждому экземпляру NauDoc ставится в соответствие виртуальный каталог (Virtual Directory) в IIS, с которым связана своя папка в файловой системе. Эта папка не содержит никаких файлов и создается вручную в произвольном месте, например, под именем “C:\Inetpub\docs”.

С помощью Internet Services Manager создайте новый виртуальный каталог в сайте IIS. В последующих формах укажите имя, под которым объект NauDoc будет отображаться в IIS (например, “docs”), и предварительно созданную папку.

Далее настройте параметры нового виртуального каталога аналогично приведенным ниже формам. В особенности следует обратить внимание на следующие настройки:

– для работы FastCGI требуется разрешение на выполнение скриптов;

– документы «по умолчанию» должны быть отключены;

– при использовании NTLM-аутентификации анонимный доступ должен быть запрещен и включена интегрированная аутентификация Windows;

– пользовательские страницы сообщений об ошибках нужно отключить (выделить все типы и нажать «Set to Default»).

Подключение расширения FastCGI

В свойствах виртуального каталога перейдите в настройки конфигурации приложения (по кнопке «Configuration» на вкладке «Virtual Directory»). Удалите все соответствия расширений файлов приложениям и вместо них создайте одно новое, где в качестве расширения задайте символ “*“ и укажите файл ISAPI_FCGI.DLL как обработчик для него.

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

– модуль FastCGI используется для всех HTTP методов (All Verbs);

– модуль должен быть указан как обработчик скриптов (Script engine);

– проверку существования файлов нужно отключить;

– буферизация и поддержка сессий должны быть выключены.

4.2.3. Настройка расширения FastCGI

Настройка FastCGI производится вручную редактированием системного реестра. Все параметры располагаются в ключе “HKEY_LOCAL_MACHINE\SOFTWARE\FastCGI”, который необходимо предварительно создать программой-редактором реестра.

В этом ключе для каждого виртуального каталога, соответствующего какому-либо экземпляру NauDoc, добавляется отдельный подключ, в качестве имени которого указывается полный путь этого виртуального каталога от корня сайта IIS (например, “/docs”). Каждый подключ должен содержать два строковых значения:

BindPath

Строка вида “address:port”, где address — доменное имя или IP-адрес сервера Zope, port — порт FastCGI, указанный в опции «-F» при его запуске.

AppPath

Строка вида “/ZOPE_PATH/VirtualHostRoot/_vh_IIS_PATH”, где “ZOPE_PATH” — путь от корневой папки Zope до объекта NauDoc, “_vh_IIS_PATH” — путь к этому объекту от корня сайта в IIS. Он совпадает с названием текущего подключа, однако в данном случае компоненты пути должны быть записаны с префиксом “_vh_”. Подробнее с форматом записи можно ознакомиться в описании продукта Virtual Host Monster.

В самом простом случае, когда сервер Zope и IIS находятся на одном физическом сервере и путь к NauDoc от корня сайта в них одинаков (например, имеет вид “/docs”), можно воспользоваться следующим reg-файлом:

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\FastCGI]

[HKEY_LOCAL_MACHINE\SOFTWARE\FastCGI\/docs]

"BindPath"="localhost:8090"

"AppPath"="/docs/VirtualHostRoot/_vh_docs"

Возможные и более сложные случаи, например, такой:

– IIS и Zope работают на разных физических серверах: iis_server и zope_server;

– путь к объекту NauDoc в Zope имеет вид “/local/docs”;

– обращения к нему должны происходит через IIS по адресу “http://iis_server/internal/naudoc”.

В этом случае настройки реестра имеют вид:

[HKEY_LOCAL_MACHINE\SOFTWARE\FastCGI\/intranet/naudoc]

"BindPath"="zope_server:8090"

"AppPath"="/local/docs/VirtualHostRoot/_vh_intranet/_vh_naudoc"

4.2.4. Настройка взаимодействия NauDoc с LDAP-сервером под управлением Active Directory

Для настройки взаимодействия необходим установленный сервер Active Directory. Собственно процедура установки Active Directory не рассматривается в настоящем документе.

После установки сервера Active Directory установите модуль поддержки LDAP на сервер, где установлена Система. Для установки необходимо выполнить следующие действия:3. распаковать архив python-ldap-2.0.0.tar.gz с исходными файлами (входит в комплект поставки);4. выполнить команду:

python setup.py installНастройка взаимодействия с LDAP-сервером для разных Подсистем выполняется различным

способами, описание которых приведено ниже.

Подсистема управления пользовательским интерфейсомЗайдите в Подсистему управления пользовательским интерфейсом от учетной записи администратора Системы и в панели навигации перейдите на вкладку («Сервис»). В случае если установка модулей поддержки LDAP на предыдущем шаге прошла успешно, в панели навигации должна быть видна ссылка «Настройки LDAP».

На следующем шаге можно приступить к настройке взаимодействия с LDAP-сервером. Щелкните на ссылке «Настройки LDAP», чтобы вызвать на экран форму настройки взаимодействия с LDAP-сервером.Перейдите в раздел «Добавить или изменить атрибут LDAP» и добавьте атрибут со следующими параметрами:

1. Имя атрибута LDAP: sAMAccountName2. Заголовок атрибута LDAP: Account Name3. Соответствует реквизиту учетной записи: не выбрано

После этого заполните поля формы настройки, следуя инструкциям, приведенным в таблицеТаблица: Поля формы настройки взаимодействия с LDAP-сервером

Название поля Какие данные указываются в полеИспользовать аутентификацию LDAP

Да

Адрес сервера LDAP <доменное имя или IP-адрес LDAP-сервера>:<порт> (например, 10.1.0.250:389)

Имя администратора (DN) из настроек сервера LDAP (например, CN=Admin,CN=Users,DC=company,DC=ru)

Пароль администратора из настроек сервера LDAP

Запретить изменения базы данных Отключено (при необходимости функцию можно активировать)

Базовое имя пользователей (DN) OU=Company,DC=company,DC=ruФильтр поиска пользователей objectClass=userОбласть поиска пользователей рекурсивноКлассы записей пользователей userАтрибут имени учетной записи Account Name (sAMAccountName)Атрибут относительного имени (RDN)

Canonical Name (cn)

Метод шифрования паролей из настроек сервера LDAP (например, clear)Использовать группы LDAP НетБазовое имя групп (DN) OU=Company,DC=company,DC=ruФильтр поиска групп objectClass= groupОбласть поиска групп рекурсивноГруппа администраторов портала Название группы вы сможет выбрать позднееВключить поддержку псевдогрупп НетКлассы объектов псевдогрупп

Заполнив поля формы, нажмите кнопку «Сохранить». 4.2.5. Настройка NTLM-аутентификации в NauDoc

Для включения NTLМ-аутентификации («интегрированной аутентификации Windows») пользователей NauDoc в домене Active Directory нужно включить опцию «Аутентификация фронтальным сервером» на странице «Настройки LDAP». Далее NauDoc будет использовать имя пользователя, полученное по протоколу FastCGI от Internet Information Server, и не производить собственную проверку пароля.Предварительно необходимо настроить NauDoc для использования учетных записей пользователей с сервера Active Directory через LDAP.IIS6:Внимание, библиотеку isapi_fcgi.dll необходимо включить в список Web Service Extensions и разрешить ее выполнение (выбрать dll и нажать на кнопку allow). Если при обращении к серверу появляется сообщение “The specified module could not be found”, то на компьютере отсутствуют библиотеки, используемые данной dll. Используйте dependency walker (depends.exe) для установления недостающих компонентов. Скорее всего, это msvcr71.dll

5. Обновление со старых версий

5.1. Переход с NauDoc v3.4.xПеред установкой обновления рекомендуется сделать резервные копии:

- папки ".../NauDoc-4/Products/CMFNauTools"

- файла базы данных "/NauDoc-3.4/var/Data.fs"

Для перехода на NauDoc v4 с версий линейки NauDoc 3.4 необходимо: - установить NauDoc 4 по инструкции (см. главу 1). - скопировать файл базы данных NauDoc3.4/var/Data.fs в каталог с новой версией NauDoc4/var/- запустите Zope,- откройте окно интернет-браузера;- введите в адресную строку браузера: http://localhost:8080/docs;- в появившемся окне авторизации введите данные учетной записи администратора NauDoc- Запустится сценарий миграции данных.Следуйте указаниями миграционного сценария. В зависимости от размера БД процедура миграции может занять до нескольких часов.После завершения процедуры миграции обратитесь в службу поддержки NauDoc за новым лицензионным ключом.

5.2. Обновление NauDoc v4.xПеред установкой обновления рекомендуется сделать резервные копии:

1. папки ".../NauDoc-4/Products/CMFNauTools"

2. файла базы данных "/NauDoc-3.4/var/Data.fs"

Установка

Для UNIX:

1. Удалить папку "CMFNauTools", находящуюся в папке ".../NauDoc-3.4/Products/"

2. Распаковать содержимое каталог CMFNauTools из обновленного дистрибутива в папку ".../NauDoc-4/Products/"

3. Распаковать содержимое архива LDAPUserFolder.zip (.tar.gz для linux) в папку ".../NauDoc-4/Products/"

4. Перезапустить Zope

5. Зайти в NauDoc администратором и следовать инструкциям сценария миграции данных

6. Обратиться в службу поддержки NauDoc за новым лицензионным ключом.

Для Windows:

1. Сохраните копию файла данных NauDoc-4/var/Data.fs

2. Деинсталлируйте NauDoc

3. Установите новую версию с дистрибутива

4. Остановите службу Zope

5. Замените файл данных Data.fs на ранее сохраненный

6. Запустите службу Zope

7. Зайти в NauDoc администратором и следовать инструкциям сценария миграции данных

Примечание! Пользователям NauDoc Pro Corporate и NauDoc Pro Enterprise необходимо обратиться в службу технической поддержки для получения дополнительных инструкций.

Documents

Руководство технолога NauDoc - CRM74crm74.ru/uploads/soft-naudoc/install_naudoc.pdf · Руководство по установке naudoc Оглавление