Обновление предыдущих версий LogAnalyzer

Чтобы установить LogAnalyzer версии 4.2 поверх версии 4.0.х, выполните шаги предварительной подготовки, а затем выполните обновление.

Предварительная подготовка

1. Создайте резервную копию Ядра LogAnalyzer. При необходимости вы сможете восстановить данные из резервной копии для версии 4.0.х.

   Резервные копии LogAnalyzer, созданные в версии 4.0.х и ниже, не подлежат восстановлению в версии 4.2. Это означает, что невозможно установить LogAnalyzer 4.2 и восстановить в ней резервную копию 4.0.х.

   Сразу после обновления LogAnalyzer до версии 4.2 создайте резервную копию.

2. Убедитесь, что соблюдены все требования к установке программы.
3. Убедитесь, что имя хоста Ядра LogAnalyzer не начинается с цифры. Обновление до версии 4.2 не может быть выполнено успешно, если имя хоста Ядра LogAnalyzer начинается с цифры. Если имя хоста Ядра LogAnalyzer начинается с цифры, потребуется ряд мероприятий, чтобы успешно выполнить обновление. Обратитесь в техническую поддержку за дополнительными инструкциями.
4. На время установки или обновления обеспечьте сетевую доступность  порта 7220 TCP на Ядре LogAnalyzer с хостов хранилищ LogAnalyzer.
5. Проверьте количество и актуальность источников событий, для которых отображается красный статус, в разделе Состояние источников → Список источников событий и для неактуальных источников событий выполните одно из следующих действий:
   • удалите неактуальные источники событий;
   • измените параметры политик мониторинга, примененных к неактуальным источникам событий, так, чтобы они соответствовали актуальному потоку событий;
   • для политик мониторинга, примененных к неактуальным источникам событий, отключите рассылку уведомлений.

   После обновления LogAnalyzer для всех источников событий с красным статусом, для которых настроена отправка уведомлений о срабатывании политики, будут отправлены уведомления на указанные адреса электронной почты.

Обновление LogAnalyzer

В зависимости от используемой схемы развертывания LogAnalyzer выполните следующие действия:

• Используйте подготовленный файл инвентаря distributed.inventory.yml и следуйте инструкции по распределенной установке программы. В файле инвентаря в секции kuma_metrics необходимо указать хост, на котором запущен активный сервис Метрики. При запуске обновления выполняется проверка и если сервис Метрики на этом хосте не найден, вернется ошибка и обновление прервется.
• Используйте подготовленный файл инвентаря k0s.inventory.yml и следуйте инструкции по распределенной установке в отказоустойчивой конфигурации с Ядром LogAnalyzer в кластере Kubernetes. В файле инвентаря в секции kuma_metrics необходимо указать хост, на котором запущен активный сервис Метрики. При запуске обновления выполняется проверка и если сервис Метрики на этом хосте не найден, вернется ошибка и обновление прервется.

  Если файл инвентаря для действующей версии недоступен, воспользуйтесь шаблоном файла инвентаря в поставке и заполните соответствующие параметры. Чтобы посмотреть список хостов и роли хостов в действующей системе LogAnalyzer, в веб-интерфейсе перейдите в раздел Ресурсы - Активные сервисы.

Процесс обновления полностью повторяет процесс установки.

Вы можете изменить тип установки следующим образом:

• Если вы хотите выполнить обновление с распределенной установки до установки с Ядром LogAnalyzer в кластере Kubernetes, выполните обновление распределенной установки до последней версии, а затем выполните Перенос Ядра в кластер Kubernetes. Для дальнейшего обновления используйте файл инвентаря k0s.inventory.yml с параметром need_transfer: false, поскольку перенос Ядра LogAnalyzer в кластер Kubernetes уже выполнен и больше не требуется.

  Чтобы перенести Ядро LogAnalyzer в новый кластер Kubernetes, выполните следующие шаги:

  1. Подготовьте файл инвентаря k0s.inventory.yml.

     В файле инвентаря k0s.inventory.yml в разделах kuma_core, kuma_ collector, kuma_correlator, kuma_storage укажите те же хосты, которые использовались при обновлении KUMA с версии 2.1.3 до версии 3.0.3, и затем до версии 3.2, или при новой установке программы. В файле инвентаря необходимо присвоить параметрам deploy_to_k8s и need_transfer значение true. Параметру deploy_example_services необходимо присвоить значение false.

  2. Выполните шаги распределенной установки с использованием подготовленного файла инвентаря k0s.inventory.yml.

  Процесс переноса Ядра LogAnalyzer в новый кластер Kubernetes

  При запуске установщика с файлом инвентаря производится поиск установленного Ядра LogAnalyzer на всех хостах, на которых планируется размещать рабочие узлы кластера. Найденное Ядро будет перенесено с хоста внутрь создаваемого кластера Kubernetes.

  Устранение ошибки невозможности переноса Ядра LogAnalyzer

  Перенос Ядра LogAnalyzer с хоста в новый кластер Kubernetes может прерываться из-за превышения времени ожидания на шаге Deploy Core transfer job. После этого в журнале задач переноса core-transfer появится следующая запись об ошибке:

  cp: can't stat '/mnt/kuma-source/core/.lic': No such file or directory

  Чтобы предотвратить появление ошибки до начала переноса Ядра LogAnalyzer:

  1. Перейдите в папку с распакованным установщиком и откройте файл roles/k0s_prepare/templates/core-transfer-job.yaml.j2 для изменения.
  2. В файле core-transfer-job.yaml.j2 найдите следующие строки:

     cp /mnt/kuma-source/core/.lic {{ core_k0s_home }}/ &&

     cp /mnt/kuma-source/core/.tenantsEPS {{ core_k0s_home }}/ &&

  3. Измените эти строки следующим образом с сохранением отступов, задающихся пробелами:

     cp /mnt/kuma-source/core/{{ core_uid }}/.lic {{ core_k0s_home }}/ &&

     cp /mnt/kuma-source/core/{{ core_uid }}/.tenantsEPS {{ core_k0s_home }}/ &&

  4. Сохраните изменения в файле.

  После этого вы можете повторно запустить распределенную установку с использованием подготовленного файла инвентаря k0s.inventory.yml. Перенос Ядра LogAnalyzer с хоста в новый кластер Kubernetes будет выполнен успешно.

  Если вы начали перенос Ядра LogAnalyzer с хоста в новый кластер Kubernetes и он завершился с ошибкой, вам нужно выполнить шаги ниже, чтобы исправить ошибку.

  Чтобы исправить ошибку после попытки переноса Ядра LogAnalyzer с хоста в новый кластер Kubernetes:

  1. На любом контроллере кластера удалите объект Ingress, выполнив следующую команду:

     sudo k0s kubectl delete daemonset/ingress -n ingress

  2. Проверьте, существует ли задача переноса в кластере:

     sudo k0s kubectl get jobs -n kuma

  3. Если задача переноса существует, удалите ее:

     sudo k0s kubectl delete job core-transfer -n kuma

  4. Перейдите в консоль хоста из группы kuma_core.
  5. Запустите сервисы Ядра LogAnalyzer, выполнив следующие команды:

     sudo systemctl start kuma-mongodb

     sudo systemctl start kuma-core-00000000-0000-0000-0000-000000000000

  6. Убедитесь, что сервис kuma-core-00000000-0000-0000-0000-000000000000 запущен успешно:

     sudo systemctl status kuma-core-00000000-0000-0000-0000-000000000000

  7. Убедитесь, что из группы kuma_core есть доступ в интерфейс KUMA по FQDN хоста.

     Другие хосты при этом могут быть остановлены.

  8. Перейдите в папку с распакованным установщиком и откройте файл roles/k0s_prepare/templates/core-transfer-job.yaml.j2 для изменения.
  9. В файле core-transfer-job.yaml.j2 найдите следующие строки:

     cp /mnt/kuma-source/core/.lic {{ core_k0s_home }}/ &&

     cp /mnt/kuma-source/core/.tenantsEPS {{ core_k0s_home }}/ &&

  10. Измените эти строки следующим образом с сохранением отступов, задающихся пробелами:

      cp /mnt/kuma-source/core/{{ core_uid }}/.lic {{ core_k0s_home }}/ &&

      cp /mnt/kuma-source/core/{{ core_uid }}/.tenantsEPS {{ core_k0s_home }}/ &&

  11. Сохраните изменения в файле.

  После этого вы можете повторно запустить распределенную установку с использованием подготовленного файла инвентаря k0s.inventory.yaml. Перенос Ядра LogAnalyzer с хоста в новый кластер Kubernetes будет выполнен успешно.

  Если на рабочих узлах компонент не обнаружен, то производится чистая установка Ядра LogAnalyzer в кластер без переноса в него ресурсов. Существующие компоненты требуется пересоздать с новым Ядром вручную в веб-интерфейсе LogAnalyzer.

  Для коллекторов и хранилищ из файла инвентаря будут заново выпущены сертификаты для связи с Ядром внутри кластера. URL Ядра для компонентов при этом не изменится.

  На хосте с Ядром установщик выполняет следующие действия:

  • Удаляет с хоста systemd-сервисы: kuma-core, kuma-mongodb, kuma-victoria-metrics, kuma-vmalert, kuma-grafana.
  • Удаляет internal сертификат Ядра.
  • Удаляет файлы сертификатов всех прочих компонентов и удаляет записи о них из MongoDB.
  • Удаляет директории:
    • /opt/kaspersky/kuma/core/bin
    • /opt/kaspersky/kuma/core/certificates
    • /opt/kaspersky/kuma/core/<идентификатор сервиса Ядра KUMA>/log
    • /opt/kaspersky/kuma/core/<идентификатор сервиса Ядра KUMA>/logs
    • /opt/kaspersky/kuma/metrics/<идентификатор сервиса Метрики>/bin
  • Переносит данные Ядра и ее зависимостей на сетевой диск внутри кластера Kubernetes.
  • На хосте с Ядром переносит директории:
    • /opt/kaspersky/kuma/core → /opt/kaspersky/kuma/core.moved
    • /opt/kaspersky/kuma/metrics → /opt/kaspersky/kuma/metrics.moved

  После проверки корректности переноса Ядра в кластер данные директории можно удалить.

  В случае возникновения проблем с переносом нужно проанализировать в журнале записи задачи переноса core-transfer в пространстве имен kuma на кластере (задача доступна в течение 1 часа после переноса).

  При необходимости повторного переноса необходимо привести названия директорий /opt/kaspersky/kuma/*.moved к их исходному виду.

  Если на хосте с Ядром использовался файл /etc/hosts со строками, не относящимися к адресам 127.X.X.X, при переносе Ядра в кластер Kubernetes содержимое файла /etc/hosts с хоста с Ядром заносится в ConfigMap coredns. Если переноса Ядра не происходит, в ConfigMap заносится содержимое /etc/hosts с хоста, на котором разворачивается главный контроллер.

• Если вы хотите обновить LogAnalyzer в распределенной установке до последней версии LogAnalyzer с Ядром в кластере Raft, в файле инвентаря distributed.inventory.yml необходимо вручную добавить группу kuma_core_peers и указать в этой группе четное количество серверов, где вы планируете установить дополнительные сервисы Ядра LogAnalyzer. Также в группе kuma_core и kuma_core_peers вы можете указать параметр raft_node_addr в формате <FQDN сервера из группы kuma_core, на котором установлено Ядро KUMA>:<порт>, если у сервера есть несколько разных FQDN. Указанный в параметре raft_node_addr FQDN будет использоваться для прослушивания сигналов от других узлов.

  После запуска установщика с подготовленным файлом инвентаря никакие дополнительные сервисы Ядра LogAnalyzer не устанавливаются на серверах автоматически. Установщик только готовит указанные в файле инвентаря серверы к установке сервисов. После завершения работы установщика автоматически установлен только один сервис Ядра LogAnalyzer на сервере указанном в группе kuma_core. После завершения работы установщика вам необходимо вручную создать сервисы Ядра LogAnalyzer в веб-интерфейсе и последовательно установить сервис Ядра LogAnalyzer с уникальным идентификатором на каждом сервере, указанном в группе kuma_core_peers.

  После обновления все существующие сервисы LogAnalyzer будут подключены к Ядру LogAnalyzer на сервере из группы kuma_core. При дальнейшей установке новых сервисов вы можете указать несколько URL через запятую в команде установки, чтобы подключить сервисы к Ядрам LogAnalyzer в кластере Raft.

Финальный этап подготовки LogAnalyzer к работе

1. После обновления LogAnalyzer очистите кеш браузера.
2. Если вы используете агенты, вручную обновите агенты LogAnalyzer.
3. Для распределенной установки в отказоустойчивой конфигурации с Ядром LogAnalyzer в кластере Kubernetes выполните обновление компонентов кластера.

Обновление LogAnalyzer успешно выполнено.

Известные ограничения

1. Для действующих пользователей при обновлении с 4.0.х до 4.2 не выполняется обновление универсального макета панели мониторинга.

   Возможное решение: перезапустите сервис Ядра kuma-core-<идентификатор сервиса Ядра KUMA>.service - данные будут обновляться с заданным для панели мониторинга интервалом.