Руководство по миграции

В этой статье описаны шаги и моменты, которые необходимо учитывать когда обновляется платформа AggreGate с версии 6.3 до 6.4.

Начиная с версии 6.4, встроенная Cassandra больше не поддерживается на платформе Windows. Это связано с тем, что Apache Cassandra 4.0 полностью отказалась от поддержки Windows.

• Развертывания на базе Windows, которые ранее полагались на встроенный экземпляр Cassandra, не запустятся после обновления до версии 6.4.

• Адекватной замены нет; сейчас на Windows нужно использовать внешний экземпляр базы данных.

Используйте Docker Desktop для запуска внешнего экземпляра Cassandra и подключения Платформы к нему.

1. Установите Docker Desktop на хост-компьютере под управлением Windows.

2. Загрузите и запустите поддерживаемый образ Cassandra (Cassandra 4.x).

3. Обновите конфигурацию платформы, указав внешний экземпляр Cassandra (хост, порт, учетные данные).

4. Проверьте доступность перед запуском обновленной платформы.

Окружения на Linux и macOS не затронуты и могут продолжать использовать встроенную Cassandra, если это применимо.

API платформы было обновлено в версии 6.4. Любые пользовательские плагины, скомпилированные для версии 6.3 или более ранних, не являются бинарными совместимыми с версией 6.4 и должны быть перекомпилированы.

• Плагины, скомпилированные на основе API версии 6.3, не загрузятся или будут вести себя непредсказуемо в версии 6.4.

1. Обновите зависимость проекта расширения от API платформы до версии 6.4.

2. Вычислите все ошибки компиляции, вызванные изменениями API.

3. Скомпилируйте артефакты расширения заново.

4. Замените существующие бинарные файлы расширения в вашей среде развертывания на вновь скомпилированные версии.

5. Запустите набор тестов расширения (если доступен) для подтверждения правильного поведения.

Выполните пересборку и проверку расширения в тестовом окружении перед развертыванием в производственной среде.

Несколько плагинов были перемещены из папки context папку в папку device в версии 6.4. К затронутым плагинам относятся, в том числе:

• context-device-servers

• context-http-server

• Если после обновления старые файлы плагинов останутся в context папке после обновления, могут возникнуть конфликты или дублирование регистраций.

После обновления до версии 6.4 вручную удалите затронутые плагины из папки context папки. Новые версии будут загружены автоматически из device папки.

1. Остановите службу платформы.

2. Перейдите в context папку вашей Установки.

3. Удалите устаревшие файлы плагинов (например, context-device-servers, context-http-server, а также любые другие плагины, которые сейчас предоставляются в device).

4. Убедитесь, что соответствующие плагины присутствуют в device папке.

5. Запустите службу платформы и проверьте журналы на предмет успешной инициализации плагинов.

1. Сделайте резервную копию текущей установки, конфигурации и данных версии 6.3.

2. Ознакомьтесь с перечисленными выше изменениями и подготовьтесь к ним.

3. В Windows: разверните внешний экземпляр Cassandra через Docker Desktop и обновите конфигурацию.

4. Пересоберите все пользовательские плагины с учетом API платформы версии 6.4.

5. Остановите службу платформы версии 6.3.

6. Установите или обновите платформу до версии 6.4.

7. Удалите устаревшие плагины из папки context папки.

8. Разверните пересозданные пользовательские плагины.

9. Запустите платформу версии 6.4 и проверьте:

   • Доступность к базе данных

   • Загрузка расширений (как встроенных, так и пользовательских)

   • Функциональность приложения

10. Проследите за журналами и метриками в течение нескольких циклов после обновления.

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

• Была создана резервная копия установки и данных версии 6.3.

• Исходные (непересозданные) плагины по-прежнему доступны.

Настоятельно рекомендуется сначала протестировать миграцию в тестовой среде.

Для получения дополнительной помощи по миграции обратитесь в службу поддержки вашей платформы или ознакомьтесь с официальными заметками к выпуску версии 6.4.

Was this page helpful?

Tell us more

Send

Thank you!