Сервис NOMAD обеспечивает взаимодействие мобильных приложений Directum Solo и Directum Jazz с системой Directum RX: предоставляет приложениям доступ к данным системы и обрабатывает запросы от приложений.
Чтобы начать работу с мобильными решениями:
1.Ознакомьтесь с типовыми требованиями и убедитесь, что ваше аппаратное и программное обеспечение подходит для установки сервиса NOMAD.
2.Выберите вариант установки:
•вместе с серверной частью Directum RX;
•дополнительно к Directum RX, если система была развернута ранее. Также возможна установка с помощью командной строки.
3.После установки выполните завершающие работы. Если нужно дополнительно распределить нагрузку на сервера компании:
•перенесите сервис NOMAD на выделенный сервер;
•настройте сервис NOMAD в ферме серверов.
Установка вместе с Directum RX
Установку сервиса NOMAD нужно выполнять под учетной записью пользователя, от имени которого запущена служба Docker. Если используется учетная запись без привилегий суперпользователя, то выдайте пользователю полные права на папку с Directum Launcher и вложенные в нее папки и файлы. Для дополнительной безопасности можно настроить запуск службы внутри контейнера от учетной записи без привилегий суперпользователя. Подробнее см. в разделе «Запуск контейнеров без привилегий суперпользователя».
1.В корень локальной папки с Directum Launcher скопируйте архивы:
•Nomad.tar.gz –сервис NOMAD;
•DockerImages.tar.gz – базовые docker-образы, если на сервере отсутствует доступ к сети Интернет.
ВАЖНО. Для корректной установки общий путь к файлам должен быть не более 256 символов. Также он не должен содержать пробелы, символы кириллицы, запятые и спецсимволы. Поэтому используйте, например, папку /srv/DirectumLauncher.
2.Запустите Directum Launcher. Способ запуска зависит от используемого дистрибутива Linux.
3.На странице Развертывание убедитесь, что установлен переключатель Установка.
4.Укажите настройки веб-сервера Directum RX и остальных компонентов, устанавливаемых вместе с системой. Подробнее см. раздел «Серверная часть Directum RX».
5.Если в организации используются собственные docker-образы, последовательно выполните действия:
•откройте страницу Настройка и перейдите в режим редактирования YAML;
•из конфигурационного файла full_config.yml.example скопируйте секцию с настройками сервиса NOMAD (NomadService). Путь до файла: DirectumLauncher/etc/full_config.yml.example;
•во встроенном редакторе YAML в секцию NomadService добавьте параметр docker_tag и укажите в нем полное наименование образа. Задайте остальные параметры, если требуется.
Пример настройки в config.yml:
NomadService:
<<: *base
...
docker_tag: 'registry.directum.ru/directum/rx-base:4.0.2-libre'
•сохраните изменения.
6.На странице Развертывание убедитесь, что установлен флажок NOMAD:
7.Ознакомьтесь с текстом лицензионного соглашения и установите флажок Я принимаю условия лицензионного соглашения.
8.Нажмите на кнопку Установить.
В результате установки генерируется конфигурационный файл config.yml. На основе этого файла при развертывании сервиса NOMAD создается XML-файл с его настройками.
После завершения установки на странице браузера появляются ссылки:
•для входа в веб-клиент. Сохраните ссылку и отправьте пользователям;
•на служебную страницу сервиса NOMAD. Перейдите по ссылке, чтобы убедиться, что сервис запустился.
Установка дополнительно к Directum RX
Установку сервиса NOMAD нужно выполнять под учетной записью пользователя, от имени которого запущена служба Docker. Если используется учетная запись без привилегий суперпользователя, то выдайте пользователю полные права на папку с Directum Launcher и вложенные в нее папки и файлы. Для дополнительной безопасности можно настроить запуск службы внутри контейнера от учетной записи без привилегий суперпользователя. Подробнее см. в разделе «Запуск контейнеров без привилегий суперпользователя».
1.В корень локальной папки с Directum Launcher скопируйте архив Nomad.tar.gz.
ВАЖНО. Для корректной установки общий путь к файлам должен быть не более 256 символов. Также он не должен содержать пробелы, символы кириллицы, запятые и спецсимволы. Поэтому используйте, например, папку /srv/DirectumLauncher.
2.Запустите Directum Launcher. Способ запуска зависит от используемого дистрибутива Linux.
3.На странице Развертывание убедитесь, что установлен переключатель Обновление.
4.Проверьте, что поля заполнены верно. Подробнее см. раздел «Серверная часть Directum RX».
5.Убедитесь, что установлен флажок NOMAD.
6.Если в организации используются собственные docker-образы, настройте их использование.
7.Продолжите установку согласно инструкции по установке Directum RX.
В результате установки генерируется конфигурационный файл config.yml. На основе этого файла при развертывании сервиса NOMAD создается XML-файл с его настройками.
После завершения установки на странице браузера появляется ссылка на служебную страницу сервиса NOMAD. Перейдите по ней, чтобы убедиться, что сервис запустился.
Установка с помощью командной строки
Установку сервиса NOMAD нужно выполнять под учетной записью пользователя, от имени которого запущена служба Docker. Если используется учетная запись без привилегий суперпользователя, то выдайте пользователю полные права на папку с Directum Launcher и вложенные в нее папки и файлы. Для дополнительной безопасности можно настроить запуск службы внутри контейнера от учетной записи без привилегий суперпользователя. Подробнее см. в разделе «Запуск контейнеров без привилегий суперпользователя».
Сервис NOMAD можно развернуть с помощью командной строки. Для этого:
1.В корень локальной папки с Directum Launcher скопируйте архив:
•Nomad.tar.gz. – сервис NOMAD;
•DockerImages.tar.gz – базовые docker-образы, если на сервере отсутствует доступ к сети Интернет.
2.Если нужно, выполните шаги по установке компонентов Directum RX. Подробнее см. раздел «Установка с помощью командной строки».
3.Если в организации используются собственные docker-образы, настройте их использование.
4.В папке с Directum Launcher последовательно выполните команды:
./do.sh components add nomad
./do.sh nomad_component install
В результате установки генерируется конфигурационный файл config.yml. На основе этого файла создается XML-файл с настройками для сервиса NOMAD при его развертывании.
После завершения установки:
1.Настройте доступ к приложению Directum Solo, если в организации приобретены лицензии на его использование. Для этого добавьте сотрудников, которые будут работать с мобильным приложением, в предопределенную роль «Пользователи Solo». Подробнее см. разделы «Предопределенные роли» и «Роли».
2.Чтобы сотрудники начали работу в Directum Solo и Directum Jazz, сообщите им адрес для подключения к NOMAD. Формат адреса зависит от настройки сервиса, по умолчанию: https://<адрес сайта>:<порт>/nomad.
© Компания Directum, 2024 |