1. Підготуйте комп’ютер або сервер

UBC Data Bridge Agent працює у Linux та підключає локальні файли, бази даних і внутрішні API до ваших потоків. Виберіть комп’ютер або сервер, який має доступ до потрібних ресурсів і залишається ввімкненим під час обміну.

Перед встановленням погодьте з адміністратором дистрибутив, його версію й архітектуру процесора. Отримайте пакет Agent, призначений саме для цього середовища, та інструкцію до нього. Назва пакета, спосіб встановлення й керування службою залежать від поставки.

Перевірте правильність системного часу, доступ до адреси Data Bridge через вихідне HTTPS-з’єднання та налаштування корпоративного проксі, якщо він використовується. Для служби виділіть окремий обліковий запис з потрібними правами.

2. Встановіть і запустіть службу

Отримайте пакет і контрольну суму від адміністратора Data Bridge. Перевірте походження та цілісність файлу. Встановіть Agent за інструкцією до пакета з правами адміністратора Linux.

Увімкніть автоматичний запуск служби під час завантаження системи. Перевірте, що вона працює від призначеного облікового запису й може читати власні налаштування, сертифікати та журнал. Зафіксуйте фактичну назву служби й розташування цих файлів для подальшого обслуговування.

3. Підключіть Agent до Data Bridge

У Data Bridge відкрийте налаштування Agent та створіть реєстраційний ключ. У налаштуваннях установленого агента вкажіть HTTPS-адресу Data Bridge і використайте цей ключ для реєстрації. Не додавайте ключ до журналів, листів або відкритих файлів.

Дочекайтеся стану підключення в Data Bridge. Якщо Agent не з’явився, перевірте адресу сервера, час, проксі, довіру до сертифіката й доступність вихідного з’єднання. Загальну послідовність перевірок наведено в розділі діагностики Agent.

4. Дозвольте потрібні ресурси

Додайте лише ті папки, бази даних і адреси API, з якими працюватимуть потоки. Для папок використовуйте абсолютні шляхи. Надайте службовому обліковому запису право проходу до потрібного каталогу та права читання або запису відповідно до задачі.

Мережеві папки мають бути доступні самій службі, а не лише у вашому особистому сеансі. Адміністратор налаштовує їх постійне підключення до Linux і перевіряє доступ після перезавантаження. Врахуйте правила SELinux або AppArmor, якщо вони ввімкнені: дозвіл у Data Bridge не замінює дозволів операційної системи.

Окремо задайте правила Agent: дозволені папки, назви файлів, адреси, порти й операції. Для процесу, який лише читає дані, не надавайте права видалення або перезапису. Докладніше — ресурси та права Agent.

5. Перевірте обмін

  1. Переконайтеся, що Data Bridge показує Agent як підключений.
  2. Перевірте доступ до кожного дозволеного ресурсу від імені служби.
  3. У потрібному підключенні Data Bridge виберіть доступ через Agent.
  4. Прочитайте невеликий тестовий файл або набір даних і перегляньте результат.
  5. Якщо потрібен запис, виконайте погоджений тест у спеціальній папці або тестовій системі.
  6. Перезапустіть службу та перевірте, що з’єднання й доступ до ресурсів відновилися.

6. Оновлюйте й контролюйте роботу

Плануйте оновлення у погоджений час. Перед зміною пакета збережіть налаштування за правилами вашої організації; секрети мають залишатися захищеними. Після оновлення перевірте реєстрацію, ресурси та один тестовий запуск.

Для розбору помилки зберіть час події, назву Agent, версію Linux, стан служби й потрібний фрагмент журналу. Не передавайте реєстраційні ключі, паролі та файли із секретами. Якщо агент більше не використовується, відкличте його доступ у Data Bridge та видаліть локальні дозволи.