1. Подготовьте компьютер или сервер
UBC Data Bridge Agent работает в Linux и подключает локальные файлы, базы данных и внутренние API — интерфейсы программного обмена — к вашим потокам. Выберите компьютер или сервер с доступом к нужным ресурсам, который остаётся включённым во время обмена данными.
До установки согласуйте с администратором дистрибутив Linux, версию и архитектуру процессора. Получите пакет Agent и инструкции установки для этой среды. Имена пакетов, шаги установки и команды управления службой зависят от поставленного пакета.
Проверьте системные часы, исходящий HTTPS-доступ к Data Bridge и настройки корпоративного прокси, если он используется. Назначьте отдельную учётную запись службы с необходимыми правами.
2. Установите и запустите службу
Получите пакет и его контрольную сумму у администратора Data Bridge. Проверьте происхождение и целостность файла. Установите Agent с правами администратора Linux по инструкциям, приложенным к пакету.
Включите автоматический запуск при загрузке системы. Проверьте, что служба работает от назначенной учётной записи и может читать свои настройки, сертификаты и журнал. Запишите фактическое имя службы и расположение файлов для обслуживания.
3. Подключите Agent к Data Bridge
Откройте настройки Agent в Data Bridge и создайте ключ регистрации. В настройках установленного Agent введите HTTPS-адрес Data Bridge и зарегистрируйтесь с этим ключом. Не помещайте ключ в журналы, письма и общие файлы.
Дождитесь появления подключения в Data Bridge. Если Agent не появился, проверьте адрес сервера, часы, прокси, доверие сертификату и исходящее соединение. Общие проверки приведены в разделе Устранение неполадок Agent.
4. Разрешите нужные ресурсы
Добавьте только папки, базы данных и адреса API, нужные потокам. Используйте абсолютные пути папок. Предоставьте учётной записи службы доступ к каталогу и права чтения или записи файлов по необходимости.
Сетевые папки должны быть доступны самой службе, а не только вашей личной сессии. Администратор должен настроить постоянное подключение и проверить доступ после перезагрузки. Если включены SELinux или AppArmor, проверьте их правила: доступ Data Bridge не заменяет права операционной системы.
Отдельно задайте правила Agent: разрешённые папки, имена файлов, адреса, порты и операции. Процессу, который только читает отчёты, не нужны права удаления или перезаписи файлов. См. Ресурсы и права Agent.
5. Проверьте подключение и обмен данными
- Убедитесь, что Data Bridge показывает Agent подключённым.
- Проверьте каждый разрешённый ресурс от имени учётной записи службы.
- Выберите доступ через Agent в соответствующем подключении Data Bridge.
- Прочитайте небольшой тестовый файл или набор данных и проверьте результат.
- Если нужна запись, выполните согласованный тест в отдельной папке или тестовой системе.
- Перезапустите службу и убедитесь, что подключение и доступ к ресурсам восстановились.
6. Обслуживание и обновление Agent
Планируйте обновления на согласованное окно обслуживания. Перед изменением пакета сохраните резервную копию настроек по правилам организации, защищая секреты. После обновления проверьте регистрацию, ресурсы и тестовый запуск.
Для разбора ошибки соберите время, имя Agent, версию Linux, состояние службы и соответствующий фрагмент журнала. Не передавайте ключи регистрации, пароли и секретные файлы. Когда Agent больше не нужен, отзовите его доступ в Data Bridge и удалите локальные разрешения.