Для установки решения «Встроенный редактор» используется инструмент Directum Launcher.

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

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

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

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

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

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

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

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

1.Архив с Directum Launcher распакуйте в локальную папку на сервере. В корень папки скопируйте архивы Platform.tar.gz, DirectumRX.tar.gz и другие, включая rxmd.tar.gz. Подробнее см. раздел «Серверная часть Directum RX».

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

2.Запустите Directum Launcher с помощью команды:

./DirectumLauncher --host=0.0.0.0

В командной строке появится адрес страницы с параметрами установки и обновления. Откройте его в браузере на компьютере с графической оболочкой, дальнейшие действия выполняйте там. Если команда выполняется на компьютере с графической оболочкой, то страница сразу откроется в браузере.

Страницу можно открыть вручную по ссылке http://<IP-адрес сервера, где выполняется установка>:5000/, например, если случайно закрыли браузер. По умолчанию используется порт 5000. Порт можно изменить, добавив к команде ключ -‑port=<номер порта>.

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

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

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

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

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

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

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

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

Если в компании используется решение «Интеграция с онлайн-редакторами ONLYOFFICE и Р7-Офис», проверьте его настройки. Для этого:

1.Запустите Directum Launcher. Подробнее см. раздел «Настройка через Directum Launcher».

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

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

4.Во встроенном редакторе YAML проверьте, что параметры ENABLED_WEB_EDITORS и ENABLE_COLLABORATIVE_EDITING заданы в секции common_config.

Если параметры отсутствуют, перенесите их из секции SungeroWebServer. Это необходимо для корректной работы решения.

Чтобы установить решение «Встроенный редактор»:

1.В корень локальной папки с Directum Launcher скопируйте архив c компонентом rxmd.tar.gz.

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

2.Убедитесь, что в папке с Directum Launcher есть компоненты Platform.tar.gz и DirectumRX.tar.gz. Подробнее см. раздел «Серверная часть Directum RX».

3.Запустите Directum Launcher с помощью команды:

./DirectumLauncher --host=0.0.0.0

В командной строке появится адрес страницы с параметрами установки и обновления. Откройте его в браузере на компьютере с графической оболочкой, дальнейшие действия выполняйте там. Если команда выполняется на компьютере с графической оболочкой, то страница сразу откроется в браузере.

Страницу можно открыть вручную по ссылке http://<IP-адрес сервера, где выполняется установка>:5000/, например, если случайно закрыли браузер. По умолчанию используется порт 5000. Порт можно изменить, добавив к команде ключ -‑port=<номер порта>.

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

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

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

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

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

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

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

1.Из комплекта поставки в корень папки с Directum Launcher скопируйте архив с решением rxmd.tar.gz и убедитесь, что в папке есть компоненты Platform.tar.gz и Directum RX.tar.gz.

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

2.Если нужно, выполните шаги по установке компонентов Directum RX. Подробнее см. раздел «Установка с помощью командной строки».

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

./do.sh components add rxmd

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

./do.sh rxmd install

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

./do.sh webclient up
./do.sh webserver up

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

./do.sh rxmd import_templates

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

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

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

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

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

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

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

1.Запустите Directum Launcher. Подробнее см. раздел «Настройка через Directum Launcher».

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.

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

RD_WEB_CUSTOM_SCHEME: 'http'

RD_WEB_CUSTOM_HOST: 'rx.company.ru'

RD_WEB_CUSTOM_HOST: 'rx.company.ru'

RD_WEB_CUSTOM_PORT: '4332'

Подробнее см. раздел «Общие настройки».

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

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

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

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

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

./do.sh integrationservice up

СМ. ТАКЖЕ