мета-данные страницы
Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
dba_agbdbadmin [19.01.2022 06:13] Анисютин |
dba_agbdbadmin [24.10.2022 10:28] (текущий) gileva_ms |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Проект "Агбис Сервисные работы" ====== | ====== Проект "Агбис Сервисные работы" ====== | ||
- | Программу можно загрузить по ссылке | + | ===== Установка программы ===== |
- | [[http://agbis.co/download/admin_tools/agbdbadmin.zip | "Агбис Сервисные работы"]]\\ | + | |
- | http://agbis.co/download/admin_tools/agbdbadmin.zip\\ | + | Программу можно загрузить по ссылке\\ |
+ | <code> | ||
+ | http://agbis.co/download/admin_tools/agbdbadmin.zip или http://download.agbis.ru/download/admin_tools/agbdbadmin.zip | ||
+ | </code> | ||
для тестирования\\ | для тестирования\\ | ||
<code> | <code> | ||
\\\WebDAV\AgbisShare\Agbis\_TestBuilds\Boris\agbdbadmin\agbdbadmin.exe | \\\WebDAV\AgbisShare\Agbis\_TestBuilds\Boris\agbdbadmin\agbdbadmin.exe | ||
</code> | </code> | ||
+ | |||
+ | Папку AgbDBAdmin с программой AgbDBAdmin.exe следует разместить в папку с программами АГБИС.\\ | ||
+ | Обычно это **e:\Agbis\agbDBAdmin\agbDBAdmin.exe**\\ | ||
+ | |||
+ | ===== Запуск программы ===== | ||
+ | |||
+ | Параметры задачи могут быть заданы в файле **agbDBAdmin.ini** или непосредственно в командной строке.\\ | ||
+ | Параметры в командной строке имеют более высокий приоритет.\\ | ||
+ | |||
+ | Пример **agbDBAdmin.ini**\\ | ||
+ | <code> | ||
+ | AliasBase="Agbis" | ||
+ | FirebirdNum= | ||
+ | CLIENT_DEP_ID= | ||
+ | timeout= | ||
+ | </code> | ||
+ | |||
+ | Если параметры не заданы, то из agbis.xml берется последняя активная запись базы данных и выполняется оптимизация.\\ | ||
+ | |||
+ | Программа запускается от имени администратора, для того чтобы была возможность установить необходимые службы и клиенты Firebird.\\ | ||
+ | |||
+ | ==== Параметры задачи ==== | ||
+ | |||
+ | Файл agbis.xml ищется в родительской папке. Если agbis.xml не найден, то нужно будет задавать параметры БД "Исходная" вручную.\\ | ||
+ | |||
+ | * **AliasBase** - алиас "Исходной" БД для поиска в списке БД agbis.xml. По умолчанию берется последняя активная БД. | ||
+ | * **FirebirdNum** - версия Firebird для новой базы данных при конвертировании (используется только первая цифра). По умолчанию совпадает с версией "Исходной" БД | ||
+ | * **CLIENT_DEP_ID** - номер подразделения в БД PC (client_dep_params.id). Используется для отправки отчета в PC при запуске из ReplIn. По умолчанию отчет не отправляется. | ||
+ | * **timeout** - задержка в секундах перед выполнением основной части программы. Используется для остановки ReplIn перед обработкой БД. По умолчанию 0. | ||
+ | |||
+ | Пример команды\\ | ||
+ | <code> | ||
+ | AgbDBAdmin.exe AliasBase="Agbis" FirebirdNum=3 | ||
+ | </code> | ||
+ | |||
+ | Хост, порт и файл **"Исходной"** базы данных берутся из agbis.xml | ||
+ | Если база данных работает под Firebird 2, то будет выполнена конвертация базы данных для работы под Firebird 3.\\ | ||
+ | Если база данных работает под Firebird 3, то будет выполнена оптимизация базы данных.\\ | ||
+ | Настройки выставляются как значения по умолчанию и перед выполнением операций их можно изменить.\\ | ||
+ | |||
+ | <alert info> | ||
+ | Подключение к **"Исходной"** базе данных должно быть локальным, так как для выполнения операций требуется прямой доступ к файлам для | ||
+ | переименования и копирования, а также используется режим Embedded Firebird.\\ | ||
+ | </alert> | ||
===== Режимы работы ===== | ===== Режимы работы ===== | ||
Строка 15: | Строка 62: | ||
* Нормальный | * Нормальный | ||
* Эксперт | * Эксперт | ||
- | |||
- | ===== Режимы работы "Экспресс" ===== | ||
- | |||
- | Предназначен для выполнения работ по восстановлению базы данных в режиме максимальной автоматизации.\\ | ||
- | {{:dba_agbdbadmin_tformmain_express.png}}\\ | ||
- | В этом случае для работы доступна только одна форма [[:dba_TFormExpressRecovery| "Экспресс восстановление"]]\\ | ||
- | Работа по восстановлению не требует специальных знаний по архитектуре базы данных АГБИС.\\ | ||
- | Достаточно знать в какой папке размещается файл базы данных.\\ | ||
- | Работа может выполняться, например, системными админиcтраторами.\\ | ||
- | <alert info> | ||
- | Если повреждения оказываются более серьезными и в автоматическом режиме их исправить не удается, | ||
- | то система будет возвращена в состояние до момента запуска восстановления.\\ | ||
- | </alert> | ||
- | В этом случае рекомендуется обратится в отдел технической поддержки АГБИС для проведения восстановления.\\ | ||
- | Если будут предоставлены журналы выполнения восстановления, то процесс выяснения проблем в базе данных и самого восстановления займет меньше времени.\\ | ||
===== Режимы работы "Нормальный" ===== | ===== Режимы работы "Нормальный" ===== | ||
Строка 39: | Строка 71: | ||
При этом некоторые операции возможно выполнить в ручном режиме сторонними средствами.\\ | При этом некоторые операции возможно выполнить в ручном режиме сторонними средствами.\\ | ||
+ | |||
{{:dba_agbdbadmin_tformmain_detail.png}}\\ | {{:dba_agbdbadmin_tformmain_detail.png}}\\ | ||
- | ==== Общие понятия ==== | + | ==== Этапы выполнения ==== |
Процесс восстановления база данных проходит несколько этапов: \\ | Процесс восстановления база данных проходит несколько этапов: \\ | ||
Строка 47: | Строка 80: | ||
- Восстановление структуры записей базы данных.\\ | - Восстановление структуры записей базы данных.\\ | ||
- Оптимизация базы данных.\\ | - Оптимизация базы данных.\\ | ||
- | - Тестирование БД **Исправленная**.\\ | + | - Тестирование БД **Новая**.\\ |
- Возвращение в режим обслуживания пользователей.\\ | - Возвращение в режим обслуживания пользователей.\\ | ||
Строка 56: | Строка 89: | ||
* БД **Переименованная** | * БД **Переименованная** | ||
* БД **Копия** | * БД **Копия** | ||
- | * БД **Исправленная** | + | * БД **Новая** |
- | Кроме этого будет использоваться еще один объект\\ | + | Кроме этого будет использоваться еще один объект, который ссылается на базу данных с данными для сверки \\ |
* БД **Эталонная** | * БД **Эталонная** | ||
Строка 82: | Строка 115: | ||
C БД **Переименованная** никакие действия не выполняются. Переименование делается только с целью блокировать изменения базы данных на время восстановления и | C БД **Переименованная** никакие действия не выполняются. Переименование делается только с целью блокировать изменения базы данных на время восстановления и | ||
таким образом избежать потери данных при замене исходной базы данных исправленную.\\ | таким образом избежать потери данных при замене исходной базы данных исправленную.\\ | ||
- | Все обработки будут выполняться в БД **Копия** и БД **Исправленная**.\\ | + | Все обработки будут выполняться в БД **Копия** и БД **Новая**.\\ |
- | Операции выполняются на [[:dba_TFormDBCopy|форме "Переименование и копирование базы данных"]]\\ | + | Операции выполняются на [[:dba_TFormDBCopy_Prepare|форме "Переименование и копирование базы данных"]]\\ |
=== Восстановление структуры записей базы данных === | === Восстановление структуры записей базы данных === | ||
Строка 109: | Строка 142: | ||
Для выполнения операции Backup/Restory требуется, чтобы успешно завершился предыдущий этап.\\ | Для выполнения операции Backup/Restory требуется, чтобы успешно завершился предыдущий этап.\\ | ||
- | **Backup** делается из БД **Копия** программой GBAK, **Restory** выполняется в БД **Исправленная** другой программой GBAK.\\ | + | **Backup** делается из БД **Копия** программой GBAK, **Restory** выполняется в БД **Новая** другой программой GBAK.\\ |
Операция Backup/Restory формируется конвейер программ GBAK. Это позволяет сократить требуемый объем свободного места на диске, так как не создается промежуточный фал бэкапа, а сразу делается резервная копия. | Операция Backup/Restory формируется конвейер программ GBAK. Это позволяет сократить требуемый объем свободного места на диске, так как не создается промежуточный фал бэкапа, а сразу делается резервная копия. | ||
И дополнительно сокращается время выполнения операции.\\ | И дополнительно сокращается время выполнения операции.\\ | ||
Строка 119: | Строка 152: | ||
Операции выполняются на [[:dba_TFormDBBackup|форме "Оптимизация/Конвертирование"]]\\ | Операции выполняются на [[:dba_TFormDBBackup|форме "Оптимизация/Конвертирование"]]\\ | ||
- | === Тестирование БД **Исправленная** === | + | === Тестирование БД **Новая** === |
Во время операции Backup/Restory возможна потеря данных. Поэтому требуется проверка результата выполнения этой операции.\\ | Во время операции Backup/Restory возможна потеря данных. Поэтому требуется проверка результата выполнения этой операции.\\ | ||
Строка 125: | Строка 158: | ||
* Активация индексов базы данных | * Активация индексов базы данных | ||
- | Для проверки выполняется сравнение БД **Исправленная** и БД **Эталонная**\\ | + | Для проверки выполняется сравнение БД **Новая** и БД **Эталонная**\\ |
В качестве БД **Эталонная** по умолчанию используется БД **Переименованная**, то есть фактически БД **Исходная**.\\ | В качестве БД **Эталонная** по умолчанию используется БД **Переименованная**, то есть фактически БД **Исходная**.\\ | ||
Однако можно заменить БД **Переименованная** на любую другую. | Однако можно заменить БД **Переименованная** на любую другую. | ||
Строка 150: | Строка 183: | ||
В момент оптимизации базы данных часть индексов может не включится. Это может произойти, например, из-за потерянных записей и, как следствие, нарушении целостности базы данных.\\ | В момент оптимизации базы данных часть индексов может не включится. Это может произойти, например, из-за потерянных записей и, как следствие, нарушении целостности базы данных.\\ | ||
- | Запускается процедура включения всех индексов БД **Исправленная**.\\ | + | Запускается процедура включения всех индексов БД **Новая**.\\ |
Операции выполняются на [[:dba_TFormDBIndexes|форме "Активация индексов базы данных"]]\\ | Операции выполняются на [[:dba_TFormDBIndexes|форме "Активация индексов базы данных"]]\\ | ||
Строка 163: | Строка 196: | ||
то в качестве БД **Исходная** берется БД **Копия**, то есть файл БД **Копия** переименовываем в файл БД **Исходная**.\\ | то в качестве БД **Исходная** берется БД **Копия**, то есть файл БД **Копия** переименовываем в файл БД **Исходная**.\\ | ||
* Если при восстановлении выполнены все этапы, | * Если при восстановлении выполнены все этапы, | ||
- | то в качестве БД **Исходная** берется БД **Исправленная**, то есть файл БД **Исправленная** переименовываем в файл БД **Исходная**.\\ | + | то в качестве БД **Исходная** берется БД **Новая**, то есть файл БД **Новая** переименовываем в файл БД **Исходная**.\\ |
Операции выполняются на [[:dba_TFormDBCopy|форме "Возвращение в режим обслуживания пользователей"]]\\ | Операции выполняются на [[:dba_TFormDBCopy|форме "Возвращение в режим обслуживания пользователей"]]\\ | ||
+ | |||
+ | ===== Режимы работы "Экспресс" ===== | ||
+ | |||
+ | Предназначен для выполнения работ по восстановлению базы данных в режиме максимальной автоматизации.\\ | ||
+ | {{:dba_agbdbadmin_tformmain_express.png}}\\ | ||
+ | В этом случае для работы доступна только одна форма [[:dba_TFormExpressRecovery| "Экспресс восстановление"]]\\ | ||
+ | Работа по восстановлению не требует специальных знаний по архитектуре базы данных АГБИС.\\ | ||
+ | Достаточно знать в какой папке размещается файл базы данных.\\ | ||
+ | Работа может выполняться, например, системными админиcтраторами.\\ | ||
+ | <alert info> | ||
+ | Если повреждения оказываются более серьезными и в автоматическом режиме их исправить не удается, | ||
+ | то система будет возвращена в состояние до момента запуска восстановления.\\ | ||
+ | </alert> | ||
+ | В этом случае рекомендуется обратится в отдел технической поддержки АГБИС для проведения восстановления.\\ | ||
+ | Если будут предоставлены журналы выполнения восстановления, то процесс выяснения проблем в базе данных и самого восстановления займет меньше времени.\\ | ||
===== Режимы работы "Эксперт" ===== | ===== Режимы работы "Эксперт" ===== | ||
Строка 191: | Строка 239: | ||
* [[:dba_TFormExpressRecovery|Форма "Экспресс восстановление"]]\\ | * [[:dba_TFormExpressRecovery|Форма "Экспресс восстановление"]]\\ | ||
- | * [[:dba_TFormDBCopy|Форма "Переименование и копирование базы данных"]]\\ | + | * [[:dba_TFormDBCopy_Prepare|Форма "Переименование и копирование базы данных"]]\\ |
* [[:dba_TFormDBFirstAid|Форма "Первичное восстановление структуры базы данных"]]\\ | * [[:dba_TFormDBFirstAid|Форма "Первичное восстановление структуры базы данных"]]\\ | ||
* [[:dba_TFormDBBackup|Форма "Оптимизация/Конвертирование"]]\\ | * [[:dba_TFormDBBackup|Форма "Оптимизация/Конвертирование"]]\\ | ||
* [[:dba_TFormDBVerify|Форма "Проверка успешности оптимизации/конвертации"]]\\ | * [[:dba_TFormDBVerify|Форма "Проверка успешности оптимизации/конвертации"]]\\ | ||
* [[:dba_TFormDBIndexes|Форма "Активация индексов базы данных"]]\\ | * [[:dba_TFormDBIndexes|Форма "Активация индексов базы данных"]]\\ | ||
- | * [[:dba_TFormDBCopy|Форма "Возвращение в режим обслуживания пользователей"]]\\ | + | * [[:dba_TFormDBCopy_Revert|Форма "Возвращение в режим обслуживания пользователей"]]\\ |
* [[:dba_TFormFirebird|Форма "Подразделения"]]\\ | * [[:dba_TFormFirebird|Форма "Подразделения"]]\\ |