мета-данные страницы
  •  

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
dba_agbdbadmin [19.01.2022 06:08]
Анисютин
dba_agbdbadmin [24.10.2022 10:28] (текущий)
gileva_ms
Строка 1: Строка 1:
 ====== Проект "​Агбис Сервисные работы"​ ====== ====== Проект "​Агбис Сервисные работы"​ ======
  
-Программу можно загрузить по ссылке  +===== Установка программы =====  
-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>​
  
 ===== Режимы работы =====  ===== Режимы работы ===== 
Строка 14: Строка 62:
   * Нормальный   * Нормальный
   * Эксперт   * Эксперт
- 
-===== Режимы работы "​Экспресс"​ =====  
- 
-Предназначен для выполнения работ по восстановлению базы данных в режиме максимальной автоматизации.\\ 
-{{:​dba_agbdbadmin_tformmain_express.png}}\\ 
-В этом случае для работы доступна только одна форма [[:​dba_TFormExpressRecovery| "​Экспресс восстановление"​]]\\ 
-Работа по восстановлению не требует специальных знаний по архитектуре базы данных АГБИС.\\ 
-Достаточно знать в какой папке размещается файл базы данных.\\ 
-Работа может выполняться,​ например,​ системными админиcтраторами.\\ 
-<alert info> 
-Если повреждения оказываются более серьезными и в автоматическом режиме их исправить не удается, ​ 
-то система будет возвращена в состояние до момента запуска восстановления.\\ 
-</​alert>​ 
-В этом случае рекомендуется обратится в отдел технической поддержки АГБИС для проведения восстановления.\\ 
-Если будут предоставлены журналы выполнения восстановления,​ то процесс выяснения проблем в базе данных и самого восстановления займет меньше времени.\\ 
  
 ===== Режимы работы "​Нормальный"​ =====  ===== Режимы работы "​Нормальный"​ ===== 
Строка 38: Строка 71:
  
 При этом некоторые операции возможно выполнить в ручном режиме сторонними средствами.\\ При этом некоторые операции возможно выполнить в ручном режиме сторонними средствами.\\
 +
 {{:​dba_agbdbadmin_tformmain_detail.png}}\\ {{:​dba_agbdbadmin_tformmain_detail.png}}\\
  
-==== Общие ​понятия ====+==== Этапы выполнения ====
  
 Процесс восстановления база данных проходит несколько этапов:​ \\ Процесс восстановления база данных проходит несколько этапов:​ \\
Строка 46: Строка 80:
   - Восстановление структуры записей базы данных.\\   - Восстановление структуры записей базы данных.\\
   - Оптимизация базы данных.\\   - Оптимизация базы данных.\\
-  - Тестирование БД **Исправленная**.\\+  - Тестирование БД **Новая**.\\
   - Возвращение в режим обслуживания пользователей.\\   - Возвращение в режим обслуживания пользователей.\\
  
Строка 55: Строка 89:
   * БД **Переименованная**   * БД **Переименованная**
   * БД **Копия**   * БД **Копия**
-  * БД **Исправленная** +  * БД **Новая** 
-Кроме этого будет использоваться еще один объект\\+Кроме этого будет использоваться еще один объект, который ссылается на базу данных с данными для сверки ​\\
   * БД **Эталонная**   * БД **Эталонная**
  
Строка 81: Строка 115:
 C БД **Переименованная** никакие действия не выполняются. Переименование делается только с целью блокировать изменения базы данных на время восстановления и  C БД **Переименованная** никакие действия не выполняются. Переименование делается только с целью блокировать изменения базы данных на время восстановления и 
 таким образом избежать потери данных при замене исходной базы данных исправленную.\\ ​ таким образом избежать потери данных при замене исходной базы данных исправленную.\\ ​
-Все обработки будут выполняться в БД **Копия** и БД **Исправленная**.\\+Все обработки будут выполняться в БД **Копия** и БД **Новая**.\\
  
-Операции выполняются на [[:dba_TFormDBCopy|форме "​Переименование и копирование базы данных"​]]\\+Операции выполняются на [[:dba_TFormDBCopy_Prepare|форме "​Переименование и копирование базы данных"​]]\\
  
 === Восстановление структуры записей базы данных === === Восстановление структуры записей базы данных ===
Строка 108: Строка 142:
 Для выполнения операции Backup/​Restory требуется,​ чтобы успешно завершился предыдущий этап.\\ Для выполнения операции Backup/​Restory требуется,​ чтобы успешно завершился предыдущий этап.\\
  
-**Backup** делается из БД **Копия** программой GBAK, **Restory** выполняется в БД **Исправленная** другой программой GBAK.\\+**Backup** делается из БД **Копия** программой GBAK, **Restory** выполняется в БД **Новая** другой программой GBAK.\\
 Операция Backup/​Restory формируется конвейер программ GBAK. Это позволяет сократить требуемый объем свободного места на диске, так как не создается промежуточный фал бэкапа,​ а сразу делается резервная копия. Операция Backup/​Restory формируется конвейер программ GBAK. Это позволяет сократить требуемый объем свободного места на диске, так как не создается промежуточный фал бэкапа,​ а сразу делается резервная копия.
 И дополнительно сокращается время выполнения операции.\\ И дополнительно сокращается время выполнения операции.\\
Строка 118: Строка 152:
 Операции выполняются на [[:​dba_TFormDBBackup|форме "​Оптимизация/​Конвертирование"​]]\\ Операции выполняются на [[:​dba_TFormDBBackup|форме "​Оптимизация/​Конвертирование"​]]\\
  
-=== Тестирование БД **Исправленная** ===+=== Тестирование БД **Новая** ===
  
 Во время операции Backup/​Restory возможна потеря данных. Поэтому требуется проверка результата выполнения этой операции.\\ Во время операции Backup/​Restory возможна потеря данных. Поэтому требуется проверка результата выполнения этой операции.\\
Строка 124: Строка 158:
   * Активация индексов базы данных   * Активация индексов базы данных
  
-Для проверки выполняется сравнение БД **Исправленная** и БД **Эталонная**\\+Для проверки выполняется сравнение БД **Новая** и БД **Эталонная**\\
 В качестве БД **Эталонная** по умолчанию используется БД **Переименованная**,​ то есть фактически БД **Исходная**.\\ В качестве БД **Эталонная** по умолчанию используется БД **Переименованная**,​ то есть фактически БД **Исходная**.\\
 Однако можно заменить БД **Переименованная** на любую другую. ​ Однако можно заменить БД **Переименованная** на любую другую. ​
Строка 149: Строка 183:
  
 В момент оптимизации базы данных часть индексов может не включится. Это может произойти,​ например,​ из-за потерянных записей и, как следствие,​ нарушении целостности базы данных.\\ В момент оптимизации базы данных часть индексов может не включится. Это может произойти,​ например,​ из-за потерянных записей и, как следствие,​ нарушении целостности базы данных.\\
-Запускается процедура включения всех индексов БД **Исправленная**.\\+Запускается процедура включения всех индексов БД **Новая**.\\
  
 Операции выполняются на [[:​dba_TFormDBIndexes|форме "​Активация индексов базы данных"​]]\\ Операции выполняются на [[:​dba_TFormDBIndexes|форме "​Активация индексов базы данных"​]]\\
Строка 162: Строка 196:
     то в качестве БД **Исходная** берется БД **Копия**,​ то есть файл БД **Копия** переименовываем в файл БД **Исходная**.\\     то в качестве БД **Исходная** берется БД **Копия**,​ то есть файл БД **Копия** переименовываем в файл БД **Исходная**.\\
   * Если при восстановлении выполнены все этапы, ​   * Если при восстановлении выполнены все этапы, ​
-    то в качестве БД **Исходная** берется БД **Исправленная**, то есть файл БД **Исправленная** переименовываем в файл БД **Исходная**.\\+    то в качестве БД **Исходная** берется БД **Новая**, то есть файл БД **Новая** переименовываем в файл БД **Исходная**.\\
  
 Операции выполняются на [[:​dba_TFormDBCopy|форме "​Возвращение в режим обслуживания пользователей"​]]\\ Операции выполняются на [[:​dba_TFormDBCopy|форме "​Возвращение в режим обслуживания пользователей"​]]\\
  
 +
 +===== Режимы работы "​Экспресс"​ ===== 
 +
 +Предназначен для выполнения работ по восстановлению базы данных в режиме максимальной автоматизации.\\
 +{{:​dba_agbdbadmin_tformmain_express.png}}\\
 +В этом случае для работы доступна только одна форма [[:​dba_TFormExpressRecovery| "​Экспресс восстановление"​]]\\
 +Работа по восстановлению не требует специальных знаний по архитектуре базы данных АГБИС.\\
 +Достаточно знать в какой папке размещается файл базы данных.\\
 +Работа может выполняться,​ например,​ системными админиcтраторами.\\
 +<alert info>
 +Если повреждения оказываются более серьезными и в автоматическом режиме их исправить не удается, ​
 +то система будет возвращена в состояние до момента запуска восстановления.\\
 +</​alert>​
 +В этом случае рекомендуется обратится в отдел технической поддержки АГБИС для проведения восстановления.\\
 +Если будут предоставлены журналы выполнения восстановления,​ то процесс выяснения проблем в базе данных и самого восстановления займет меньше времени.\\
  
 ===== Режимы работы "​Эксперт"​ =====  ===== Режимы работы "​Эксперт"​ ===== 
Строка 190: Строка 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|Форма "​Подразделения"​]]\\