Divarion_D
dbf535bcc5
Fix Markdown-mangling artifacts the free web engine (yandex) produced in the
committed docs/ru, and regenerate the whole tree cleanly (0 fallbacks):
- Sentinel format @@N@@ -> {N}. MT engines are trained to preserve curly
format-string placeholders, so {N} survives code-heavy lines where @@N@@ (and
ZZZ…ZZZ, which also duplicated its Z) were split/moved — e.g. the stray
"@0@@" in the FAQ and "load balancerZ" in the README are gone.
- Possessive: a trailing English `'s` is consumed INTO the masked span and
dropped on restore. Every sentinel format breaks when a bare `'s` sits right
after it, and Russian has no possessive `'s`.
- Validate + retry: after restore, any leftover brace fragment triggers a retry
(the engine is non-deterministic); after a few failures the line stays English
so a broken token is never emitted.
- Glossary += KeyDB, yt-dlp, Ubuntu, iptables, MAGSCAN.
Regenerated docs/ru (37 files, translators/yandex): no residual sentinels,
mkdocs build --strict clean.
8.0 KiB
XC_VM Руководство по миграции
Безопасная миграция с совместимых IPTV-систем с помощью встроенных инструментов миграции XC_VM.
Важное уведомление о переносе
Прочтите это перед началом миграции.
XC_VM миграция переносит только данные. Вся конфигурация намеренно исключена из процесса миграции.
Это включает в себя (но не ограничивается этим):
- Ключи API (например, TMDb)
- Учетные данные внешней службы
- Настройки, зависящие от конкретной среды
- Конфигурация панели и системы
- Время выполнения и состояние потока
Эти значения ** должны быть перенастроены вручную после миграции**.
Это ** дизайнерское решение**, а не ограничение или ошибка. Пропуск переконфигурации приведет к ** прерыванию выборки метаданных, обновлению заголовков потоков и связанных с ними функций **.
Прежде чем Вы начнете
💡 Рекомендация: Выполните миграцию при новой установке XC_VM.
⚠️ Важно: Системные настройки и настройки панели ** НЕ перенесены**. Передаются только данные базы данных, поддерживаемые процессом миграции.
Если вы решите перейти на существующую установку, имейте в виду:
- XC_VM приведет к удалению всех таблиц в основной базе данных, которые соответствуют данным из базы данных миграции.
- Резервное копирование является обязательным. Автоматический откат не предусмотрен.
Этапы миграции
1. Загрузить резервную копию
Загрузите существующую резервную копию базы данных на сервер XC_VM, используя SFTP.
Примерное местоположение:
/tmp/backup.sql
2. Восстановить резервную копию в базе данных миграции
Очистите базу данных миграции и восстановите резервную копию:
sudo /home/xc_vm/console.php tools migration "/tmp/backup.sql"
Прежде чем продолжить, убедитесь, что восстановление завершилось ** без ошибок**.
3. Начать миграцию
Как только резервная копия будет восстановлена, запустите миграцию, используя один из следующих способов.
Вариант 1 — Командная строка (рекомендуется)
/home/xc_vm/console.php migrate
Вариант 2 — Веб-установщик
- Вернитесь к веб-установщику ** (ссылка показана во время настройки панели).
- Выберите Перенос
- Следуйте инструкциям на экране
Вы будете видеть обновления о ходе выполнения в режиме реального времени. После завершения работы система будет доступна.
Восстановление Доступа После Миграции
Если войти в систему не удается из-за отсутствия учетных данных или кода доступа, воспользуйтесь средствами восстановления.
Создайте аварийный код доступа
sudo /home/xc_vm/console.php tools access
Создайте учетную запись администратора
sudo /home/xc_vm/console.php tools user
❗️ После восстановления доступа ** немедленно измените ** код доступа и учетные данные администратора.
Подготовка балансировщика нагрузки
Подсистемы балансировки нагрузки не перенесены.
- При необходимости переустановите операционную систему
- Перенастройка сети и маршрутизации
- Повторно подключите их к основному серверу
Постмиграционный период (обязательно)
После миграции система ** не готова к работе** до тех пор, пока не будут выполнены эти шаги.
Пропуск их приведет к ** ожидаемому, но нарушенному поведению **.
1. Повторная инициализация состояния среды выполнения
- Запускайте все потоки вручную
- Убедитесь, что потоки доступны и стабильны
Состояние выполнения потока ** никогда не сохраняется ** во время миграции.
2. Перенастроить системные параметры
Просмотрите и восстановите все настройки, зависящие от конкретной среды:
- Пути к файлам
- Ограничения и квоты
- Настройки сети и обратного прокси-сервера
- Настройка производительности
Не предполагайте, что значения по умолчанию соответствуют вашим предыдущим настройкам. Значения по умолчанию применяются намеренно.
3. Восстановление ключей API и поставщиков
Ключи API Никогда Не Переносятся
Следующие параметры ** необходимо перенастроить вручную**:
- Ключ API TMDb
Это ** ожидаемое поведение**.
Если выборка метаданных не работает после миграции, убедитесь, что ключ API был повторно добавлен и поставщик включен. Это не указывает на ошибку переноса.
Общие проблемы после миграции
Метаданные Не извлекаются (TMDb)
Причина: Ключ API TMDb и конфигурация поставщика не были восстановлены.
Разрешение: Повторно добавьте ключ API TMDb и включите провайдера в настройках главного сервера.
Резюме
- Миграционный перенос ** только основных данных приложения**
- Конфигурация ** исключена по замыслу**
- Ключи API и настройки, зависящие от среды , должны быть восстановлены вручную
- Отсутствие функциональности после миграции ** ожидается до завершения реконфигурации**