Перейти к основному контенту

Резервное копирование RiCoder

В статье описаны инструкции по настройке и использованию встроенного механизма резервного копирования RiCoder через Яндекс.Диск: как создать, обновить или восстановить копию с помощью мастера установки, какие ограничения действуют и как избежать ошибок при восстановлении.

1. Введение

RiCoder создает резервную копию с помощью Docker-контейнеров. Результат — архивный файл в формате .dump, содержащий полный снимок всех данных, настроек и событий на момент резервного копирования. Этот файл не является рабочей базой данных, но позволяет полностью восстановить систему после сбоя или ошибки обновления.

Как работает резервное копирование?
1. Настройка резервного копирования выполняется с помощью мастера установки RiCoder;
2. Архивный файл (dump-файл) создается в ручном режиме при запуске мастера установки RiCoder;
3. В копии полностью сохраняются:
 - настройки RiCoder
 - база данных со всеми подключёнными объектами 
 - архив непереданных событий, присутствующие в системе в момент копирования;
4. Безопасное обновление RiCoder, без потери данных;
5. Безопасное восстановления системы в случае неудачного обновления RiCoder.
Ограничения
В текущей версии RiCoder не предусмотрена автоматическая ротация dump-файлов: старые копии не удаляются автоматически. При большом объёме данных рекомендуется:
  • Периодически удалять старые dump-файлы вручную.
  • Контролировать свободное место на Яндекс.Диске.

2. Подготовка к работе

Для организации резервного копирования RiCoder на Яндекс.Диск необходимо:

Настройка директории для резервных копий на Яндекс.Диске

Это директория, в которую RiCoder будет сохранять dump-файлы. 

Вы можете:

  • Создать директорию в момент работы с мастером установки – мастер создаст ее самостоятельно.
  • Заранее создать директорию на Яндекс.Диске и указать её имя при работе с мастером установки.
  • Использовать любую существующую директорию а Яндекс.Диске — мастер настроит запись резервных копий именно туда, куда вы укажете в диалоге.

Рекомендация по названию директории
Используйте простое, понятное название без пробелов и специальных символов:  например, RiCoder_Backups.

3. Сценарии работы 

При работе с резервным копированием RiCoder возможно выполнение следующих сценариев:

  1. Первичная установка RiCoder и настройка резервного копирования. Подробнее ...  
  2. Изменение настроек резервного копирования (изменение названия папки, токена Яндекс.Диск). Подробнее ... 
  3. Восстановления резервной копии. Подробнее ... 

3.1. Первичная настройка резервного копирования RiCoder

Первичная настройка выполняется в момент первой установки RiCoder на сервер. Алгоритм установки для Windows и Linux включает настройку резервного копирования. Выполните действия в алгоритме и проверьте корректность настройки резервного копирования.

3.2. Изменение настроек резервного копирования

Ситуации при которых необходимо изменить настройки Яндекс.Диск с помощью мастера установки RiCoder:

  • Создание новой папки на Яндекс.Диск для хранения резервных копий. 
  • Изменение названия существующей директории.
  • Истечение срока действия токена Яндекс.Диск (1 год).
  • Смена аккаунта Яндекс.Диск.

Во всех перечисленных ситуациях необходимо:

1. Запустить мастер установки RiCoder в режиме обновления. Подробнее об алгоритме обновления RiCoder.

2. Ввести текущие настройки RiCoder в блоке Ввод основных данных (язык установки, версии RiCoder, сетевые настройки).

Экран мастера установки RiCoder: Общие настройки

RiCoder_LAUN_ввод основных данных.png

3. В блоке Настройка резервного копирования ввести новые параметры для Яндекс.Диск.

Экран мастера установки: Настройка резервного копирования

RiCoder_LAUN_выберите действие.png

4. Выбрать действие – [1] создать / настроить резервное копирование.

Сценарии изменения настроек резервного копирования в RiCoder
Ситуация Подготовительные действия Ввод в мастере установки RiCoder

Создание новой директории на Яндекс.Диск. 

Ввести название новой директории.

Изменение названия существующей директории

Ввести название новой директории.

Будет создана новая директория., старая при этом не удаляется.

Истечение срока действия токена Яндекс.Диск (1 год)

Получить новый токен для текущего аккаунта. Подробнее ... Скопировать и вставить новый токен.

Смена аккаунта Яндекс.Диск

Для нового аккаунта получить токен Яндекс.Диск. Подробнее ... Скопировать и вставить новый токен.

3.3. Восстановление резервной копии

Важно!
Восстанавливайте только актуальную резервную копию.
Использование устаревшего dump-файла может привести к конфликтам данных и ошибкам в работе RiCoder.
Особенно критично это в случаях, когда:
  -
Заявки в реальном RiCoder отличаются от тех, что были на момент создания копии. После восстановления резервной копии произойдет синхронизации с облачным сервисом RiCloud и заявки будут актуализированы.
  -
Данные об объектах существуют в резервной копии, но были удалены в реальном RiCoder (или наоборот). Перед восстановлением убедитесь, что выбранная копия соответствует последнему стабильному состоянию системы.

Для восстановления резервной копии RiCoder с вашего Яндекс.Диска используйте мастер установки, с помощью которого был установлен RiCoder на сервер.

1. Зайдите на Яндекс.Диск в директорию с сохраненными резервными копиями и скопируйте имя нужной вам копии.

Экран сервиса Яндекс.Диск

Яндекс диск резервные копии.png

2. Убедитесь, что Docker Desktop запущен и работает: статус Enginerunning.

3. Найдите папку в которой хранится мастер установки RiCoder \CHOP_DEPLOY\.

4. Запустите файл launcher_windows.exe.

5. Выберите язык установки и нажмите ENTER после информационного сообщения.

6. Выберите режим Автовосстановление. Введите 2.

Экран мастера установки RiCoder

RiCoder_LAUN_восстановление.png

7. Выберите восстановить данные из резервной копии.

Экран мастера установки RiCoder

RiCoder_LAUN_восстановл резервной копии.png

8. Введите имя файла для восстановления и нажмите Enter.

9. Дождитесь окончания перезагрузки и настройки контейнеров и закройте мастер установки.

10. Откройте веб-панель администратора RiCoder с помощью ярлыка на рабочем столе и убедитесь, что данные восстановлены.

3.4. Обновление RiCoder

Перед запуском обновления RiCoder создайте резервную копию текущих настроек и базы данных. Это обеспечит возможность восстановления конфигурации и данных в случае сбоя обновления.

Подробнее о работе с обновлением RiCoder.

4. Отказ от резервного копирования на Яндекс. Диск

RiCoder сохраняет резервные копии на Яндекс.Диск. Для организации другого способа резервирования данных обратитесь к вашему менеджеру.

Чтобы пропустить настройку резервного копирования на Яндекс.Диск - в диалоге мастера установки RiCoder поля в разделе Настройка резервного копирования оставьте пустыми. 

Дата обновления: 29.01.2026