База знаний VMmanager
Режим фокусировки

После обновления до версии 2026.02.2 и выше платформа не работает

Проблема

После обновления платформы до версии 2026.02.2 и выше перестала работать платформа.

Причина

Начиная с версии 2026.02.2 изменилась архитектура платформы — добавлен контейнер vm_back. Поэтому шаблоны конфигураций некоторых сервисов были перенесены из контейнера vm_box в новый контейнер vm_back. Например, шаблон настройки ip-fabric. Проблема возникает из-за кастомных патчей (YAML-файлов), которые продолжают ссылаться на контейнер vm_box. Подробнее о патчах см. в статье Модификация контейнеров через патчи.

Диагностика

Чтобы подтвердить причину проблемы:

  1. Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
  2. Проверьте наличие кастомных патчей:
    1. Откройте конфигурационный файл платформы:
      cat /opt/ispsystem/vm/config.json
    2. Изучите секцию Patches. В ней указаны все патчи, включая кастомные.

      Пример вывода
      "Patches":{"channelp":{"base64_compose":"c2VydmljZXM6CiAgdm1fYm94OgogICAgZVfVElNRU9VVDogMC4zCg=="}

      Примеры названий системных патчей:

      • для модуля «Интеграция с DNSmanager 6» — vmdnsmgr;
      • для модуля «Интеграция с IPmanager 6» — vmipmgr.
  3. Проверьте содержимое кастомного патча:
    1. Откройте файл патча.
    2. Проверьте секцию services. Признак проблемы: в секции services указан контейнер vm_box.
      Пример секции services с vm_box
      services:
        vm_box:
  4. Проверьте функциональность патча. Например, проблема подтверждается, если наблюдаются следующие события:
    • патч редактирует файл в контейнере vm_box, но этого файла в контейнере больше нет;
    • патч копирует файл в контейнер vm_box, но файл перестал копироваться.

Решение

Чтобы решить проблему, замените в кастомном патче контейнер vm_box на vm_back:

  1. Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
  2. Отключите целевой патч:
    vm remove-patch -p=<patch_name>

    Пояснения к команде:

    • <patch_name> — уникальное имя патча.
  3. Отредактируйте файл патча: замените vm_box на vm_back.
    Пример патча после изменений
    version: "3.5"
    services:
      vm_back:
        command:
          - bash
          - -c
  4. Подключите новый патч:
    vm add-patch -p=<patch_name> -f=</path/to/patch.yaml>

    Пояснения к команде:

    • <patch_name> — уникальное имя патча;
    • </path/to/patch.yaml> — путь к файлу с содержимым патча.
  5. Если кастомных патчей несколько, повторите инструкцию для каждого патча.
  6. Проверьте работоспособность платформы.
Может быть полезно