Настройка параметров резервного копирования обычно выполняется при помощи панели. В настоящем разделе приведена дополнительная информация для опытных пользователей. Начиная с версии 2.10.1.4 SP1 в тип точек данных «_DataManager» был добавлен узел «Backup» со следующими элементами:
Таблица: Узел «Backup» типа точек данных «_DataManager»
| Элемент точки данных | Тип | Пример | Описание | |
| Command | int | 1, -1 | Управление процессом резервного копирования | |
| Status | int | -4 | Состояние текущего или предыдущего цикла резервного копирования | |
| Timeout | int | 300 | Максимально допустимая продолжительность резервного копирования | |
| MemoryKBLimit | int | 65 | Минимальный свободный объем виртуальной памяти | |
| MaxBufferedMessages | int | 10000 | Максимально допустимое количество сообщений в буфере | |
| Inputfile | struct | Данные для входного файла программы «WCCOAtoolMedia» | ||
| Command | string | «backup» | Команда для «WCCOAtoolMedia», всегда «backup» | |
| Device | string | «C:/tmp/backup» | Целевые устройство / директория | |
| Type | string | «FILE» | Тип целевой резервной копии, например, «FILE», «DAT» | |
| Compression | bool | 0 | На данный момент игнорируется, всегда «0». | |
| StartTime | time | Выбор архивов, подлежащих резервному копированию. | ||
| UnsavedValArchs | bool | 0,1 | При значении «TRUE» (истина) будет выполняться резервное копирование еще не скопированных архивных файлов. | |
| Outputfile | struct | Содержимое выходного файла программы «WCCOAtoolMedia» | ||
| MasterError | int | 0 | Значение «0» при успешном создании резервной копии или код ошибки. | |
| FileError | dyn_string | Содержит информацию о файлах, при работе с которыми возникли ошибки, а также коды ошибок |
Backup.Command
Служит для управления процессом резервного копирования. Допустимые значения:
- «1» запускает процесс резервного копирования. К этому моменту времени «Backup.Inputfile» должен содержать корректные значения. В связи с этим сначала необходимо установить значения в «Backup.Inputfile», а затем установить требуемое значение «Backup.Command»
- «-1» прерывает текущий процесс резервного копирования.
Backup.Status
Используется для отображения состояние процесса резервного копирования. Возможные значения:
- 0 BackupOK: Резервное копирование в настоящий момент времени не выполняется, последняя резервная копия была создана успешно. «Backup.Outputfile» содержит информацию о результатах последнего резервного копирования.
- 1 BackupRunning: Выполняется резервное копирование, менеджер БД функционирует в режиме резервного копирования.
- -1 BackupAbort: Процесс резервного копирования был прерван путем изменения значения «Backup.Command».
- -2 BackupMQOverflow: Последний процесс резервного копирования был прерван в связи с превышением максимально допустимого числа сообщений в буфере.
- -3 BackupTimeout: Последний процесс резервного копирования был прерван по тайм-ауту.
- -4 BackupCored: Программой «WCCOAtoolMedia» возвращен код выхода «0» в связи с невозможностью проведения резервного копирования или невозможностью открытия выходного файла.
- -5 BackupError: Последнее резервное копирование было завершено, однако возникли ошибки. Дополнительная информация приведена в подразделе «Backup.Outputfile».
- -6 BackupMemExhausted: Последний процесс резервного копирования был прерван в связи со снижением свободного объема виртуальной памяти ниже минимально допустимого значения.
Backup.Timeout
Максимально допустимое время создания резервной копии (в секундах). В случае превышения данного порога процесс резервного копирования будет остановлен с присвоением состояния «-3». Любое значение <= 0 подразумевает неограниченную продолжительность выполнения резервного копирования, т.е. контроль за продолжительностью выполнения резервного копирования возлагается на пользователя.
Backup.MemoryKBLimit
Используется для установки минимально допустимого свободного объема виртуальной памяти. По умолчанию данное значение определяется как «_MemoryCheck.EmergencyKBLimit» плюс 50 Мбайт. Т.е. как минимум 60 Мбайт, даже при отсутствии заданного порога для мониторинга памяти. Указываемое здесь значение должно как минимум на 50 Мбайт превышать значение, используемое в качестве порога при мониторинге памяти. Подобный подход направлен на предотвращение перехода менеджера БД в аварийный режим (см. раздел «Аварийный режим менеджера данных, основы«). В случае снижения доступного объема виртуальной памяти ниже минимального допустимого значения процесс резервного копирования будет остановлен с присвоением состояния «-6».
ВНИМАНИЕ
В ходе выполнения резервного копирования объем доступного пространства на диске не контролируется. Перед созданием резервной копии следует убедиться в наличии достаточного объема свободного дискового пространства. Не следует создавать резервную копию на том же диске, на котором находится текущая база данных.
ВНИМАНИЕ
При использовании в конфигурационном файле записи «checkMemory = 0″ или при значении элемента точки данных «MemoryKBLimit» < 0 контроль объема доступной виртуальной памяти в режиме резервного копирования не производится.
Backup.MaxBufferedMessages
Используется для задания максимально допустимого количества сообщений в буфере. В ходе выполнения резервного копирования возможно поступление большого количества сообщений. Подобные сообщения блокируют менеджер БД и систему на значительный промежуток времени даже после выхода из режима резервного копирования. В связи с этим с целью ограничения максимального количества сообщений в буфере, в системе предусмотрен этот элемент точки данных. В случае превышения заданного порога процесс резервного копирования будет остановлен с присвоением состояния «-2». При любом значении <= 0 функция контроля количества сообщений в буфере отключается. По умолчанию максимально допустимое количество сообщений равно 100.000.
Backup.Inputfile
Соответствует структуре входного файла за исключением элемента точки данных «StartTime» (см. подраздел «Структура входного файла» раздела «WCCOAtoolMedia»). Описание элементов точки данных:
- Command
Команда для «WCCOAtoolMedia». Из возможных значений «backup», «restore», «rewind», «eject» и др. здесь имеет смысл только «backup». Проверка на предмет допустимости команд не выполняется, поскольку в противном случае при каждом изменении программы «WCCOAtoolMedia» были бы необходимы соответствующие изменения в менеджере БД.
- Device
Используется для указания целевого устройства или целевой директории для сохранения резервной копии. Примеры возможных значений: «C:/tmp/backup» для сохранения резервной копии на жесткий диск в ОС Windows или «tape0» для сохранения резервной копии на ленточный накопитель. Проверка целевого устройства или целевой директории со стороны менеджера БД на предмет наличия и доступности для записи не производится. Подобная проверка выполняется программой «WCCOAtoolMedia».
- Type:
Используется для указания типа устройства. Возможные значения: «FILE» для сохранения резервной копии на диск или «DAT» для сохранения на ленточный накопитель. Проверка со стороны менеджера БД на предмет допустимости значений не выполняется.
- Compression
На данный момент не используется. Значение всегда должно равняться «0».
- StartTime
Используется для принятия решения о том, какое файлы подлежат резервному копированию. На основании указанного здесь времени, менеджером БД создается список файлов для «WCCOAtoolMedia». Список всегда содержит все файлы базы данных «КАСКАД Цифра» из директории «db» (*.dbd, *.db, *.key), поддиректорий «alliving», «aloverflow», «empty» и «lastval», а также все архивы (значений и алармов), которые содержат значения, соответствующие интервалу времени от указанного момента времени до текущего момента времени. Указанное время и текущее время образуют интересующий интервал. Т.е. менеджер БД отбирает наборы файлов, значения в которых соответствуют интервалу времени от указанного момента времени до текущего момента времени, например, за последние 4 недели.
- UnsavedValArchs
Используется для управления резервным копированием еще не скопированных файлов («TRUE» = выполнять резервное копирование еще не скопированных файлов, «FALSE» = не выполнять).
В ходе резервного копирования каждые 60 секунд менеджер БД выполняет проверку на предмет завершения процесса резервного копирования или необходимости прерывания резервного копирования и изменяет соответствующим образом значения элементов точек данных «Status» и «Outputfile».
Условия прерывания процесса
- Превышен лимит времени.
По умолчанию лимит времени не задан. В элементе точки данных «_DataManager.Backup.Timeout» может быть указано максимально допустимое время в секундах (настройка выполняется при помощи панели).
- Превышено максимально допустимое число сообщений в буфере.
По умолчанию в буфере могут находиться не более 100 000 сообщений. Данное значение может быть изменено в элементе точки данных «_DataManager.Backup.MaxBufferedMessages» (настройка выполняется при помощи панели). Система учитывает количество сообщений, но не объем памяти, который они занимают.
- Снижение свободного объема виртуальной памяти ниже минимального допустимого значения.
В течение резервного копирования доступный объем виртуальной памяти должен на 50 Мбайт превышать границу, при которой производится переход в аварийный режим. Подобный подход направлен на предотвращение перехода менеджера БД в аварийный режим в ходе или сразу по окончании резервного копирования. При отсутствии заданных значений в элементе точки данных «_MemoryCheck.EmergencyKBLimit» или в элементе точки данных «_DataManager.Backup.MemoryKBLimit» используется минимальное значение 60 Мбайт.