Агенты

Эта инструкция описывает порядок установки агентов подсистемы топологии.

Установка

Чтобы установить агенты подсистемы топологии:

  1. Загрузите архив genome-2.0.0.tar.gz на установочный узел.

  2. Распакуйте архив:

    tar -xvzf genome-2.0.0.tar.gz
  3. Сделайте файл установщика исполняемым:

    chmod +x genome-2.0.0.run
  4. Запустите установщик платформы:

    ./genome-2.2.0.run
  5. В меню установщика выберите действие Установка зависимостей. Дождитесь выполнения операции.

  6. В меню установщика выберите действие Выход.

  7. Перейдите в директорию distrib/:

    cd ./distrib/
    Далее пути к файлам указываются относительно директории distrib/, если явно не указано иное.
  8. Скопируйте файл foliage-config-example.yml в foliage-config.yml:

    cp foliage-config-example.yml foliage-config.yml
  9. Внесите изменения в файл foliage-config.yml:

    • foliage_agent_nats_login: имя пользователя для подключения к серверу NATS;

    • foliage_agent_nats_password: пароль для подключения к серверу NATS;

    • foliage_agent_nats_port: порт, который слушает сервер NATS;

    • foliage_agent_nats_hub_domain: название пространства (REALM) в IAM;

    • foliage_agent_nats_host: IP-адрес сервера подсистемы топологии;

    • foliage_agent_skalar_home_path: директория установки;

    • foliage_agent_systemd_path: путь к директории с конфигурацией systemd.

    Пример заполнения
    ---
    foliage_agent_nats_login: "foliage_agent"
    foliage_agent_nats_password: "p@sS*******0rD"
    foliage_agent_nats_port: 4223
    foliage_agent_nats_hub_domain: GENOME
    foliage_agent_nats_host: <topology_server>
    foliage_agent_scalar_home_path: /opt/skala-r
    foliage_agent_systemd_path: /etc/systemd/system
    # ...
  10. Создайте файл инвентаря Ansible foliage-inventory.ini и заполните его по образцу:

    [all:vars]
    ansible_python_interpreter=/usr/bin/python3
    
    [foliage_agents]
    <agent_node_1_ip> ansible_user=root ansible_password=<pass>
    <agent_node_2_ip> ansible_user=root ansible_password=<pass>
    # ...
    <agent_node_N_ip> ansible_user=root ansible_password=<pass>

    Здесь:

    • <agent_node_*_ip> — IP-адрес узла для установки на него агента подсистемы топологии;

    • <pass> — пароль пользователя root.

  11. Удалите ранее установленные агенты:

    ansible-playbook foliage-agent.yml \
      -i foliage-inventory.ini \
      -e @foliage-config.yml \
      --tags foliage_agent_uninstall
  12. Установите агенты:

    ansible-playbook foliage-agent.yml \
      -i foliage-inventory.ini \
      -e @foliage-config.yml \
      --tags foliage_agent_install

Проверка корректности

Проверьте корректность развёртывания агентов топологии:

  • Убедитесь, что на всех узлах, указанных в инвентаре Ansible, служба агента топологии активна и запущена:

    systemctl status foliage_agent
  • Убедитесь, что установленные агенты зарегистрированы в подсистеме топологии и отображаются в NATS или веб-интерфейсе подсистемы топологии.