Переход на СУБД PostgreSQL (доступно с версии 3.12.0.1)

Раздел описывает статьи по переходу на СУБД PostgreSQL

• Порядок действий при переходе на PostgreSQL
• Установка СУБД PostgreSQL на ОС Windows
• Установка утилиты переноса данных
• Настройка утилиты переноса данных
• Перенос данных из БД MS Access в БД PostgreSQL
• Настройка рабочего места ПАУ для работы с СУБД PostgreSQL
• Настройка СУБД PostgreSQL
• Перенос данных из БД PostgreSQL в БД MS Access
• Настройка удаленного доступа к БД PostgreSQL
• Резервное копирование и восстановление базы данных СУБД PostgreSQL
• Настройка рабочего места ПАУ для работы с БД MS Access
• Обновление ПАУ с поддержкой работы с СУБД PostgreSQL
• Как создать резервную копию базы данных postgreSQL с помощью pgAdmin (при переносе базы данных)
• Как восстановить базу данных из резервной копии с помощью pgAdmin (при переносе базы данных)
• Перенос рабочего места с использованием базы данных postgreSQL
• Решение проблем связанных с обновлением базы данных ПАУ
• Сбросить пароль для баз ПАУ на PostgreSQL

Порядок действий при переходе на PostgreSQL

Данная инструкция описывает необходимые действия для начала использования ПАУ с PostgreSQL в качестве основной базы данных. 

Для обеспечения правильного перехода с базы данных MS Access на систему управления базами данных PostgreSQL вам потребуется системный администратор, который обеспечит выполнение условий, содержащихся в инструкциях.

На текущий момент, переход на другую базу данных доступен для версий ПАУ начиная с 3.12.0.1. В том случае, если сейчас используется ПАУ версии ниже чем 3.12.0.1, то необходимо обновить ПАУ и рабочую БД до требуемой версии.

Порядок действий при переходе на PostgreSQL

1. Скачать по ссылке PostgreSQL 12* версии и установить на сервер или ПК, который будет выполнять роль сервера (перейти к инструкции)

*При скачивании этого продукта, который является собственностью ENTERPRISEDB («EDB»), и при использовании вы соглашаетесь с условиями его использования (лиц.соглашение https://www.enterprisedb.com/legal/EDB-Eula)

2. Скачать по ссылке и установить pgAdmin (перейти к инструкции)

3. Подключиться к серверу СУБД PostgreSQL через pgAdmin (перейти к инструкции)

4. Создать пустую базу данных ama (перейти к инструкции)

5. Создать пользователя ama_user (перейти к инструкции)

6. Установить утилиту переноса данных (перейти к инструкции)

7. Настроить утилиту переноса данных (перейти к инструкции)

8. Перенести данные в базу данных PostgreSQL с помощью утилиты переноса данных (перейти к инструкции)

9. Настроить права пользователей, для работы с существующими таблицами и др. объектами (перейти к инструкции)

10. Настроить удалённый доступ к СУБД PostgreSQL (перейти к инструкции)

11. Скачать и установить ПАУ с поддержкой работы с СУБД PostgreSQL по ссылке

12. Убедиться, что на каждом рабочем месте стоит версия утилиты резервного копирования СУБД PostgreSQL такая же или выше, чем версия базы PostgreSQL, к которой вы будете подключаться. Если нет, то надо обновить утилиты.

• • как проверить версию утилиты резервного копирования базы данных (перейти к инструкции);
  • как проверить версию используемой базы данных PostgreSQL (перейти к инструкции);
  • как обновить утилиты резервного копирования базы данных (перейти к инструкции);

13. Запустить ПАУ и подключиться к базе данных PostgreSQL (перейти к инструкции)

Вопросы и ответы

Вопрос: Мы используем несколько БД при работе, как их объединить в одну?

Ответ: На данный момент такой возможности нет, в одном из ближайших релизов добавим.

 

Вопрос: Мы используем несколько БД при работе, как сделать так же с PostgreSQL?

Ответ: При переносе данных из базы данных MS Access в базу данных PostgreSQL необходимо в файле конфигурации в параметре pg_dbname указать наименование название БД, отличное от ama и при подключении указать его

Вопрос: Можем ли мы перейти обратно с PostgreSQL на MS Access?

Ответ: Да, для этого нужно воспользоваться утилитой переноса данных

Установка СУБД PostgreSQL на ОС Windows

Следует понимать, что установка должна происходить на сервере или ПК, к которому затем планируется подключаться.

Загрузка дистрибутива PostgreSQL

Ссылки приведены для справки (Рекомендуем использовать версию PostgreSQL 12)*: https://drive.russianit.ru/d/s/12WQEF5YLJftEtF4SSUcg3076JwOTbm4/qam2_4yTfPpFfkKNbRXvBe9yXSpmW7rX-Hb6A7bcgHww 

*При скачивании этого продукта, который является собственностью ENTERPRISEDB («EDB»), и при использовании вы соглашаетесь с условиями его использования (лиц.соглашение https://www.enterprisedb.com/legal/EDB-Eula)

В зависимости от разрядности ОС (32 или 64 бита) следует скачивать соответствующий дистрибутив для установки (Если версия PostgreSQL меньше 11-й).

Установка СУБД PostgreSQL

1. Запуск 

2. Установка дополнительных компонентов

3. Начало установки

4. Указание пути установки

По умолчанию СУБД устанавливается в следующие папки:

• x86: C:\Program Files (x86)\PostgreSQL\11
• x64: C:\Program Files\PostgreSQL\11

5. Выбор компонентов для установки

Необходимо отметить:

• Command Line Tools;
• PostgreSQL Server.

Необязательно устанавливать:

• pgAdmin 4.

Не устанавливать:

• Stack Builder.

6. Выбор расположения БД postgreSQL

По умолчанию БД устанавливается в следующие папки:

• x86: C:\Program Files (x86)\PostgreSQL\11\data
• x64: C:\Program Files\PostgreSQL\11\data

7. Указание пароля суперпользователя

На данном шаге необходимо указать пароль суперпользователя. В дальнейшем, его понадобится вводить несколько раз, поэтому настоятельно рекомендуем его сохранить или запомнить

8. Указание порта

СУБД postgreSQL предлагает по умолчанию порт 5432, однако, он может быть занят каким-либо другим приложением, поэтому перед указанием порта можно проверить свободен ли он.

9. Выбор региональных настроек

Выбрать Russian, Russia

10. Подтверждение данных для установки СУБД

Желательно сохранить данные в отдельный файл.
Пример данных для установки:

11. Окончание конфигурирования

12. Установка

13. Завершение установки

Проверка открыт ли порт

1. Нажимаем сочетание клавиш Win+R на клавиатуре
2. В открывшемся окне пишем cmd.exe 
3. В командной строке пишем команду netstat -a 
4. Получаем перечень занятых портов и проверяем, что вашего порта нет в перечне

Установка утилиты переноса данных

Для переноса данных предназначена утилита переноса данных, которая позволяет:

• перенести данные из базы данных PostgreSQL в пустую базу данных MS Access;
• перенести данные из базы данных MS Access в пустую базу данных PostgreSQL;
• сохранить данные базы данных в дамп
• загрузить данные базы данных из дампа

Загрузка дистрибутива

Необходимо скачать дистрибутив по этой ссылке

Технические требования

Для корректной работы программы требуется Net Framework 3.5.  Установить его можно пройдя по этой ссылке.

 

Установка утилиты переноса данных

1. Выбор языка процесса установки

2. Выбор пути, куда будет установлена утилита переноса данных

3. Выбор пути до папки, в которой будут расположены ярлыки программы Утилита переноса данных, Перенести данные ПАУ в БД PostgreSQL и Перенести данные ПАУ в БД MS Access

4. Приготовление к установке

5. После завершения установки программы требуется нажать Завершить, чтобы начать пользоваться утилитой переноса данных

Конфигурация утилиты переноса данных

Параметры переноса данных определяются с помощью файла конфигурации settings.config, расположенного по пути: %appdata%\RussianIT\TransferUtil\

Основные параметры

Пример файла конфигурации

Описание обменного формата

При переносе данных как из БД PostgreSQL, так и из БД MS Access, формируются файлы определенного формата (дампы):

Префиксы строк, наименования и типы колонок, а так же значения строк отделяются друг от друга вертикальной чертой |

Доступные команды

Утилита представляет собой консольное приложение, запускать которое следует с помощью "Командной строки Windows" (cmd.exe).

Пример использования: TransferUtil.exe to-pg

 

Настройка утилиты переноса данных

Для переноса данных предназначена утилита переноса данных, которая позволяет:

• перенести данные из базы данных PostgreSQL в пустую базу данных MS Access;
• перенести данные из базы данных MS Access в пустую базу данных PostgreSQL;
• сохранить данные базы данных в дамп
• загрузить данные базы данных из дампа

Исключения:

• двоичные данные не переносятся.

Скачать дистрибутив утилиты переноса данных https://rsit.ru/#load-ama 

Установка утилиты переноса данных

1. Выбор языка процесса установки

   

2. Выбор пути, куда будет установлена утилита переноса данных

   

3. Выбор пути до папки, в которой будут расположены ярлыки программы Утилита переноса данных, Перенести данные ПАУ в БД PostgreSQL и Перенести данные ПАУ в БД MS Access

   

4. Приготовление к установке

   

5. После завершения установки программы требуется нажать Завершить, чтобы начать пользоваться утилитой переноса данных

   

Параметры переноса данных определяются с помощью файла конфигурации settings.config, расположенного по пути: %appdata%\RussianIT\TransferUtil\

Конфигурация утилиты переноса данных

Параметры переноса данных определяются с помощью файла конфигурации settings.config, расположенного по пути: %appdata%\RussianIT\TransferUtil\

Основные параметры

Ключ	Значения по-умолчанию	Описание
pg_server	127.0.0.1	Необходимо указать ip адрес сервера, на котором расположена СУБД PostgreSQL, например: 127.0.0.1 или 192.168.0.123
pg_port	5432	Необходимо указать открытый порт на сервере, на котором расположена СУБД PostgreSQL, например: 5432
pg_dbname	ama	Наименование БД PostgreSQL на сервере, в которую и из которой будет происходит перенос данных
pg_dbuser	ama_user	Необходимо указать логин пользователя postgresql, из под которого будет совершён перенос данных.
pg_dbpassword	12345	Необходимо указать пароль пользователя СУБД PostgreSQL. В идеале это должен быть сложный пароль, а пароль 12345 представлен лишь для примера.
pg_ssl	False	Для подключения через SSL нужно подставить значение True, для подключения без SSL значение False
ma_dbpath	C:\Users\Public\Documents\ama.mdb	Путь до базы MS Access, которая будет использоваться при переносе данных.
save_documentarchive	False	Для сохранения содержимого таблицы DocumentArchive (архив документов) нужно подставить значение True, а для того чтобы пропустить эту таблицу - значение False

Пример файла конфигурации
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<pg_server>localhost</pg_server>
<pg_port>5432</pg_port>
<pg_dbname>ama</pg_dbname>
<pg_dbuser>postgres</pg_dbuser>
<pg_dbpassword>12345</pg_dbpassword>
<pg_ssl>False</pg_ssl>
<ma_dbpath>ama.mdb</ma_dbpath>
<save_documentarchive>False</save_documentarchive>
</configuration>

Дополнительная информация об утилите переноса данных

Описание обменного формата

При переносе данных как из БД PostgreSQL, так и из БД MS Access, формируются файлы определенного формата (дампы):

Префиксы строк, наименования и типы колонок, а также значения строк, отделяются друг от друга вертикальной чертой |

Доступные команды

Утилита представляет собой консольное приложение, запускать которое следует с помощью "Командной строки Windows" (cmd.exe).

Пример использования: TransferUtil.exe to-pg

Перенос данных из БД MS Access в БД PostgreSQL

Данная статья описывает полный процесс перехода с БД MS Access в БД PostgreSQL.

Для переноса данных из MS Access в PostgreSQL потребуется воспользоваться утилитой переноса данных.

Пошаговая инструкция по переносу данных в БД PostgreSQL

1. Настроить утилиту переноса данных
2. Создать пустую базу данных PostgreSQL см. инструкцию по созданию БД PostgreSQL
3. Запустить утилиту переноса данных с помощью ярлыка Перенести данные в БД PostgreSQL 
   
   либо запустить утилиту из командной строки TransferUtil.exe to-pg
4. Запустите ПАУ и настройте подключение к базе данных PostgreSQL см. инструкцию по настройке рабочего места ПАУ

Описание процесса переноса данных утилиты переноса данных

Порядок переноса данных

1. Подключение к базе данных MS Access указанной в файле конфигурации в параметре ma_dbpath;
2. Формирование дампа исходной базы данных MS Access. Дамп исходной базы данных -access.ama.csv будет расположен в папке to-pg\output_[дата_переноса]\access.ama.csv;
3. Подключение к СУБД PostgreSQL используя параметры pg_server, pg_port, pg_dbname, pg_dbuserи pg_dbpassword из файла конфигурации;
4. Проверка существования БД;
5. Проверка версии схемы данных БД, в том случае, если БД уже существует;
6. Создание таблиц в соответствии со схемой данных;
7. Перенос данных из дампа БД MS Access, полученного ранее.
8. Завершение переноса.

Сообщения о ходе переноса данных

Список сообщений об ошибках

Настройка рабочего места ПАУ для работы с СУБД PostgreSQL

Данная инструкция описывает подключение ПАУ к уже существующей и настроенной СУБД PostgreSQL.

Если СУБД не установлена или не настроена, то следует воспользоваться инструкциями:

1. Установка СУБД PostgreSQL
2. Настройка СУБД PostgreSQL

Так же, в том случае, если данные не перенесены, то следует воспользоваться утилитой переноса данных:

1. Установка утилиты переноса данных
2. Настройка утилиты переноса данных
3. Перенос данных из БД MS Access в БД PostgreSQL

Настройка подключения из ПАУ

1. Установить обновление программы для СУБД PostreSQL. Скачать обновление можно на сайте https://rsit.ru/load/ama/ .

2. Запустить ПАУ. В основном меню программы выбрать пункт Настройка приложения

   

3. На форме настройки приложения выбрать пункт Настройка подключения к БД

   

4. На форме Настройка подключения к БД указать Тип базы данных -> PostgreSQL

   

5. В поля Сервер, Порт, Наименование базы данных, Пользователь и Пароль ввести данные, которые были указаны на стадии переноса данных.

6. Нажать кнопку Проверить подключение к базе данных.

   В том случае, если удалось подключиться к базе данных PostgreSQL было успешным в графе Состояние базы данных будет указано Нормальное:

   

   В том случае, если по какой-то причине подключиться к базе данных PostgreSQL не удалось, то в графе Состояние базы данных будет указано Не удалось подключиться к базе данных.

   

   В этом случае, необходимо проверить параметры подключения с помощью утилиты pgAdminили обратиться к вашему системному администратору.

7. В том случае, если параметры подключения введены правильно и подключение удалось осуществить, необходимо нажать кнопку Сохранить, после чего программа Помощник арбитражного управляющего будет перезапущена.

   

8. После перезапуска программы Помощник арбитражного управляющего можно продолжать работу со всеми данными, перенесенными ранее.

   

Настройка СУБД PostgreSQL

После установки СУБД postgreSQL необходимо создать БД для работы с ПАУ, а так же, настроить доступ к БД и серверу.

Внимание: перед назначением прав по пункту "Настройка прав пользователя через Grant Wizard" должен быть выполнен перенос данных из Microsoft Access в PostgreSQL:

1. Установить утилиту переноса данных (перейти к инструкции)
2. Настроить утилиту переноса данных (перейти к инструкции)
3. Перенести данные в базу данных PostgreSQL с помощью утилиты переноса данных (перейти к инструкции)

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

Ниже приведены типовые настройки для доступа к СУБД PosgtreSQL

Установка pgAdmin

1. Необходимо скачать утилиту для конфигурирования и настройки СУБД PostgreSQL с официального сайта
2. Установить утилиту можно как на локальный ПК, так и на сервер под управлением ОС Windows
3. Запустить pgAdmin

Если вы используете Internet Explorer и у вас проблемы с пользовательским интерфейсом pgAdmin вам нужно сделать следующее:

1. Перейти в трей на панели задач Windows

2. Правой кнопкой мыши нажать на иконку запущенного pgAdmin

3. Выбрать пункт Copy server URL

4. Открыть любой другой браузер (не Internet Explorer)

5. Вставить ссылку в адресную строку

Подключение к СУБД PostgreSQL

1. Подключение к серверу

   

2. Задать имя сервера

   На вкладке General в поле Name указать имя сервера (любое) 

3. Задать адрес для подключения

На вкладке Connection указать параметры подключения:

• Если СУБД установлена на удаленном ПК или сервере, то в поле Hostname/address указать адрес или имя ПК/сервера, например: 192.168.0.123 или company-server;
• Если СУБД установлена на локальный ПК, то в поле Hostname/address следует указать имя сервера localhost.
• 

4. Задать порт для подключения

На вкладке Connection указать параметры подключения:

• Если СУБД установлена на удаленном ПК или сервере, то в поле Hostname/address указать адрес или имя ПК/сервера, например: 192.168.0.123 или company-server;
• Если СУБД установлена на локальный ПК, то в поле Hostname/address следует указать имя сервера localhost.

5. Указать пароль для пользователя

На стадии установки СУБД PostgreSQL было предложено ввести пароль суперпользователя и сейчас необходимо указать его в поле Password;

6. Сохранить настройки с помощью кнопки Save

Создание базы данных

После настройки подключения к СУБД PostgreSQL необходимо создать БД, для этого:

1. В окне Browser выбрать сервер, к которому было настроено подключение;

2. В меню Object выбрать пункт Create -> Database;

   

3. В появившемся окне, в поле Database необходимо ввести ama;

   

4. Сохранить параметры базы данных с помощью кнопки Save

5. База данных создана!

Создание пользователя

1. Задать имя пользователя

2. Задать пароль пользователя 

3. Задать права пользователя. На рисунке ниже изображён минимальный перечень прав для работы с базой данных ПАУ. 

4. Нажать Save. 

Настройка прав для пользователей базы данных по умолчанию

1) В списке баз данных выбрать нужную. Нажать правой кнопкой мыши, по ней, и выбрать пункт меню Properties.

2) Перейти на вкладку Default Priveleges

3) Нажать на "+" и выбрать пользователя, на которого настраиваются права

4) Задать права выбранного пользователя

5. Нажать Save.

Настройка прав пользователя через Grant Wizard

При добавлении новых пользователей в базу данных с уже сформированной структурой можно воспользоваться инструментом Grant Wizard, чтобы быстро настроить права нового пользователя для работы с множеством существующих объектов базы данных. Для этого нужно сделать следующее:

1. Выбрать базу данных, и открыть пункт tools в верхнем меню и выбрать инструмент GrantWizard

2. В окне инструмента GrantWizard на первом шаге необходимо выбрать объекты на которые будут выданы права. Проставить галочки нужно на все объекты и нажать Next

3. На втором шаге потребуется выбрать перечень операций над объектами, которые будут доступны пользователю. Для этого кликаем на +, чтобы добавить "привелегию" и задаём пользователя, из списка пользователей и ролей в колонке Grantee. В колонке Privileges выбираем перечень операций. Минимальный перечень для работы с базой ПАУ, указан на рисунке

4. На третьем шаге просто нажимаем кнопку Finish

Перенос данных из БД PostgreSQL в БД MS Access

Данная статья описывает полный процесс перехода с БД PostgreSQL в БД MS Access.

Для переноса данных из БД PostgreSQL в БД MS Access потребуется воспользоваться утилитой переноса данных.

Пошаговая инструкция по переносу данных в БД MS Access

1. Настроить утилиту переноса данных
2. Запустить утилиту переноса данных с помощью ярлыка 

   Перенести данные в БД Ms Access

   
   либо запустить утилиту из командной строки TransferUtil.exe to-ma
3. Скопировать базу данных MS Access из папки to-ma\output_[дата_переноса] в нужное вам место.
4. Запустите ПАУ и настройте подключение к базе данных MS Access см. инструкцию по настройке рабочего места ПАУ

Описание процесса переноса данных утилиты переноса данных

Порядок переноса данных

1. Подключение к базе PostreSQL используя параметры pg_server, pg_port, pg_dbname, pg_dbuser и pg_dbpassword из файла конфигурации;
2. Формирование дампа исходной базы PostgreSQL. Дамп исходной базы - postgres.ama.csv будет расположен в папке to-ma\output_[дата_переноса];
3. Создание БД MS Access ama.mdb в папке to-ma\output_[дата_переноса];
4. Создание таблиц в соответствии со схемой данных;
5. Перенос данных из дампа БД PostgreSQL полученного ранее.
6. Завершение переноса.

Сообщения о ходе переноса данных

Список сообщений об ошибках

Настройка удаленного доступа к БД PostgreSQL

1. 1. Создать пользователя базы данных, который будет использоваться для удалённой работы с базой данных
   2. Настроить права пользователя по умолчанию (права для работы с объектами базы данных, которые будут созданы в будущем)
   3. Настроить права пользователя на таблицы и другие объекты базы данных (права для работы с объектами базы данных, которые были созданы до создания пользователя)
   4. Открыть папку с установленной БД PostgreSQL

   По умолчанию база данных устанавливается:

   • x86: C:\Program Files (x86)\PostgreSQL\11\data
   • x64: C:\Program Files\PostgreSQL\11\data

5. В текстовом редакторе открыть файл pg_hba.conf
6. И под строкой:

host all all 127.0.0.1/32 md5

добавить строку по аналогии с примером

host ama ama_user all md5

Небольшая расшифровка этой строки:

- host - используется подключение по TCP/IP

- ama– Удалённый пользователь сможет подключаться к базе данных «ama», название базы можно заменить на своё, например «mydb». Помимо этого можно написать слово all, тогда для пользователя будет открыт доступ ко всем базам данных сервера

- ama_user– пользователь с псевдонимом «ama-user» сможет подключаться к базе данных «ama», если указать слово all, то база данных будет доступна любому пользователю

- all- Используется в качестве адреса удалённого рабочего места, в данном случае доступ открывается для любой удалённой машины, для пользователя с псевдонимом указанном в предыдущем столбце. Если требуется указать конкретный адрес, то его можно написать вот в такой форме: 192.168.0.2/32, а для нескольких пользователей придётся указывать несколько строк подключения, указывать каждого в новой строке, пример будет приведён ниже

-md5 – пароль пользователя хешируется алгоритмом MD5, если соответствует, то можно зайти

Пример предоставления доступа нескольким рабочим местам через пользователя «ama-user» к базе данных «ama»:

host ama ama-user 192.168.0.2/32 md5
host ama ama-user 192.168.0.3/32 md5
host ama ama-user 192.168.0.4/32 md5

Для более подробной информации по настройке конфига pg_hba.conf, пройдите по ссылке.

1. Сохранить изменения в файле;
2. Открыть порт в настройках брандмауэра Windows
3. Открыть папку с установленной БД PostgreSQL

По умолчанию база данных устанавливается:

• x86: C:\Program Files (x86)\PostgreSQL\11\data
• x64: C:\Program Files\PostgreSQL\11\data

4. В текстовом редакторе открыть файлpostgresql.conf
5. Найти строку listen_addresses и убедиться, что она имеет такой вид:

listen_addresses = '*'                              # what IP address(es) to listen on;

6. Открыть Панель управления -> Администрирование -> Службы
7. Выбрать в списке службpostgresql и перезапустить ёё

Настройка брандмауэра Windows

Данный пункт необходим, если с СУБД PostgreSQL работает несколько пользователей одновременно. Так же, следует уточнить, что в этом пункте рассматривается базовый сценарий по открытию порта для подключения и может не подойти Вам по параметрами безопасности.

1. Открыть Панель управления -> Брандмауэр защитника Windows; 

2. Выбрать пункт Дополнительные параметры;

3. Выбрать пункт Правила для входящих подключений -> Создать правило.... На форме мастер создания правила выбрать Для порта и нажать Далее

4. Выбрать пункт Протокол TCP и пункт Определенныйе локальные порты. На стадии установки СУБД PostgreSQL было предложено указать порт для доступа к БД PostgreSQL. Номер порта необходимо ввести в поле Определенные локальные порты: (по умолчанию, при установке указывается порт 5432) и затем нажать Далее

5. Выбрать пункт Разрешить подключение и затем нажать Далее

6. Выбрать все пункты и нажать Далее

7. Задать имя правила, например ama-pg и нажать Готово

8. Настройка порта завершена

После выполнения всех пунктов данной инструкции, к БД Postgres можно подключаться с удаленного компьютера

Резервное копирование и восстановление базы данных СУБД PostgreSQL

Системные требования

Для корректного создания резервной копии или восстановления базы данных из резервной копии необходимо установить распространяемый компонент Microsoft Visual C++, пройдя по ссылке.

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

1. Запустить ПАУ. В основном меню программы выбрать пункт Настройка приложения

   

2. В секции резервное копирование нажать на кнопку Создать.

   

3. Откроется мастер создания резервной копии, в котором, на первом шаге, вам будет предложено выбрать путь сохранения архива с резервной копией.

   

4. Ожидаем завершения резервного копирования

   

5. В результате получится архив с пользовательскими шаблонами, документами и базой данных [база].mdb (в случае MS Access) либо дампом базы данных [дамп].bak.

   

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

1. Для восстановления из резервной копии, в секции Резервное копирование нужно нажать на кнопку Восстановить из резервной копии...

   

2. Указать путь до архива с резервной копией

   

3. Ожидаем завершения восстановления из резервной копии

   

4. После восстановления база данных, как в случае MS Access, так и в случае PostgreSQL, будет заменена на базу с данными из резервной копии. Нажимаем ОК в уведомлении о завершении процесса восстановления и можем вернуться в ПАУ.

   

Как узнать путь до лога утилиты резервного копирования и восстановления базы данных (версия 3.14.0.1 и больше)

1. Откройте программу Помощник Арбитражного Управляющего

2. В основном меню программы (3 полоски, в правой части окна), выберите пункт Поддержка -> Протокол работы программы

3. Перейдите в конец открытого файла ama.log

4. Над сообщением об ошибке при восстановлении базы данных или создании резервной копии будет сообщение:

При восстановлении базы:

При создании резервной копии:

5. Файл протокола работы программы (ama.log), а также найденный файл с логом утилиты postgresql, можно направить в тех. поддержку

 

 

Настройка рабочего места ПАУ для работы с БД MS Access

Данная инструкция описывает подключение ПАУ к уже существующей и настроенной БД MS Access.

Если требуется перенос данных, но он ещё не был совершён, то следует воспользоваться утилитой переноса данных:

1. Установка утилиты переноса данных
2. Настройка утилиты переноса данных
3. Перенос данных из БД PostgreSQL в БД MS Access

Настройка подключения из ПАУ

1. Запустить ПАУ. В основном меню программы выбрать пункт Настройка приложения

   

2. На форме настройки приложения в секции путь до базы данных нажать на кнопку Изменить...

   

3. На форме Настройка подключения к БД указать Тип базы данных -> MS Access

   

4. Нажимаем на кнопку Изменить..., чтобы задать путь до базы данных.

5. Выбираем базу и нажимаем Открыть.

6. Нажать кнопку Проверить подключение к базе данных.

   В том случае, если удалось подключиться к базе данных MS Access было успешным в графе Состояние базы данных будет указано Нормальное:

   

7. В том случае, если параметры подключения введены правильно и подключение удалось осуществить, необходимо нажать кнопку Сохранить, после чего программа Помощник арбитражного управляющего будет перезапущена.

   

8. После перезапуска программы Помощник арбитражного управляющего можно продолжать работу со всеми данными, перенесенными ранее.

   

9. Настройка завершена!

Обновление ПАУ с поддержкой работы с СУБД PostgreSQL

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

• Необходимо выключить Помощник Арбитражного Управляющего на всех рабочих местах
• Ответственный за обновление сотрудник должен загрузить дистрибутив с новой версией программы Помощник Арбитражного Управляющего
• Установить обновление из Update-<версия>.exe
• Запустить программу Помощник Арбитражного Управляющего
• В появившемся диалоговом окне с вопросом будете ли вы обновлять базу данных, нажать «Да»

• После этого откроется окно мастера обновления базы данных, в нём необходимо нажать на кнопку «Далее»

• Как только процесс обновления базы данных завершится надо будет нажать «Закрыть»

• После этого откроется программа Помощник Арбитражного Управляющего обновлённая до новой версии
• Теперь можно обновлять программу на других рабочих местах следуя п.2 и п.3 данной инструкции

Как закрыть лишние соединения к базе данных СУБД PostgreSQL

Если после того как вы установили обновление программы из Update-<версия>.exe и запустили новую версию программы, вы видите диалог о том, что необходимо оставить только одно подключение к базе данных, это означает, что либо кто-то не выключил программу Помощник Арбитражного Управляющего, либо в базе данных остались подключения вследствие какой-то ошибки.

Решением данной ситуации будет принудительное закрытие всех подключений к базе данных и этого можно будет достичь следуя этой инструкции.

• Сначала нужно закрыть диалог, в котором написано, что нужно оставить одно подключение, нажав на «ОК»
• Далее вы перейдёте в настройки приложения, их необходимо закрыть на крестик, тем самым вы закроете Помощник Арбитражного Управляющего
• Далее необходимо открыть PgAdmin, подключиться к вашей базе данных и выбрать её в списке

• Далее в верхнем меню нажмите на Tools --> Query Tool

• В открывшейся вкладке Query Tool, в текстовое поле вставляем такой текст запроса:

SELECT pg_terminate_backend(pg_stat_activity.pid) FROM pg_stat_activity WHERE pg_stat_activity.datname = '<название вашей базы данных>'   AND pid <> pg_backend_pid();

и нажимаем на кнопку с иконкой молнии

• После этого можно снова запустить программу Помощник Арбитражного Управляющего и обновить базу данных

Решение проблемы с ошибкой «у текущего пользователя базы данных ПАУ, не хватает прав для обновления»

Данная инструкция написана с целью решения проблемы с ошибкой: “У текущего пользователя базы данных ПАУ, "[имя пользователя]", не хватает прав для обновления. 

На форме настройки приложения ПАУ необходимо открыть настройки подключения к базе данных ПАУ и указать имя пользователя с правами "superuser", а затем повторно запустить обновление базы данных.“

При возникновении такой ошибки необходимо:

• Нажать на кнопку «Закрыть» на форме обновления базы данных
• Открыть Помощник Арбитражного Управляющего
• На вопрос «будете ли обновляться?» - выбрать вариант «Нет» (если понадобится сделать это дважды – сделайте)

• Откроется форма «настроек приложения», там нажмите на кнопку «Изменить» в строке «Путь до базы данных»

• Откроется форма настроек подключения к базе данных и оставляем окно открытым

• Запускаем pgAdmin

• Выбрать в списке серверов баз данных Ваш, а также открыть список пользователей базы данных

• Выбираем Вашего пользователя и нажимаем по нему правой кнопкой мыши, далее, в контекстном меню выбираем «Properties».

• Открываем вкладку «Privelegies» и проверяем пункт «Superuser»

• Нам нужен пользователь с отмеченным пунктом «Superuser» - «Yes», поэтому требуется закрыть это окно свойств пользователя и продолжить искать по списку необходимого пользователя, выполняя пункты 8-9.

• Как только необходимый пользователь найден, закрываем окно свойств пользователя в pgAdmin и возвращаемся к настройкам подключения в Помощнике Арбитражного Управляющего
• Вводим в поля «Имя пользователя» и «Пароль» данные пользователя с отмеченным пунктом «Superuser» в правах, которого мы видели в pgAdmin

• Нажимаем «Сохранить» и возвращаемся в настройки приложения Помощник Арбитражного Управляющего
• Нажимаем «Обновить базу данных» в строке «Состояние базы данных» и соглашаемся обновлять базу данных

После этого можно продолжать работу с новой версией Помощника Арбитражного Управляющего.

 

Как создать резервную копию базы данных postgreSQL с помощью pgAdmin (при переносе базы данных)

1. В случае, если Postgresql установлен на компьютере, Заходим в меню «Пуск» и находим «pgAdmin»

Если в меню «Пуск» его нет, то ищем в папке, куда установлен postgresql, например:

C:\Program Files\PostgreSQL\11\pgAdmin 4\v4\pgAdmin4.exe

Ещё можно загрузить pgAdmin по ссылке: https://www.pgadmin.org/download/pgadmin-4-windows/ и установить на рабочий компьютер

2. Запускаем 

3. Подключаемся к серверу базы данных и вводим пароль

 

4. Выбираем в списке базу данных

5. Нажимаем на «Tools» в меню и выбираем пункт «Backup…»

6. В открывшемся окне нажимаем на «…» в поле Filename

7. В окне выбора файла перемещаемся в папку, куда будет сохранена резервная копия, затем в поле, где путь до файла, дописываем имя файла (на примере задано имя ama).

8. Выбираем формат резервной копии «backup».

9. Нажимаем Create

10. После этого нажимаем на кнопку «Backup»

11. При окончании процесса резервного копирования увидим окно. 

Как восстановить базу данных из резервной копии с помощью pgAdmin (при переносе базы данных)

1. В случае, если Postgresql установлен на компьютере - Нажимаем «Пуск» и находим «pgAdmin»

Если в меню «Пуск» его нет, то ищем в папке, куда установлен postgresql, например:

C:\Program Files\PostgreSQL\11\pgAdmin 4\v4\pgAdmin4.exe

Ещё можно загрузить pgAdmin по ссылке: https://www.pgadmin.org/download/pgadmin-4-windows/ и установить на рабочий компьютер

2. Запускаем

3. Подключаемся к серверу базы данных и вводим пароль

4. Если у вас есть существующая база данных, содержимое которой вы хотели бы заменить данными из резервной копии, то тогда выбираем эту базу данных в списке, правая кнопка мыши, в меню пункт Properties

5. Необходимо переименовать её и нажать Save

6. Кликаем правой кнопкой мыши по пункту Databases -> Create -> Database…

7. Вводим название базы данных, переименованной ранее и нажимаем Create

8. Выбираем в списке, недавно созданную базу данных

9. Нажимаем на пункт меню «Tools» и выбираем пункт «Restore»

10. В появившемся окне нажимаем на «…» в поле Filename

11. В окне выбора файла, задаём формат резервной копии «backup» находим файл резервной копии, выбираем его и нажимаем «Select»

12. Вернувшись в окно настроек резервной копии, нажимаем «Restore»

13. Запустится процесс восстановления базы данных, а по окончании этого процесса появится такое окно:

14. После этого можно снова подключаться к базе данных из ПАУ и продолжать работать.

Перенос рабочего места с использованием базы данных postgreSQL

В случае, если вы планируете перенести рабочее место с использованием базы данных postgreSQL, воспользуйтесь нашей инструкцией:

1. Создайте резервную копию базы данных postgreSQL с помощью pgAdmin

2. Установите postgreSQL на новом месте 
3. Восстановите в пустую базу данных, данные из резервной копии 
4. Настройте права через Grant Wizard 
5. Задайте новые ip адреса до базы данных 

Решение проблем связанных с обновлением базы данных ПАУ

Как узнать какая версия сервера базы данных используется

C использованием утилиты PostgreSQL psql.exe

1) Переходим в папку, куда установлен PostgreSQL

2) Переходим в папку bin

3) С помощью командной строки cmd.exe запускаем утилиту командой psql.exe -–version

4) На экран будет выведена текущая версия PostgreSQL

С использованием pgAdmin

1) Открываем PgAdmin на компьютере/сервере, куда установлен PostgreSQL

2) Выбираем любую базу данных, к которой вы можете подключиться

3) Выбираем пункт Tools в верхнем меню, а затем пункт QueryTool

 

 

4) В открывшейся панели для ввода запроса пишем SELECT version(); и нажимаем на кнопку с иконкой в виде молнии, после этого мы получим таблицу с текстом PostgreSQL [ваша версия PostgreSQL]

 

Как узнать какая версия утилиты резервного копирования используется

1. Перейти в папку, куда установлен ПАУ (по умолчанию: C:\Program Files (x86)\RussianIT\Помощник АУ)
2. Перейти в папку pg_utils
3. Найти файл pg_dump.exe (утилита для создания резервной копии базы данных)
4. Нажать по файлу правой кнопкой мыши -> Свойства
5. В окне свойств перейти на вкладку "Подробно". Версия утилиты будет указана в строке "Версия продукта"

6. Для файла pg_restore.exe (Утилита восстановления базы из резервной копии) повторяем пункты 4-5, этой инструкции.

Решение проблемы с ошибкой «Версия сервера базы данных PostgreSQL выше чем версия утилиты»

Во время создания резервной копии, восстановления базы данных из резервной копии или при обновлении ПАУ, можно столкнуться с предупреждением о том, что версия сервера базы данных выше чем версия утилиты (резервного копирования или восстановления).

В этом случае, нужно следовать такой инструкции:

1) Загружаем архив PostgreSQLтой же версии, что и версия сервера баз данных, что стоит у вас на сервере с сайта https://www.enterprisedb.com/download-postgresql-binaries(этот пункт можно пропустить, если на компьютере был установлен PostgreSQL)

2)Распаковываем архив, если был выполнен пункт 1 и переходим в папку pgsql или, если пункт 1 не выполнялся, переходим в папку, куда установлен PostgreSQLна рабочем компьютере

 

3) Переходим в папку bin

4) Выделяем и копируем все .dll, .lib файлы и утилиты pg_restore.exe, pg_dump.exe

5) Переходим в папку, куда установлен ПАУ

 

6) Переходим в папку pg_utils и копируем с заменой в неё выделенные файлы из пункта 3

7) После этого ошибка не должна появляться

 

Решение проблемы с ошибкой «у текущего пользователя базы данных ПАУ, не хватает прав для обновления»

На форме настройки приложения ПАУ необходимо открыть настройки подключения к базе данных ПАУ и указать имя пользователя с правами "superuser", а затем повторно запустить обновление базы данных.“.

При возникновении такой ошибки необходимо:

1. Нажать на кнопку «Закрыть» на форме обновления базы данных

2. Открыть Помощник Арбитражного Управляющего

3. На вопрос «будете ли обновляться?» - выбрать вариант «Нет» (если понадобится сделать это дважды – сделайте)

4. Откроется форма «настроек приложения», там нажмите на кнопку «Изменить» в строке «Путь до базы данных»

5. Откроется форма настроек подключения к базе данных и оставляем окно открытым

6. Запускаем pgAdmin

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

8. Выбираем Вашего пользователя и нажимаем по нему правой кнопкой мыши, далее в контекстном меню выбираем «Properties».

9. Открываем вкладку «Privelegies» и проверяем пункт «Superuser»

10. Нам нужен пользователь с отмеченным пунктом «Superuser» - «Yes», поэтому требуется закрыть это окно свойств пользователя и продолжить искать по списку необходимого пользователя, выполняя пункты 8-9.

11. Как только необходимый пользователь найден, закрываем окно свойств пользователя в pgAdmin и возвращаемся к настройкам подключения в Помощнике Арбитражного Управляющего

12. Вводим в поля «Имя пользователя» и «Пароль» данные пользователя с отмеченным пунктом «Superuser» в правах, которого мы видели в pgAdmin

13. Нажимаем «Сохранить» и возвращаемся в настройки приложения Помощник Арбитражного Управляющего

14. Нажимаем «Обновить базу данных» в строке «Состояние базы данных» и соглашаемся обновить базу данных

После этого можно продолжать работу с новой версией Помощника Арбитражного Управляющего.

 

Решение проблемы с отсутствием файла VCRuntime140.dll

1) Закрыть все окна ошибки об отсутствии файла, закрыть окно обновления базы данных и закрыть ПАУ

 

2) Перейти по ссылке https://support.microsoft.com/ru-ru/help/2977003/the-latest-supported-visual-c-downloads

3) Найдите на странице раздел "Visual Studio 2015, 2017 и 2019" и загрузите пакет Visual C++ Redistributable согласно разрядности вашей операционной системы

4) Установите загруженный пакет Visual C++ Redistributable

5) Попробуйте снова зайти в Помощник Арбитражного Управляющего и попробовать обновить базу данных.

Сбросить пароль для баз ПАУ на PostgreSQL

1. Если на компьютере отсутствует PgAdmin, то скачиваем его по ссылке и устанавливаем

2. Открываем меню Пуск и вбиваем в поле поиска «Настройки приложения» (имеется ввиду настройки приложения ПАУ)

3. В строке выбора пути до базы данных кликаем на «Изменить»

4. Откроется форма настроек подключения к базе данных

5. Переходим в меню Пуск и вбиваем в поле поиска «PgAdmin»

Для Windows 10, вбиваем текст «PgAdmin» в поле поиска рядом с меню Пуск

6. Запускаем pgAdmin 4

7. Если в пункте «Servers» нет подключения к вашей базе PostgreSQL, то его надо создать, для этого кликаем правой кнопкой мыши по пункту «Servers»

8. В меню выбираем Create -> Server..

9. В открывшемся окне в поле Name вводим любой текст

10. Переходим на вкладку Connection и заполняем поля данными аналогично настройкам подключения к базе данных ПАУ.

Host name/address – это Сервер

Port – это Порт

Maintenance database – это Наименование базы данных

Username – это Пользователь

Password – это Пароль

11. Если в настройках подключения ПАУ не стоит галочка SSL, этот пункт можно пропустить, а если стоит, то в PgAdmin, надо перейти на вкладку «SSL» и выбрать SSL Mode – «Require»

12. Нажимаем Save

13. Выбираем пункт Databases, затем выбираем вашу базу данных, по нажатию на левую кнопку мыши

14. Кликаем по базе данных правой кнопкой мыши и в открывшемся меню выбираем 

15. Для сброса пароля у всех пользователей, в открывшейся вкладке вводим запрос:

UPDATE UserList SET password='202CB962AC59075B964B07152D234B70'

 

Для сброса пароля у одного конкретного пользователя (например, admin):

UPDATE UserList SET password='202CB962AC59075B964B07152D234B70' WHERE login = 'admin'

16. Нажимаем на кнопку с иконкой треугольника

17. Теперь можно попробовать зайти в ПАУ, Пароль по умолчанию - 123