Прикладные модули > База знаний > Локальная установка решения

Для установки решения «База знаний» используется инструмент Directum Launcher. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Установка системы (Directum Launcher)» (Windows, Linux).

Чтобы установить решение:

1.Ознакомьтесь с типовыми требованиями и убедитесь, что ваше аппаратное и программное обеспечение подходит для установки решения.

2.Выберите вариант установки:

•вместе с серверной частью Directum RX;

•дополнительно к Directum RX, если система была развернута ранее. Также возможна установка с помощью командной строки.

3.После установки настройте интеграцию с Directum RX.

ВАЖНО. Компонент memo зависит от компонента DirectumRX. Их версии должны быть совместимы. Если зависимый компонент нужной версии не найден в папке с Directum Launcher, то при запуске инструмента установки возникнет ошибка. Проверьте, что все нужные архивы есть в папке.

Порядок установки решения «База знаний» в операционных системах Microsoft Windows и Linux совпадает. При этом расширение архивов и синтаксис команд отличается в зависимости от операционной системы.

Пример команды:

do <команда>

./do.sh <команда>

Далее в разделе приведен порядок установки на Windows.

Установка вместе с Directum RX

1.Архив с Directum Launcher распакуйте в локальную папку на сервере. В корень папки скопируйте архивы Platform.zip, DirectumRX.zip и другие, включая memo.zip. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

ВАЖНО. Для корректной установки общий путь к файлам должен быть не более 256 символов. Также он не должен содержать пробелы, символы кириллицы, запятые и спецсимволы. Поэтому используйте, например, папку D:\DirectumLauncher.

2.От имени администратора запустите файл DirectumLauncher.exe. Откроется командная строка, в ней запустится сервис развертывания, в браузере откроется страница с параметрами установки и обновления. До окончания установки не закрывайте окно командной строки.

Страницу можно открыть вручную по ссылке http://127.0.0.1:5000/, например, если случайно закрыли браузер или он не настроен по умолчанию.

Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

3.На странице Развертывание убедитесь, что установлен переключатель Установка.

4.Укажите настройки сервисов Directum RX и остальных компонентов. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

5.Убедитесь, что установлены флажки memo и Импортировать шаблоны документов решения «База знаний».

6.Ознакомьтесь с текстом лицензионного соглашения и установите флажок Я принимаю условия лицензионного соглашения.

7.Нажмите на кнопку Установить и дождитесь окончания установки.

8.Настройте интеграцию с Directum RX.

9.Запросите и активируйте ключи лицензии, чтобы использовать возможности решения.

Установка дополнительно к Directum RX

1.Из дистрибутива Directum RX в корень папки Directum Launcher скопируйте архив memo.zip

2.Убедитесь, что в папке с Directum Launcher есть компоненты Platform.zip и DirectumRX.zip. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

3.От имени администратора запустите файл DirectumLauncher.exe. Откроется командная строка, в ней запустится сервис развертывания, в браузере откроется страница с параметрами установки и обновления. До окончания установки не закрывайте окно командной строки.

Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

4.На странице Развертывание убедитесь, что установлен переключатель Обновление.

5.Убедитесь, что установлены флажки memo и Импортировать шаблоны документов решения «База знаний», а другие сняты.

7.Нажмите на кнопку Обновить и дождитесь окончания установки.

8.Настройте интеграцию с Directum RX.

9.Запросите и активируйте ключи лицензии, чтобы использовать возможности решения.

Установка с помощью командной строки

1.Из комплекта поставки в корень папки с Directum Launcher скопируйте архив с решением memo.zip.

3.Добавьте компонент решения. Для этого выполните команду:

do components add memo

4.Установите решение. Для этого выполните команду:

do memo install

5.Дождитесь окончания установки и перезапустите веб-клиент. Для этого выполните команду:

do webclient up

6.Импортируйте шаблон документа решения. Для этого выполните команду:

do memo import_templates

7.Настройте интеграцию с Directum RX.

8.Запросите и активируйте ключи лицензии, чтобы использовать возможности решения.

Настройка интеграции с Directum RX

При установке решения «База знаний» задаются минимально необходимые настройки. Их можно изменить:

•во встроенном редакторе YAML (рекомендуется). Подробнее см. в документации Directum RX в руководстве администратора, раздел «Встроенный редактор YAML» (Windows, Linux);

•в конфигурационном файле config.yml.

Убедитесь, что для сервисов Directum RX заданы настройки интеграции. Для этого:

1.Запустите Directum Launcher. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Настройка через Directum Launcher» (Windows, Linux).

2.Убедитесь, что на открывшейся странице установлен переключатель Настройка.

3.Измените положение переключателя Визуальный режим конфигурирования. В результате во встроенном редакторе YAML отображается содержимое файла config.yml.

4.Сравните адрес обработчика гиперссылок, который указан в параметре HYPERLINK_SERVER, с адресом веб-клиента Directum RX. Если они совпадают, перейдите к следующему пункту настройки. Иначе в секции common_config добавьте параметры:

•RD_WEB_CUSTOM_SCHEME, если в адресах отличаются протоколы. При работе системы Directum RX по протоколу HTTP в параметре укажите значение http, а при работе по протоколу HTTPS добавлять параметр необязательно;

•RD_WEB_CUSTOM_HOST, если в адресах отличаются хосты. В параметре укажите хост системы Directum RX. Например, если адрес веб-клиента https://rx.company.ru/ClientWeb, укажите значение rx.company.ru.

•RD_WEB_CUSTOM_PORT, если в адресах отличаются хосты и для работы с системой используется нестандартный порт. В параметре укажите значение этого порта. По умолчанию для работы по протоколу HTTPS используется стандартный порт 443, по протоколу HTTP – 80.

Примеры настройки

Пример 1:

•адрес веб-клиента – https://rx.company.ru/ClientWeb;

•адрес обработчика гиперссылок – http://rx.company.ru:4332/.

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

Пример 2:

•адрес веб-клиента – http://rx.company.ru/ClientWeb;

•адрес обработчика гиперссылок – https://hyperlinks.rx.company.ru:4332/.

В этом случае в секцию common_config добавьте параметры:

RD_WEB_CUSTOM_SCHEME: 'http'
RD_WEB_CUSTOM_HOST: 'rx.company.ru'

Пример 3:

•адрес веб-клиента – https://rx.company.ru:4332/ClientWeb;

•адрес обработчика гиперссылок – https://hyperlinks.rx.company.ru/.

В этом случае в секцию common_config добавьте параметры:

RD_WEB_CUSTOM_HOST: 'rx.company.ru'
RD_WEB_CUSTOM_PORT: '4332'

Подробнее см. в документации Directum RX в руководстве администратора, раздел «Общие настройки» (Windows, Linux).

5.Убедитесь, что в секции сервиса интеграции IntegrationService для параметра AUTH_COOKIE_SCHEME_ENABLED установлено значение true. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Сервис интеграции» (Windows, Linux).

6.Если ранее обновляли систему Directum RX с версии 4.0 или 4.1, в секции сервиса интеграции IntegrationService в параметре INTEGRATION_SERVICE_RELATIVE_PATH проверьте, что верно указан адрес сервиса интеграции. Если параметр не задан, то используется значение по умолчанию Integration.

Убедитесь, что этот же адрес указан в конфигурационном файле решения DirectumLauncher\etc\_builds\memo\client\config.js в параметре INTEGRATION_SERVICE_PATH. Значение параметра указывается в формате /<Адрес сервиса интеграции>/odata.

При необходимости измените значение параметра в файле config.js и сохраните изменения.

7.Чтобы применить изменения, перезапустите сервис интеграции Directum RX с помощью команды:

do integrationservice up

СМ. ТАКЖЕ