# Установка и настройка PostgreSQL 18 для приложения "Первая Форма"

> ℹ️ В данном разделе приведена инструкция для установки Postgres Pro 18+ для версии OS Ubuntu 22.04 LTS

## Установка PostgreSQL PRO 18

1\. Обновляем список пакетов и устанавливаем необходимые зависимости:

```bash
sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl freetds-common freetds-dev \
  g++ gcc git gnupg gnupg2 gpg libcurl4-openssl-dev libsybdb5 lsb-release make softwareproperties-common vim wget
```

2\. Добавляем репозиторий Postgres Pro

```bash
curl -o pgpro-repo-add.sh https://repo.postgrespro.ru/pgpro-18/keys/pgpro-repo-add.sh
sudo sh pgpro-repo-add.sh
sudo apt update
```

3\. Устанавливаем пакеты Postgres:

```bash
sudo apt install -y postgrespro-std-18
sudo apt install -y postgrespro-std-18-dev postgrespro-std-18-client
```

## Настройка postgresql.conf

В файле конфигурации '/var/lib/pgpro/std-18/data/postgresql.conf' редактируем параметры:

```
max_connections = 1500
listen_addresses = '*'
log_timezone = 'Europe/Moscow'
timezone = 'Europe/Moscow'
# Критично для русского полнотекстового поиска: FTS-индексы в БД "Первой Формы"
# строятся через to_tsvector('russian', ...). Без этого параметра websearch_to_tsquery
# без явного language идёт по english словарю и не находит русские документы.
default_text_search_config = 'pg_catalog.russian'
```

Настраиваем доступ к серверу PostgreSQL. Для этого редактируем файл '/var/lib/pgpro/std-18/data/pg\_hba.conf'. Для разрешения соединений только из указанной подсети:

```
host all all 192.168.4.0/24 md5
```

Для разрешения соединения из любой подсети:

```
host all all 0.0.0.0/0 md5
```

## Настройка локализации

Устанавливаем локаль ru\_RU.utf8:

```bash
sudo apt install -y language-pack-ru
sudo update-locale LANG=ru_RU.UTF-8
```

Проверяем командой locale. Должны получить следующее:

```
LANG=ru_RU.UTF-8
LANGUAGE=
LC_CTYPE="ru_RU.UTF-8"
LC_NUMERIC="ru_RU.UTF-8"
LC_TIME="ru_RU.UTF-8"
LC_COLLATE="ru_RU.UTF-8"
LC_MONETARY="ru_RU.UTF-8
LC_MESSAGES="ru_RU.UTF-8"
LC_PAPER="ru_RU.UTF-8"
LC_NAME="ru_RU.UTF-8"
LC_ADDRESS="ru_RU.UTF-8"
LC_TELEPHONE="ru_RU.UTF-8"
LC_MEASUREMENT="ru_RU.UTF-8"
LC_IDENTIFICATION="ru_RU.UTF-8"
LC_ALL=
```

Настраиваем формат даты и времени. Создаем файл '/etc/freetds/locales.conf' со следующим наполнением:

```bash
sudo vim /etc/freetds/locales.conf
```

Содержимое:

```
[default]
date format = %b %e %Y %I:%M:%S.%z%p
```

Проверяем командой date. Должны получить дату в следующем формате:

```
Вт 09 мая 2023 22:16:05 UTC
```

## Перезапуск службы PostgreSQL. Проверка статуса

1\. Для перезапуска службы выполним следующую команду:

```bash
sudo systemctl restart postgrespro-std-18.service
```

2\. Проверим статус:

```bash
sudo systemctl status postgrespro-std-18.service
```

## Настройка расширений

1\. Для использования баз данных "Первой Формы" в PostgreSQL должны быть настроены следующие расширения:

- http

- pg\_buffercache

- pg\_hint\_plan

- pgcrypto

- postgres\_fdw

- rum

- tds\_fdw

1\. Скачиваем и устанавливаем модуль rum:

```bash
git clone https://github.com/postgrespro/rum
cd rum
make USE_PGXS=1
sudo make USE_PGXS=1 install
cd
```

В случае ошибки pg\_config not found выполните:

```bash
sudo ln -s /opt/pgpro/std-18/bin/pg_config /usr/bin/pg_config
```

2\. Скачиваем с GitHub исходники модуля tds\_fdw, компилируем и устанавливаем:

```bash
git clone https://github.com/tds-fdw/tds_fdw.git
cd tds_fdw
make USE_PGXS=1
sudo make USE_PGXS=1 install
cd
```

3\. Скачиваем с GitHub исходники модуля pg\_hint\_plan, компилируем и устанавливаем:

```bash
git clone https://github.com/ossc-db/pg_hint_plan.git
cd pg_hint_plan
git checkout PG18
make
sudo make install
cd
```

4\. Скачиваем с GitHub исходники модуля http, компилируем и устанавливаем:

```bash
git clone https://github.com/pramsey/pgsql-http.git
cd pgsql-http
make
sudo make install
cd
```

5\. Заходим в терминальный клиент Postgres и подключаемся к базе d10task:

```bash
sudo -u postgres psql -d d10task
```

6\. Активируем расширения:

```sql
LOAD 'pg_hint_plan';

CREATE EXTENSION IF NOT EXISTS tds_fdw schema public;

CREATE EXTENSION IF NOT EXISTS http schema public;

CREATE EXTENSION IF NOT EXISTS rum schema public;

CREATE EXTENSION IF NOT EXISTS postgres_fdw schema public;

CREATE EXTENSION IF NOT EXISTS pgcrypto schema public;

CREATE EXTENSION IF NOT EXISTS pg_buffercache schema public;

CREATE EXTENSION IF NOT EXISTS btree_gin;
```

## Создание пользователей и баз данных

1\. Создаем пользователей:

```sql
create user dbo with superuser createdb createrole inherit login password 'PASSWORD';

create user d10taskuser with inherit login password 'PASSWORD';

create user migrationsdaemon with inherit login password 'PASSWORD';

create user rebus with inherit login password 'PASSWORD';

create user implementer with inherit login password 'PASSWORD';
```

Вместо PASSWORD пропишите пароли пользователей PostgreSQL.

2\. Выйдите из консоли psql:

\\q

3\. Создаем базы данных d10task и taskfilesdb:

```sql
create database d10task
  template template0
  owner dbo
  encoding 'utf8'
  lc_collate 'ru_RU.utf8'
  lc_ctype 'ru_RU.utf8';
```

```sql
create database taskfilesdb
  template template0
  owner dbo
  encoding 'utf8'
  lc_collate 'ru_RU.utf8'
  lc_ctype 'ru_RU.utf8';
```

```sql
GRANT ALL PRIVILEGES ON DATABASE d10task TO d10taskuser;

GRANT ALL PRIVILEGES ON DATABASE taskfilesdb TO d10taskuser;
```

Выйти из консоли можно командой \\q.

4\. Создаем схему в базе taskfilesdb:

```bash
sudo -u postgres psql -d taskfilesdb
```

```sql
create extension if not exists tds_fdw schema public;

create schema if not exists dbo authorization dbo;

create table dbo.UploadFiles
(
  id int not null generated by default as identity,
  FileContent bytea,
  Ext varchar,
  UserID int,
  FileName varchar,
  Compressed bool constraint DF_UploadFiles_Compressed default false,
  constraint PK_UploadFiles primary key (id)
);
```

\\q

5\. Копируем на сервер файл с расширением dump, содержащий структуру и контент базы данных, в определенную папку, например: /src/d10task\_hd.dump. Данный файл вам может предоставить техническая поддержка.

Выполняем рестор 'pg\_restore -d DB\_NAME DB\_DUMP' в созданную базу:

```bash
sudo su - postgres
pg_restore -d d10task /var/lib/pgpro/std-18/data/backup/d10task-template.dump
exit
```

6\. Настраиваем схемы для пользователей в новой базе:

```bash
sudo -u postgres psql -d d10task
```

```sql
alter role D10TaskUser set search_path = "dbo", "public";

alter role dbo set search_path = "dbo", "public";

alter user MigrationsDaemon set search_path = "dbo", "public";

alter user rebus set search_path = "rebus", "public";

grant dbo, rebus to MigrationsDaemon;

grant all on all tables in schema dbo, sys to dbo, MigrationsDaemon;

grant all on all sequences in schema dbo, sys to dbo, MigrationsDaemon;

grant all on all functions in schema dbo, sys to dbo, MigrationsDaemon;

grant all on schema dbo, sys to dbo, MigrationsDaemon;

alter default privileges in schema dbo, sys, SignalR grant all on tables to dbo, MigrationsDaemon;

alter default privileges in schema dbo, sys, SignalR grant all on sequences to dbo, MigrationsDaemon;

alter default privileges in schema dbo, sys, SignalR grant all on functions to dbo, MigrationsDaemon;

alter default privileges in schema dbo, sys, SignalR grant all on types to dbo, MigrationsDaemon;
```

На этом настройка СУБД PostgreSQL PRO 18 завершена.