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

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

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

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

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

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

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

  1. Скачать по ссылке PostgreSQL 12 версии и установить на сервер или ПК, который будет выполнять роль сервера (перейти к инструкции)
  2. Скачать по ссылке и установить pgAdmin (перейти к инструкции)
  3. Подключиться к серверу СУБД PostgreSQL через pgAdmin (перейти к инструкции)
  4. Создать пустую базу данных ama (перейти к инструкции)
  5. Создать пользователя ama_user (перейти к инструкции)
  6. Установить утилиту переноса данных (перейти к инструкции)
  7. Настроить утилиту переноса данных (перейти к инструкции)
  8. Перенести данные в базу данных PostgreSQL с помощью утилиты переноса данных (перейти к инструкции)
  9. Настроить права пользователей, для работы с существующими таблицами и др. объектами (перейти к инструкции)
  10. Настроить удалённый доступ к СУБД PostgreSQL (перейти к инструкции)
  11. Скачать и установить ПАУ с поддержкой работы с СУБД PostgreSQL по ссылке
  12. Убедиться, что на каждом рабочем месте стоит версия утилиты резервного копирования СУБД PostgreSQL такая же или выше, чем версия базы PostgreSQL, к которой вы будете подключаться. Если нет, то надо обновить утилиты.
  13. Запустить ПАУ и подключиться к базе данных PostgreSQL (перейти к инструкции)

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

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

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

 

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

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


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

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

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

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

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

Ссылки приведены для справки (Рекомендуем использовать версию PostgreSQL 12):
https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

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

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

  1. Запуск 

23.png

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

Step_1_2.png

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

Step_1_3.png

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

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

24.png


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

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

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

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

Step_1_5.png

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

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

Step_1_6.png

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

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

Step_1_7.png

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

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

Step_1_8.png

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

Выбрать Russian, Russia

Step_1_9.png

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

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

mceclip0.png

25.png

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

Step_1_11.png

12. Установка

Step_1_12.png

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

Step_1_13.png


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

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

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

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

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

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

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

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

 

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

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

installUtil_1.png

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

installUtil_2.png

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

installUtil_3.png

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

installUtil_4.png

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

installUtil_5.png

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

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

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

mceclip0.png

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

mceclip1.png

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

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

mceclip2.png

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

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

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

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

mceclip3.png

 

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

Данная статья описывает файл настроек утилиты переноса данных, а также все его параметры.

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

Параметры переноса данных определяются с помощью файла конфигурации 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, формируются файлы определенного формата (дампы):

mceclip0.png

mceclip1.png

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

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

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

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

mceclip2.png

 

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

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

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

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

  1. Настроить утилиту переноса данных
  2. Создать пустую базу данных PostgreSQL см. инструкцию по созданию БД PostgreSQL
  3. Запустить утилиту переноса данных с помощью ярлыка Перенести данные в БД PostgreSQL 
    TransferUtil_ToPG_lnk.png
    либо запустить утилиту из командной строки 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. Завершение переноса.

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

Этап Сообщение
Начало переноса данных из MS Access в PostgreSQL Начало переноса данных из БД MS Access в БД PostgreSQL
Проверка наличия БД MS Access Проверка наличия БД MS Access
БД MS Access существует БД MS Access существует - ОК
Получаем версию схемы данных базы MS Access Получили версию схемы данных из БД MS Access - OK
Начало подключения к БД MS Access Подключение к исходной БД MS Access
Конец подключения к БД MS Access Подключились к исходной БД MS Access - ОК
Начало формирования дампа Начали формировать дамп исходной БД - ОК
Окончание формирования дампа Дамп исходной БД сформирован - ОК
Начало проверки существования БД PostgreSQL Проверка наличия БД PostgreSQL
Конец проверки существования БД PostgreSQL БД PostgreSQL существует - ОК
Подключение к СУБД PostgreSQL Подключились к СУБД PostgreSQL
Получение номера версии БД PostgreSQL Получили версию схемы данных из БД PostgreSQL - OK
Проверка версии схемы данных БД Проверка версии схемы данных БД
По результату проверки версии схем данных совпадают Версии схем данных совпадают - ОК
По результату проверки версии схем, выявлено, что БД PostgreSQL пустая и туда можно переносить данные БД PostgreSQL пустая
Создание таблиц согласно версии схемы данных Созданы таблицы согласно схеме данных - ОК
Начало переноса данных из дампа БД MS Access Начали переносить данные из дампа БД
Закончили переносить данных из дампа БД MS Access Закончили переносить данные из дампа БД MS Access - ОК
Завершение переноса данных из MS Access в PostgreSQL Перенос данных завершен

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

Сообщение об ошибке Описание и рекомендации
Нет файла БД MS Access - Ошибка Проверьте права доступа для пути %appdata%\RussianIT\TransferUtil\to-pg
Не удалось подключиться к исходной БД MS Access - Ошибка Не удалось подключиться к исходной БД MS Access, указанной в параметре ma_dbpath файла конфигурации, необходимо проверить наличие файла БД
Введёны неверные логин и пароль пользователя - Ошибка Необходимо проверить параметры подключения указанные в параметрах pg_dbuser и pg_dbpassword в файле конфигурации
Нет доступа к СУБД PostgreSQL - Ошибка Необходимо проверить параметры подключения в конфиге pg_hba.conf
Не удалось подключиться к СУБД PostgreSQL - Ошибка Необходимо проверить параметры подключения указанные в параметрах pg_server, pg_port, pg_dbname, pg_dbuser и pg_dbpassword в файле конфигурации
БД PostgreSQL не существует - Ошибка БД PostgreSQL не создана, необходимо создать БД согласно инструкции
Версии схем данных не совпадают - Ошибка БД PostgreSQL уже была создана ранее и её версия отличается от версии БД MS Access, необходимо обновить уже существующую БД PostgreSQL в ПАУ, либо очистить базу, а затем произвести перенос.
Не удалось сформировать дамп исходной БД - Ошибка В ходе формирования дампа исходной БД MS Access возникла ошибка, подробное описание будет указано в файле TransferUtil.log
Не удалось создать таблицы в БД PostgreSQL - Ошибка В ходе создания необходимых таблиц в БД PostgreSQL произошла ошибка, подробное описание будет указано в файле TransferUtil.log
Не удалось перенести данные из дампа в БД PostgreSQL - Ошибка В ходе переноса данных из дампа БД MS Access возникла ошибка, подробное описание будет указано в файле TransferUtil.log

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

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

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

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

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

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

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

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

    Step_4_1.png

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

    Step_4_2.png

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

    Step_4_3.png

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

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

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

    Step_4_5.png

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

    Step_4_4.png

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

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

    Step_4_6.png

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

    Step_4_7.png

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

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

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

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

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

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

Установка pgAdmin

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

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

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

28.png

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

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

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

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

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

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

    Step_2_1.png

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

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

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

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

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

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

Step_2_3__1_.png

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

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

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

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

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

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

    Step_2_4.png

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

    Step_2_5.png

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

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

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

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

29.png

30.png

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

Step_2_0_2.png

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

4. Нажать Save. 

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

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

32.png

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

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

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

33.png

5. Нажать Save.

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

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

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

34.png

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

35.png

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

36.png

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

37.png

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

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

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

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

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

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

    TransferUtil_ToMA_lnk.png
    либо запустить утилиту из командной строки 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 в MS Access Начало переноса данных из БД PostgreSQL в БД MS Access
Начало подключения к БД PostgreSQL Подключение к БД PostgreSQL
Конец подключения к БД PostgreSQL Подключились к исходной БД PostgreSQL - ОК
Получили версию схемы данных PostgreSQL Получили версию схемы данных из БД PostgreSQL - OK
Начало формирования дампа Начали формировать дамп исходной БД PostgreSQL - ОК
Окончание формирования дампа Закончили формировать дамп исходной БД - OK
Создание БД MS Access Создали БД MS Access - OK
Подключились к БД MS Access Подключились к БД MS Access - OK
Создание таблиц согласно версии схемы данных Созданы таблицы согласно схеме данных - ОК
Начало переноса данных из дампа БД PostgreSQL Начали перенос данных из дампа БД PostgreSQL
Закончили переносить данных из дампа БД PostgreSQL Закончили перенос данных из дампа БД PostgreSQL - ОК
Завершение переноса данных из PostgreSQL в MS Access Перенос данных из БД PostgreSQL в БД MS Access завершен

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

Сообщение об ошибке Описание и рекомендации
Не удалось подключиться к исходной БД PostgreSQL - Ошибка Необходимо проверить параметры подключения указанные в параметрах pg_server, pg_port, pg_dbname, pg_dbuser и pg_dbpasswordв файле конфигурации
Не удалось сформировать дамп исходной БД - Ошибка В ходе формирования дампа исходной БД MS Access возникла ошибка, подробное описание будет указано в файле TransferUtil.log
Не удалось создать результирующую БД MS Access - Ошибка Проверьте права доступа для пути %appdata%\RussianIT\TransferUtil\to-ma
Не удалось создать таблицы в БД MS Access - Ошибка В ходе создания необходимых таблиц в БД PostgreSQL произошла ошибка, подробное описание будет указано в файле TransferUtil.log
Не удалось перенести данные из дампа в БД MS Access - Ошибка В ходе переноса данных из дампа БД PostgreSQL возникла ошибка, подробное описание будет указано в файле TransferUtil.log

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

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

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

    • x86: C:\Program Files (x86)\PostgreSQL\11\data
    • x64: C:\Program Files\PostgreSQL\11\data
  1. В текстовом редакторе открыть файл pg_hba.conf
  2. И под строкой:

host all all 127.0.0.1/32 md5

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

host ama ama_user all md5

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

__________.png

- 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

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

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

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

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

27.png

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

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

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

Step_3_1.png

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

Step_3_2.png

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

Step_3_3.png

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

Step_3_4.png

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

Step_3_5.png

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

Step_3_6.png

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

Step_3_7.png

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

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

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

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

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

26.png

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

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

    Step_5_1.png

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

    Step_5_2.png

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

    Step_5_3.png

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

    Step_5_5.png

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

    Step_5_6.png

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

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

    Step_6_1.png

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

    Step_6_2.png

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

    Step_6_3.png

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

    Step_6_4.png

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

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

find_pg_utils_log_0.png

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

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

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

mceclip0.png

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

mceclip1.png

find_pg_utils_log_1.png

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

 

 

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

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

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

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

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

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

    Step_4_1.png

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

    Step_4_2.png

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

    Step_4_8.png

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

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

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

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

    Step_4_10.png

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

    Step_4_6.png

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

    Step_4_7.png

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

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

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

mceclip0.png

mceclip1.png

mceclip2.png

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

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

mceclip3.png

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

mceclip4.png

mceclip5.png

SELECT pg_terminate_backend(pg_stat_activity.pid)

FROM pg_stat_activity

WHERE pg_stat_activity.datname = '<название вашей базы данных>'

  AND pid <> pg_backend_pid();

mceclip6.png

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

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

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

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

mceclip7.png

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

mceclip8.png

mceclip9.png

mceclip10.png

mceclip11.png

mceclip12.png

mceclip13.png

mceclip14.png

mceclip15.png

mceclip16.png

mceclip17.png

mceclip18.png

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

 

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

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

mceclip0.png

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

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

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

2. Запускаем 

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

mceclip1.png

 

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

mceclip2.png

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

mceclip3.png

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

mceclip4.png

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

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

mceclip5.png

9. Нажимаем Create

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

mceclip6.png

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

mceclip7.png

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

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

mceclip0.png

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

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

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

2. Запускаем

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

mceclip1.png

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

mceclip2.png

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

mceclip3.png

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

mceclip4.png

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

mceclip5.png

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

mceclip6.png

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

mceclip7.png

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

mceclip8.png

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

mceclip9.png

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

mceclip10.png

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

mceclip11.png

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

2.png

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

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

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

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

3.png

 

 

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

4.png

 

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

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

38.png

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

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

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

5.png

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

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

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

 

6.png

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

7.png

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

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

8.png

 

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

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

 

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

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

9.png

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

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

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

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

10.png

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

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

12.png

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

13.png

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

14.png

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

15.png

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

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

17.png

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

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

18.png

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

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

19.png

20.png

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

 

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

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

21.png

 

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

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

22.png

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

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

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

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

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

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

mceclip0.png

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

mceclip1.png

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

mceclip2.png

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

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

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

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

mceclip3.png

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

mceclip4.png

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

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

Port – это Порт

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

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

Password – это Пароль

mceclip5.png

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

mceclip6.png

12. Нажимаем Save

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

mceclip7.png

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

mceclip8.png

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

UPDATE UserList SET password='202CB962AC59075B964B07152D234B70'

 

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

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

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

mceclip9.png

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